Anexo VIII (Correlação Item NBS, IndOp e cClassTrib) e Código 170601: Como Configurar IBS/CBS em Lote via Org API

Quando mapeamos a tabela completa do Anexo VIII da Receita Federal para dentro do motor de validação da Notaas, eu abri pela primeira vez o arquivo oficial chamado AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS publicado pelo Comitê Gestor da NFS-e Nacional (CGNFS-e) e pela Secretaria Especial da Receita Federal. São mais de 11.380 linhas cruzando códigos de tributação nacional (cTribNac), códigos da Nomenclatura Brasileira de Serviços (NBS), Indicadores de Operação (cIndOp) e Classificações Tributárias (cClassTrib) do IBS (Imposto sobre Bens e Serviços) e da CBS (Contribuição sobre Bens e Serviços).

Naquela mesma semana, nosso canal de engenharia começou a receber dezenas de chamados de CTOs de ERPs, desenvolvedores de plataformas de marketing/infoprodutos e escritórios de BPO contábil com exatamente a mesma dúvida: "Minhas notas do código 170601 (Propaganda e Publicidade) e de tecnologia estão voltando com erro E363, E637 ou E0903 depois que a prefeitura virou a chave da Reforma Tributária. Eu vou ter que refatorar o banco de dados do meu ERP inteiro e pedir para cada cliente preencher quatro campos fiscais novos antes de emitir uma nota?"

A resposta curta é não. Você não precisa tocar no payload de emissão do seu sistema legado nem obrigar o seu usuário final a entender o que é um cIndOp ou um cClassTrib.

Ao longo deste artigo, vou abrir a estrutura real da planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS, mostrar por que códigos campeões de volume como o 170601 quebram nas validações cruzadas das prefeituras e do Ambiente de Dados Nacional (ADN), entregar uma tabela de consulta rápida com as tuplas válidas para os serviços mais comuns do mercado e, por fim, compartilhar o script em TypeScript que usamos para parametrizar 50, 200 ou 500 CNPJs em lote usando o endpoint PATCH /api/v1/org/projects/{id} da Org API da Notaas.

O que é a planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS e por que ela trava emissões em produção

Antes da entrada em vigor das Notas Técnicas do Regime de Transição do Consumo (LC 214/2025 e EC 132/2023), emitir uma NFS-e exigia basicamente informar o item da Lei Complementar 116/2003 (ou o código de tributação nacional de 6 dígitos no padrão SNNFSE, o cTribNac), a alíquota do ISS e o valor do serviço. Mesmo quando um sistema enviava um código NBS genérico, a maioria das prefeituras tratava aquele campo como meramente informativo.

Isso acabou. Com a validação ativa do bloco IBSCBS tanto no Sistema Nacional da NFS-e quanto em provedores municipais atualizados (como DBSeller, Betha, GINFES, IPM e Pública), o autorizador não olha mais para cada campo de forma isolada. Ele executa um INNER JOIN estrito contra a matriz oficial AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS.

Na prática, essa matriz transforma quatro códigos independentes em uma tupla fechada e indivisível:

1. Código de Tributação Nacional (cTribNac — 6 dígitos): É o subitem da LC 116/2003 acrescido de dois dígitos de desdobramento nacional (por exemplo, 17.06.01 vira 170601; 01.05.01 vira 010501).
2. Código NBS (cNBS — 9 dígitos numéricos): A Nomenclatura Brasileira de Serviços, Intangíveis e Outras Operações que Produzam Variações no Patrimônio. Cada cTribNac aceita apenas um subconjunto restrito de códigos NBS.
3. Indicador da Operação de Consumo (cIndOp — 6 dígitos): Define a regra constitucional do princípio do destino na Reforma Tributária — isto é, onde o fato gerador do IBS/CBS é considerado ocorrido (no domicílio do adquirente/tomador, no local físico da execução do serviço, no local do imóvel ou no exterior).
4. Classificação Tributária do IBS/CBS (cClassTrib — 6 dígitos) + CST (3 dígitos): Determina o regime de cálculo da operação conforme a Lei Complementar 214/2025 (tributação integral padrão com CST 000 e cClassTrib 000001, redução de alíquota em 60% para serviços de saúde/educação com CST 200 e cClassTrib 200030, redução de 30% para profissões intelectuais regulamentadas, ou imunidade/não incidência com CST 410).

