Skip to main content

Visão Geral

A rota de emissão de NF-e é responsável por realizar todo o processo de geração, assinatura e autorização da Nota Fiscal Eletrônica (NF-e) junto à Secretaria da Fazenda (SEFAZ), permitindo que empresas emitam documentos fiscais válidos de forma totalmente automatizada.

Essa funcionalidade é essencial para integrar sistemas de vendas, ERP e plataformas de gestão fiscal diretamente com o ambiente da SEFAZ, garantindo conformidade legal, rastreabilidade e segurança no envio de informações fiscais.

Importância da Emissão de NF-e​

A emissão eletrônica substitui os antigos documentos em papel, proporcionando benefícios como:

  • Automação e agilidade no processo de faturamento.
  • Redução de erros manuais, com validações automáticas antes do envio.
  • Assinatura digital para garantir autenticidade, integridade e não repúdio.
  • Armazenamento eletrônico e facilidade na recuperação de documentos.
  • Integração direta com sistemas de controle contábil, fiscal e logístico.

Funcionamento​

Para emitir uma NF-e, o sistema do usuário deve enviar um payload completo com os dados da operação, incluindo:

  • Emitente – informações do CNPJ, endereço e regime tributário.
  • Destinatário – dados do comprador, seja pessoa física ou jurídica.
  • Produtos e serviços – códigos, descrições, CFOP, NCM e valores.
  • Tributação – cálculos de ICMS, PIS, COFINS, IPI, entre outros.
  • Transporte e pagamento – forma de entrega e método de cobrança.

O documento é então assinado digitalmente com o certificado do emitente e transmitido à SEFAZ para autorização.

Retorno da Emissão​

O processamento pode ocorrer de duas formas:

  • Síncrono (indSinc = 1) — o retorno da autorização é imediato.
  • Assíncrono (indSinc = 0) — a autorização ocorre em segundo plano, e deve ser consultada posteriormente.

Após o processamento, a SEFAZ retorna:

  • ✅ Confirmação da autorização
  • 🔑 Chave de acesso da NF-e
  • 🧾 Protocolo de autorização (nProt)
  • 🧠 XML autorizado completo

Essas informações permitem que o documento seja entregue ao cliente, armazenado internamente e utilizado em processos contábeis, fiscais e logísticos.

Conformidade e Benefícios​

A emissão via API garante que todas as etapas fiscais sejam executadas em conformidade com a legislação vigente, proporcionando:

  • Segurança jurídica e integridade digital por meio da assinatura com certificado A1.
  • Redução de tempo e custo operacional com emissão automatizada.
  • Comunicação direta e validada com a SEFAZ, sem intermediários.
  • Rastreabilidade completa de cada documento emitido.

Boas Práticas​

  • Utilize o ambiente correto (tpAmb):
    • 1 = Produção
    • 2 = Homologação
  • Envie o certificado digital através da rota para obter o hash que será usado nas demais rotas /certificate/upload.
  • Armazene o XML autorizado e o DANFE localmente.
  • Sempre verifique o status da SEFAZ antes da emissão, usando a rota /nfe/statusservico.
  • Mantenha logs e cópias de segurança para auditoria fiscal.