2026.5 - XML do Evento de Cancelamento da NFS-e Nacional
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.
Arquitetura — NFS-e Inbound
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.
Arquitetura da Captura Fiscal — NF-e, CT-e e NFS-e
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.
Associar Emissor
Como associar clientes do WHMCS a uma empresa emissora específica no módulo NFE.io, sobrepondo o emissor padrão.
Ativar a captura de NFS-e pelo painel
Passo a passo para ativar o recebimento automático de NFS-e no console app.nfe.io, sem escrever código.
Ativar a captura de NFS-e via API
Como cadastrar, consultar, atualizar e desativar a captura automática de NFS-e de uma empresa pela API REST.
Atualização
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.
Automatize a emissão de notas fiscais de serviço NFS-e com WHMCS e NFE.io
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.
Captura Fiscal
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.
Capturar uma NFS-e sob demanda pela chave de acesso
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.
Caracteres especiais nos campos de texto da NFS-e
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.
Catálogo de eventos de webhook — Documentos recebidos
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.
Catálogo de eventos de webhook — NFS-e
Todos os eventos de webhook de emissão e cancelamento de NFS-e (service_invoice), com payload real anonimizado.
Catálogo de eventos do webhook — NFS-e Inbound
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.
Cenários de erro 400 (BadRequest) na emissão de NFS-e
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.
Certificado digital na recepção de NFS-e
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.
CNAE e item da LC116 (código de serviço)
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.
Código de Serviço
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.
Códigos de evento — XSD vs CSV
Distinção entre os dois contextos de eventCode no NFS-e Inbound: XSD tpEvento (webhook) vs EventCode do CSV de bulk export analítico.
Como emitir Nota Fiscal de Serviço (NFS-e) em Caridade, CE
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Caririaçu (CE)
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Coronel Fabriciano - MG
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Itabaiana (SE)
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Santa Rita (PB)
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Sorocaba - SP
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.
Como emitir Nota Fiscal de Serviço (NFS-e) em Tucuruí (PA)
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.
Como emitir Nota Fiscal de Serviço em Amélia Rodrigues (BA)
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.
Como emitir nota fiscal de serviço em Balneário Camboriú (SC)
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.
Como emitir Nota Fiscal de Serviço em Castelo (ES)
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.
Como emitir nota fiscal de serviço em Congonhas (MG)
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.
Como emitir Nota Fiscal de Serviço em Lábrea (AM)
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).
Como emitir Nota Fiscal de Serviço em Posse (GO)
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.
Como emitir Nota Fiscal de Serviço em Santana (AP)
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.
Como exportar NFS-e em massa (XML, PDF, CSV)
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.
Como fazer — NFS-e Inbound
Receitas para resolver problemas concretos com NFS-e Inbound: integração REST, manifestação do tomador, captura sob demanda, bulk export.
Como Integrar Emissão de NFE na Mundipagg com NFe.io
Saiba como integrar a emissão de NFS-e na Mundipagg com o NFe.io
Como manifestar uma NFS-e capturada
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.
Como obter o XML do evento de cancelamento
Passo a passo para baixar o XML do evento de cancelamento (código 101101) de uma NFS-e do Ambiente Nacional via API.
Como simular erro de processamento na NFS-e
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.
Conceitos — NFS-e Inbound
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 fiscais — NFS-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).
Conexão com a NFE.io
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
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.
Configuração fiscal
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.
Conformidade normativa e disponibilidade
O que a NFE.io já suporta, por Nota Técnica, na Reforma Tributária e no padrão nacional de NFS-e.
Consultar NFS-e capturadas no painel
Como localizar, filtrar e baixar XML, PDF (DANFSe) e CSV das NFS-e capturadas no console app.nfe.io.
CSV analítico — NFS-e Inbound (24 colunas)
Esquema completo, coluna a coluna, do CSV analítico de NFS-e recebidas (resource company-nfse-inbound-analytical-csv).
Detalhamento do processamento e regras de periodicidade
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).
Emissão de NFS-e com externalId e RPS
Como usar externalId (idempotência) e RPS na emissão de NFS-e.
Emissão de NFS-e com IBS/CBS (Reforma Tributária)
Cenários do grupo IBS/CBS da Reforma Tributária na emissão de NFS-e.
Emissão de NFS-e com retenções
Cenários de retenção na emissão de NFS-e: IRRF, ISS retido, PIS/COFINS/CSLL, INSS e retenção plena.
Emissão de NFS-e em São Paulo: Valor Total Recebido e documentos de reembolso
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.
Emissão de NFS-e por regime tributário e tomador
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.
Emissão de NFS-e por tipo de atividade
Cenários por tipo de atividade na emissão de NFS-e: evento, construção, locação, comércio exterior, substituição, intermediário.
Emissão de NFS-e: ISS e local de prestação
Cenários de tributação do ISS (cálculo manual, isento, imune, suspenso) e local de prestação na emissão de NFS-e.
Emita NFS-e automaticamente no Stripe com o App da NFE.io
Emita NFS-e automaticamente a cada fatura paga no Stripe, direto pela NFE.io.
Endpoints — NFS-e Inbound
Referência curada dos endpoints REST da recepção de NFS-e: empresas, documentos, downloads, manifestação e manutenção.
Erros HTTP — NFS-e Inbound
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.
Evento de cancelamento da NFS-e Nacional
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.
Eventos do documento fiscal
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.
Exemplos de integração — NFS-e Inbound (C#, Node, Python, PHP)
Snippets prontos em C#, Node.js, Python e PHP para listar as NFS-e recebidas via API.
FAQ — NFS-e Inbound
Perguntas frequentes sobre a recepção automática de NFS-e: certificado, webhook, manifestação e exportação.
Fiscal Document Capture Architecture — NF-e, CT-e and NFS-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.
Fluxos de processamento — NF-e, CT-e e 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.
Guia de Solução de Problemas - Erros Comuns da API (RTC)
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.
Instalação
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.
Instalação
Como instalar e ativar o módulo NFE.io NFSe no WHMCS — requisitos, campos personalizados, upload dos arquivos e configuração inicial.
Integração NFe.io + Eduzz
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.
Integração NFe.io + Excel
Integre o NFe.io com Excel via Pluga para emitir NF-e ou NFS-e automaticamente a partir de linhas da sua planilha.
Integração NFe.io + Google Forms
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.
Integração NFe.io + Google Sheets
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.
Integração NFe.io + Hotmart
Integre o NFe.io com a Hotmart via Pluga para emitir NFS-e automaticamente a partir de vendas e assinaturas aprovadas.
Integração NFe.io + Iugu
Integre o NFe.io com a Iugu via Pluga para emitir NFS-e automaticamente a partir de faturas e assinaturas aprovadas.
Integração NFe.io + Kobana (Boleto Simples)
Integre o NFe.io com a Kobana (Boleto Simples) via Pluga para emitir NFS-e automaticamente a partir de boletos e assinaturas.
Integração NFe.io + Pipefy
Integre o NFe.io com o Pipefy via Pluga para emitir NFS-e automaticamente a partir de cards criados, movidos de fase ou finalizados.
Integração NFe.io + Pluga Webhooks
Integre o NFe.io com o Pluga Webhooks para emitir NF-e/NFS-e automaticamente a partir de eventos recebidos por webhook.
Integração NFe.io + Stripe
Integre o NFe.io com o Stripe via Pluga para emitir NFS-e automaticamente a partir de pagamentos e assinaturas aprovados.
Integração NFe.io + Superlógica Assinaturas
Integre o NFe.io com a Superlógica Assinaturas via Pluga para emitir NFS-e automaticamente a partir de cobranças e assinaturas.
Integração NFe.io + Typeform
Integre o NFe.io com o Typeform via Pluga para emitir NF-e/NFS-e automaticamente a partir de novas respostas do formulário.
Integração NFe.io + Vindi Recorrência
Integre o NFe.io com a Vindi via Pluga para emitir NFS-e automaticamente a partir de transações e assinaturas aprovadas.
Integração via REST — NFS-e Inbound
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.
Layout RTC - Documentação Funcional
Documentação funcional detalhada do layout RTC para emissão de NFS-e, incluindo campos, regras e exemplos.
Manutenção administrativa da captura de NFS-e
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).
Mapa de cross-repos — peças transversais
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.
Matriz de cenários de emissão de NFS-e
Índice dos 32 cenários de emissão de NFS-e, com o payload base e o guia de cada eixo.
NFS-e de ajuste de IBS/CBS (crédito e débito): situação atual
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.
NFS-e de São Paulo: resumo das mudanças dos manuais 3.3.7, 3.3.8 e 3.3.9
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.
NFS-e de São Paulo: Valor Total Recebido e mudanças dos manuais 3.3.7, 3.3.8 e 3.3.9
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.
NFS-e Inbound
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.
Notas Fiscais
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.
Notas fiscais de serviço (NFS-e)
Emita, liste, consulte, cancele e baixe NFS-e com nfe.serviceInvoices no host api.nfe.io /v1, tratando o retorno discriminado 202.
Notas fiscais de serviço (NFS-e)
Emita, liste, consulte, cancele e baixe NFS-e com $nfe->serviceInvoices no host api.nfe.io /v1, tratando o retorno discriminado 202 com instanceof.
Notas fiscais de serviço (NFS-e)
Emita, liste, consulte, cancele e baixe NFS-e com client.service_invoices no host api.nfe.io /v1, tratando o retorno discriminado 202.
NT-009 da NFS-e nacional — ajustes de IBS/CBS
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.
Onboarding do zero — NFS-e Inbound
Do zero à primeira NFS-e recebida: conta, empresa, certificado e ativação. Sem empresa + certificado, o serviço não é ativado.
Payloads dos webhooks de documentos recebidos (inbound)
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.
Payloads dos webhooks de emissão (NFS-e, NF-e, NFC-e)
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.
PIS, COFINS, CSLL, IR e INSS no payload da NFS-e
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.
Primeira integração — NFS-e Inbound
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.
Processing details and polling-frequency rules
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 flows — NF-e, CT-e and NFS-e Inbound
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.
Quickstart — primeira NFS-e em ≤5 minutos
Ative a captura automática de NFS-e do padrão nacional e receba o primeiro documento em menos de 5 minutos.
Referência — NFS-e Inbound
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.
Referência completa de campos de emissão de NFS-e
Todos os campos do corpo (POST) de emissão de NFS-e, com tipo, obrigatoriedade e descrição.
Referência: eventos por tipo de documento
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.
Reforma Tributária
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.
Retenções
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.
Segurança e LGPD — NFS-e Inbound
Como a recepção de NFS-e trata autenticação, assinatura de webhook, URLs assinadas, retenção e proteção de dados (LGPD).
Solução de erros 400 na emissão de NFS-e
Como diagnosticar e resolver os erros HTTP 400 (BadRequest) mais comuns ao emitir ou operar uma NFS-e, organizados por sintoma.
Solução de problemas
Os erros mais comuns e como resolver.
Special characters in NFS-e text fields
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.
Substituição de NFS-e
Como o fluxo de substituição de NFS-e aparece na recepção: a nota substituta, o evento na original e como correlacioná-las.
Tipos e enums — NFS-e Inbound
Enumerações do domínio de recepção de NFS-e: tipo de documento, status, status de webhook, manifestação e notificações.
Tributos federais na NFS-e: PIS, COFINS, CSLL, IR e INSS
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.
Tributos federais no XML da NFS-e: Ambiente Nacional e São Paulo
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.
Troubleshooting — NFS-e Inbound
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 — NFS-e Inbound
Tutoriais guiados para aprender a integrar NFS-e Inbound do zero — recomendado para primeira leitura.
Uso no dia a dia
Com tudo configurado, a emissão é automática. Veja como acompanhar e agir sem sair do Stripe.
Versionamento do payload de webhook — NFS-e
Diferença entre as versões v1 e v2 do payload de webhook de NFS-e e como cada empresa é versionada.
Webhook e Callbacks
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.