Se o seu sistema envia um cTribNac válido, mas combina esse item com um NBS de outra linha da planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS, ou informa um cIndOp que não pertence àquela família de serviço, o webservice nem chega a processar a assinatura digital da nota. Ele aborta a transação na hora e devolve uma das três rejeições que dissecamos em detalhes no nosso guia central sobre a Reforma Tributária (IBS/CBS), Anexo VIII e resolução dos erros E363 e E637:

• E363 (Provedores Municipais / DBSeller / ABRASF customizado): "Relação entre NBS, Indop e cClassTrib inválida."
• E637 (SNNFSE / ABRASF 2.04 RTC): "Classificação Tributária incompatível com o código NBS ou indicador de operação."
• E0903 (Ambiente Nacional DPS v1.01): "O código NBS informado não possui correlação válida com o código de tributação nacional (cTribNac) na tabela do Anexo VIII."

Na Reforma Tributária, tentar adivinhar NBS e cClassTrib em tabelas separadas no banco de dados é garantia de rejeição em lote. Ou o seu sistema valida a tupla inteira do Anexo VIII, ou delega isso para a API fiscal.

Dissecando o Código 170601 (Propaganda e Publicidade): O Caso Clássico de Rejeição

Ao analisar as buscas que chegam ao nosso blog técnico e os logs de homologação de ERPs parceiros, um código aparece disparado no topo: 170601.

Por que justamente o 170601 gera tanta dor de cabeça? Porque ele corresponde ao item 17.06 da LC 116/2003 no padrão da NFS-e Nacional:

• Código Nacional (cTribNac): 170601 (ou 17.06.01)
• Descrição Oficial: Propaganda e publicidade, inclusive promoção de vendas, planejamento de campanhas ou sistemas de publicidade, elaboração de desenhos, textos e demais materiais publicitários.

Esse é o código utilizado diariamente por milhares de agências de marketing digital, gestores de tráfego pago, plataformas de afiliados, produtoras de conteúdo, consultorias de growth e veículos de mídia que emitem notas fiscais automatizadas por meio de ERPs, CRMs e plataformas SaaS.

Quando abrimos a planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS e filtramos pelo código 170601, descobrimos exatamente onde os desenvolvedores tropeçam:

1. A armadilha do NBS no 170601: Muitas contabilidades antigas cadastravam qualquer código da posição 1.1406 da NBS ou até mesmo códigos de design/tecnologia (1.1502...) para agências digitais. Porém, no Anexo VIII, o código 170601 exige estritamente os códigos NBS da família 11406, especificamente:
   • 114061100 — Serviços de campanhas publicitárias (ideal para gestão de tráfego, planejamento de mídia e agências full-service).
   • 114061200 — Serviços de marketing direto e mala direta (ideal para automação de CRM, disparos de performance e promoção de vendas).
   • 114061900 — Outros serviços de publicidade (elaboração de peças, textos, criativos e materiais publicitários em geral).
2. O Indicador de Operação (cIndOp) obrigatório: Como os serviços de publicidade e planejamento de campanhas (170601) são serviços prestados de forma remota ou intelectual cujo consumo ocorre no estabelecimento ou domicílio de quem contrata a campanha, o Anexo VIII amarra essa operação ao indicador 100301 (Prestação de serviço em que o local da operação corresponde ao domicílio principal do adquirente/destinatário, nas operações onerosas). Se o ERP enviar 010101 (serviço prestado presencialmente no estabelecimento do prestador) ou 020301 (serviço sobre bem imóvel), a prefeitura rejeita a nota com E363 na mesma hora.
3. O CST e o cClassTrib: Para agências e empresas em regime regular ou mesmo na parametrização de referência do RTC, a combinação padrão exigida na linha do 170601 é CST 000 (Tributação integral) com cClassTrib 000001 (Situações tributadas integralmente pelo IBS e pela CBS).

