Como automatizar a emissão de nota fiscal
Automatizar emissão de nota fiscal exige três decisões: certificado digital A1, porque o A3 em token não funciona em servidor sem alguém presente; o tipo de nota, já que NF-e é estadual e NFS-e é municipal com regra diferente em cada cidade; e o tratamento de rejeição, para não emitir a mesma nota duas vezes.
Certificado A1 ou A3 decide se a automação existe
Essa é a primeira pergunta e a que mais derruba projeto no meio. O certificado A3 fica em token USB ou cartão e exige que alguém insira a mídia e digite o PIN. Não existe automação de servidor sobre isso: toda emissão viraria uma interrupção humana.
O certificado A1 é um arquivo que o servidor carrega, com senha guardada em cofre de segredos. É o único caminho viável para emissão automática. A contrapartida é a validade menor, o que significa que a troca do certificado precisa entrar no calendário de operação.
Um alarme de vencimento do certificado com trinta dias de antecedência não é luxo. Certificado vencido derruba a emissão inteira, e costuma vencer exatamente na virada do mês, quando o volume é maior.
NF-e e NFS-e são projetos diferentes
NF-e cobre circulação de mercadoria, é autorizada pela SEFAZ do estado e segue um layout nacional. Quem já integrou NF-e em um estado integra em outro com esforço pequeno.
NFS-e cobre prestação de serviço e é municipal. Historicamente cada prefeitura definiu o próprio padrão, então integrar em duas cidades podia significar dois trabalhos completamente distintos. Existe um padrão nacional em adoção que melhora esse cenário, mas a adesão é gradual e ainda convive com sistemas municipais próprios.
A consequência prática: se você emite serviço em vários municípios, o custo cresce por município, não por nota. Isso muda completamente a conta de fazer internamente versus usar um intermediador.
Rejeição não é erro do sistema, é parte do fluxo
A SEFAZ rejeita nota por dezenas de motivos: cadastro do destinatário irregular, código fiscal incompatível, campo obrigatório vazio para aquela operação. Rejeição é resposta normal, e o sistema precisa tratá-la como estado previsto.
A regra que evita o pior problema: nunca reemita cegamente após falha. Antes de tentar de novo, consulte a situação da nota pela chave de acesso. Boa parte das notas duplicadas nasce de uma retentativa automática sobre uma emissão que na verdade tinha sido autorizada, e só a resposta se perdeu.
Separe rejeição de denegação. Rejeição você corrige e reenvia. Denegação significa que o fisco recusou por irregularidade cadastral, a nota fica registrada nesse estado e a operação não pode seguir como se nada tivesse acontecido.
Homologação existe por um motivo
A SEFAZ oferece ambiente de homologação, com as mesmas validações e sem valor fiscal. Toda regra de emissão deve ser exercitada ali antes de tocar produção, incluindo os casos de erro.
O detalhe que pega: nota emitida em produção por engano durante teste precisa ser cancelada dentro do prazo legal, e o prazo é curto. Passado ele, o caminho vira carta de correção quando cabe, ou nota de devolução, o que é bem mais trabalhoso que ter usado homologação desde o início.
Passo a passo da emissão automatizada
- Garanta um certificado digital A1. Confirme que a empresa tem certificado A1 em arquivo, não A3 em token. Sem isso, emissão automática em servidor não é possível. Guarde a senha em cofre de segredos, nunca no código.
- Defina o tipo de nota e os municípios envolvidos. Identifique se é NF-e, NFS-e ou ambas, e em quais municípios você presta serviço. O número de municípios é o que determina o esforço real de uma integração de NFS-e.
- Decida entre integrar direto ou usar intermediador. Integração direta com a SEFAZ dá controle e evita custo por nota. Intermediador absorve a diferença entre municípios e as mudanças de layout. Com muitos municípios, o intermediador quase sempre sai na frente.
- Monte a emissão em ambiente de homologação. Implemente a montagem do documento e a assinatura contra o ambiente de homologação. Exercite também os casos de erro, não apenas a emissão bem-sucedida.
- Trate rejeição consultando antes de reenviar. Em qualquer falha, consulte a situação da nota pela chave de acesso antes de tentar de novo. Retentativa cega sobre nota já autorizada é a origem mais comum de duplicidade.
- Guarde o XML autorizado e o protocolo. Persista o XML autorizado junto do protocolo de autorização, que é o documento com validade fiscal. O PDF é representação e pode ser gerado de novo a partir do XML.
- Monitore certificado, fila e taxa de rejeição. Alarme para vencimento do certificado com trinta dias de antecedência, alarme para nota parada na fila e acompanhamento da taxa de rejeição por motivo, que revela cadastro sujo antes de virar problema.
Integrar direto ou usar intermediador
A conta muda conforme o tipo de nota e o número de municípios. Volume alto de NF-e num estado favorece integração direta. Serviço em muitas cidades favorece intermediador.
| Abordagem | Custo | Prazo | Onde para de servir |
|---|---|---|---|
| Integração direta com a SEFAZ (NF-e) | Só desenvolvimento, sem custo por nota | 3 a 6 semanas | Controle total e sem taxa por documento. Você assume o acompanhamento de mudança de layout e a operação de contingência. |
| Intermediador ou API de terceiros | Mensalidade mais valor por nota | 1 a 2 semanas | Absorve a diferença entre municípios e as mudanças de layout. Custo cresce com o volume e cria dependência de fornecedor. |
| Módulo fiscal do ERP | Licença do módulo | Semanas de configuração | Integrado ao restante do fiscal. Emissão disparada por evento fora do ERP costuma exigir desenvolvimento adicional. |
| Emissão manual no portal | Zero em software | Imediato | Inviável acima de poucas notas por dia e sujeito a erro de digitação. É o cenário que a automação substitui. |
Perguntas frequentes
Referências
Quer isso rodando na sua operação?
Escopo, prazo e preço travados antes de começar, com 90 dias de garantia.
Quero automatizar minha emissão