Como baixar XML de CT-e automaticamente

Ao contrário da NF-e de compra, que costuma vir acompanhada de alguma comunicação do fornecedor, o CT-e é emitido dentro do sistema da transportadora e frequentemente não sai de lá. O que chega ao tomador é o DACTE — a representação impressa — junto com a mercadoria, ou nada.

Só que o documento fiscal é o XML assinado, não o DACTE. Sem ele não há importação para o sistema, não há conferência da assinatura e a escrituração fica apoiada em papel. Pedir arquivo por arquivo à transportadora funciona uma vez; não funciona todo mês.

A boa notícia é que não existe um segundo canal para aprender. A SEFAZ distribui os CT-e em que a sua empresa aparece pelo mesmo webservice de Distribuição de DFe que entrega as NF-e emitidas contra o seu CNPJ. Mesma fila, mesma sequência de NSU, mesmo certificado digital.

Na prática isso significa que quem já resolveu a captura das NF-e resolveu a dos CT-e no mesmo movimento — desde que o sistema saiba reconhecer o schema do CT-e quando ele aparece na fila, em vez de ignorar o que não é NF-e. A XSafe lê os dois, e também os eventos de cada um.

As regras de consulta desse canal, que são o que costuma quebrar uma integração caseira, estão explicadas no guia sobre baixar XML de NF-e em lote. Elas valem igualmente para o CT-e.

Cada documento entra indexado por chave de acesso, CNPJ do emitente, valor e data de emissão, e recebe um rótulo próprio: “CT-e” e “Evento de CT-e”, distintos de “NF-e completa”, “Resumo de NF-e” e das NFS-e. Isso importa no fechamento — frete e mercadoria não podem cair no mesmo balde só porque vieram pela mesma fila.

A busca, a exportação em CSV, o ZIP do período e o pacote mensal por e-mail funcionam sobre todos os tipos juntos ou filtrados por um deles. O painel de demonstração mostra o formato com dados fictícios, sem cadastro.

A fila de distribuição retém cerca de 90 dias. CT-e mais antigo que isso não vem por esse canal — nem para a XSafe, nem para nenhum outro serviço que use a fonte oficial. E o MDF-e, o manifesto eletrônico de documentos fiscais, não é captado hoje.

A XSafe também não emite nem cancela nada em nome da sua empresa: a conexão com a SEFAZ é apenas de leitura, com o certificado apresentado no momento da consulta e descartado da memória em seguida.