Pular para o conteúdo principal

NFS-e: leiaute nacional da NT 009

Atualização de 16/11/2026
  • Datas do IBS/CBS na NFS-e: o Ato Conjunto RFB/CGIBS nº 7, de 11/11/2026, alterou as datas de obrigatoriedade do Ato Conjunto nº 4, inclusive para os optantes do Simples Nacional. Veja "Simples Nacional: prazo da obrigatoriedade".
  • Sefin Nacional: as notas de produção emitidas pela Sefin Nacional passam ao leiaute da NT 009 em 01/12/2026, às 00:00 de Brasília. Isso inclui, por padrão, o optante do Simples Nacional em cidade conveniada ao Ambiente Nacional. Veja "Emissão pelo Ambiente Nacional".

Para quem é este comunicado: clientes que emitem NFS-e via integração, especialmente prestadores optantes pelo Simples Nacional e quem emite nota de ajuste de IBS/CBS, locação, condomínio, pagamento vinculado ou serviço com comércio exterior.

O que muda no seu lado: se você emite pela Sefin Nacional, revise a integração antes de 01/12/2026. Nessa data, o XML muda e as validações do leiaute novo passam a valer, inclusive para campos que você já envia, como os documentos de dedução. Nos provedores municipais, a produção só muda quando a NFE.io ativar o leiaute na prefeitura que você usa.

Visão geral​

A NT SE/CGNFS-e 009 v1.01, o Anexo VI v1.04.01 e o Anexo VII v1.03.00 reestruturam a DPS do padrão nacional da NFS-e. A API de NFS-e da NFE.io já aceita todos os campos desse leiaute. Nas notas de produção emitidas pela Sefin Nacional, o leiaute passa a valer em 01/12/2026. Nos provedores municipais, ele só passa a valer na produção da prefeitura que a NFE.io ativar para o leiaute NT 009.

O que isso significa para a sua integração:

  • Nenhum campo foi removido ou renomeado na API. Todos os campos novos são opcionais e nuláveis. Nos provedores municipais fora do leiaute NT 009, uma requisição que você envia hoje continua válida. No leiaute NT 009, as validações novas também alcançam campos que já existiam (veja "Validações que recusam a nota antes do envio").
  • Nos provedores municipais, a produção muda só com a ativação por prefeitura, pela NFE.io. Enquanto a prefeitura não estiver no leiaute NT 009, o XML gerado continua o de hoje e os campos novos são ignorados.
  • Cinco campos são exclusivos do leiaute NT 009. Se você enviar um deles para uma prefeitura que ainda não está no leiaute, a nota é recusada antes do envio, com mensagem, e o webhook é disparado. A lista está na seção "Validações que recusam a nota antes do envio".
  • A emissão pelo Ambiente Nacional segue configuração própria. MEI e as notas roteadas para a Sefin Nacional não seguem a opção da cidade. Desde 01/11/2026, o optante do Simples Nacional em cidade conveniada ao Ambiente Nacional também emite, por padrão, pela Sefin Nacional. Essas notas passam ao leiaute NT 009 em 01/12/2026, às 00:00 de Brasília.
  • A SE/CGNFS-e informou que as evoluções da NT 009 devem entrar em produção em 01/12/2026. O cronograma formal ainda não foi publicado, e o Ambiente Nacional pode não aceitar todos os grupos nessa data (veja "Emissão pelo Ambiente Nacional").
  • Na homologação, o leiaute NT 009 já é o padrão para a Sefin Nacional e para os provedores do padrão nacional.

O que recomendamos fazer agora: revisar os campos das seções seguintes, identificar quais se aplicam ao seu negócio e testar em homologação.

O leiaute é preliminar

O schema usado no desenvolvimento (XSD v1.02) não é a versão oficial nem a mais recente, e o cronograma formal de produção da NT 009 ainda não foi publicado. Campos, cardinalidades e regras desta página podem mudar quando a versão oficial for publicada. Vamos atualizar a documentação e comunicar as diferenças quando isso acontecer. A lista dos pontos em que há maior chance de ajuste está em "Ressalvas importantes".

O que mudou​

O que muda, por tema​

