Pular para o conteúdo
TRILHA TESOURARIA · ABERTA

As tabelas oficiais da reforma tributária, consultadas pelo Claude na fonte e com a data da cópia.

A Receita Federal publicou no GitHub as tabelas da reforma tributária (CBS, IBS e Imposto Seletivo), mas elas vêm em SQL, para quem sobe a calculadora em Java. A Consulta da Reforma embute essas tabelas, byte a byte, numa skill: você pergunta ao Claude qual cClassTrib, CST, redução ou anexo se aplica, e ele responde pela tabela oficial, com a data da cópia em toda resposta. É consulta de tabela, não parecer tributário.

Como instalar Dar uma estrela no GitHub Grátis e aberta · Apache-2.0
python scripts/consultar.py cclasstrib 200028 --data 2027-03-10
Consulta de tabela oficial da Receita Federal (calculadora-rtc, MIT). Não é parecer tributário.
Cópia das tabelas de 18/11/2026 (commit 8c538c9b de 22/10/2026, base V0059).
Data consultada: 10/03/2027.
cClassTrib: 200028 (grupo CBS/IBS)
Descrição: Fornecimento dos serviços de educação (Anexo II)
CST: 200 (Alíquota reduzida)
Redução: CBS 60%; IBSUF 60%; IBSMun 60%
Fundamentação: Art. 129 LIVRO I DO IMPOSTO SOBRE BENS E SERVIÇOS (IBS) E DA CONTRIBUIÇÃO SOCIAL SOBRE BENS E SERVIÇOS (CBS) TÍTULO IV DOS REGIMES DIFERENCIADOS DO IBS E DA CBS CAPÍTULO III DA REDUÇÃO EM SESSENTA POR CENTO DAS ALÍQUOTAS DO IBS E DA CBS Seção II Dos Serviços de Educação
Vigência: desde 01/01/2026, sem fim

saída real do motor, num arquivo de teste do repositório.

120

testes automatizados no motor

61

arquivos oficiais da Receita embutidos, conferidos por sha256

60

dias de cópia: acima disso, a resposta avisa que a tabela pode estar velha

Quem emite nota na reforma precisa saber a cClassTrib, o CST e a redução de cada item, e a resposta está espalhada entre lei complementar, nota técnica e planilha. Perguntar a um chat sem a tabela dá uma resposta confiante que ninguém consegue conferir.

A Receita abriu as tabelas no GitHub, mas em SQL, feitas para a calculadora em Java: para quem não mexe com banco de dados, elas continuam fora de alcance.

Como funciona

  1. 1 Confere. Na primeira consulta, o motor confere cada arquivo da cópia contra o manifesto e monta o banco das tabelas na pasta temporária.
  2. 2 Consulta. Responde por comandos fixos (cClassTrib, alíquota de referência, NCM, NBS, vínculo, Simples Nacional e busca por palavra), sem SQL livre e sem completar com memória o que a tabela não traz.
  3. 3 Data. Toda resposta abre dizendo que é consulta de tabela oficial e de quando é a cópia, e avisa quando ela está velha.

As duas formas de resolver isso

De onde vem a resposta

Perguntar a um chat sem a tabela
da memória do modelo, sem fonte
Consulta da Reforma (nós)
da tabela oficial da Receita, embutida

Quando a tabela não define o valor

Perguntar a um chat sem a tabela
costuma inventar um número
Consulta da Reforma (nós)
diz que não está definido, nunca troca por zero

Data da informação

Perguntar a um chat sem a tabela
não diz
Consulta da Reforma (nós)
a data da cópia em toda resposta

Custo

Perguntar a um chat sem a tabela
a assinatura do chat
Consulta da Reforma (nós)
grátis e aberto

O dado é seu

O que sai da sua máquina, em cada caminho.

A skill não pede nem lê arquivo seu: a entrada é um código ou uma palavra que você digita, e o motor não faz chamada de rede. No terminal, a consulta roda no seu computador. No Claude Code, no Cowork ou numa conversa do Claude, o seu pedido, a saída do motor e a resposta vão para a Anthropic, como qualquer conversa.

O que vem

A prova que eu tenho hoje

As consultas foram conferidas contra os exemplos e os testes que a própria Receita publicou junto com a calculadora. A prova é da tabela, não de um caso real: a ferramenta não sabe nada da sua operação além do código que você digita.

Onde isso ainda não chega.

  • Não calcula imposto: base, valor e total são da calculadora oficial da Receita, não desta skill.
  • Não é parecer tributário. A decisão sobre o enquadramento é do profissional responsável.
  • A base oficial só traz a alíquota de referência de 2026, e as alíquotas do Imposto Seletivo ainda não foram fixadas em lei: a resposta diz isso em vez de inventar um número.
  • A cópia envelhece quando a Receita publica tabela nova: a data sai em toda resposta, e uma versão nova da skill traz a cópia nova.

É para você?

É para você se

  • Quem emite nota ou parametriza ERP e precisa da cClassTrib, do CST e da redução de cada item na reforma.
  • Quem quer usar o Claude para isso com a tabela oficial na mão, e não com a memória do modelo.

Não é para você se

  • Quem precisa do valor do imposto calculado: isso é a calculadora oficial da Receita.
  • Quem precisa de parecer sobre um caso concreto: isso é o profissional responsável.

Antes de instalar: o que você precisa

  • Python 3.10 ou mais no computador, com o SQLite que vem junto no Python oficial.
  • Para usar como skill: Claude Code, o Cowork do Claude Desktop ou uma conversa do Claude com a skill enviada em zip. Direto no terminal funciona sem Claude nenhum.

Como instalar

Quatro caminhos. A skill não lê arquivo seu: a entrada é o código que você digita, e o motor não faz chamada de rede.

  1. Terminal, sem IA. Baixe o repositório e rode o motor com Python. A consulta roda no seu computador.
  2. Claude Code. Instale o plugin pelo marketplace do repositório. Em sessão local, o motor roda no seu computador; o seu pedido, a saída do motor e a resposta vão para a Anthropic.
  3. Cowork. Adicione o marketplace do repositório. O trabalho roda na nuvem da Anthropic, e o pedido e a resposta vão para lá.
  4. Conversa do claude.ai. Suba o zip da skill. O trabalho roda na nuvem da Anthropic, e o pedido e a resposta vão para lá.

Passo a passo de cada um, com os comandos: como instalar uma skill no Claude. O código, o README e as issues estão no GitHub (Apache-2.0).

Me avise da próxima ferramenta

Quando a próxima ferramenta abrir, mandamos um e-mail. Sem data marcada.

Sem spam. Descadastro em 1 clique.

Perguntas frequentes

Isso substitui o contador ou o advogado tributarista?

Não. É consulta de tabela oficial: diz o que a tabela da Receita traz para um código. O enquadramento do seu caso é decisão do profissional responsável.

Ele calcula quanto eu vou pagar?

Não. A skill só consulta tabela. Para o cálculo, use a calculadora oficial que a Receita publicou.

De quando são as tabelas?

Da cópia indicada no começo de toda resposta, com o commit da Receita de onde ela veio. Quando a cópia passa de 60 dias, a resposta avisa.

Algum dado meu sai do computador?

A skill não lê arquivo seu: a entrada é o código que você digita, e o motor não faz chamada de rede. Numa conversa com o Claude, o pedido e a resposta vão para a Anthropic, como qualquer conversa.