--- title: "FAQ — NFe/CTe Inbound" description: "Perguntas frequentes sobre o NFe/CTe Inbound — técnico (API, NSU, rate limit) e funcional (cobertura, fraude, sincronia, NFC-e)." source_url: https://nfe.io/docs/distribuicao-nfe-cte-faq/ last_updated: 2026-07-30 --- # Perguntas Frequentes (FAQ) Respostas a dúvidas frequentes de desenvolvedores e usuários do NFe/CTe Inbound. ## Sumário - [Dúvidas técnicas](#dúvidas-técnicas) - [Dúvidas funcionais](#dúvidas-funcionais) ## 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? 1. Aguarde pelo menos 4 horas — o tempo de sincronização entre a SEFAZ estadual e o Ambiente Nacional pode variar 2. Verifique se o CNPJ destinatário da NF-e é o mesmo que está configurado 3. Confirme com o fornecedor se a NF-e foi **autorizada** pela SEFAZ (não apenas emitida localmente) 4. 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? 1. **Não confirme** a operação — não clique em "Confirmar Operação" 2. Registre o **Desconhecimento da Operação** imediatamente na plataforma 3. Verifique com seu departamento financeiro se houve alguma compra que não reconhece 4. Se confirmar fraude, registre um Boletim de Ocorrência (BO) e notifique a Receita Federal pelo e-CAC 5. Contate sua assessoria jurídica para avaliar as medidas cabíveis ## Veja também - [Glossário](./glossario.md) - [Manifestar NF-e](../how-to/manifestar-nfe.md) - [Conceitos: Arquitetura](../explanation/arquitetura.md) - [Conceitos: Reforma tributária](../explanation/reforma-tributaria.md) - [Conceitos: Segurança e LGPD](../explanation/seguranca-lgpd.md)