Perguntas Frequentes (FAQ)
Respostas a dúvidas frequentes de desenvolvedores e usuários do NFe/CTe Inbound.
Sumário
Dúvidas técnicas
Quanto tempo leva para receber um documento após a emissão?
Em condições normais, entre 30 minutos e 4 horas após a autorização da SEFAZ. O nosso sistema faz polling periódico na SEFAZ; o intervalo depende da configuração, da sincronização entre a SEFAZ de origem e o Ambiente Nacional e da disponibilidade da SEFAZ.
O que é um "resumo" (productInvoiceSummary)?
Quando o XML completo ainda não está disponível no Ambiente Nacional, a SEFAZ retorna apenas um resumo com os dados básicos da NF-e. Eventualmente, o documento completo chega e é atualizado automaticamente.
Posso buscar documentos históricos?
Sim. A SEFAZ mantém documentos disponíveis por até 90 dias para consulta via NSU. Configure StartFromDate ou StartFromNsu ao ativar o inbound para sincronizar o histórico.
A URL do XML expira?
Sim. As URLs retornadas em links.xml e links.pdf expiram em 1 hora. Para download, use a URL logo após obtê-la, ou chame o endpoint /xml a qualquer momento para obter uma nova URL.
O que acontece se meu webhook estiver fora do ar?
O sistema tentará reenviar o webhook com backoff exponencial por até 24 horas. Após esse período, você pode usar o endpoint de reprocessamento para solicitar novo envio.
Preciso manifestar todas as NF-es?
Pela legislação brasileira, o destinatário deve manifestar ciência de operação para NF-es de entrada (que você está comprando). Configure AutomaticManifesting para que o sistema faça isso automaticamente.
Como testar sem afetar o ambiente de produção?
Configure com EnvironmentSEFAZ: "Test" para usar o ambiente de homologação SEFAZ. Documentos emitidos em homologação não têm validade fiscal. Ao terminar os testes, delete a configuração e recrie com "Production".
Qual o limite de requisições?
Por padrão, o limite é de 60 requisições por minuto por empresa. Os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset informam o status atual. Para limites maiores, entre em contato com o suporte nfe.io.
Como saber se o inbound está atrasado?
Consulte GET /productinvoices e compare OperationDetail_CurrentNsu com OperationDetail_MaxNsu. Se a diferença for grande e OperationDetail_ExecutedOn for antigo, pode haver um problema. Verifique se a configuração está Active e se o certificado digital não expirou.
Dúvidas funcionais
O serviço cobre todos os documentos destinados ao meu CNPJ?
Sim. O serviço consulta o Ambiente Nacional (AN) da SEFAZ, que centraliza todos os documentos destinados ao seu CNPJ, independentemente de qual estado foi emitido.
Documentos emitidos antes da ativação aparecem?
Sim, até 90 dias antes da ativação. Ao configurar a "Data de Início", definimos o ponto de partida da busca histórica. A SEFAZ mantém os documentos disponíveis por 90 dias para consulta via distribuição.
Se você precisar de documentos mais antigos que 90 dias, será necessário obtê-los diretamente com o emitente.
O que acontece se a SEFAZ ficar fora do ar?
Nosso sistema fica tentando a consulta periodicamente. Quando a SEFAZ voltar, ele retoma de onde parou e busca todos os documentos que chegaram durante a indisponibilidade. Nenhum documento é perdido.
Posso receber documentos de mais de um CNPJ?
Sim. Você pode ativar o serviço para cada CNPJ da sua empresa separadamente. Cada CNPJ tem sua própria configuração de inbound.
Meu fornecedor diz que emitiu a NF-e, mas não aparece no sistema. O que fazer?
- Aguarde pelo menos 4 horas — o tempo de sincronização entre a SEFAZ estadual e o Ambiente Nacional pode variar
- Verifique se o CNPJ destinatário da NF-e é o mesmo que está configurado
- Confirme com o fornecedor se a NF-e foi autorizada pela SEFAZ (não apenas emitida localmente)
- Se o problema persistir, entre em contato com o suporte nfe.io informando a chave de acesso da NF-e
Qual a diferença entre NF-e e NFC-e?
| Documento | Modelo | Uso |
|---|---|---|
| NF-e | 55 | Venda entre empresas (B2B) |
| NFC-e | 65 | Venda para consumidor final (B2C) — substitui o cupom fiscal |
O serviço de inbound foca em NF-e (modelo 55), pois são as notas destinadas à sua empresa.
Preciso pagar por cada NF-e recebida?
Depende do seu plano na nfe.io. Consulte a tabela de preços ou entre em contato com nosso time comercial.
O serviço funciona em ambiente de testes (homologação)?
Sim. Configure EnvironmentSEFAZ: Homologação para testar com documentos emitidos no ambiente de homologação SEFAZ. Esses documentos não têm validade fiscal.
O que fazer se chegar uma NF-e que parece fraude?
- Não confirme a operação — não clique em "Confirmar Operação"
- Registre o Desconhecimento da Operação imediatamente na plataforma
- Verifique com seu departamento financeiro se houve alguma compra que não reconhece
- Se confirmar fraude, registre um Boletim de Ocorrência (BO) e notifique a Receita Federal pelo e-CAC
- Contate sua assessoria jurídica para avaliar as medidas cabíveis