A Sefaz às vezes demora ou não responde. A nota pode ter chegado lá e sido autorizada, ou não. Emitir de novo nessa hora é arriscar duas notas; dar a venda como sem nota é arriscar uma nota autorizada que ninguém mandou ao cliente. Por isso a API tem uma situação própria para esse momento: pendente.
O que o 202 quer dizer
- A nota foi enviada à Sefaz, mas a resposta não chegou.
- O número não é devolvido ainda, de propósito: ele só vale se a nota existir.
- A nota fica reservada para aquela Idempotency-Key. Reenviar com a mesma chave devolve a mesma pendência, nunca uma segunda nota.
Como resolver: sincronizar
Espere um minuto e peça para a API conferir a nota na Sefaz pela chave de acesso:
curl -X POST https://erp.datafrontier.com.br/api/v1/nfe/ID_DA_NOTA/sincronizar \
-H "X-Chave-Integracao: dfapp_SUA_CHAVE"| A Sefaz diz | A nota passa a | O que fazer |
|---|---|---|
| Autorizada | autorizada | Seguir normalmente: número, XML e PDF já estão disponíveis. |
| Não existe | rejeitada ou erro | Mandar de novo com a mesma Idempotency-Key. |
| Ainda sem resposta | pendente | Tentar de novo mais tarde. |
Há um limite de uma sincronização por minuto por nota. Antes disso, a resposta é 429: é só esperar.
Uma rotina que não deixa pendência esquecida
Em vez de depender de alguém lembrar, rode uma tarefa de tempos em tempos que lista as pendentes e sincroniza cada uma:
curl "https://erp.datafrontier.com.br/api/v1/nfe?situacao=pendente&pageSize=50" \
-H "X-Chave-Integracao: dfapp_SUA_CHAVE"Se você usa o aviso automático (webhook), a mudança de pendente para autorizada também chega por lá, e o seu sistema nem precisa perguntar.
Pendente não é erro. É a API se recusando a adivinhar o que a Sefaz fez.
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.