TemaO que a NT 009 trazCampos da API envolvidos
Simples NacionalPassam a ser informados o regime de apuração do IBS/CBS do optante e o código da atividade. Surge o optante pendente (opSimpNac = 4).ibsCbs.simplesNacionalApuration, ibsCbs.simplesNacionalActivityCode
NFS-e de ajusteA NFS-e passa a ter finalidade de ajuste de crédito ou de débito, com tipo e valores de IBS/CBS a ajustar.ibsCbs.adjustmentPurpose, ibsCbs.debitAdjustmentType, ibsCbs.creditAdjustmentType, ibsCbs.adjustment
Deduções e reembolsosDeduções do ISSQN e reembolsos de terceiros passam a sair como ajuste da base de cálculo, com código próprio por documento.deduction.documents[].baseCalculationAdjustmentType, ibsCbs.thirdPartyReimbursements.documents[].baseCalculationAdjustmentType
Bens imóveisO grupo de imóvel ganha município, dados de locação e lista de unidades imobiliárias, cada uma com endereço e parcelas fora da base de cálculo.realEstate.municipalityCode, realEstate.leasing, realEstate.propertyUnits[]
Bens móveisLocação de bens móveis passa a listar os bens por NCM.ibsCbs.movableAssets[]
CondomíniosOperações condominiais passam a detalhar cobranças, detalhamentos e descontos.ibsCbs.condominium
Pagamentos vinculadosA NFS-e passa a poder referenciar as transações de pagamento que a liquidam.ibsCbs.paymentLinks[]
Comércio exteriorEntram fatura, contrato de câmbio, consumo concomitante e o ajuste da base de cálculo na exportação.foreignTrade.invoiceNumber, foreignTrade.invoiceAmount, foreignTrade.exchangeContractNumber, foreignTrade.concurrentConsumption, ibsCbs.foreignTradeBaseCalculationAdjustment

As seções seguintes detalham cada campo, o que foi alterado e o que foi descontinuado.

Simples Nacional: prazo da obrigatoriedade​

O Ato Conjunto RFB/CGIBS nº 4/2026 (art. 1º, § 1º), com a redação dada pelo Ato Conjunto RFB/CGIBS nº 7, de 11/11/2026, fixa duas datas para o início da obrigatoriedade de emissão dos documentos com IBS/CBS pelos contribuintes optantes pelo Simples Nacional:

  • 01/01/2027: serviços sujeitos ao ISS não listados abaixo, bens imateriais, condomínios, locações e demais serviços (alíneas "d" a "h" do inciso III do art. 1º; § 1º, I).
  • 01/03/2027: serviços de plataformas digitais e serviços intermediados por elas, e serviços dos subitens 1.03, 1.05, 1.09 e 16.01 da lista anexa à LC 116/2003 (alíneas "a" a "c" do inciso III; § 1º, II).

Até 31/12/2026, a omissão do IBS/CBS na NFS-e não acarreta a rejeição do documento pelo sistema nacional, segundo a orientação publicada pela SE/CGNFS-e em 07/08/2026. Segundo a mesma orientação, a falta evidencia a desconformidade do documento fiscal conforme a categoria e a respectiva data de vigência do Ato Conjunto. Para o optante do Simples Nacional, essas datas são as listadas acima.

Novos campos da API​

Todos os campos abaixo são opcionais e nuláveis. Nenhum campo existente foi removido ou renomeado na API.

