Receita libera APIs 2.0 da CBS e muda integração de débitos e créditos

Nova arquitetura permite consultas incrementais, exige renovação das credenciais e prepara a automação da apuração da CBS.

Atualizado em 10 de novembro de 2026

A Receita Federal liberou as versões 2.0 das APIs de consulta de débitos e créditos da CBS, ampliando a integração entre os sistemas das empresas e a plataforma de apuração do novo tributo. A principal mudança está no modelo de consulta: em vez de devolver repetidamente toda a base disponível, as novas APIs podem retornar apenas as alterações ocorridas desde a consulta anterior.

Embora a Receita tenha divulgado oficialmente a novidade em 9 de novembro, as APIs estão disponíveis desde 28 de outubro de 2026 nos ambientes de Produção Restrita, destinado aos testes, e Produção Beta.

Além disso, quem já possuía credenciais para acessar os serviços precisará gerar uma nova chave. Portanto, empresas e desenvolvedores não devem presumir que uma integração anterior continuará funcionando sem ajustes.

A atualização representa mais um passo na construção da infraestrutura tecnológica que sustentará a CBS quando o tributo entrar em sua próxima fase em 2027.

01O que mudou nas APIs da CBS?

A principal novidade da versão 2.0 é a possibilidade de realizar consultas incrementais.

Na prática, o sistema passa a informar as novas movimentações e as alterações ocorridas em registros já consultados anteriormente. Dessa forma, uma integração não precisa recuperar toda a massa de débitos e créditos sempre que quiser atualizar sua base.

Segundo a Receita, o modelo foi desenvolvido após sugestões de profissionais contábeis, empresas de software e contribuintes com grande volume de transações.

Com isso, a nova arquitetura busca reduzir:

• tempo de processamento;
• consumo de recursos computacionais;
• volume de informações transferidas;
• tamanho dos arquivos armazenados.

Ao mesmo tempo, a integração tende a ficar mais eficiente para empresas que processam grandes quantidades de documentos fiscais.

02O que significa uma consulta incremental?

Um exemplo ajuda a entender.

Imagine que uma empresa consulte sua apuração e receba informações referentes a 50 mil débitos e créditos.

Depois, apenas 300 registros sofrem alterações.

Em uma consulta tradicional, o sistema poderia precisar recuperar novamente uma parcela muito maior da base. Já no modelo incremental, a integração pode trabalhar apenas com as novidades e atualizações ocorridas desde a consulta anterior.

Portanto, o ganho não está necessariamente na quantidade de informações disponíveis.

Ele está na forma como os sistemas sincronizam essas informações.

Essa diferença ganha importância para grandes contribuintes, ERPs, plataformas fiscais e softwares contábeis que precisam atualizar dados várias vezes ao longo do processo de apuração.

03API de débitos traz origem e situação do valor

A API de consulta de débitos fornece informações relacionadas à origem do débito de CBS.

Entre os dados retornados estão:

• documento fiscal de referência;
• data de emissão;
• data de registro;
• data de atualização;
• valor do tributo;
• situação do débito.

A Receita menciona, por exemplo, estados como suspenso, extinto ou devedor.

Assim, a integração pode permitir que o sistema empresarial acompanhe não apenas o valor originalmente apurado, mas também mudanças posteriores na situação daquele débito.

Isso aproxima o ERP ou sistema fiscal da base utilizada pela própria Receita.

04API de créditos mostra o que pode ou não ser utilizado

A versão voltada aos créditos também traz informações mais detalhadas sobre a apuração.

A consulta permite visualizar os valores de crédito e sua situação, incluindo:

• parcela apropriada;
• parcela a apropriar;
• parcela utilizada;
• parcela não utilizada.

A parcela apropriada corresponde ao valor liberado para utilização dentro das regras aplicáveis.

Portanto, a existência de um crédito na base não significa automaticamente que todo aquele valor esteja disponível para compensar débitos naquele momento.

Essa distinção tende a ser relevante na rotina fiscal.

Em um sistema baseado em não cumulatividade, acompanhar o ciclo do crédito — da identificação até sua utilização — passa a ser tão importante quanto calcular o débito da operação.

05Os dados vêm da mesma base da Apuração Assistida

Outro ponto importante é a origem das informações.

