NF-e do e-mail no TMS e no ERP: como parar de digitar

Por que a nota ainda é digitada?

Em muitas transportadoras e armazéns, a nota chega por e-mail e alguém digita chave de acesso, remetente, destinatário, peso, volumes e valor no TMS, no WMS ou no ERP. Clientes maiores costumam enviar o arquivo NOTFIS, do padrão EDI da PROCEDA. Os demais mandam XML, PDF da DANFE, foto ou link. Um erro de digitação aparece depois, no CT-e corrigido, na cobrança do frete ou na doca.

De onde vem o XML da nota?

O Ajuste SINIEF 07/05 determina que o tomador do serviço envie ao transportador contratado o arquivo da NF-e e o protocolo de autorização, ou disponibilize o download, antes do início da prestação. Na prática, o arquivo chega por caminhos diferentes.

• Anexo do e-mail: o sistema lê a caixa de coleta, separa os XML e identifica o cliente pelo CNPJ do emitente.
• Só o PDF da DANFE: o PDF traz a chave de acesso, que permite buscar o XML na SEFAZ ou pedir o arquivo ao cliente.
• Link de portal: exige integração ou automação de tela, conforme as regras do portal.
• Download na SEFAZ: pela NT 2014.002, o serviço NFeDistribuicaoDFe entrega a NF-e completa ao transportador do grupo de transporte, ao CNPJ informado no evento “Ator Interessado” e a quem consta no campo autXML. A consulta usa o certificado digital da empresa e alcança documentos dos últimos 90 dias.

Por que o XML, e não o PDF, é a fonte da verdade?

A NF-e tem existência apenas digital. Sua validade jurídica vem da assinatura eletrônica do emitente e da autorização de uso da SEFAZ. O DANFE é um documento auxiliar: acompanha o trânsito da mercadoria e facilita a consulta da nota.

O XML traz itens, valores, volumes e pesos em campos definidos no leiaute. PDF e foto exigem OCR ou IA, e a leitura pode errar. Use o PDF para achar a chave e buscar o XML. Sem XML, os campos de baixa confiança passam por revisão. Peso e volumes também são opcionais no leiaute: uma nota sem peso bruto vira exceção, não um zero no sistema.

O que validar antes de lançar

• Chave de acesso: são 44 posições, e a última é um dígito verificador que protege contra erros de digitação. Com o CNPJ alfanumérico, a chave aceita letras nas posições do CNPJ. Confirme que o seu validador já aceita esse formato.
• Situação na SEFAZ: consulte a nota pela chave perto do embarque. Em regra, o emitente pode cancelar a NF-e em até 24 horas da autorização, desde que a mercadoria não tenha circulado. A distribuição também entrega ao transportador os eventos de cancelamento e de carta de correção.
• Duplicidade: a mesma nota pode chegar por e-mail e por EDI. Use a chave de acesso como identificador único.
• Limites de consulta: a NT 2014.002 limita as consultas por hora e trata o excesso como uso indevido. Planeje a rotina antes de ligar a automação.

Confira a nota contra a coleta e o agendamento

Uma nota autorizada pode não corresponder ao que foi pedido. Compare os dados com a solicitação de coleta ou com o agendamento, usando tolerâncias definidas pela operação para cada cliente e tipo de carga.

• Peso: compare o peso bruto com a coleta e com a balança. Pelo CTB (art. 257, § 4º), o embarcador responde pelo excesso de peso quando é o único remetente e declarou na nota um peso inferior ao aferido. Quando a carga de mais de um embarcador ultrapassa o peso bruto total, a responsabilidade é do transportador (§ 5º). Registre a pesagem junto da nota.
• Volumes: compare quantidade e espécie com o agendamento e com as etiquetas lidas na coleta.
• Itens: relacione cada produto ao cadastro do WMS pelo EAN ou pelo código do cliente, com conversão de unidade.
• Produtos perigosos: pela Resolução ANTT 5.998/2022, o documento para o transporte, que pode ser a própria nota fiscal, deve trazer para cada produto o número ONU, o nome apropriado para embarque, a classe ou subclasse de risco, o grupo de embalagem quando aplicável e a quantidade total. Se faltar um desses dados, a nota fica retida antes do carregamento.

Exceções e integração com o sistema

Combine com a operação o que pode entrar sem revisão, por exemplo: XML autorizado, cadastros completos e peso dentro da tolerância. O resto vai para uma fila com o documento, os dados lidos e o motivo lado a lado, e com um responsável por cliente. Quando o erro está na origem, o cliente recebe um pedido de correção.

Cada TMS, como Bsoft, ESL, Senior ou TOTVS, e cada ERP, como TOTVS Protheus, Sankhya, Omie ou Bling, aceita dados de formas que variam com a versão e o contrato. A Devled integra por API, arquivo ou, quando não há outra via, automação de tela (RPA). O fluxo precisa confirmar a gravação antes de concluir e não pode duplicar o lançamento ao repetir uma tentativa.

O que medir

Meça antes de mudar o processo e informe sempre o total de notas do período junto de cada indicador.

• Tempo do recebimento do e-mail até o lançamento no sistema.
• Notas lançadas sem digitação, separadas por origem: XML, PDF, link, SEFAZ e EDI.
• Exceções por motivo: XML ausente, nota cancelada, duplicidade, peso, cadastro e produto perigoso.
• Divergências de peso e de volumes encontradas antes do embarque.
• CT-e corrigidos por erro de digitação e horas da equipe dedicadas à digitação.

Como começar

Mapeie onde as notas chegam, em quais formatos, quem digita e em qual sistema. Meça por algumas semanas o volume, o tempo de digitação e as correções feitas depois. Sem essa base, não há como avaliar o piloto.

Comece com um cliente que envia muitas notas por e-mail, de preferência com XML, e só depois inclua PDF e foto. O cenário ilustrativo de leitura de notas fiscais por e-mail, no site da Devled, mostra um desenho possível desse fluxo. É uma referência de arquitetura, não um resultado de cliente.