Campo (JSON)TipoTag XMLObservação
ibsCbs.adjustmentPurposestringfinNFSeCredit (1) ou Debit (2); ausente = nota regular (0). Exclusivo do leiaute NT 009.
ibsCbs.debitAdjustmentTypestringtpNFSeDebitoCooperativeCreditTransfer (01), CreditAnnulmentExemptOutflows (02), UnprocessedInvoiceDebits (03), FinesAndInterest (04), SuccessionCreditTransfer (05), AdvancePayment (06). Obrigatório com adjustmentPurpose = Debit.
ibsCbs.creditAdjustmentTypestringtpNFSeCreditoFinesAndInterest (01), SuccessionCreditTransfer (05). Obrigatório com adjustmentPurpose = Credit.
ibsCbs.adjustmentobjeto { ibsAmount, cbsAmount }gIBSCBS/gIBSCBSAjusteValores a ajustar. Obrigatório nos ajustes sem tributo (débito 01, 02, 03 e 05; crédito 05).
ibsCbs.simplesNacionalApurationstringprest/regTrib/regApIBSCBSSNIbsAndCbsBySimplesNacional (1), CbsBySimplesNacionalIbsRegular (2), IbsAndCbsRegular (3). Só para optante ou optante pendente do Simples.
ibsCbs.simplesNacionalActivityCodestringserv/cServ/cAtvSN"07" a "14" ou "90".
ibsCbs.movableAssets[]array (até 1000)IBSCBS/bensMoveisncmCode (8 dígitos), ncmDescription (até 150), quantity (1 a 999). cTribNac 99.04.01.
ibsCbs.condominiumobjetoIBSCBS/condominiosoriginalDueDate, charges[] (1 a 20), discounts[] (até 10). cTribNac 99.05.01.
ibsCbs.paymentLinks[]array (até 99)IBSCBS/gPgtoVinc/pgtonumber, transactionId, paymentMethod, receiverFederalTaxNumber, paymentInstitutionBaseTaxNumber.
ibsCbs.advancePaymentInvoiceKeys[]array de string (até 99)gIBSCBS/gPagAntecipado/refNFSeChaves de 50 posições das NFS-e de pagamento antecipado (ajuste de débito 06) abatidas nesta nota. Só na NFS-e regular. Exclusivo do leiaute NT 009.
ibsCbs.foreignTradeBaseCalculationAdjustmentnúmerovalores/vAjusteBC/vAjusteBCIBSCBSComExtCom o prestador emitente, só em exportação.
realEstate.municipalityCodestring (IBGE, 7)imovel/cMunSe ausente, usa siteAddress.city.code, depois o município da unidade ou o local da prestação.
realEstate.leasingobjetoimovel/gLocacaocoOwnershipPercentage (0 a 100, padrão 100), totalOperationAmount, unconditionalDiscountTotal, conditionalDiscountTotal, originalDueDate. cTribNac 99.03.
realEstate.propertyUnits[]array (até 99)imovel/gUnidImobpropertyFiscalRegistration, cibCode, address, baseCalculationAdjustments[].
foreignTrade.invoiceNumberstring (até 20)comExt/nFatura
foreignTrade.invoiceAmountnúmerocomExt/vFatura
foreignTrade.exchangeContractNumberstring (até 20)comExt/nContCambio
foreignTrade.concurrentConsumptionbooleanocomExt/mdPrestacao = 5true vence o serviceMode. Exclusivo do leiaute NT 009.
deduction.documents[].baseCalculationAdjustmentTypeinteirodocAjusteBC/tpAjusteBC2, 5, 6, 7, 8, 9 ou 99; vence o código derivado do deductionType. Use 9 para profissional parceiro. Exclusivo do leiaute NT 009.
ibsCbs.thirdPartyReimbursements.documents[].baseCalculationAdjustmentTypeinteirodocAjusteBC/tpAjusteBC101 a 105 ou 199; vence o código derivado do reimbursementType. Use 105 para glosa de serviços de saúde. Exclusivo do leiaute NT 009.

Exemplos de payload​

Os valores abaixo são fictícios e servem só para ilustrar o formato.

Simples Nacional: regime de apuração do IBS/CBS e código da atividade:

{
"ibsCbs": {
"simplesNacionalApuration": "IbsAndCbsBySimplesNacional",
"simplesNacionalActivityCode": "07"
}
}

NFS-e de ajuste de débito, sem tributo: exige o tipo e os valores a ajustar:

{
"ibsCbs": {
"adjustmentPurpose": "Debit",
"debitAdjustmentType": "CooperativeCreditTransfer",
"adjustment": { "ibsAmount": 120.50, "cbsAmount": 45.30 }
}
}

Imóvel com unidades imobiliárias: o formato novo, uma entrada por unidade:

{
"realEstate": {
"municipalityCode": "3550308",
"leasing": {
"coOwnershipPercentage": 100,
"totalOperationAmount": 5000.00,
"originalDueDate": "2026-11-10"
},
"propertyUnits": [
{
"propertyFiscalRegistration": "1234567890",
"cibCode": "12345678",
"address": {
"postalCode": "01310100",
"street": "Avenida Paulista",
"number": "1000",
"district": "Bela Vista"
},
"baseCalculationAdjustments": [
{ "type": 3, "amount": 350.00 }
]
}
]
}
}

Bens móveis e pagamentos vinculados:

{
"ibsCbs": {
"movableAssets": [
{ "ncmCode": "84295211", "ncmDescription": "Escavadeira hidráulica sobre esteiras", "quantity": 2 }
],
"paymentLinks": [
{
"transactionId": "E00000000202610151200abcdef01",
"paymentMethod": 17,
"receiverFederalTaxNumber": "11222333000181",
"paymentInstitutionBaseTaxNumber": "11222333000181"
}
]
}
}

