Se o seu ERP, SaaS ou sistema contábil começou a receber falhas de validação de schema ao transmitir a Declaração de Prestação de Serviços (DPS) para a Sefin Nacional em novembro de 2026, a causa quase sempre está na Nota Técnica SE/CGNFS-e nº 009 (versão 1.01) e na tabela de correlação do Anexo VIII (AnexoVIII-CorrelacaoItemNBSIndOpCClassTrib_IBSCBS).
Quando atualizamos o motor de validação e a calculadora da Reforma Tributária aqui na Notaas para refletir 100% de paridade com os schemas DPS_v1.01.xsd (revisão NT-009) e com a tabela oficial de 1.515 tuplas da Receita Federal, vimos na prática onde a maioria dos desenvolvedores perde horas: a posição exata de novas tags dentro de <infDPS>, a obrigatoriedade do Código Indicador da Operação (cIndOp) de 6 dígitos e a amarração estrita entre cTribNac, cNBS, CST e cClassTrib.
Neste artigo, vou abrir os detalhes técnicos do layout da NT-009 v1.01, mostrar como funciona a validação cruzada do Anexo VIII e como você pode emitir NFS-e com IBS e CBS via JSON puro sem precisar manter tabelas de correlação de 1.500 linhas dentro do seu código.
⚡ Quer emitir NFS-e Nacional com validação automática da NT-009 e Anexo VIII hoje? A API da Notaas já resolve e valida a tríade
cNBS+cIndOp+cClassTrib, preenche<finNFSe>automaticamente e gera o DANFSe v2.0 (NT-008) em< 180ms:
- 20 notas fiscais gratuitas por mês em Produção Real (1 CNPJ) + até 5 CNPJs grátis em Homologação via Org API (sem cartão de crédito).
- Auto-preenchimento IBS/CBS em Lote: Configure padrões para toda a carteira de clientes contábeis ou multi-tenant. 👉 Criar Conta Grátis na Notaas | Consultar Documentação da API
O que muda na prática com a Nota Técnica 009 (NT-009 v1.01) da NFS-e Nacional
A Nota Técnica 009 (NT-009) consolidou os ajustes do schema v1.01 da NFS-e Nacional para recepcionar a escrituração do IBS (Imposto sobre Bens e Serviços) e da CBS (Contribuição sobre Bens e Serviços) conforme a Lei Complementar nº 214/2025 e o cronograma do Ato Conjunto RFB/CGIBS nº 7/2026.
Na trincheira de quem monta e assina o XML da DPS, existem três mudanças estruturais na NT-009 v1.01 que quebram emissores legados:
- Posição estrita da tag
<finNFSe>dentro de<infDPS>:- A tag
<finNFSe>(Indicador da Finalidade da Emissão da NFS-e:0para NFS-e Regular) deve ser posicionada obrigatoriamente após<verAplic>e<ambGer>(ou dentro da sequência inicial de cabeçalho da<infDPS>antes do grupo<subst>e dos atores<prest>/<toma>). Se o seu serializador XML colocar<finNFSe>dentro do bloco<IBSCBS>, o validador XSD da Sefin rejeita imediatamente com falha de schema (E0014/cvc-complex-type.2.4.a).
- A tag
- Inscrição Municipal do Tomador (
<toma><IM>) no tipoTSInscMun:- Na revisão
1.01-nt009, a tag<IM>dentro de<toma>deve vir posicionada logo após o documento de identificação (<CNPJ>,<CPF>,<NIF>ou<cNaoNIF>) e imediatamente antes de<xNome>, respeitando1..15caracteres comwhiteSpace="preserve".
- Na revisão
- Validação cruzada do grupo
<IBSCBS>com o Anexo VIII:- Não basta enviar um
cClassTribqualquer de 6 dígitos. A Sefin Nacional cruza em tempo de autorização se a quádrupla(cTribNac, cNBS, cIndOp, cClassTrib)existe na planilha oficial do Anexo VIII, sob pena de disparar o Erro E637 na NFS-e Nacional.
- Não basta enviar um
Desvendando o Anexo VIII: A Correlação Item LC 116 x NBS x cIndOp x cClassTrib
Muitos desenvolvedores chegam ao nosso suporte perguntando o que é a tabela AnexoVIII-CorrelacaoItemNBSIndOpCClassTrib_IBSCBS publicada no Portal Nacional da NFS-e.
Em termos simples: antes da Reforma Tributária, você só precisava informar o código de tributação nacional (cTribNac, de 6 dígitos derivado da LC 116/03, como 010501 para licenciamento de software ou 171901 para contabilidade). Com a NT-009, cada item de serviço precisa ser traduzido para três novos códigos federais que determinam onde o imposto é devido e qual alíquota/redução se aplica:
| Campo na API / XML | Nome Oficial na NT-009 | Formato | O que ele define na Reforma Tributária |
|---|---|---|---|
cTribNac |
Código de Tributação Nacional (LC 116) | 6 dígitos (010501) |
Subitem e desdobramento do serviço municipal na Lista Nacional. |
nbs (<cNBS>) |
Nomenclatura Brasileira de Serviços | 9 dígitos (115021000) |
Classificação econômica federal do serviço intangível ou intelectual. |
cIndOp (<cIndOp>) |
Código Indicador da Operação | 6 dígitos (010101) |
Define a regra de localidade de incidência (cLocalidadeIncid) do IBS/CBS (domicílio do prestador, domicílio do destinatário/adquirente ou local da execução física). |
cClassTrib (<cClassTrib>) |
Classificação Tributária do IBS/CBS | 6 dígitos (000001) |
Vincula o serviço ao artigo da LC 214/2025 (alíquota padrão 000001, redução de 30% para profissões regulamentadas 200029, redução de 60% saúde/educação, etc.). |
💡 Por que a tag
cIndOpe a pergunta sobre "Destinatário do Serviço para fins de apuração do IBS/CBS" travam tantos emissores? No modelo do IBS e da CBS, a regra geral deixou de ser a cobrança na origem (município do prestador) e passou a ser o princípio do destino. OcIndOpdiz ao motor de cálculo da Receita Federal e do Comitê Gestor do IBS se a alíquota municipal/estadual de destino deve ser buscada no código IBGE do adquirente/destinatário ou no local da prestação presencial.
Exemplos Práticos de Tuplas Válidas do Anexo VIII (2026)
Para que você não precise abrir a planilha do Anexo VIII toda vez que for testar um payload, aqui estão os mapeamentos mais utilizados por Software Houses, SaaS e Escritórios de Contabilidade:
- SaaS, Licenciamento de Software e Desenvolvimento Sob Encomenda (
01.05/01.01):codigoTributacaoNacional:"010501"(ou"010101")nbs:"115021000"(Licenciamento de direitos de uso de programas de computador) ou"115011000"(Desenvolvimento)cIndOp:"010101"cst:"000"cClassTrib:"000001"(Tributação integral — alíquota de teste 2026:0,9%CBS +0,1%IBS)
- Escritórios de Contabilidade, Auditoria e Consultoria Contábil (
17.19):codigoTributacaoNacional:"171901"nbs:"113021000"(Serviços de contabilidade e escrituração mercantil)cIndOp:"010101"cst:"200"(Alíquota reduzida) ou"000"cClassTrib:"200029"(Redução de 30% para profissões intelectuais regulamentadas em conselho federal, quando em Regime Regular) ou"000001"
- Serviços Médicos e Clínicas de Saúde (
04.01a04.03):codigoTributacaoNacional:"040101"nbs:"123012100"cIndOp:"030101"cst:"200"cClassTrib:"200003"(Redução de 60% para serviços de saúde humana)
Como Enviar os Campos da NT-009 via API REST JSON na Notaas
Se você integra pela API NFS-e Nacional da Notaas, você tem duas opções:
- Opção 1 (Automática — Zero Complexidade): Você envia apenas o
codigoTributacaoNacional(ex.:"010501"). Se o projeto tiver o perfil IBS/CBS padrão configurado via Org API em lote, nossa engine preenche e valida a tríade do Anexo VIII automaticamente. - Opção 2 (Explícita por Nota no Payload JSON): Você informa o objeto
ibsCbsdentro deservico, e o nosso validador síncrono checa as 1.515 correlações do Anexo VIII antes mesmo de enfileirar a nota (retornando HTTP 400 descritivo caso a combinação não exista na tabela da Receita).
Veja um exemplo real de requisição POST /api/v1/emitir compatível com a NT-009 v1.01:
{
"ambiente": "producao",
"tipoDocumento": "nfse",
"externalId": "fatura-saas-2026-11-9482",
"tomador": {
"cpfCnpj": "12345678000199",
"inscricaoMunicipal": "9876543",
"razaoSocial": "ACME TECNOLOGIA E SISTEMAS S.A.",
"email": "fiscal@acme.com.br",
"endereco": {
"logradouro": "Avenida Paulista",
"numero": "1000",
"bairro": "Bela Vista",
"codigoMunicipio": "3550308",
"uf": "SP",
"cep": "01310100"
}
},
"servico": {
"descricao": "Assinatura mensal do ERP Cloud - Competência 11/2026",
"valorServicos": 1250.00,
"codigoTributacaoNacional": "010501",
"nbs": "115021000",
"ibsCbs": {
"finNFSe": "0",
"indFinal": "1",
"cIndOp": "010101",
"indDest": "0",
"cst": "000",
"cClassTrib": "000001"
}
}
}
⚡ Fluxo de Validação Síncrona da NT-009 na Engine da Notaas:
- 1. Recepção REST JSON (
POST /api/v1/emitir): O mapper normalizatomador.inscricaoMunicipal(preservando caracteres internos até 15 posições) e valida o formato de 9 dígitos donbs.- 2. Cruzamento com o Anexo VIII (1.515 tuplas): O motor verifica se a combinação
(cTribNac, nbs, cIndOp, cst, cClassTrib)é permitida pela Receita Federal, prevenindo o Erro E637 na Sefin.- 3. Serialização DPS v1.01 (NT-009): A tag
<finNFSe>é injetada na posição canônica de<infDPS>, o XML é assinado com XMLDSig RSA-SHA256 e comprimido em GZip + Base64.- 4. Autorização & DANFSe v2.0 Local: A Sefin Nacional retorna a chave de 50 dígitos e a Notaas renderiza o DANFSe v2.0 (NT-008) localmente em
< 180mscom o quadro demonstrativo de IBS e CBS.
Como Testar e Automatizar para Múltiplos Clientes (ERPs e Contabilidades)
Se você mantém um ERP multi-CNPJ ou um sistema próprio para escritório de contabilidade, atualizar manualmente cada cliente para a NT-009 é inviável. Na Notaas, você resolve isso em minutos:
- Configure os padrões de IBS/CBS via Org API Multi-CNPJ: Ao cadastrar ou atualizar o projeto de um cliente (
PATCH /api/v1/org/projects/{id}), você define onbs,cIndOp,cstecClassTribpadrão do CNAE dele uma única vez. - Use o nosso MCP Server no Claude Code ou Cursor (
npx -y @notaas/mcp): Se estiver usando Vibe Coding Fiscal, basta pedir ao agente de IA para consultar a tool de códigos tributários da Notaas: ela retorna automaticamente a tupla válida do Anexo VIII para qualquer item da LC 116. - Trate falhas de conexão e indisponibilidade da Sefin sem perder notas: Veja nosso guia sobre como resolver o Erro ao Gerar Chave da NFS-e e falhas de conexão na API Nacional e o guia definitivo de payload JSON para IBS e CBS na DPS v1.01.
Conclusão: Pare de Atualizar Tabelas do Anexo VIII na Mão
A cada nova revisão da Nota Técnica 009 e da calculadora oficial do Regime Regular, a Receita Federal adiciona ou altera correlações no Anexo VIII. Manter esse motor de regras acoplado ao código do seu SaaS drena o tempo de engenharia que deveria ir para o seu produto principal.
Na Notaas, você começa com 20 notas fiscais gratuitas por mês em Produção Real (1 CNPJ) + até 5 projetos simultâneos grátis em Homologação via Org API, sem precisar cadastrar cartão de crédito:

