Since January 5, 2026, validation rule UB12-10 is in effect, and NF-e issued by standard-regime companies in Brazil must carry the new IBS and CBS fields — including the cClassTrib. In short: trying to issue a fiscal document without the cClassTrib table loaded in your ERP is now a real rejection risk. If your company runs Protheus, TOTVS centralizes these codes in the Tax Configurator (FISA170), and importing the official table is straightforward when done in the right order.
This practical guide covers the complete step-by-step process to import the cClassTrib table in Protheus, the technical prerequisites that commonly block the operation, and the most frequent mistakes that end up triggering SEFAZ rejection.
What cClassTrib is and why it became mandatory
The cClassTrib (Tax Classification Code) was created for the new IBS (Tax on Goods and Services) and CBS (Contribution on Goods and Services) assessment model and is defined in Technical Note RT 2025.002, published on the national NF-e portal. It does not describe the product itself — it signals to the tax authority which set of tax rules applies to that transaction, under Complementary Law 214/2025.
The cClassTrib works alongside the CST (Tax Situation Code) for IBS/CBS — a separate table from PIS/COFINS. Simplified: the CST indicates the general situation (taxed, exempt, reduced rate) and the cClassTrib details the classification, usually reusing the first digits of the CST. This is why correct classification can no longer rely on NCM alone.
Prerequisites: what to check before importing
Before opening the Tax Configurator, ensure the environment is ready. Skipping this step is the number one cause of "cClassTrib table not showing in Protheus":
- System version: release 12.1.2410 or higher is mandatory. Earlier versions do not include the IBS/CBS structures.
- Data dictionary updated: run UPDDISTR so the new IBS/CBS tables and fields are available in the environment.
- Correct module: the register is in Livros Fiscais (SIGAFIS).
- Official file in hand: download the table directly from the national NF-e portal, always in the latest version of Technical Note RT 2025.002 — codes are revised periodically throughout the transition (2026–2032).
If you are still in the release update phase, read our Protheus version migration guide first — it is the prerequisite that unlocks everything else.
Step by step: importing the cClassTrib table in Protheus
1. Download the official table
On the national NF-e portal, locate the IBS and CBS Tax Classification Code table and download it. The file is usually provided in .xlsx format (Excel).
2. Convert the file to CSV
Protheus processes .CSV files exclusively. Open the spreadsheet, use Save As and select the CSV type. The most critical point is the header: the system requires exactly four columns with these exact names:
- CST-IBS/CBS
- Descrição CST-IBS/CBS
- cClassTrib
- Descrição cClassTrib
If any of these names differ, Protheus will display an alert and will not perform the import. Also verify the separator (comma or semicolon) according to your environment settings.
3. Access the Tax Configurator (FISA170)
In the Livros Fiscais (SIGAFIS) module, follow this path:
4. Import and validate
Use the import option on the screen, point to the prepared CSV file and confirm. After loading, verify that the codes are listed correctly on the registration screen. With the table available, the next step — what truly ensures compliance — is linking each item to the appropriate cClassTrib in the fiscal rules.
Setting up your full fiscal environment for the Tax Reform? Also see how to prepare Split Payment in Protheus and how to migrate safely from TES to the Tax Configurator.
The most common mistakes (and how to avoid them)
- Header out of pattern: any divergence in column names blocks the import. Standardize before uploading the file.
- File still in .xlsx: Protheus only reads .CSV. Converting is mandatory, not optional.
- Outdated dictionary: without UPDDISTR, the "Tabela cClassTrib – IBS/CBS" option may simply not appear.
- Generic classification "just to avoid rejection": filling in any cClassTrib value to release the invoice creates fiscal inconsistency and may compromise credits from 2027. Classification is item by item.
- Rejection 1065: generally indicates that the cClassTrib requires the Regular Taxation group and it was not configured.
How Vanquish Code can help
Vanquish Code is a full-service IT company specializing in Protheus ERP with strong expertise in Tax Reform fiscal compliance. Our approach combines deep technical Protheus knowledge with your business' tax requirements:
- Free environment diagnosis: we check version, dictionary, and Tax Configurator readiness.
- cClassTrib import and parametrization: official table load and fiscal rule linking per item/transaction.
- Pre-go-live homologation: test NF-e issuance to validate the XML and anticipate rejections.
- Ongoing fiscal support: monitoring of new table versions throughout the entire transition period.
Conclusion
Importing the cClassTrib table in Protheus is a straightforward process when the environment is updated and the file is in the right format. The real challenge — what separates compliant companies from those accumulating rejections — lies in the correct per-item classification under LC 214/2025. The sooner this structure is homologated, the lower the risk of halting invoicing due to a rejected document.
Vanquish Code handles this process end-to-end: from the free diagnosis to complete fiscal parametrization, with homologation before go-live.
