Configurar IBS e CBS (Reforma Tributária) na tributação
Desde 2026 toda nota fiscal precisa levar as informações de IBS e CBS, mesmo quando a operação não é tributada. Quem manda nessas informações é a regra de tributação: você define o CST e a Classificação Tributária (cClassTrib), e o Hap preenche as tags da NF-e a partir daí. Este guia mostra os dois caminhos para configurar — pela tela de Tributação de Impostos e direto pelo item da nota fiscal — e como deixar as operações de retorno e retorno simbólico com o CST 410, que é o correto para operação sem onerosidade.
Quando usar
Use quando a nota estiver saindo com IBS/CBS errado ou faltando, quando o contador pedir um CST específico (por exemplo 410 para retorno de armazém geral), ao cadastrar uma tributação nova ou ao revisar as regras existentes por causa da Reforma Tributária.
Antes de começar
- Acesso ao menu Impostos > Impostos > Tributação de Impostos.
- Saber qual CST e qual Classificação Tributária (cClassTrib) o seu contador determinou para a operação.
- Empresa com regime tributário preenchido no cadastro (Lucro Real, Presumido ou Simples).
O que é
IBS e CBS são os tributos criados pela Reforma Tributária (LC 214/2025). Desde 2026 toda nota fiscal eletrônica precisa levar o grupo de IBS/CBS no XML — inclusive quando a operação não é tributada. Nota sem essa informação é nota sujeita a rejeição e a autuação.
Duas informações comandam tudo o que sai no XML: o CST (a situação tributária, com 3 dígitos) e a Classificação Tributária, o cClassTrib (6 dígitos). Os três primeiros dígitos do cClassTrib são sempre iguais ao CST — por isso, no Hap, você escolhe a classificação e o CST é preenchido sozinho.
Quem define esses códigos é a regra de tributação (menu Impostos). O Hap escolhe a regra pela combinação de cliente, produto, natureza da operação, UF e NCM, e usa o que estiver configurado nela para montar as tags da nota.
Onde configurar
Existem dois caminhos, e os dois abrem a mesma tela de tributação. Use o que for mais prático no momento.
Caminho 1: pela tela de Tributação de Impostos
É o caminho para revisar várias regras de uma vez. Na busca do topo do sistema, digite "impos" e escolha Tributação de Impostos (Impostos > Impostos > Tributação de Impostos).
- 1
Na lista de tributações, localize a regra que quer ajustar. Vale conferir a coluna de CFOP para ter certeza de que é a operação certa (por exemplo 5906 / 6906 para retorno de armazém geral).
- 2
Clique na regra para abrir. Se a regra ainda não existe, use o botão de nova tributação.
- 3
Vá até a etapa Reforma Tributária (IBS/CBS) e siga a seção "Preenchendo os parâmetros" abaixo.
Caminho 2: pelo item da nota fiscal
É o caminho mais rápido quando você já está montando a nota e quer ver ou corrigir a tributação daquele item. Ao adicionar o produto, o Hap procura a regra sozinho e mostra o resultado no selo ao lado do título Item.
- 1
Selo verde Tributação encontrada: o Hap achou uma regra para esse item. Clique no selo para abrir o painel Por que essa tributação foi aplicada?, que mostra a regra escolhida, as concorrentes e o motivo da escolha.
- 2
Dentro desse painel, clique na regra para abri-la e editar — inclusive a parte de IBS/CBS. É a mesma tela do Caminho 1.
- 3
Selo laranja Tributação não encontrada: nenhuma regra atendeu a combinação de cliente, produto e operação. Clique no selo para já abrir o cadastro de uma tributação nova.
- 4
Botão + ao lado do selo: cadastra uma tributação nova a qualquer momento, mesmo quando já existe uma encontrada. Use quando precisar de uma regra mais específica (por exemplo, só para um cliente ou uma natureza de operação).
Preenchendo os parâmetros de IBS/CBS
Essa é a etapa Reforma Tributária (IBS/CBS) da tributação. É aqui que o CST e a Classificação da nota são definidos.
- 1
Ligue a chave Informar dados da Reforma Tributária (IBS/CBS)? Essa chave é obrigatória: enquanto ela estiver desligada, os campos ficam bloqueados e nada do que você preencher é gravado.
- 2
Ligue também Calcular IBS/CBS automaticamente? Nesse modo você informa apenas a Classificação e o motor de cálculo preenche CST, alíquotas e valores a partir das tabelas oficiais. É a forma mais segura de configurar.
- 3
Em Classificação IBS/CBS, escolha o código informado pelo seu contador. A lista vem da tabela oficial de cClassTrib.
- 4
Confira o campo CST IBS/CBS logo abaixo: ele é preenchido sozinho com os três primeiros dígitos da classificação. Se você escolheu 000001, o CST fica 000; se escolheu 410999, fica 410.
- 5
Deixe o Indicador de Doação desligado, a não ser que a operação seja realmente uma doação.
- 6
Antes de salvar, clique em Calcular/Validar IBS/CBS. Ele simula o cálculo e aponta qualquer inconsistência sem gravar nada.
- 7
Salve a tributação.
Como o Hap calcula a base do IBS e da CBS
Não há nada a configurar: a base segue a Nota Técnica 2025.002 e é uma só para o IBS da UF, o IBS do Município e a CBS. Vale para toda nota nova; nota já autorizada não muda.
| Soma | Subtrai |
|---|---|
| Valor dos produtos | Desconto incondicional |
| Frete, seguro e outras despesas | ICMS, DIFAL e FCP |
| Imposto de importação (II) | PIS e COFINS (e o ISS, em serviço) |
Na regra de tributação, a redução e o diferimento são percentuais do imposto, não pontos de alíquota. Os dois existem para a UF, para o Município e para a CBS (por exemplo, CBS - Redução da alíquota (%) e CBS - Diferimento (%)).
| Campo | O que significa | Exemplo |
|---|---|---|
| Redução da alíquota (%) | Quanto da alíquota é reduzido | 60 reduz a CBS de 0,90% para 0,36% |
| Diferimento (%) | A parte do imposto que fica diferida | 50 difere metade do imposto; a outra metade é exigida na nota |
Configuração para retorno e retorno simbólico
Retorno de mercadoria depositada e retorno simbólico (CFOP 5906 / 6906 e 5907 / 6907) não têm onerosidade: não há fato gerador de IBS e CBS. Configure assim:
- 1
Abra a regra de tributação daquele CFOP de retorno.
- 2
Ligue Informar dados da Reforma Tributária (IBS/CBS) e o cálculo automático.
- 3
Em Classificação IBS/CBS, escolha 410999. O CST passa para 410 (imunidade e não incidência).
- 4
Confirme que base, alíquotas e valores de IBS e CBS ficam zerados. A nota sai com o grupo de IBS/CBS presente, porém sem débito.
- 5
Não preencha a seção de Tributação Regular: o CST 410 não declara tributação regular.
Como conferir se ficou certo
- 1
Emita uma nota de teste em ambiente de homologação.
- 2
Abra o item da nota e clique no selo de tributação para ver qual regra foi aplicada.
- 3
Confira no XML o grupo IBSCBS: o CST e o cClassTrib têm que ser os que você configurou.
- 4
Em nota de venda normal, espere CST 000 com a classificação 000001 e os valores de IBS e CBS calculados.
- 5
Em nota de retorno, espere CST 410 com a classificação 410999, base preenchida e valores de IBS e CBS iguais a zero.
Problemas comuns
- A aba da Reforma Tributária está cinza e não deixa digitar: a chave Informar dados da Reforma Tributária (IBS/CBS) está desligada. Ligue a chave primeiro — sem ela nada do que você preencher é gravado.
- Os campos estão travados mesmo com a chave ligada: o Calcular IBS/CBS automaticamente está ligado. Nesse modo você informa só a Classificação e o motor preenche o resto. Se precisar digitar manualmente, desligue o cálculo automático.
- A classificação que o contador pediu não aparece na lista: a lista vem da tabela oficial de cClassTrib. Peça para a equipe Hap importar a tabela oficial atualizada — não precisa de nova versão do sistema.
- A nota continua saindo com CST 000: a regra usada na nota não é a que você editou. Abra o item da nota, clique no selo de tributação e confira em Por que essa tributação foi aplicada? qual regra foi escolhida.
- Retorno saindo com valor de IBS e CBS: a regra está com CST 000 (tributado integralmente). Troque para a classificação 410999 e zere base, alíquotas e valores.
- Erro de validação dizendo que os três primeiros dígitos do cClassTrib devem ser iguais ao CST: escolha a classificação pela lista em vez de digitar o CST na mão — assim os dois sempre casam.
- Nota sem nenhuma informação de IBS/CBS: nenhuma regra de tributação foi encontrada para a combinação de cliente, produto e operação. Cadastre a regra ou amplie o alcance de uma existente (Qualquer cliente / Qualquer produto).