Segundo a Receita, as APIs consultam a mesma base que alimenta o serviço Minha Apuração Assistida de CBS. Dessa forma, os dados acessados pelo sistema empresarial ficam sincronizados com o processamento dos documentos fiscais e eventos utilizado pelo ambiente da Receita.

Isso revela uma mudança importante na arquitetura do novo sistema tributário.

A apuração deixa de depender exclusivamente de uma conta construída internamente pela empresa e posteriormente informada ao Fisco.

A Receita está desenvolvendo uma infraestrutura em que documentos fiscais, eventos, débitos, créditos e pagamentos alimentam uma base de apuração que também pode ser consultada pelo contribuinte.

Nesse cenário, a conciliação entre ERP e base fiscal ganha ainda mais importância.

06ERP e Receita passam a trabalhar com a mesma referência de dados

A nova API não transforma o ERP em sistema da Receita.

Entretanto, reduz a distância entre as duas bases.

A empresa continuará registrando vendas, compras e demais operações em seus próprios sistemas.

Ao mesmo tempo, poderá consultar a posição reconhecida na plataforma de apuração da CBS.

Consequentemente, surge uma possibilidade de conciliação mais frequente:

o que a empresa calculou internamente versus o que a plataforma da Receita reconheceu.

Se houver diferença, a organização poderá investigar o problema antes do fechamento.

Por exemplo, uma divergência pode decorrer de:

• documento fiscal ausente;
• evento ainda não processado;
• classificação incorreta;
• crédito ainda não apropriado;
• alteração posterior do documento;
• cancelamento;
• diferença de valor;
• problema de integração.

Assim, a API não elimina a necessidade de conciliação.

Na prática, ela fornece mais informações para realizá-la.

07Empresas que já possuem chave precisam gerar uma nova

A atualização exige atenção imediata das equipes de tecnologia.

Para utilizar as APIs, o contribuinte ou seu procurador digital deve gerar uma chave por meio do serviço Gerar Credencial de Acesso, disponível no Portal de Serviços da Receita Federal ou no ambiente Tributação sobre Consumo Beta.

Além disso, a Receita determinou que contribuintes que já possuíam chaves anteriores precisam cancelá-las e gerar novas credenciais para acessar a versão atual.

Portanto, testar apenas o endpoint não é suficiente.

É necessário verificar também autenticação, autorização e renovação das credenciais utilizadas pelo sistema.

08Produção Beta não é o mesmo que ambiente definitivo de 2027

As APIs estão disponíveis em dois ambientes:

Produção Restrita: utilizada para testes;

Produção Beta: ambiente disponibilizado para operação e validação da nova infraestrutura.

Essa distinção deve ser preservada.

A existência da API em Produção Beta não significa que toda a operação definitiva da CBS para 2027 esteja encerrada ou congelada.

A plataforma continua evoluindo.

Inclusive, a própria Receita já anunciou novos serviços para novembro.

Por isso, empresas devem tratar esse período como uma oportunidade para validar integrações antes da próxima etapa da Reforma Tributária.

09Novembro terá novas APIs

O cronograma divulgado pela Receita não termina nas consultas de débitos e créditos.

A documentação publicada em setembro previa novas funcionalidades em três etapas.

No primeiro grupo estavam:

• consulta de débitos;
• consulta de créditos.

Esses serviços agora estão disponíveis na versão 2.0.

Para o início de novembro, o cronograma previa ainda:

• consulta de pagamentos;
• consulta de recolhimentos realizados pelo adquirente.

Já para o final de novembro estão previstos:

• emissão de DARF para Recolhimento pelo Adquirente, chamado RAD;
• emissão de DARF para Pagamento do Contribuinte, ou PCONT.

Portanto, a integração tende a avançar da simples consulta da apuração para outras etapas do ciclo financeiro do tributo.

10O que é o recolhimento pelo adquirente?

A inclusão de uma API específica para recolhimentos realizados pelo adquirente mostra que a infraestrutura está sendo preparada para diferentes formas de extinção dos débitos da CBS.

Nesse cenário, será necessário identificar não apenas quanto a empresa deve, mas também como determinado débito foi pago ou extinto.

Isso torna o status do débito uma informação operacional relevante.

Um valor originalmente classificado como devedor pode, posteriormente, assumir outra situação depois de pagamento, recolhimento, suspensão ou outro evento previsto no sistema.

