Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

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)?​

É o que a SEFAZ entrega ao destinatário antes da manifestação: um resumo (resNFe) com os dados básicos da NF-e, sem o XML completo. A SEFAZ só libera o XML completo (procNFe) depois que o destinatário manifesta — por exemplo, com a Ciência da Operação (210210). Veja a pergunta abaixo.

Por que recebi só o resumo da NF-e e não o XML completo?​

Porque a NF-e ainda não foi manifestada. Registre a manifestação (manualmente, pela API ou com a manifestação automática) para que a SEFAZ libere o XML completo.

Enquanto houver só o resumo:

  • o issuedOn do resumo é a data de recebimento na SEFAZ (dhRecbto), não a data de emissão (dhEmi), que o resumo não traz. Isso é por desenho;
  • não existe DANFE: GET .../inbound/{access_key}/pdf responde 422.
NF-e cancelada antes da manifestação

A SEFAZ recusa a Ciência da Operação para uma NF-e cancelada (cStat 650). Por isso, uma NF-e cancelada antes de ser manifestada fica como resumo + evento de cancelamento (110111): o XML completo não será liberado. Nesse caso, o registro fiscal é o XML do evento (procEventoNFe), disponível em GET .../inbound/{access_key}/events/{event_key}/xml.

Como acompanho o resultado de uma manifestação?​

Por polling. A submissão (POST .../manifestation-events ou o legado POST /manifest) é assíncrona e devolve o evento em Pending. Consulte GET .../productinvoices/manifestation-events/{id} até o status virar Accepted, Rejected ou Failed. Não há webhook de conclusão da manifestação. Detalhes em Manifestar NF-e.

Desativei o inbound de NF-e. Perco os documentos?​

Não. Os documentos já capturados continuam armazenados, mas as rotas de leitura de NF-e respondem 403 enquanto o inbound estiver desativado (a rota /xml responde 400). Para voltar a ler e capturar, reative com POST .../inbound/productinvoices; o startFromDate informado não pode ser anterior a 90 dias.

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?​

DocumentoModeloUso
NF-e55Venda entre empresas (B2B)
NFC-e65Venda 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 envie o evento "Confirmação da 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​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.