Condomínio: cobranças, detalhamento e descontos:

{
"ibsCbs": {
"condominium": {
"originalDueDate": "2026-11-10",
"charges": [
{
"type": 1,
"typeDescription": "Taxa condominial ordinária",
"amount": 850.00,
"details": [
{ "type": 999, "typeDescription": "Limpeza e conservação", "amount": 300.00 }
]
}
],
"discounts": [
{ "type": 2, "amount": 50.00, "description": "Pagamento até o vencimento" }
]
}
}
}

Comércio exterior: fatura, câmbio, consumo concomitante e ajuste da base:

{
"foreignTrade": {
"invoiceNumber": "FAT-2026-0098",
"invoiceAmount": 12500.00,
"exchangeContractNumber": "CC-884512",
"concurrentConsumption": true
},
"ibsCbs": {
"foreignTradeBaseCalculationAdjustment": 1200.00
}
}

Documento de dedução: baseCalculationAdjustmentType vence o código derivado do deductionType:

{
"deduction": {
"documents": [
{
"nfseKey": "00000000000000000000000000000000000000000000000001",
"deductionType": "Subcontracting",
"baseCalculationAdjustmentType": 9,
"issueDate": "2026-10-01",
"deductibleTotal": 2000.00,
"usedAmount": 1500.00
}
]
}
}

Campos alterados, descontinuados e removidos​

Na API, nada foi removido nem renomeado. As mudanças abaixo acontecem no XML gerado (DPS) quando a prefeitura está no leiaute NT 009. Os campos da API continuam sendo aceitos como hoje.

Campo da APIO que acontece no leiaute NT 009
foreignTrade.serviceAmountInCurrencyContinua aceito na API, mas não é mais enviado no XML: vServMoeda foi removido do XSD v1.02.
foreignTrade.importDeclaration (nDI)Passa a ser enviado como nDUIMP, com 15 caracteres alfanuméricos, sem truncar o valor.
foreignTrade.exportRegistration (nRE)Passa a ser enviado como nDUE, com 14 caracteres alfanuméricos.
foreignTrade.serviceModeContinua valendo, mas concurrentConsumption = true vence o valor informado e envia mdPrestacao = 5.
deduction.documents[].deductionType = "FoodAndBeverages" (tipo 1)Descontinuado pela NT 009. A nota é recusada antes do envio, com mensagem.
deduction.documents[].municipalNfse e fiscalDocumentNumberNão identificam o documento no leiaute NT 009. Use nfseKey, nfeKey ou nonFiscalDocumentNumber.
realEstate.propertyFiscalRegistration, cibCode, siteAddressContinuam aceitos: viram uma única unidade imobiliária (gUnidImob). Informe este formato ou propertyUnits, não os dois.
purposeContinua com o único valor regular. As NFS-e de ajuste são informadas em adjustmentPurpose, não aqui.

Nenhum enum existente ganhou valor novo. ibsCbs.purpose, foreignTrade.serviceMode, deduction.documents[].deductionType e thirdPartyReimbursements.documents[].reimbursementType seguem com os mesmos valores de hoje. O que é exclusivo da NT 009 entrou em campos novos, justamente para não mudar o comportamento de quem não usa o leiaute.

Outras mudanças no XML gerado:

  • finNFSe, indDest e dest saem do grupo IBSCBS e passam para a raiz de infDPS.
  • CST e cClassTrib passam a ser informados no grupo trib.
  • vAjusteBC substitui vDedRed e gReeRepRes.
  • cServ é reordenado, com xDescServ por último.
  • atvEvento/cMun passa a ser enviado nos subitens 12.13 e 17.10, quando o município do evento difere do local da prestação.
  • Nos CST 400, 410 e 820, gIBSCBS e cIndOp são omitidos.
  • Nos ajustes sem tributo, a DPS também não leva regEspTrib, valores/trib, cIndOp, tpOper, gRefNFSe, tpEnteGov nem IBSCBS/imovel.

Validações que recusam a nota antes do envio​

A validação roda no início do processamento da nota, para qualquer provedor. Quando ela recusa, a nota termina como falha de emissão, com o motivo na mensagem, e o webhook é disparado, sem nenhuma chamada à prefeitura.