Consequentemente, manter a base empresarial sincronizada passa a exigir acompanhamento contínuo das atualizações.

11A apuração tende a ficar mais dinâmica

No modelo tradicional, muitas empresas trabalham com uma lógica de fechamento bastante concentrada no fim do período.

A arquitetura que está sendo desenvolvida para a CBS aponta para uma operação mais dinâmica.

Documentos fiscais alimentam a base.

Eventos podem alterar esses documentos.

Créditos passam por estados de apropriação e utilização.

Débitos também mudam de situação.

Além disso, pagamentos e recolhimentos serão incorporados às consultas.

Por isso, o fechamento tende a depender de uma sequência maior de eventos digitais.

A API incremental é coerente com esse modelo, pois permite acompanhar as alterações sem recuperar repetidamente toda a base.

12A atualização não muda a legislação da CBS

É importante separar tecnologia de regra tributária.

A versão 2.0 das APIs não altera alíquotas, hipóteses de incidência ou regras legais de crédito da CBS.

A novidade trata da forma como os sistemas consultam e recebem os dados da apuração.

Portanto, não nasce um novo benefício fiscal nem uma nova obrigação material apenas porque a API foi atualizada.

O impacto é tecnológico e operacional.

Entretanto, esse impacto pode ser relevante porque a apuração do novo tributo dependerá de uma infraestrutura digital muito mais integrada.

13O que muda para empresas que não usam integração por API?

Empresas que não realizam integração direta não precisam necessariamente desenvolver uma API própria.

A Receita também disponibiliza a Minha Apuração Assistida de CBS em seu ambiente digital, e os dados consultados pelas APIs vêm da mesma base utilizada nesse serviço.

Assim, existem diferentes formas de acessar as informações.

Para operações menores, a interface do portal pode atender parte das necessidades.

Já empresas com milhares ou milhões de documentos tendem a depender mais de integração sistêmica.

Nesse caso, consultar manualmente cada movimentação seria pouco eficiente.

14Software houses precisam revisar integrações agora

A própria Receita recomendou atenção das empresas desenvolvedoras de software e dos contribuintes que operam integrações sistêmicas.

A orientação é consultar a documentação técnica e planejar as adequações necessárias conforme os serviços forem sendo disponibilizados.

Para software houses, alguns pontos merecem prioridade:

• autenticação com as novas credenciais;
• implementação das consultas incrementais;
• tratamento dos estados de débitos;
• tratamento das situações dos créditos;
• controle do último ponto consultado;
• atualização de registros já existentes;
• logs de sincronização;
• tratamento de erros e indisponibilidades;
• reconciliação com a base interna.

Além disso, a arquitetura precisa estar preparada para incorporar os novos serviços previstos para novembro.

15O risco está em tratar API como simples importação de arquivo

Uma integração fiscal robusta não deveria apenas receber dados.

Ela precisa saber o que fazer quando esses dados mudam.

Por exemplo, imagine que um débito já registrado no ERP apareça posteriormente com situação diferente na Receita.

O sistema precisa identificar a alteração sem criar um segundo registro.

Da mesma forma, um crédito que antes estava “a apropriar” pode posteriormente ser liberado.

Consequentemente, a versão 2.0 exige uma lógica de sincronização mais sofisticada do que simplesmente importar uma lista.

Esse é um dos principais efeitos das consultas incrementais.

16A Receita passa a expor mais informações sobre sua própria visão da apuração

Existe ainda um efeito de governança.

Ao disponibilizar APIs sincronizadas com a mesma base da Apuração Assistida, a Receita permite que empresas consultem programaticamente informações que refletem como o sistema fiscal está processando suas operações.

Isso cria uma camada adicional de evidência.

A empresa poderá comparar:

ERP: o que foi registrado internamente;

documentos fiscais: o que foi transmitido;

API da CBS: o que a base de apuração reconheceu;

contabilidade: como a operação foi contabilizada;

financeiro: o que efetivamente foi pago ou recebido.

Quanto mais cedo essas quatro dimensões forem conciliadas, menor tende a ser o risco de descobrir divergências somente depois do fechamento.

17A API não substitui a qualidade dos dados de origem

Automação não corrige informação errada automaticamente.

Se um documento fiscal nasce com classificação incorreta, valor errado ou tratamento tributário inadequado, a integração poderá apenas transportar esse dado com mais velocidade.

