A NFS-e do Ambiente Nacional passa a disponibilizar o XML do evento de cancelamento (código 101101) por um endpoint dedicado, sem sobrescrever o XML de emissão. Provedores legados seguem sem alteração.
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.
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 associar clientes do WHMCS a uma empresa emissora específica no módulo NFE.io, sobrepondo o emissor padrão.
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 atualizar o módulo NFE.io NFSe no WHMCS entre versões, quais migrações de banco cada versão executa e como migrar da versão legada v1.4 para a v2.x.
Módulo oficial NFE.io para WHMCS — emissão automática de NFS-e, multiempresas, campos da Reforma Tributária (NBS, CBS/IBS, PIS/COFINS) e gestão das notas no admin.
SDK Node.js oficial da NFE.io — TypeScript nativo, Node 22+, zero dependências de runtime, ESM + CommonJS e respostas discriminadas.
SDK Python oficial da NFE.io — Python 3.10+, zero dependências de runtime, clientes síncrono e assíncrono, NFS-e, empresas, certificados, webhooks e consultas de CNPJ, CPF e CEP.
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.
Como pedir a captura imediata de uma NFS-e específica pela chave de acesso, sem esperar o lote do ambiente nacional — incluindo a restrição de sigilo fiscal, o registro de uso e a interação com a data de corte.
Como a plataforma trata acentos, emoji, aspas curvas, travessões e caracteres invisíveis nos campos de texto da NFS-e, o que cada provedor municipal aceita e como corrigir uma rejeiçã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.
Todos os eventos de webhook de emissão e cancelamento de NFS-e (service_invoice), com payload real anonimizado.
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.
Catálogo dos cenários em que a API de NFS-e retorna HTTP 400 (BadRequest) na emissão e nas operações da nota, com a regra violada e como corrigir.
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.
Use NfeClient ou AsyncNfeClient, entenda os estados da NFS-e e espere o resultado com create_and_wait, wait e cancel_and_wait, tratando InvoiceProcessingError e PollingTimeoutError.
Como o NFE.io trata o vínculo entre CNAE e o item da LC116 (código de serviço) na emissão de NFS-e.
Como definir códigos de serviço municipais personalizados por produto no WHMCS, com NBS, Indicador da Operação e Classificação Tributária por serviço.
Distinção entre os dois contextos de eventCode no NFS-e Inbound: XSD tpEvento (webhook) vs EventCode do CSV de bulk export analítico.
Saiba como cadastrar sua empresa, obter inscrição municipal e emitir NFS-e em Caridade (CE). Passo a passo no portal da prefeitura, documentação necessária e dicas para evitar erros na emissão.
Guia prático para empresas de Caririaçu (CE) realizarem o cadastro municipal e emitir Nota Fiscal de Serviço Eletrônica (NFS-e), com documentação necessária, passo a passo no portal da prefeitura e dicas úteis.
Passo a passo para empresas e prestadores de serviço se credenciarem e emitirem NFS-e em Coronel Fabriciano (MG), com documentação necessária, acesso ao portal da prefeitura e dicas práticas.
Passo a passo atualizado para cadastro, credenciamento e emissão de Nota Fiscal de Serviço (NFS-e) na Prefeitura de Itabaiana, Sergipe. Inclui documentação, acesso ao portal e dicas práticas.
Passo a passo atualizado para empresas e prestadores de serviço de Santa Rita (PB) realizarem o credenciamento e emitirem NFS-e pelo portal da prefeitura, com documentos necessários, dicas e links oficiais.
Passo a passo atualizado para credenciamento, documentação e emissão de Nota Fiscal de Serviço Eletrônica (NFS-e) em Sorocaba (SP), com links oficiais e dicas práticas.
Passo a passo atualizado para empresas e prestadores de serviço emitirem nota fiscal de serviço eletrônica em Tucuruí (PA), incluindo documentos necessários, acesso ao portal da prefeitura e dicas práticas.
Passo a passo atualizado para credenciamento, documentação e emissão de Nota Fiscal de Serviço em Amélia Rodrigues, Bahia, com dicas práticas e link para o portal da prefeitura.
Passo a passo e pré-requisitos para empresas emitirem nota fiscal de serviço (NFSe) em Balneário Camboriú (SC). Informações sobre cadastro, documentação, acesso ao portal da prefeitura e dicas práticas.
Passo a passo para empresas e prestadores de serviço de Castelo (ES) realizarem o credenciamento na Prefeitura, acessar o portal de notas e emitir a NFS-e com segurança.
Saiba quais são os pré-requisitos, documentos e o passo a passo para emitir Nota Fiscal de Serviço eletrônica em Congonhas (MG). Inclui links oficiais e dicas práticas para simplifyar o processo.
Passo a passo atualizado com pré-requisitos, documentação e acesso ao portal da Prefeitura de Lábrea para emissão de Nota Fiscal de Serviço (NFSe).
Aqui você entenderá melhor como emitir nota fiscal eletrônica de serviço (NFS-e) em Lote na nossa plataforma, explicado passo-a-passo.
Passo a passo atualizado para empresas e prestadores de serviço emitirem Nota Fiscal de Serviço no município de Posse (GO), com documentos necessários, instruções para acesso ao portal da prefeitura e dicas práticas.
Passo a passo atualizado para cadastro, credenciamento e emissão de Nota Fiscal de Serviço no município de Santana, Amapá. Inclui documentação, acesso ao portal da prefeitura e dicas práticas.
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 para resolver problemas concretos com NFS-e Inbound: integração REST, manifestação do tomador, captura sob demanda, bulk export.
Saiba como integrar a emissão de NFS-e na Mundipagg com o NFe.io
Plugin oficial NFE.io para WooCommerce — emissão automática de NFS-e a partir dos pedidos da loja, webhook assinado, campos da Reforma Tributária (RTC) e compatibilidade com o HPOS.
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.
Passo a passo para baixar o XML do evento de cancelamento (código 101101) de uma NFS-e do Ambiente Nacional via API.
Como forçar um erro de processamento ao emitir NFS-e no ambiente Development, para testar retries e tratamento de erro na sua integração.
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.
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).
Depois de instalar o app, conecte a sua conta NFE.io. A conexão é feita com a Chave de Nota Fiscal da NFE.io.
Configuração do módulo NFE.io NFSe no WHMCS — cadastro de emissores, campos da Reforma Tributária, configurações globais de emissão e link da nota na fatura.
Com a conexão ativa, defina como as notas serão emitidas. A maior parte dos dados vem automaticamente da fatura do Stripe; aqui você configura o que o Stripe não conhece - principalmente o código de serviço municipal.
O que a NFE.io já suporta, por Nota Técnica, na Reforma Tributária e no padrão nacional de NFS-e.
Como localizar, filtrar e baixar XML, PDF (DANFSe) e CSV das NFS-e capturadas no console app.nfe.io.
Esquema completo, coluna a coluna, do CSV analítico de NFS-e recebidas (resource company-nfse-inbound-analytical-csv).
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).
Baixe DANFE/PDF e XML de uma nota identificada, em bytes (Buffer) ou por link, conforme o recurso.
Baixe o PDF, o XML e o XML de cancelamento da NFS-e como bytes. O SDK segue o redirecionamento para a URL temporária sem reenviar a chave de API.
Retorno discriminado (202 vs 201), estados de FlowStatus, createAndWait/cancelAndWait e emissão webhook-driven.
Como usar externalId (idempotência) e RPS na emissão de NFS-e.
Cenários do grupo IBS/CBS da Reforma Tributária na emissão de NFS-e.
Cenários de retenção na emissão de NFS-e: IRRF, ISS retido, PIS/COFINS/CSLL, INSS e retenção plena.
Cenários de emissão de NFS-e em São Paulo com IBS/CBS após os manuais 3.3.7 a 3.3.9: total com documentos de reembolso, paidAmount, multa e juros, Valor Inicial Cobrado e recusas E1003/E1004.
Emita NFS-e no layout da Reforma Tributária do Consumo (IBS e CBS) com service_invoices.create e o grupo ibsCbs — o que foi provado ao vivo, o payload mínimo, retenções e o que depende da parametrização da empresa.
Cenários de emissão de NFS-e por regime tributário do prestador (MEI, Simples, Lucro Presumido, Lucro Real) e por tipo de tomador.
Cenários por tipo de atividade na emissão de NFS-e: evento, construção, locação, comércio exterior, substituição, intermediário.
Cenários de tributação do ISS (cálculo manual, isento, imune, suspenso) e local de prestação na emissão de NFS-e.
Recursos de emissão no leiaute RTC — serviceInvoicesRtc (NFS-e) e productInvoicesRtc (NF-e/NFC-e).
Emita NFS-e e NF-e/NFC-e no leiaute RTC (IBS/CBS/IS). O RTC é selecionado pelo payload, no mesmo endpoint da emissão atual.
Emita NFS-e automaticamente a cada fatura paga no Stripe, direto pela NFE.io.
Referência curada dos endpoints REST da recepção de NFS-e: empresas, documentos, downloads, manifestação e manutenção.
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.
O que é o evento de cancelamento (101101) no Ambiente Nacional da NFS-e e por que ele gera um documento fiscal próprio em XML.
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.
Snippets prontos em C#, Node.js, Python e PHP para listar as NFS-e recebidas via API.
Perguntas frequentes sobre a recepção automática de NFS-e: certificado, webhook, manifestação e exportação.
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.
Um guia para ajudar a diagnosticar e resolver erros comuns ao integrar com a API de emissão de NFS-e usando o layout RTC.
CRUD de inscrições municipais (pré-requisito da NFS-e) com nfe.municipalTaxes, incluindo a semântica de substituição do update (PUT).
Este guia mostra como instalar o App NFE.io Notas Fiscais na sua conta do Stripe e autorizar os acessos necessários. Leva poucos minutos.
Como instalar e ativar o módulo NFE.io NFSe no WHMCS — requisitos, campos personalizados, upload dos arquivos e configuração inicial.
Saiba como integrar NFe.io com Eduzz via Pluga para automatizar a emissão de notas fiscais de serviço (NFS-e) a partir das vendas aprovadas.
Integre o NFe.io com Excel via Pluga para emitir NF-e ou NFS-e automaticamente a partir de linhas da sua planilha.
Integre o NFe.io com o Google Forms via Pluga para emitir NF-e ou NFS-e automaticamente a partir de respostas do formulário.
Integre o NFe.io com o Google Sheets via Pluga para emitir NF-e ou NFS-e automaticamente a partir de linhas da sua planilha.
Integre o NFe.io com a Hotmart via Pluga para emitir NFS-e automaticamente a partir de vendas e assinaturas aprovadas.
Integre o NFe.io com a Iugu via Pluga para emitir NFS-e automaticamente a partir de faturas e assinaturas aprovadas.
Integre o NFe.io com a Kobana (Boleto Simples) via Pluga para emitir NFS-e automaticamente a partir de boletos e assinaturas.
Integre o NFe.io com o Pipefy via Pluga para emitir NFS-e automaticamente a partir de cards criados, movidos de fase ou finalizados.
Integre o NFe.io com o Pluga Webhooks para emitir NF-e/NFS-e automaticamente a partir de eventos recebidos por webhook.
Integre o NFe.io com o Stripe via Pluga para emitir NFS-e automaticamente a partir de pagamentos e assinaturas aprovados.
Integre o NFe.io com a Superlógica Assinaturas via Pluga para emitir NFS-e automaticamente a partir de cobranças e assinaturas.
Integre o NFe.io com o Typeform via Pluga para emitir NF-e/NFS-e automaticamente a partir de novas respostas do formulário.
Integre o NFe.io com a Vindi via Pluga para emitir NFS-e automaticamente a partir de transações e assinaturas aprovadas.
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.
Documentação funcional detalhada do layout RTC para emissão de NFS-e, incluindo campos, regras e exemplos.
Endpoints operacionais sob .../inbound/nfse/maintenance: forçar captura (fetch-now, acessível pela própria empresa), consultar notificações/estatísticas e reativar empresas (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.
Índice dos 32 cenários de emissão de NFS-e, com o payload base e o guia de cada eixo.
Catálogo de onde cada mensagem de erro da API de NFS-e aparece, com o texto literal em inglês, a tradução de referência em português, a causa e a ação.
Situação da NFS-e de ajuste de IBS e CBS prevista na NT 009: ainda não liberada pelo Ambiente Nacional, o que a NFE.io vai disponibilizar e o que fazer enquanto isso.
Resumo do que mudou na NFS-e de São Paulo com os manuais 3.3.7, 3.3.8 e 3.3.9, do formato recomendado e do que a NFE.io faz com o paidAmount.
Como a NFE.io atende as mudanças da NFS-e Paulistana publicadas nos manuais 3.3.7, 3.3.8 e 3.3.9, com o tratamento do paidAmount, documentos de reembolso, Valor Inicial Cobrado, tributos federais e caracteres permitidos.
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.
Gestão das NFS-e emitidas pelo módulo NFE.io no WHMCS — listagem, status, ações de reemissão, cancelamento, envio por e-mail e emissão manual a partir da fatura.
Emita, liste, consulte, cancele e baixe NFS-e com nfe.serviceInvoices no host api.nfe.io /v1, tratando o retorno discriminado 202.
Emita, liste, consulte, cancele e baixe NFS-e com $nfe->serviceInvoices no host api.nfe.io /v1, tratando o retorno discriminado 202 com instanceof.
Emita, liste, consulte, cancele e baixe NFS-e com client.service_invoices no host api.nfe.io /v1, tratando o retorno discriminado 202.
Emita, consulte, liste, cancele, reenvie por e-mail e baixe NFS-e com client.service_invoices (API v1 em api.nfe.io), com espera até o estado final e busca por external_id.
O que a NT-009 muda na NFS-e nacional e o que a NFE.io está implementando para a nota de ajuste de IBS/CBS e o novo leiaute.
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.
Referência do corpo entregue em cada evento de emissão: envelope por tipo de documento, campos, exemplos reais anonimizados e como discriminar sucesso de falha.
Referência dos campos de tributos federais na API de NFS-e da NFE.io: o que cada campo significa, formato de alíquota e valor, CST do PIS/COFINS e exemplos de requisição.
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.
Instale o pacote nfe-io, crie um NfeClient, emita sua primeira NFS-e e acompanhe o processamento com createAndWait/polling.
Instale o pacote nfe-io, crie um NfeClient, emita sua primeira NFS-e com create_and_wait e baixe o PDF.
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 a captura automática de NFS-e do padrão nacional e receba o primeiro documento em menos de 5 minutos.
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.
Todos os campos do corpo (POST) de emissão de NFS-e, com tipo, obrigatoriedade e descrição.
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.
Campos da Reforma Tributária (NBS, Classificação Tributária IBS/CBS, Indicador da Operação, PIS/COFINS e taxationType) no módulo NFE.io para WHMCS e a ordem de precedência aplicada na emissão.
Alíquotas de retenção de ISS, PIS, COFINS e tipo de tributação do ISSQN por código de serviço no módulo NFE.io para WHMCS.
Como a recepção de NFS-e trata autenticação, assinatura de webhook, URLs assinadas, retenção e proteção de dados (LGPD).
Como diagnosticar e resolver os erros HTTP 400 (BadRequest) mais comuns ao emitir ou operar uma NFS-e, organizados por sintoma.
Os erros mais comuns e como resolver.
How the platform handles accents, emoji, curly quotes, dashes and invisible characters in NFS-e text fields, what each municipal provider accepts, and how to fix a rejection.
Como o fluxo de substituição de NFS-e aparece na recepção: a nota substituta, o evento na original e como correlacioná-las.
Enumerações do domínio de recepção de NFS-e: tipo de documento, status, status de webhook, manifestação e notificações.
A hierarquia de exceções do SDK Python, os atributos de cada erro, outcome_unknown e a receita de reconciliação por external_id que evita nota duplicada.
Como a NFE.io trata PIS, COFINS, CSLL, IR e INSS na emissão de NFS-e: tributo próprio × retido, cálculo automático e as mudanças da NT 007.
Como a NFE.io traduz PIS, COFINS, CSLL, IR e INSS para o XML do Ambiente Nacional e da Prefeitura de São Paulo: tpRetPisCofins, vRetCSLL, ValorCSLL e CST, conforme a NT 007.
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.
Tutoriais guiados para aprender a integrar NFS-e Inbound do zero — recomendado para primeira leitura.
Com tudo configurado, a emissão é automática. Veja como acompanhar e agir sem sair do Stripe.
Verifique a assinatura X-Hub-Signature (HMAC-SHA1) das entregas de webhook da NFE.io com nfeio.webhooks, sobre o corpo bruto, com exemplos em Flask, FastAPI e Django e deduplicação por X-Hook-Id.
Diferença entre as versões v1 e v2 do payload de webhook de NFS-e e como cada empresa é versionada.
Como o módulo NFE.io para WHMCS recebe atualizações de status das NFS-e via webhook, como verificar a configuração e como diagnosticar callbacks não entregues.