Prefeitura fora do leiaute NT 009. A nota é recusada quando informa um destes cinco campos:

  • ibsCbs.adjustmentPurpose
  • foreignTrade.concurrentConsumption = true
  • deduction.documents[].baseCalculationAdjustmentType
  • ibsCbs.thirdPartyReimbursements.documents[].baseCalculationAdjustmentType
  • ibsCbs.advancePaymentInvoiceKeys

Os demais campos novos são simplesmente ignorados nessa prefeitura.

Prefeitura no leiaute NT 009 (inclui a Sefin Nacional a partir de 01/12/2026). As regras abaixo também valem para campos que já existiam, como os documentos de dedução. A tabela traz as recusas principais e não é exaustiva: a mensagem de recusa sempre indica o campo e o motivo.

GrupoMotivo da recusa
Nota de ajusteadjustmentPurpose sem o tipo correspondente (debitAdjustmentType ou creditAdjustmentType); ajuste sem tributo (débito 01, 02, 03 e 05; crédito 05) sem adjustment.ibsAmount e adjustment.cbsAmount.
Documento de deduçãoSem tipo, issueDate, deductibleTotal ou usedAmount; tipo 1 (descontinuado) ou fora de 2, 5, 6, 7, 8, 9 e 99; tipo 99 sem otherDeductionDescription; identificado só por NFS-e municipal ou documento fiscal avulso.
Documento de reembolsoTipo fora de 101 a 105 e 199; sem amount, issueDate ou documento; tipos 101, 103, 104 e 199 sem documento fiscal (otherNationalDfe ou otherFiscalDoc); otherFiscalDoc sem accrualOn ou com accrualOn a partir de 2026.
ImóvelUnidade sem cibCode nem CEP; leasing sem totalOperationAmount; município do imóvel não resolvido.
Bens móveisNCM sem 8 dígitos, sem descrição ou quantidade fora de 1 a 999.
CondomínioSem originalDueDate ou sem cobrança; cobrança ou detalhe sem tipo; tipo 99 ou 999 sem descrição; desconto com tipo fora de 1 e 2 ou sem descrição.
Pagamentos vinculadostransactionId fora de 2 a 35 caracteres ou com espaço; paymentMethod fora de 15, 17, 18, 20, 23 e 24; CNPJ do recebedor ou do PSP ausente ou inválido.
Atenção ao CNPJ do PSP

O campo paymentInstitutionBaseTaxNumber exige o CNPJ completo, com 14 posições, e não a raiz de 8. Essa regra mudou com a versão do XSD de 06/10/2026.

Como o campo é tratado, conforme a prefeitura. Os cinco campos exclusivos são ibsCbs.adjustmentPurpose, foreignTrade.concurrentConsumption = true, os dois baseCalculationAdjustmentType (dedução e reembolso) e ibsCbs.advancePaymentInvoiceKeys. Qualquer outro campo novo enviado a uma prefeitura fora do leiaute é apenas ignorado: a nota é emitida normalmente.

Ativação e testes em homologação​

Nos provedores municipais, a troca de leiaute na produção é feita pela NFE.io, no cadastro da prefeitura. Não há nada a enviar na requisição para escolher o leiaute. Na produção, o padrão é o leiaute atual.

Na homologação (as notas fora do ambiente de produção), o leiaute NT 009 já é o padrão para a Sefin Nacional e para os provedores do padrão nacional. Uma prefeitura pode ser mantida no leiaute atual na homologação, por configuração da NFE.io. Uma nota de produção nunca usa a configuração de homologação.

Como se preparar:

  1. Identifique, na seção "O que muda, por tema", quais cenários se aplicam ao seu negócio.
  2. Emita em homologação com os campos novos e confira o XML gerado e o payload do webhook. Se a prefeitura que você usa não estiver no leiaute NT 009 na homologação, fale com o suporte da NFE.io.
  3. Se você emite pela Sefin Nacional, teste também as requisições que já envia hoje, em especial as com deduções e reembolsos, e conclua os testes antes de 01/12/2026.
  4. Nos provedores municipais, mantenha a produção como está até a ativação do leiaute na prefeitura.

Emissão pelo Ambiente Nacional. A nota emitida pelo Ambiente Nacional (MEI, regionalTaxNumber 530000 ou 999999 na inscrição municipal e rota do Emissor Nacional) não segue a configuração da cidade. Ela segue uma configuração própria do Ambiente Nacional. Desde 01/11/2026, o optante do Simples Nacional em cidade conveniada ao Ambiente Nacional emite, por padrão, pela rota do Emissor Nacional. Colocar um provedor municipal no leiaute NT 009 não muda a emissão pela Sefin Nacional. Quando a nota é recusada, a mensagem indica qual dos dois destinos está no leiaute antigo.

