Arquitetura — NFe/CTe Inbound
Como o NFe/CTe Inbound funciona por dentro: fluxo SEFAZ -> Ambiente Nacional -> nfe.io -> seu sistema, com tempos e papel do NSU.
Como o NFe/CTe Inbound funciona por dentro: fluxo SEFAZ -> Ambiente Nacional -> nfe.io -> seu sistema, com tempos e papel do NSU.
Desenho de arquitetura da Captura Fiscal (DFe Inbound) da NFE.io: componentes, integrações com os ambientes do governo, implantação, segurança e resiliência dos subprodutos NF-e, CT-e e NFS-e Inbound.
Como ativar, consultar e desativar o serviço de inbound NFe/CTe via API REST, com todos os campos do payload e variações de ambiente.
Passo a passo para ativar o NFe/CTe Inbound pelo Painel nfe.io, sem precisar de integração programática.
Captura automática de documentos fiscais eletrônicos (NF-e, CT-e e NFS-e) destinados ao CNPJ da sua empresa: captura via SEFAZ e SEFIN, webhooks, manifestação e exportação.
Todos os eventos de webhook de captura de NF-e, CT-e e NFS-e de terceiros contra o seu CNPJ, com payload real anonimizado.
Por que o serviço de inbound precisa do certificado digital, diferença entre A1 e A3, como obter e como configurar na plataforma nfe.io.
Referência dos códigos HTTP retornados pela API, formato de erro, headers de rate limit e estratégia de retry com backoff exponencial.
Receitas práticas para tarefas concretas do NFe/CTe Inbound: ativar via API ou painel, manifestar NF-e, configurar webhook, consultar com OData.
Conceitos fundamentais do NFe/CTe Inbound: arquitetura, NSU, chave de 44 dígitos, certificado digital, Reforma Tributária e LGPD.
Os conceitos fundamentais do DFe Inbound: modelo 55 (NF-e), modelo 57 (CT-e), NSU, chave de 44 dígitos, eventos e tipos de registro.
Como cadastrar o endpoint de webhook, validar a assinatura HMAC e reprocessar notificações para o NFe/CTe Inbound.
Habilite o recebimento de CT-e de entrada e consulte documentos e eventos por chave de acesso com $nfe->transportationInvoices no host api.nfse.io /v2.
Habilite a busca automática de CT-e (Distribuição DFe) e leia documentos e eventos recebidos por chave de acesso com client.transportation_invoices no host api.nfse.io /v2.
Como usar a API OData do NFe/CTe Inbound para filtrar, ordenar e paginar consultas avançadas de CT-e e eventos.
Como encontrar e baixar XML/DANFE de NF-e capturadas, diretamente pelo Painel nfe.io.
Habilite e consulte CT-e por chave de acesso com nfe.transportationInvoices (host api.nfse.io).
Como a Captura Fiscal processa NF-e, CT-e e NFS-e, com que periodicidade consulta os ambientes nacionais e como obedece às regras das Notas Técnicas (NT 2014.002, NT 2015.002 e APIs do ADN).
Referência dos endpoints da API para CT-e: metadados, XML, reprocessamento de webhooks e consolidação de batch.
Um documento fiscal autorizado não é o fim de uma história — é o começo dela. NF-e, NFC-e, CT-e e NFS-e Nacional continuam tendo fatos registrados sobre si mesmos depois da autorização na NF-e modelo 55, o evento Atualização da Data de Previsão de Entrega da mercadoria — código 112150), cancela a operação, confirma que recebeu a mercadoria, ou declara uma informação exigida pela nova legislação tributária. Cada um desses fatos é um evento fiscal.
Código pronto para integrar com o NFe/CTe Inbound em C#, Node.js, Python e PHP: busca por chave, consumo de webhook, listagem OData e ativação.
Exportar em massa os documentos NF-e/CT-e recebidos em XML, PDF (DANFE) ou CSV analítico, com o esquema de 18 colunas do CSV de NF-e.
Perguntas frequentes sobre o NFe/CTe Inbound — técnico (API, NSU, rate limit) e funcional (cobertura, fraude, sincronia, NFC-e).
Architecture design of NFE.io Fiscal Document Capture (DFe Inbound): components, integration with government environments, deployment, security and resilience for NF-e, CT-e and NFS-e Inbound.
Diagramas dos fluxos de processamento da Captura Fiscal: agendamento, consulta ao ambiente nacional, processamento por NSU, manifestação e recuperação de lacunas para NF-e, CT-e e NFS-e.
Definições dos termos técnicos e fiscais usados no NFe/CTe Inbound (NSU, DANFE, AN, IBS, CBS, EFD, manifestação, etc.).
Captura automática de NF-e (modelo 55) e CT-e (modelo 57) destinadas ao CNPJ da sua empresa, via Ambiente Nacional da SEFAZ.
Referência do corpo entregue nos eventos de NF-e, CT-e e NFS-e capturadas de terceiros: campos, resumo vs documento completo e exemplos reais anonimizados.
Tutorial guiado em 6 etapas: obter credenciais, localizar company_id, ativar inbound, configurar webhook, validar recepção e migrar para produção.
How Fiscal Document Capture processes NF-e, CT-e and NFS-e, how often it queries the national environments, and how it complies with the Technical Notes (TN 2014.002, TN 2015.002 and ADN APIs).
Processing flow diagrams of Fiscal Document Capture: scheduling, national environment queries, per-NSU processing, manifestation and gap recovery for NF-e, CT-e and NFS-e.
Ative o NFe/CTe Inbound e receba o primeiro documento da SEFAZ em menos de 5 minutos.
Documentação de referência do NFe/CTe Inbound: endpoints NF-e e CT-e, webhook events com HMAC, tipos e enums, códigos HTTP, FAQ e glossário.
Esta página lista os eventos fiscais que a NFE.io processa hoje, organizados pelo modelo de eventos do documento fiscal. Para cada evento: o código, quem o registra, como registrá-lo ou consultá-lo, e qual webhook notifica sobre ele.
O que muda no recebimento de NF-e e CT-e com a Reforma Tributária (LC 214/2025): IBS, CBS, IS e o período de transição.
Como o NFe/CTe Inbound protege seus dados fiscais: criptografia, controle de acesso, retenção legal e conformidade com a LGPD.
Referência dos enums usados na API NFe/CTe Inbound: EnvironmentSEFAZ, OperationType, MetadataResourceType, EntityStatus, CTeInterestedPartyRole e códigos de evento de manifestação.
Sinais de problema na recepção de NF-e/CT-e e como diagnosticar: NSU travado, empresa desativada, webhooks não chegando, rate limit.
Aprenda passo a passo a integrar o NFe/CTe Inbound: primeiros passos guiados e exemplos prontos em C#, Node.js, Python e PHP.
Catálogo dos eventos do webhook NFe/CTe Inbound (product_invoice_inbound, transportation_invoice_inbound), payload e contrato de validação HMAC-SHA1 (x-hub-signature).