Voltar ao Blog NotaasReforma Tributária
Reforma Tributária

Nota Técnica 009 NFS-e Nacional (NT-009 v1.01) e Anexo VIII: cIndOp, cClassTrib e NBS via API

Guia prático da Nota Técnica SE/CGNFS-e nº 009 (v1.01) e Anexo VIII da Reforma Tributária: correlação Item LC 116 x NBS x cIndOp x cClassTrib, tag finNFSe e emissão REST JSON.

Fábio Magalhães CostaAtualizado em 21/11/2026
Validação de schema XSD da Nota Técnica 009 (NT-009 v1.01) e correlação do Anexo VIII (NBS, cIndOp e cClassTrib) na API NFS-e Nacional

Validação de schema XSD da Nota Técnica 009 (NT-009 v1.01) e correlação do Anexo VIII (NBS, cIndOp e cClassTrib) na API NFS-e Nacional

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:

  1. Posição estrita da tag <finNFSe> dentro de <infDPS>:
    • A tag <finNFSe> (Indicador da Finalidade da Emissão da NFS-e: 0 para 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).
  2. Inscrição Municipal do Tomador (<toma><IM>) no tipo TSInscMun:
    • 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>, respeitando 1..15 caracteres com whiteSpace="preserve".
  3. Validação cruzada do grupo <IBSCBS> com o Anexo VIII:
    • Não basta enviar um cClassTrib qualquer 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.

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 cIndOp e 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. O cIndOp diz 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:

  1. 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)
  2. 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"
  3. Serviços Médicos e Clínicas de Saúde (04.01 a 04.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 ibsCbs dentro de servico, 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 normaliza tomador.inscricaoMunicipal (preservando caracteres internos até 15 posições) e valida o formato de 9 dígitos do nbs.
  • 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 < 180ms com 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:

  1. 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 o nbs, cIndOp, cst e cClassTrib padrão do CNAE dele uma única vez.
  2. 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.
  3. 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:

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em Reforma Tributária

Guias Pilares de Integração Fiscal