IBSCBS no item da NF-e: como ler grupos, códigos e valores

IBSCBS, em det/imposto, reúne as informações de IBS e CBS de cada item da NF-e/NFC-e. O grupo identifica a situação tributária e organiza os valores conforme o contexto. Não é um total da nota nem um grupo com uma única fórmula para todas as situações.

O caminho desta página é /nfeProc/NFe/infNFe/det/imposto/IBSCBS.

A estrutura começa por dois códigos

O XSD define IBSCBS como TTribNFe. Dentro dele, CST tem três dígitos e cClassTrib tem seis, ambos obrigatórios quando o grupo existe. indDoacao é opcional. CST caracteriza a situação; cClassTrib detalha a classificação, com os três primeiros dígitos correspondentes ao CST. É necessário consultar também vigência e permissões por modelo. Uma sequência numérica com o tamanho certo pode não existir ou ser incompatível. XSD, IT v1.70, pp. 4–7.

Quais grupos podem aparecer juntos

Há uma escolha opcional entre gIBSCBS (base e tributação), gIBSCBSMono (monofasia), gTransfCred (transferência) e gAjusteCompet (ajuste de período). Esses quatro não se acumulam na mesma escolha. Em seguida pode vir gEstornoCred. Por fim há outra escolha opcional: gCredPresOper ou gCredPresIBSZFM. Logo, estorno e crédito são irmãos do cálculo, não filhos de gCBS; as duas formas de crédito não são cumuladas nesse item.

Dentro de gIBSCBS, a sequência essencial é base vBC, IBS estadual gIBSUF, IBS municipal gIBSMun, valor do IBS vIBS e CBS gCBS; os grupos condicionais gTribRegular e gTribCompraGov vêm depois. gTribRegular é um filho específico, e não sinônimo do grupo inteiro gIBSCBS. XSD, TTribNFe e TCIBS_NFe.

Quando uma estrutura opcional se torna exigida

minOccurs=0 em IBSCBS é opcionalidade estrutural, não uma dispensa fiscal. Na redação da NT v1.52, UB12-10 documenta 1115 para a falta de IBSCBS. A observação não riscada prevê homologação para emissão a partir de 01/07/2026 com CRT 3 (Regime Normal), e implementação futura para produção. As antigas observações de produção 03/08/2026 e 04/01/2027 estão riscadas, portanto não sustentam uma exigência ativa. A regra excepciona devolução (finNFe = 4) ou complementar (finNFe = 2) que referenciem NF-e emitida antes de 2027, e produto com cProdANP presente na tabela de combustíveis monofásicos. O ano 2026 da primeira exceção foi riscado e substituído por 2027. Essas condições dizem respeito à regra de ausência, sem dispensar as validações dos dados quando informados; já UB13-20/30 tratam da presença ou falta de gIBSCBS segundo ind_gIBSCBS do CST. A exceção de UB13-30 para tpNFDebito=07, perda em estoque, impede aplicar a exigência sem olhar o documento. Grupos de transferência, ajuste e crédito têm controles distintos. Identifique código, modelo, finalidade e regra antes de incluir um grupo. NT, pp. 40–41 e 65–67.

Como conferir uma integração

Siga o item identificado por det/@nItem: confira os dois códigos e a linha da tabela válida, depois o grupo escolhido e seus filhos. Compare valores monetários, percentuais, base, parcelas condicionais e totalizadores do mesmo tributo. Se a rejeição for 1020/1023, investigue existência dos códigos; 1024, vínculo entre os dois; 1025, modelo permitido; 1021/1022, grupo padrão vedado ou ausente. Não altere a classificação só para satisfazer uma regra: confirme o parâmetro fiscal e corrija o mapeamento correspondente. NT, pp. 40–41.

A árvore apresentada não é um XML completo: IBSCBS → CST + cClassTrib + escolha de cálculo/ajuste + estorno opcional + escolha de crédito. Um XML completo exigiria escolher códigos e valores de uma operação; cada grupo específico deve ser validado no seu contexto.

Versão técnica e efeito fiscal

O XSD define a estrutura, a NT descreve as validações e as tabelas informam códigos e indicadores; nenhum desses documentos, sozinho, concede tratamento tributário. O IT 2025.002 v1.70, p. 3, prevê implantação das tabelas até 16/10/2026 nos dois ambientes. O aviso ENCAT de 05/10/2026 adiou as mudanças das NTs com homologação prevista para 05/10 para 26/10 em homologação e 16/11 em produção. Esses marcos não suspendem todas as regras anteriores nem antecipam direito material. Em 14/10/2026, as datas novas ainda eram futuras. IT v1.70, aviso ENCAT.

Campos relacionados

• Código de Situação Tributária de IBS e CBS — /nfeProc/NFe/infNFe/det/imposto/IBSCBS/CST.