Veja como fica o bloco de resolução exato para uma nota do código 170601 enviada pela API NFS-e Nacional da Notaas:

{
  "tipo": "nfse",
  "ambiente": "producao",
  "referencia": "AGENCIA-2026-8841",
  "prestador": {
    "cnpj": "12345678000199"
  },
  "tomador": {
    "cpfCnpj": "98765432000110",
    "razaoSocial": "Ecommerce Varejo Digital S.A.",
    "email": "fiscal@ecommercevarejo.com.br",
    "endereco": {
      "logradouro": "Avenida Brigadeiro Faria Lima",
      "numero": "3477",
      "bairro": "Itaim Bibi",
      "codigoMunicipio": "3550308",
      "uf": "SP",
      "cep": "04538133"
    }
  },
  "servico": {
    "codigo": "170601",
    "descricao": "Planejamento de campanha de mídia paga e produção de criativos publicitários - Competência Outubro/2026.",
    "aliquota": 2.0,
    "valor": 8500.00
  },
  "ibscbs": {
    "nbs": "114061100",
    "indicadorOperacao": "100301",
    "cst": "000",
    "classificacaoTributaria": "000001",
    "consumidorFinal": true
  }
}

Tabela Prática do Anexo VIII: Tuplas Prontas para ERPs, SaaS e Contabilidades

Para poupar horas da sua equipe filtrando planilhas .xlsx de 11 mil linhas da Receita Federal, consolidei abaixo as tuplas mais utilizadas pelos clientes que integram com a Notaas. Todas essas combinações foram validadas diretamente contra a matriz AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS em produção:

Repare na diferença sutil entre os serviços de TI/Publicidade (170601, 010501, 010601) e os serviços médicos (040101). Enquanto um SaaS ou uma agência de publicidade cai na regra geral (CST 000 / cClassTrib 000001 / cIndOp 100301), uma clínica médica tem direito constitucional à redução de 60% na alíquota do IBS e da CBS (CST 200 / cClassTrib 200030). Se o sistema contábil tentar aplicar 000001 em um NBS médico que exige regime diferenciado, ou vice-versa, o autorizador barra a emissão.

O Problema de Escala: Como Atualizar 50 ou 500 CNPJs Sem Mexer no Código de Emissão do ERP

Agora coloque-se no lugar de um CTO de uma Software House ou do diretor de tecnologia de uma plataforma de contabilidade digital que gerencia 300 CNPJs emitentes (por exemplo, 120 agências de publicidade usando o código 170601, 80 empresas de tecnologia usando 010501/010601 e 100 clínicas médicas usando 040101).

Na maioria das APIs fiscais legadas do mercado — como mostramos no nosso comparativo técnico de APIs de emissão de NF-e, NFS-e e NFC-e —, a única maneira de enviar os campos do IBS e da CBS é alterando o payload JSON de cada requisição de emissão de nota. Isso significa que você precisaria:

1. Criar colunas novas (nbs_padrao, cindop_padrao, cclasstrib_padrao, cst_ibscbs) na tabela de empresas ou serviços do seu banco de dados;
2. Construir telas novas no seu ERP para os contadores preencherem esses códigos;
3. Refatorar os microsserviços de faturamento e reimplantar tudo em produção correndo contra o relógio.

Aqui na Notaas nós resolvemos esse problema de arquitetura de um jeito muito mais limpo: criamos os Defaults de IBS/CBS por Projeto (CNPJ) na nossa Org API.

Cada CNPJ cadastrado na sua organização na Notaas é um Projeto isolado (proj_...) que aceita quatro propriedades nativas de fallback para a Reforma Tributária:

• defaultNbs (ex.: "114061100")
• defaultIndicadorOperacao (ex.: "100301")
• defaultCstIbscbs (ex.: "000")
• defaultClassificacaoTributaria (ex.: "000001")

