Da homologação para a produção: a lista antes de a nota valer

Homologação é o ambiente de teste da Sefaz: a nota é de verdade para o sistema, mas não tem valor fiscal e não entra na sua conta. É lá que o seu sistema deve errar. Antes de liberar produção, confira se ele já passou por estes cenários.

Os cenários que o seu sistema precisa ter visto

1. Nota autorizada (201): guardou o id e a chave, mandou XML e PDF ao cliente.
2. Campo inválido (422): mostrou o erro para alguém corrigir, sem travar a fila.
3. Repetição (200, "repetida": true): mandou a mesma venda duas vezes e ficou com uma nota só.
4. Pendente (202): não emitiu de novo e sincronizou depois.
5. Webhook: conferiu a assinatura e ignorou um aviso repetido.
6. Cancelamento e carta de correção: o fluxo inteiro, do botão à atualização da venda.
7. Chave revogada (401): o sistema avisou em vez de tentar sem parar.

Liberar a produção

1. Na tela Empresa, aba Fiscal, mude o ambiente da NF-e (e o da NFS-e, se usar) para Produção.
2. No corpo das notas, passe a mandar "ambiente": "producao". Sem o campo, a nota continua indo para homologação.

As duas travas são de propósito: mandar "producao" sem ter liberado a empresa volta 422 com a explicação, e nada é enviado. Um sistema de teste esquecido apontando para a sua conta não emite nota de verdade por acidente.

O que passa a contar

Conta na assinatura só a nota autorizada em produção, uma vez por chave de acesso. Homologação, recusa e erro não contam. O consumo do mês aparece no painel.

Guardar e conferir

# Notas autorizadas em produção num período (até 200 por página)
curl "https://erp.datafrontier.com.br/api/v1/nfe?situacao=autorizada&ambiente=producao&de=2026-09-01&ate=2026-09-30&pageSize=200" \
  -H "X-Chave-Integracao: dfapp_SUA_CHAVE"

• O XML é o documento fiscal. A empresa precisa guardá-lo pelo prazo da lei, em regra cinco anos, e o cliente também.
• A API guarda os arquivos e permite baixar de novo a qualquer momento, mas mantenha a sua própria cópia: é a sua obrigação, não a do fornecedor.
• Feche o mês conferindo a lista da API com as vendas do seu sistema. Venda sem nota e nota sem venda aparecem na hora.

Produção é homologação com consequência. Se o seu sistema passou pelos sete cenários em teste, a virada é uma palavra no corpo da nota.

Conhecer a API de nota fiscal Documentação completa

Tutorial escrito pela equipe da API em 29 de setembro de 2026, conferido com a versão v1 no ar. Regra fiscal muda: o enquadramento de imposto da sua empresa é com o seu contador. Viu algo desatualizado? Fale com a gente pelo WhatsApp.