cClassTrib

Check if a cClassTrib (Código de Classificação Tributária do IBS e da CBS) exists in the official table, the code the field cClassTrib carries next to the CST-IBS/CBS.

• Options (IsValidClassTribOptions): cst is the CST-IBS/CBS the document carries, checked against the classification as well. Omit it to check the cClassTrib alone; a null or non-object options is read as none.
• Every classification belongs to exactly one CST-IBS/CBS, the first 3 digits of its code, and a document that carries a cClassTrib with another CST is rejected (rejection 1024, "Classificação Tributária do IBS e da CBS incompatível com o CST informado"). A cst that is given and is not the CST of the classification, whatever it is, makes the result false.
• Only the classifications in force count: the Informe Técnico 2025.002 excludes a classification by closing its validity (dFimVig), as v.1.60 did with 220001, 220002 and 220003, and those are rejected. 161 are in force in the version published on 23/06/2026.
• Accepts a string of bare digits with optional surrounding whitespace, or a non-negative safe integer. The field is numeric with 6 digits and has no mask, so any other string is rejected.
• A value narrower than 6 digits is left padded with zeros: 1, '1' and '000001' are all the code 000001. cst is read the same way, padded to 3 digits.
• Only the code list is bundled with this function, not the descriptions getClassTrib returns.

import { isValidClassTrib } from '@brazilian-utils/brazilian-utils';

isValidClassTrib('200001'); // true
isValidClassTrib(1); // true (padded to '000001')
isValidClassTrib('200001', { cst: '200' }); // true
isValidClassTrib('200001', { cst: '000' }); // false (the classification belongs to CST 200)
isValidClassTrib('999999'); // false
isValidClassTrib('220001'); // false (excluded by Informe Técnico 2025.002 v.1.60)
isValidClassTrib('c200001'); // false (not a documented form)

Look a cClassTrib up and get its official classification. The result is a ClassTrib record: { code, cst, name, description }.

• Same table and the same rules for reading the code as isValidClassTrib. Returns null when the code is unknown or the value is not in a documented form.
• The cst option exists only on isValidClassTrib, since the entry returned here already carries its CST as cst.
• cst is the CST-IBS/CBS the classification belongs to, the first 3 digits of its code; name is the short name the official table gives for display (the column "Nome cClassTrib") and description the situation it refers to (the column "Descrição cClassTrib").
• The legal wording the workbook also prints for each row (the article of Lei Complementar nº 214/2025 and of both regulations) is not shipped.

import { getClassTrib } from '@brazilian-utils/brazilian-utils';

getClassTrib('000002');
// {
//   code: '000002',
//   cst: '000',
//   name: 'Exploração de via',
//   description: 'Exploração de via, observado o art. 11 da Lei Complementar nº 214, de 2025.',
// }
getClassTrib(2)?.code; // '000002'
getClassTrib('999999'); // null
getClassTrib('220001'); // null (excluded by Informe Técnico 2025.002 v.1.60)
getClassTrib('c200001'); // null (not a documented form)

Source: the CST and cClassTrib sheets of the "Tabela de Classificação Tributária do IBS e CBS" workbook the Portal Nacional da NF-e publishes under "Documentos" > "Diversos" (the version published on 23/06/2026), divulged by the Informe Técnico 2025.002 (v.1.60), and the Nota Técnica 2025.002-RTC, fields UB13 and UB14.