A partir de 01/12/2026, às 00:00 de Brasília, as notas de produção emitidas pela Sefin Nacional saem no leiaute NT 009. Isso vale para as notas do parágrafo anterior e para as cidades cadastradas para emitir pela Sefin Nacional. É a data informada pela SE/CGNFS-e para a entrada das evoluções da NT 009 em produção. A partir dela, a estrutura da DPS dessas notas muda, os campos novos enviados vão para o XML e as validações da seção "Prefeitura no leiaute NT 009" passam a valer. Se a SE/CGNFS-e mudar a data, a NFE.io acompanha a nova data.

O Ambiente Nacional pode não aceitar todos os grupos em 01/12/2026

Em 26/10/2026, a produção restrita do Ambiente Nacional ainda recusava parte dos grupos da NT 009, como as notas de ajuste, os pagamentos vinculados, o comércio exterior, os condomínios e os campos novos do Simples Nacional. Teste em homologação antes de enviar esses grupos em produção. A recusa vem do governo, com o código e o motivo no retorno da nota.

O que não muda​

  • Sua integração atual, nos provedores municipais fora do leiaute NT 009. Uma requisição que não usa os campos novos continua válida e gera o mesmo XML de hoje. No leiaute NT 009, a estrutura da DPS muda mesmo sem campos novos (veja "Campos alterados, descontinuados e removidos").
  • Os endereços e a autenticação da API. Nenhuma rota nova, nenhuma versão nova.
  • Os valores dos enums existentes. Nada foi acrescentado a ibsCbs.purpose, foreignTrade.serviceMode, deductionType ou reimbursementType.
  • O payload do webhook, para quem não usa os campos novos. Eles só aparecem no payload quando você os enviou na requisição: são opcionais, nunca preenchidos pela plataforma, e campos nulos não são serializados. Uma nota sem dados da NT 009 gera exatamente o mesmo payload de antes.

Ressalvas importantes​

O leiaute é preliminar e pode sofrer pequenas alterações. A NT SE/CGNFS-e 009 v1.01 e o Anexo VI v1.04.01 já foram publicados, mas o schema (XSD v1.02) usado no desenvolvimento não é a versão oficial e não é a última versão disponível. Campos, cardinalidades e regras desta documentação podem mudar quando a versão oficial for publicada. Vamos atualizar a documentação e comunicar as diferenças quando isso acontecer.

Alguns pontos já conhecidos em que a NT e o Anexo divergem do XSD preliminar, e onde, portanto, há maior chance de ajuste:

  • Obrigatoriedade de docAjusteBC/dtEmiDoc e de gUnidImob/end/xBairro.
  • Cardinalidade dos campos de condomínio (xTpCobranca, vCobranca, xTpDetCobranca, vDetCobranca, vDesconto).
  • Sinal de vAjusteBCIBSCBSComExt (a NT admite valor negativo; o XSD preliminar, não).
  • Tipo de nFatura e nContCambio (numérico na NT, texto no XSD).
  • Precisão de pCopropriedade.

Sujeito a alterações legais pelo Governo. O cronograma formal de entrada da NT 009 em produção ainda não foi publicado.

Próximos passos​

  1. 📩 Compartilhe este comunicado com quem mantém a sua integração de NFS-e.
  2. 🔎 Identifique quais temas se aplicam ao seu negócio e revise os campos correspondentes.
  3. 🧪 Teste em homologação, onde o leiaute NT 009 já é o padrão para a Sefin Nacional e para os provedores do padrão nacional.
  4. 🏭 Se você emite pela Sefin Nacional, teste também as requisições que já envia hoje e conclua os testes antes de 01/12/2026. Nos provedores municipais, mantenha a produção como está até a ativação do leiaute na prefeitura.
  5. 💬 Dúvidas sobre este comunicado ou sobre o leiaute em homologação: fale com o seu contato na NFE.io ou abra um chamado pelo suporte.

Documentação​

