Receita Federal's CBS APIs v2 require new keys from existing users

Receita Federal's CBS APIs v2 require new keys from existing users

10 November 2026: Brazil's federal tax authority has opened version 2.0 of its APIs for assessing the CBS, the new federal consumption tax created by the tax reform, and taxpayers that already generated access keys must cancel them and create new ones to use it. A second notice told software integrators to update the XSD for the PGCC event before the DeRE beta environment changed on 11 November.

Not yet independently verified. Neither Receita Federal notice gives a deadline for regenerating keys or retiring earlier API versions, and neither says what changed in the PGCC schema. We will update this when it can be confirmed, and remove this note.

Incremental queries of debits and credits

Receita Federal says version 2.0, released on 28 October, lets systems query CBS debits and credits incrementally rather than pulling the full picture each time. The debit query returns the origin, the tax document behind each entry, the issue, registration and update dates, the tax amounts and a status such as suspended, extinguished or in debt. The credit query returns assessed amounts split into released, to be released, used and unused.

Both draw on the same base as Minha Apuração Assistida de CBS, the authority's assisted assessment service, so figures in an ERP or tax engine should match what a company sees there. The APIs are available in restricted production for testing and in production as a beta, and the authority says more CBS assessment services will follow during November.

Old keys stop being enough

Access keys come from the "Gerar Credencial de Acesso" service on the Receita Federal or consumo.tributos.gov.br portals. The notice is plain: taxpayers who already hold keys "precisarão cancelá-las e gerar novas chaves" to get access. Any integration built on the first version therefore needs a credentials change, not only a code change, and whoever owns the company's government portal access has to do it.

The DeRE beta and the PGCC schema

The second notice, from Receita Federal and the CGIBS, the committee that manages the IBS, announced an update to the production beta of the DeRE, the declaration for specific tax regimes, on 11 November at 7:00, without service interruption. Integrators had to update the XSD for the PGCC event before that deployment. The notice gives no download link and no further deadline.

Who has to act

Finance teams in Brazil should confirm with their ERP or tax engine supplier whether it calls the CBS assessment APIs, whether it has moved to version 2.0 and who regenerates the keys. Our sales tax software category lists 15 products and corporate tax software seven, though few state Brazilian CBS support on their listings. The technical documentation is published on the Receita Federal developer site.

Sources

• Receita Federal: Receita Federal libera acesso às novas APIs de apuração da CBS, 9 November 2026
• Receita Federal: Reforma Tributária, atualização do ambiente beta da DeRE, 10 November 2026
• Receita Federal: CBS assessment API documentation (read 2026-11-13), 13 November 2026