Portanto, a atualização tecnológica aumenta a importância da governança de dados.

Empresas precisarão revisar:

• cadastro de produtos e serviços;
• NCM e NBS quando aplicáveis;
• classificação tributária;
• dados dos fornecedores;
• documentos de entrada;
• documentos de saída;
• eventos fiscais;
• regras de créditos;
• integrações entre sistemas.

Assim, a API melhora a comunicação entre plataformas, mas não substitui a qualidade da origem.

18O que empresas devem fazer agora?

A primeira ação é identificar se o ERP ou sistema fiscal utiliza diretamente as APIs da Receita.

Se utiliza, a empresa deve confirmar com o fornecedor se a versão 2.0 já foi implementada.

Depois, precisa verificar se as antigas credenciais foram substituídas.

Além disso, vale testar:

1. consulta de débitos;
2. consulta de créditos;
3. atualização incremental;
4. alteração de status;
5. sincronização com documentos fiscais;
6. conciliação com a Apuração Assistida.

Por fim, equipes técnicas devem acompanhar as próximas liberações previstas para novembro.

19A Reforma Tributária está virando integração de sistemas

Durante boa parte do debate sobre a Reforma Tributária, a atenção esteve concentrada em alíquotas e regras de crédito.

Entretanto, a implementação mostra outra dimensão do novo modelo.

A CBS também dependerá de infraestrutura tecnológica capaz de conectar documentos fiscais, eventos, apuração, créditos, débitos e pagamentos.

A versão 2.0 das APIs é mais um componente dessa arquitetura.

Ela permite consultas incrementais, aproxima ERP e base fiscal e prepara a inclusão de novos serviços ao longo de novembro.

Por isso, a principal mudança não é simplesmente “a Receita publicou uma API nova”.

A mudança é que a apuração da CBS começa a ganhar uma camada de integração contínua entre o sistema do contribuinte e a base utilizada pelo Fisco.

Para empresas, isso muda o critério de preparação para 2027.

Não basta saber calcular a CBS.

Também será necessário garantir que os sistemas consigam consultar, interpretar, reconciliar e atualizar os dados que sustentam essa apuração.

20Perguntas frequentes

Qual é a nova versão da API da CBS?

A Receita Federal liberou a versão 2.0 das APIs de consulta de débitos e créditos da CBS.

Quando as APIs foram liberadas?

As versões 2.0 estão disponíveis desde 28 de outubro de 2026, embora a Receita tenha publicado o comunicado oficial sobre a liberação em 9 de novembro.

O que mudou na versão 2.0?

A principal mudança é a consulta incremental, que permite recuperar novidades e alterações ocorridas desde consultas anteriores, reduzindo o volume de dados processados.

Preciso gerar uma nova credencial?

Sim. A Receita informou que contribuintes que já possuíam chaves precisam cancelar as anteriores e gerar novas credenciais para utilizar as APIs atuais.

A API mostra os créditos disponíveis?

Ela fornece informações sobre os créditos apurados, incluindo parcelas apropriadas, a apropriar, utilizadas e não utilizadas.

Os dados são diferentes da Minha Apuração Assistida?

A Receita informa que as APIs utilizam a mesma base que alimenta a Minha Apuração Assistida de CBS.

Existem novas APIs previstas para novembro?

Sim. O cronograma prevê consultas de pagamentos e recolhimentos realizados pelo adquirente, além de serviços de emissão de DARF para RAD e PCONT.

A versão 2.0 altera as regras tributárias da CBS?

Não. A atualização trata da integração tecnológica e da consulta aos dados da apuração. As regras materiais do tributo dependem da legislação e da regulamentação aplicáveis.

21Referências

Receita Federal — 9 de novembro de 2026. Comunicado oficial sobre a liberação das APIs 2.0 de consulta de débitos e créditos da CBS, ambientes disponíveis e necessidade de gerar novas credenciais.

Receita Federal — 14 de setembro de 2026. Documentação e cronograma das novas APIs, incluindo consultas incrementais, pagamentos, recolhimentos pelo adquirente e emissão de DARF.

Receita Federal — Plataforma da Reforma Tributária do Consumo. A Receita mantém a liberação das novas APIs entre as atualizações oficiais da implementação da CBS.