Veja o que acontece no motor da Notaas quando você configura esses quatro parâmetros via PATCH /api/v1/org/projects/{id}:

⚡ Fluxo Arquitetural de Herança de IBS/CBS via Org API:

• 1. Parametrização Única em Lote (PATCH /api/v1/org/projects/{id}): Um script administrativo percorre sua base de CNPJs e grava a tupla padrão do Anexo VIII (defaultNbs, defaultIndicadorOperacao, defaultCstIbscbs, defaultClassificacaoTributaria) no cadastro de cada projeto na Notaas.
• 2. Emissão Legada Intacta (POST /api/v1/emitir): O seu ERP continua disparando exatamente o mesmo payload JSON que já enviava antes da Reforma Tributária (apenas com prestador, tomador e servico), sem precisar enviar o objeto ibscbs.
• 3. Injeção Automática pelo Motor da Notaas: Quando o worker da Notaas recebe a requisição e percebe que o bloco ibscbs não foi enviado no JSON da nota, ele busca em memória (cache Redis sub-milissegundo) os defaults daquele projectId.
• 4. Validação Cruzada Anexo VIII & Geração de XML/DANFSe: A Notaas valida a tupla contra as 11.380 linhas da tabela AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS, monta as tags <IBSCBS> no layout exigido pelo município ou pelo ADN e gera localmente o DANFSe v2.0 (NT-008) com o demonstrativo do IBS/CBS pronto para o cliente final.

Se em uma nota específica o cliente prestar um serviço secundário diferente do habitual, basta enviar o objeto ibscbs no JSON daquela nota puntual: o valor enviado no payload sobrescreve o default do projeto apenas naquela transação.

Script Completo em TypeScript: Parametrizando Múltiplos CNPJs em Lote via PATCH na Org API

Para mostrar como isso funciona na prática, escrevi abaixo o script completo em Node.js / TypeScript que várias software houses parceiras rodaram para adequar centenas de clientes à Reforma Tributária em menos de cinco minutos, sem tocar no código do ERP principal.

O script mapeia o código de serviço principal de cada cliente (como o 170601 de publicidade, 010501 de SaaS ou 040101 de clínicas) para a tupla oficial do Anexo VIII e dispara chamadas PATCH /api/v1/org/projects/{id} autenticadas com a chave mestra da organização (NOTAAS_ORG_API_KEY):

/**
 * Script de Parametrização em Lote do Anexo VIII (IBS/CBS) via Notaas Org API
 * Execução: npx tsx scripts/configure-ibscbs-batch.ts
 */

interface AnexoViiiTuple {
  defaultNbs: string;
  defaultIndicadorOperacao: string;
  defaultCstIbscbs: string;
  defaultClassificacaoTributaria: string;
  descricaoRegra: string;
}

// Mapa de tuplas validadas na planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS
const ANEXO_VIII_PRESETS: Record<string, AnexoViiiTuple> = {
  // 17.06.01 - Propaganda e publicidade, promoção de vendas e planejamento de campanhas
  "170601": {
    defaultNbs: "114061100",
    defaultIndicadorOperacao: "100301",
    defaultCstIbscbs: "000",
    defaultClassificacaoTributaria: "000001",
    descricaoRegra: "Agências de Publicidade e Marketing (170601 -> NBS 114061100)",
  },
  // 01.05.01 - Licenciamento ou cessão de direito de uso de programas de computação (SaaS)
  "010501": {
    defaultNbs: "115022000",
    defaultIndicadorOperacao: "100301",
    defaultCstIbscbs: "000",
    defaultClassificacaoTributaria: "000001",
    descricaoRegra: "Software Houses e SaaS (010501 -> NBS 115022000)",
  },
  // 01.06.01 - Assessoria e consultoria em informática
  "010601": {
    defaultNbs: "115011000",
    defaultIndicadorOperacao: "100301",
    defaultCstIbscbs: "000",
    defaultClassificacaoTributaria: "000001",
    descricaoRegra: "Consultoria em TI (010601 -> NBS 115011000)",
  },
  // 17.19.01 - Contabilidade, inclusive serviços técnicos e auxiliares
  "171901": {
    defaultNbs: "113021000",
    defaultIndicadorOperacao: "100301",
    defaultCstIbscbs: "000",
    defaultClassificacaoTributaria: "000001",
    descricaoRegra: "Escritórios de Contabilidade e BPO Fiscal (171901 -> NBS 113021000)",
  },
  // 04.01.01 - Medicina e biomedicina (Redução de 60% na alíquota de IBS/CBS)
  "040101": {
    defaultNbs: "123012100",
    defaultIndicadorOperacao: "010101",
    defaultCstIbscbs: "200",
    defaultClassificacaoTributaria: "200030",
    descricaoRegra: "Clínicas Médicas - Redução 60% Saúde (040101 -> NBS 123012100)",
  },
};

