Como automatizar emissão e leitura de nota fiscal

Automatizar nota fiscal são dois projetos diferentes com o mesmo nome. Emitir é integrar seu sistema à SEFAZ, direto ou via provedor, e tratar autorização, rejeição e contingência. Receber é baixar o XML das notas dos fornecedores, validar contra o pedido de compra e lançar. Os dois lados rendem, mas o segundo costuma dar retorno mais rápido e ter menos armadilha.

Antes de integrar: o cadastro é que trava

A causa mais comum de emissão automática que não funciona não é a integração, é o cadastro. A SEFAZ valida o conteúdo, e conteúdo incompleto é rejeitado independentemente de quão boa seja a integração.

O que precisa estar correto antes:

No produto: NCM válido e compatível, CEST quando aplicável, unidade comercial padronizada, origem da mercadoria, CFOP correto por tipo de operação e por UF de destino.

No cliente: documento válido, inscrição estadual em situação regular (ou isento declarado corretamente), endereço com código de município oficial e CEP consistente.

Na empresa: certificado digital A1 válido e com data de renovação monitorada, regime tributário configurado, série e numeração organizadas, ambiente de homologação separado do de produção.

O certificado merece um alerta próprio: ele vence, e vence sempre num dia inconveniente. Um alerta automático com 30 dias de antecedência evita a manhã em que a empresa não consegue faturar.

Emitir: direto na SEFAZ ou via provedor

Para a maioria das empresas, provedor ganha, especialmente por causa da NFS-e, que historicamente tem padrão próprio por município e transforma cada nova cidade atendida em um miniprojeto. A migração nacional do padrão de serviços reduz esse problema, mas conviver com os dois modelos durante a transição é exatamente o tipo de trabalho que compensa terceirizar.

Integração direta faz sentido em volume muito alto, quando o custo por documento pesa, ou quando há requisito de arquitetura que o provedor não atende.

O fluxo de emissão que aguenta produção

1. Evento de venda dispara a preparação da nota
2. Validação prévia dos dados obrigatórios, antes de enviar
3. Envio com chave de idempotência para não emitir duas notas do mesmo pedido
4. Tratamento da resposta, autorizada, rejeitada, em processamento
5. Persistência de chave de acesso, XML e protocolo
6. Entrega do DANFE e do XML ao cliente
7. Fila de exceção para o que foi rejeitado

O passo 2 é o que mais economiza. Validar CNPJ, NCM, CFOP e endereço antes de enviar transforma uma rejeição da SEFAZ, que exige análise fiscal, em uma mensagem clara para quem cadastrou.

E os estados de exceção precisam de tratamento explícito:

• Rejeição, nota não existe, precisa correção e reenvio
• Denegação, a nota recebe número mas é negada, geralmente por irregularidade do destinatário; não pode ser reenviada com o mesmo número
• Contingência, SEFAZ fora do ar; a operação continua com transmissão posterior
• Carta de correção, corrige o que a legislação permite, sem cancelar
• Cancelamento, dentro do prazo legal, com justificativa

Sistema que só trata "autorizada" e "erro" deixa nota presa em estado indefinido, e nota presa vira problema fiscal, não problema de software.

Receber: leitura de XML, a automação de melhor retorno

Do lado de entrada, a automação é mais simples e o ganho é imediato, porque substitui digitação pura.

O fluxo:

1. Captura, download automático dos XMLs por manifestação do destinatário, integração com o provedor, ou uma caixa de e-mail dedicada
2. Leitura, o XML é estruturado, então a extração é confiável: emitente, itens, valores, impostos, chave, vencimentos
3. Validação contra o pedido de compra, item, quantidade e preço batem com o que foi comprado?
4. Classificação, centro de custo e conta contábil, por regra ou por histórico do fornecedor
5. Lançamento, no financeiro e no estoque, com o título a pagar já gerado
6. Exceção, divergência vai para conferência humana

O passo 3 é o que gera valor além da economia de digitação. Conferir automaticamente nota contra pedido pega cobrança a mais, item trocado e preço fora do combinado, coisas que a conferência manual deixa passar justamente porque é manual e cansativa.

Detalhe importante: XML é a fonte, PDF é a cópia. Quem lê o DANFE em PDF com OCR está resolvendo um problema difícil que não precisava existir. Se o fornecedor só manda PDF, cobre o XML, ele é obrigatório.

Onde a IA entra e onde não precisa

Em documento estruturado como o XML da NF-e, IA não é necessária: a informação já vem em campos definidos e regra simples resolve melhor e mais barato.

A extração com modelo de linguagem ganha nos documentos que não são estruturados:

• Boleto avulso em PDF sem XML correspondente
• Recibo, contrato de serviço, fatura de fornecedor estrangeiro
• Nota de serviço em layout municipal antigo
• Documento fotografado por WhatsApp

Mesmo nesses casos, a regra vale: o modelo extrai, a regra valida. Confira dígito verificador do documento, soma dos itens contra o total, formato de data e existência do fornecedor no cadastro antes de gravar. Extração sem validação é digitação automática de erro.

O que monitorar

• Notas rejeitadas nas últimas 24 horas, agrupadas por motivo, o motivo repetido aponta o campo de cadastro a corrigir
• Notas em processamento há muito tempo, indício de resposta perdida
• Vencimento do certificado digital, com aviso antecipado
• XMLs recebidos x pedidos de compra abertos, nota que chega sem pedido correspondente
• Divergências de valor entre nota e pedido, por fornecedor

Esse último indicador costuma se pagar sozinho: fornecedor que diverge sempre não é erro de sistema, é uma conversa comercial que precisa acontecer, e que só aparece quando alguém mede.