Editorial Fisacorp
On November 9, 2026, Brazil's Federal Revenue Service (Receita Federal) announced version 2.0 of the APIs used to query the assessed debits and credits of the Contribution on Goods and Services (CBS), the federal tax created by Brazil's consumption tax reform. According to the agency, the new version has been available since October 28 and is the first step in a series of services expected to arrive later in November. For companies that rely on ERPs, tax systems and integrations with their accountants, the news shows where CBS data will flow from now on.
What the Receita Federal released
According to the Receita Federal announcement, the version 2.0 APIs are available in two environments: Restricted Production, intended for testing, and Beta Production. The main points are:
- Debit queries: show the origin of the debit, the reference tax document, the issue, registration and update dates, and the amounts by status, such as suspended, extinguished or outstanding.
- Credit queries: return the assessed amounts, the portion already appropriated (released for use), the portion still to be appropriated, and the used and unused portions.
- Same base as the portal: the data comes from the same base that feeds the Minha Apuração Assistida de CBS (assisted CBS assessment) service, which keeps both queries in sync.
- Incremental queries: according to Convergência Digital, the new version can return only the records that are new or changed since the last query, instead of the full history.
A new credential is mandatory
To use the APIs, the taxpayer or its digital proxy must generate a key through the "Gerar Credencial de Acesso" (Generate Access Credential) service, available on the Receita Federal services portal and on the Consumption Taxation portal (Beta). Anyone who already had a key must cancel it and generate a new one. In practice, integrations set up with the previous version will not work with 2.0 until the credential is replaced.
What comes next
The Receita Federal says new CBS assessment services will be released via API in November. Convergência Digital reports that the schedule published in September provided, for early in the month, queries on payments and collections made by the acquirer and, for the end of the month, the issuance of DARF payment slips under the acquirer-collection and taxpayer-payment modes. Since dates may change, it is worth confirming each release in the official technical documentation before putting a workflow into use.
Who this matters to
The change is mainly relevant to three groups:
- companies that already follow their CBS assessment and want to bring that data into their own systems, instead of only checking it on the portal;
- accounting firms and digital proxies that serve multiple CNPJs (company tax IDs);
- ERP and tax software vendors, who need to adjust credentials and integration routines.
Each company's obligations depend on its tax regime. An article by Carmelitas Contabilidade notes that the release creates no new rate and does not change the general calendar, and that the query "does not replace the company's accounting and tax controls and checks" (translated from Portuguese).
What companies should do now
- Check with your accountant whether the integration makes sense for your tax regime and document volume.
- Replace the old credential, store the new one securely and limit who has access to it.
- Test in Restricted Production before using the data in real routines.
- Record the date of the last query to take advantage of incremental mode and be able to reprocess failures.
- Reconcile debits and credits with the invoices issued and received, and document any discrepancies.
- Follow the upcoming November releases before relying on them for payments.
Where document management comes in
CBS reconciliation depends on quickly finding the tax document behind each debit or credit. EnvSense, Fisacorp's document management solution, organizes folders and permissions by team and project, automates workflows with real-time status for each document, and provides integration with existing systems. It does not replace the ERP, the Receita Federal APIs or accounting advice, but it helps keep invoices and receipts accessible for review. If you would like to assess this workflow in your company, talk to the Fisacorp team.
References
- Receita Federal — Receita Federal releases access to the new CBS assessment APIs (11/09/2026, in Portuguese)
- Receita Federal — Technical documentation for the CBS assessment APIs (in Portuguese)
- Convergência Digital — Tax Reform: Receita releases new APIs to query CBS assessment (11/10/2026, in Portuguese)
- CRCMG — Receita Federal releases access to the new CBS assessment APIs (11/10/2026, in Portuguese)
- Carmelitas Contabilidade — Receita Federal releases new CBS APIs (11/10/2026, in Portuguese)
Sources consulted on November 11, 2026.