interface TenantProject {
  notaasProjectId: string;
  cnpj: string;
  razaoSocial: string;
  cTribNacPrincipal: string;
}

async function updateProjectIbsCbsDefaults(
  orgApiKey: string,
  tenant: TenantProject,
  tuple: AnexoViiiTuple
) {
  const url = `https://platform.notaas.com.br/api/v1/org/projects/${tenant.notaasProjectId}`;

  const response = await fetch(url, {
    method: "PATCH",
    headers: {
      "Authorization": `Bearer ${orgApiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      defaultNbs: tuple.defaultNbs,
      defaultIndicadorOperacao: tuple.defaultIndicadorOperacao,
      defaultCstIbscbs: tuple.defaultCstIbscbs,
      defaultClassificacaoTributaria: tuple.defaultClassificacaoTributaria,
    }),
  });

  if (!response.ok) {
    const errorBody = await response.text();
    throw new Error(
      `Erro HTTP ${response.status} ao atualizar CNPJ ${tenant.cnpj} (${tenant.notaasProjectId}): ${errorBody}`
    );
  }

  return response.json();
}

async function runBatchConfiguration() {
  const orgApiKey = process.env.NOTAAS_ORG_API_KEY;
  if (!orgApiKey) {
    throw new Error("Variável de ambiente NOTAAS_ORG_API_KEY não definida.");
  }

  // Exemplo de lista vinda do banco de dados do seu ERP ou sistema contábil
  const carteiraClientes: TenantProject[] = [
    {
      notaasProjectId: "proj_01j8x9k2m4p7q8r9s0t1u2v3",
      cnpj: "14253647000188",
      razaoSocial: "Performance Ads & Growth Marketing Ltda",
      cTribNacPrincipal: "170601",
    },
    {
      notaasProjectId: "proj_01j8x9k5z8w1y2x3c4v5b6n7",
      cnpj: "22334455000109",
      razaoSocial: "CloudERP Sistemas de Gestão S.A.",
      cTribNacPrincipal: "010501",
    },
    {
      notaasProjectId: "proj_01j8x9k9a1s2d3f4g5h6j7k8",
      cnpj: "33445566000177",
      razaoSocial: "Clínica Médica Integrada Paulista Ltda",
      cTribNacPrincipal: "040101",
    },
  ];

  console.log(`Iniciando parametrização do Anexo VIII para ${carteiraClientes.length} CNPJs...`);

  let sucessos = 0;
  let falhas = 0;

  for (const cliente of carteiraClientes) {
    const tuple = ANEXO_VIII_PRESETS[cliente.cTribNacPrincipal];

    if (!tuple) {
      console.warn(
        `[SKIP] CNPJ ${cliente.cnpj} possui cTribNac ${cliente.cTribNacPrincipal} sem preset mapeado.`
      );
      continue;
    }

    try {
      await updateProjectIbsCbsDefaults(orgApiKey, cliente, tuple);
      sucessos++;
      console.log(
        `[OK] ${cliente.razaoSocial} (${cliente.cnpj}) -> ${tuple.descricaoRegra}`
      );
    } catch (err) {
      falhas++;
      console.error(`[ERRO] Falha no CNPJ ${cliente.cnpj}:`, err);
    }
  }

  console.log(
    `\n Lote finalizado! Sucessos: ${sucessos} | Falhas: ${falhas}`
  );
}

runBatchConfiguration().catch(console.error);

Depois que esse script roda, todas as emissões da agência Performance Ads & Growth Marketing Ltda (código 170601) já saem automaticamente com NBS 114061100, cIndOp 100301, CST 000 e cClassTrib 000001, mesmo que o módulo financeiro do seu ERP envie apenas os dados básicos do tomador e o valor da nota.

E para quem opera com NF-e (Modelo 55) e NFC-e (Modelo 65) no Varejo e Indústria?

Vale lembrar que a arquitetura da Notaas unifica documentos fiscais de serviços e mercadorias sob o mesmo guarda-chuva multi-tenant. Se além de emitir NFS-e seus clientes também emitem notas de produto pela nossa API de NF-e (Modelo 55) ou cupons fiscais de varejo via API de NFC-e (Modelo 65), os defaults configurados no projeto via Org API também servem como base de resolução para a NT 2025.002-RTC, que exige o grupo <IBSCBS> por item associado ao NCM do produto.

Além disso, se você utiliza editores com IA generativa (como Cursor, Claude Code ou Windsurf) para operar ou manter seu sistema contábil, nosso servidor oficial @notaas/mcp (v0.2.1 com 44 Tools) permite consultar as regras fiscais e atualizar os defaults dos projetos da sua organização diretamente pelo chat da IDE, sem nem mesmo precisar escrever o script de migração na mão.

Perguntas Frequentes sobre o Anexo VIII e o Código 170601

1. Qual é o NBS correto para o código de serviço 170601 (Propaganda e Publicidade) no Anexo VIII?

Segundo a tabela oficial AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS, o código de tributação nacional 170601 (subitem 17.06 da LC 116/2003) aceita os códigos NBS da posição 1.1406, sendo os principais 114061100 (Serviços de campanhas publicitárias), 114061200 (Serviços de marketing direto e mala direta) e 114061900 (Outros serviços de publicidade). O indicador de operação obrigatório para operações nacionais onerosas nesse item é o 100301 (domicílio principal do adquirente), combinado com CST 000 e cClassTrib 000001.

2. Posso testar a configuração em lote da Org API sem pagar mensalidade?

Sim. No Plano Free da Notaas, você pode gerar até 3 Organization Tokens e provisionar até 5 projetos (CNPJs) simultâneos gratuitamente em Homologação, além de contar com 1 CNPJ em Produção real com 20 notas fiscais gratuitas por mês, sem exigir cartão de crédito. Para operações multi-CNPJ em produção, o Plano Dev (R$ 99/mês) contempla até 3 CNPJs em produção e o Plano SaaS Pro (R$ 249/mês) libera CNPJs ilimitados em produção com 2.500 notas/mês inclusas.

3. O que acontece se um CNPJ do meu ERP prestar mais de um tipo de serviço (ex.: 010501 e 170601)?

Você deve configurar nos defaults do projeto (PATCH /api/v1/org/projects/{id}) a tupla correspondente ao serviço que representa 90% do volume de faturamento daquele CNPJ. Quando ele emitir uma nota de um serviço secundário, basta informar o objeto ibscbs no payload daquela requisição POST /api/v1/emitir, que terá prioridade sobre o default cadastrado no projeto.

Parametrize seus CNPJs para a Reforma Tributária em Minutos

Não espere o lote de faturamento do dia 1º travar com erro E363 ou E637 para correr atrás das 11.380 linhas do Anexo VIII da Receita Federal. Crie sua conta gratuita na Notaas, teste a parametrização via Org API em homologação para até 5 CNPJs e emita até 20 notas fiscais por mês em produção real sem custo:

👉 Criar Conta Gratuita na Notaas (20 Notas/Mês em Produção + 5 CNPJs em Homologação)
👉 Explorar a Referência da Org API na Documentação Oficial