PáginaPara que serve
NT-009 da NFS-e nacional: ajustes de IBS/CBSO que a NT 009 estabelece e como afeta a sua emissão.
Documentação do layout de emissão de NFS-e (RTC)Referência completa de cada campo, com as regras de validação. A seção com os campos da NT 009 entra no ar junto com a liberação em homologação.
Mudanças no layout de integração da NFS-eComparação entre o layout anterior e o atual, campo a campo.
NFS-e de ajuste de IBS/CBS (crédito e débito)Situação atual da nota de ajuste.
Referência completa de campos de emissão de NFS-eContrato do payload de emissão.
Tabelas de referência da Reforma TributáriaIndicador de operação (indOp), CST e classificação tributária, correlação LC 116 x NBS, comércio exterior.
Monitoramento da adesão dos municípios ao Ambiente NacionalEm que situação está cada município.
Perguntas e respostas sobre a Reforma TributáriaDúvidas frequentes.
Release notesHistórico de mudanças da plataforma.

FAQ​

Preciso alterar a minha integração agora? Depende de por onde você emite. Nenhum campo foi removido ou renomeado na API. Nos provedores municipais fora do leiaute NT 009, uma requisição que não usa os campos novos continua gerando o mesmo XML de hoje. Se você emite pela Sefin Nacional, revise e teste a integração antes de 01/12/2026: nessa data, a estrutura da DPS muda e as validações do leiaute novo passam a valer, inclusive para campos que já existiam, como os documentos de dedução e de reembolso.

Quando a NT 009 entra em produção? A SE/CGNFS-e informou que as evoluções da NT 009 devem entrar em produção em 01/12/2026, mas ainda não publicou o cronograma formal. Nas notas emitidas pela Sefin Nacional, a NFE.io passa ao leiaute NT 009 nessa data, às 00:00 de Brasília. Nos provedores municipais, a produção muda só quando a NFE.io ativar o leiaute na prefeitura.

O que acontece se eu enviar um campo novo para uma prefeitura que ainda não está no leiaute NT 009? Quase todos os campos novos são ignorados e a nota é emitida normalmente. Cinco campos são exclusivos do leiaute (ibsCbs.adjustmentPurpose, foreignTrade.concurrentConsumption = true, os dois baseCalculationAdjustmentType e ibsCbs.advancePaymentInvoiceKeys): com eles, a nota é recusada antes do envio, com mensagem, e o webhook é disparado.

Sou optante do Simples Nacional. Quando preciso destacar IBS e CBS? Pelo Ato Conjunto RFB/CGIBS nº 4/2026, alterado pelo Ato Conjunto RFB/CGIBS nº 7/2026, a obrigatoriedade de emissão dos documentos com IBS/CBS para optantes do Simples Nacional começa em 01/01/2027 para a maioria dos serviços e em 01/03/2027 para os serviços de plataformas digitais e os intermediados por elas e para os subitens 1.03, 1.05, 1.09 e 16.01 da LC 116/2003. Até 31/12/2026, a omissão não é rejeitada pelo sistema nacional. A desconformidade conta conforme a categoria e a respectiva data de vigência.

O schema da NFE.io é o oficial? Não. O schema usado no desenvolvimento (XSD v1.02) não é a versão oficial nem a mais recente. Quando a versão oficial for publicada, atualizamos a documentação e comunicamos as diferenças.


Em resumo:

  1. A API já aceita os campos da NT 009. Todos opcionais e nuláveis. Nada foi removido ou renomeado.
  2. Sefin Nacional em 01/12/2026; provedores municipais por prefeitura. Nas notas de produção emitidas pela Sefin Nacional, inclusive as do optante do Simples em cidade conveniada ao Ambiente Nacional, o leiaute NT 009 passa a valer em 01/12/2026, com XML novo e validações novas. Nos provedores municipais, a produção muda só com a ativação por prefeitura. Na homologação, o leiaute NT 009 já é o padrão. Cinco campos exclusivos recusam a nota em prefeitura fora do leiaute.
  3. Cronograma formal ainda não publicado e leiaute preliminar. O XSD usado não é o oficial e pode haver ajustes. O Ambiente Nacional pode não aceitar todos os grupos em 01/12/2026.
  4. Simples Nacional: regime de apuração do IBS/CBS, código da atividade e optante pendente entram no leiaute. A obrigatoriedade de emissão com IBS/CBS para optantes começa em 01/01/2027 para a maioria dos serviços e em 01/03/2027 para os serviços de plataformas digitais e os intermediados por elas e para os subitens 1.03, 1.05, 1.09 e 16.01 da LC 116/2003.

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.