AN × ADN — SEFAZ e SEFIN na recepção
As diferenças entre o Ambiente Nacional da SEFAZ (NF-e/CT-e) e o Ambiente de Distribuição Nacional da SEFIN (NFS-e): protocolo, autenticação, paginação e downloads.
As diferenças entre o Ambiente Nacional da SEFAZ (NF-e/CT-e) e o Ambiente de Distribuição Nacional da SEFIN (NFS-e): protocolo, autenticação, paginação e downloads.
Como o NFe/CTe Inbound funciona por dentro: fluxo SEFAZ -> Ambiente Nacional -> nfe.io -> seu sistema, com tempos e papel do NSU.
Visão sistêmica do serviço de captura automática de NFS-e do padrão nacional: atores, fluxo SEFIN → ADN → NFE.io → cliente, conceitos e pontos de falha.
Passo a passo para ativar o recebimento automático de NFS-e no console app.nfe.io, sem escrever código.
Como cadastrar, consultar, atualizar e desativar a captura automática de NFS-e de uma empresa pela API REST.
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.
Como autenticar na API de recepção automática: API Key no header Authorization, ambientes de produção/homologação e o campo environmentSEFAZ.
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.
Catálogo dos 6 eventos do webhook NFS-e Inbound: envelope, payload, schema do document (amounts, taxes, IBS/CBS), validação HMAC (x-hub-signature + SHA1), política de retry e idempotência.
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.
Como o certificado digital da empresa é usado na recepção de NFS-e: acesso ao ADN via mTLS e desativação por problemas de certificado.
Da emissão por terceiros à manifestação: as etapas que todo documento fiscal percorre desde a autorização até chegar ao seu sistema.
Distinção entre os dois contextos de eventCode no NFS-e Inbound: XSD tpEvento (webhook) vs EventCode do CSV de bulk export analítico.
Referência dos códigos HTTP retornados pela API, formato de erro, headers de rate limit e estratégia de retry com backoff exponencial.
Receita para gerar arquivos consolidados (XML, PDF ou CSV analítico) de NFS-e capturadas em lote, via API assíncrona do shared-usage-api da NFE.io.
Receitas práticas para tarefas concretas do NFe/CTe Inbound: ativar via API ou painel, manifestar NF-e, configurar webhook, consultar com OData.
Receitas para resolver problemas concretos com NFS-e Inbound: integração REST, manifestação do tomador, bulk export.
Receita para submeter Ciência (203202) ou Rejeição (203206) de uma NFS-e capturada pelo NFS-e Inbound, tratando o fluxo assíncrono e os códigos cStat do SEFIN Nacional.
Conceitos fundamentais do NFe/CTe Inbound: arquitetura, NSU, chave de 44 dígitos, certificado digital, Reforma Tributária e LGPD.
Visão sistêmica do NFS-e Inbound: atores envolvidos, fluxo SEFIN → ADN → NFE.io → cliente, decisões de design e diferenças em relação ao NF-e/CT-e Inbound.
Conceitos transversais à recepção automática de NF-e, CT-e e NFS-e: ciclo de vida, NSU, chaves, ambientes, autenticação, Reforma Tributária e glossário.
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.
Os conceitos próprios da recepção de NFS-e: modelo 56, chave de 50 dígitos, DPS, NSU e o Ambiente de Distribuição Nacional (ADN).
Como cadastrar o endpoint de webhook, validar a assinatura HMAC e reprocessar notificações para o NFe/CTe Inbound.
Quando consumir a recepção automática pelo console (app.nfe.io) e quando integrar por API REST — critérios e como combinar os dois.
Como usar a API OData do NFe/CTe Inbound para filtrar, ordenar e paginar consultas avançadas de CT-e e eventos.
Como encontrar, filtrar e baixar XML/DANFE de NF-e e CT-e recebidos, diretamente pelo Painel nfe.io.
Como localizar, filtrar e baixar XML, PDF (DANFSe) e CSV das NFS-e recebidas no console app.nfe.io.
O modelo de identidade da recepção automática: conta guarda-chuva, empresa (CNPJ), certificado digital e ativação por empresa. Sem empresa + certificado, o serviço não é ativado.
Esquema completo, coluna a coluna, do CSV analítico de NFS-e recebidas (resource company-nfse-inbound-analytical-csv).
Referência curada dos endpoints REST da recepção de NFS-e: empresas, documentos, downloads, manifestação e manutenção.
Referência dos endpoints da API para CT-e: metadados, XML, reprocessamento de webhooks e consolidação de batch.
Referência dos endpoints da API para NF-e: buscar metadados, baixar XML/PDF, eventos, manifestação e reprocessamento de webhook.
Códigos de status HTTP retornados pela API de recepção de NFS-e, formato do corpo de erro e como reagir a cada um.
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.
Snippets prontos em C#, Node.js, Python e PHP para listar as NFS-e recebidas via API.
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).
Perguntas frequentes sobre a recepção automática de NFS-e: certificado, webhook, manifestação e exportação.
Definições dos termos técnicos e fiscais usados no NFe/CTe Inbound (NSU, DANFE, AN, IBS, CBS, EFD, manifestação, etc.).
Definições dos termos do domínio de recepção automática de DFe: NSU, AN, ADN, SEFAZ, SEFIN, chave de acesso, DPS, manifestação, IBS/CBS/IS e mais.
Tutorial completo de integração com a API NFS-e Inbound: autenticação por API Key, ativação, listagem com filtros, downloads, paginação incremental e tratamento de erros.
Como registrar manifestação de NF-e (Ciência, Confirmação, Desconhecimento, Operação Não Realizada) manualmente ou de forma automática.
Endpoints administrativos para forçar captura, consultar notificações e estatísticas e reativar empresas — restritos ao papel Management.
Onde vivem as peças transversais do NFS-e Inbound: HMAC, polling ADN, signed URLs, auth, rate limiting. Referência rápida para consultar contrato técnico e abrir ticket no time certo.
Captura automática de NF-e (modelo 55) e CT-e (modelo 57) destinadas ao CNPJ da sua empresa, via Ambiente Nacional da SEFAZ.
Captura automática de NFS-e do padrão nacional (LC 214/2025) emitidas contra o CNPJ da sua empresa: tutoriais, receitas, referência e conceitos.
Como os documentos recebidos são identificados: NSU, chaves de acesso (44/50 dígitos), chaves de evento, DPS e os modelos fiscais 55/56/57/65.
Do zero à primeira NFS-e recebida: conta, empresa, certificado e ativação. Sem empresa + certificado, o serviço não é ativado.
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.
Ative a captura automática de NFS-e do padrão nacional para o CNPJ da sua empresa e consulte o primeiro documento recebido via API.
Tutorial guiado em 6 etapas: obter credenciais, localizar company_id, ativar inbound, configurar webhook, validar recepção e migrar para produção.
Ative a captura automática de NFS-e do padrão nacional e receba o primeiro documento em menos de 5 minutos.
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.
Catálogos canônicos do NFS-e Inbound: eventos do webhook, códigos de evento (XSD vs CSV) e tabela de troubleshooting com HTTP codes, cStat SEFIN e deactivationReason.
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.
O que muda na recepção automática com a Reforma Tributária (LC 214/2025): IBS, CBS e IS nos documentos recebidos e os eventos de manifestação NT 2025.002.
Como o NFe/CTe Inbound protege seus dados fiscais: criptografia, controle de acesso, retenção legal e conformidade com a LGPD.
Como a recepção de NFS-e trata autenticação, assinatura de webhook, URLs assinadas, retenção e proteção de dados (LGPD).
Como o fluxo de substituição de NFS-e aparece na recepção: a nota substituta, o evento na original e como correlacioná-las.
Referência dos enums usados na API NFe/CTe Inbound: EnvironmentSEFAZ, OperationType, MetadataResourceType, EntityStatus.
Enumerações do domínio de recepção de NFS-e: tipo de documento, status, status de webhook, manifestação e notificações.
Sinais de problema na recepção de NF-e/CT-e e como diagnosticar: NSU travado, empresa desativada, webhooks não chegando, rate limit.
Catálogo de códigos HTTP, cStat SEFIN, deactivationReason e sintomas operacionais comuns do NFS-e Inbound — com causa e ação recomendada para cada um.
Aprenda passo a passo a integrar o NFe/CTe Inbound: primeiros passos guiados e exemplos prontos em C#, Node.js, Python e PHP.
Tutoriais guiados para aprender a integrar NFS-e Inbound do zero — recomendado para primeira leitura.
Como usar o console app.nfe.io na recepção automática: login, navegação, selecionar empresa, lista e detalhe das notas, downloads, exportação e acompanhamento.
Diferença entre as versões v1 e v2 do payload de webhook de NFS-e e como cada empresa é versionada.
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).