A Receita Federal liberou as versões 2.0 das APIs de apuração da CBS para consulta de débitos e créditos. O anúncio saiu no portal do órgão em 9 de novembro de 2026. Na prática, empresas e escritórios contábeis passam a puxar os dados da apuração direto para o próprio sistema, sem depender de conferência manual tela por tela.

As interfaces funcionam nos ambientes de produção restrita, usado nos testes, e de produção beta. Além disso, a nova versão trabalha com consultas incrementais. Ou seja, cada chamada devolve apenas o que mudou desde a última leitura.
Com isso, cada consulta reduz o volume de dados trafegados e o tempo de processamento. Por isso, a mudança interessa principalmente a quem tem muitas notas e precisa conciliar valores todos os dias.
O que a versão 2.0 das APIs de apuração da CBS entrega
Primeiro, a consulta de débitos retorna a origem do débito e o documento fiscal de referência. Também informa as datas de emissão, de registro e de atualização, além dos valores do tributo conforme a situação, como suspenso, extinto ou devedor.
Depois, a consulta de créditos segue a mesma lógica. Ela mostra os valores apurados e separa a parcela apropriada, liberada para uso, da parcela a apropriar. Além disso, indica o que já foi utilizado e o que continua disponível.
Dessa forma, as informações vêm da mesma base que alimenta o serviço Minha Apuração Assistida de CBS, disponível no portal. Dessa forma, os dados ficam sincronizados com o processamento dos documentos fiscais e dos eventos.
Como obter a credencial de acesso
Para usar as APIs, o contribuinte ou o procurador digital precisa gerar uma chave de acesso. O serviço se chama Gerar Credencial de Acesso e fica nos portais Serviços da Receita Federal e Tributação sobre Consumo (Beta).
Além disso, quem já tinha chave precisa cancelar a antiga e emitir uma nova. Portanto, a integração existente pode parar de funcionar até a troca ser feita.
Documentação técnica e cronograma
A documentação para integrar sistemas fica em docs.receitafederal.gov.br/apuracao-cbs. O material descreve os endpoints, os formatos de resposta e as regras de cada consulta.
Além disso, o calendário merece leitura. A Receita informou que vai liberar novos serviços ligados à apuração da CBS ainda em novembro de 2026. Segundo a previsão divulgada em setembro, a consulta de pagamentos e de recolhimentos feitos pelo adquirente chega no início do mês. Já a emissão de DARF para recolhimento pelo adquirente e para pagamento do contribuinte fica para o fim do mês.
Por que as APIs de apuração da CBS importam agora
Primeiro, a reforma tributária do consumo substitui PIS e Cofins pela CBS e troca o ICMS pelo IBS. Durante a transição, os dois sistemas convivem. Nesse caso, a apuração deixa de ser um evento mensal e passa a exigir acompanhamento contínuo.
Quando o sistema puxa os dados direto da fonte, a equipe ganha tempo para analisar divergências. Além disso, a conciliação entre o que a empresa escriturou e o que a Receita apurou fica mais simples de demonstrar em uma fiscalização.
Além disso, há o efeito sobre o crédito. A separação entre parcela apropriada e parcela a apropriar ajuda a empresa a entender quanto já pode ser usado. Por isso, o controle de crédito deixa de depender de planilhas paralelas.
O que não mudou
Primeiro, a liberação das APIs não cria obrigação tributária nova. Ela também não altera, por si só, as regras de apuração em vigor. Ou seja, existe uma via de acesso aos mesmos dados, agora em formato adequado para integração.
Além disso, a fase atual ainda é de teste. Os documentos fiscais já exigem os campos de IBS e CBS desde 3 de agosto de 2026, com alíquota de teste de 1%. A cobrança em cheio deve começar em 2027, conforme o cronograma da reforma.
Como integrar as APIs de apuração da CBS na rotina
O primeiro passo é confirmar quem dentro da empresa pode gerar credenciais. Procuradores digitais precisam estar habilitados antes do início dos testes. Em seguida, é hora de trocar as chaves antigas e validar o acesso em produção restrita.
Depois, a equipe técnica deve testar os cenários de erro. Vale simular credencial vencida, ausência de permissão e resposta vazia. Por fim, o time contábil precisa definir como vai conciliar os dados importados.
Também é recomendável registrar as consultas. Assim, guardar a data, o horário e o retorno de cada chamada ajuda a explicar diferenças de saldo. Além disso, o histórico facilita a auditoria interna.
O comunicado oficial resume o escopo da liberação. O portal da Reforma Tributária do Consumo reúne os marcos da transição.
Impacto no escritório contábil
Para o escritório, a integração muda a rotina de conferência. Assim, em vez de abrir o portal cliente por cliente, a equipe pode consolidar os dados e priorizar quem tem divergência.
Esse ganho tem valor comercial. O escritório que automatiza a conciliação sobra tempo para orientar o cliente sobre crédito, regime e planejamento. Assim, o serviço deixa de ser apenas operacional.
Um sistema contábil para escritórios ajuda a centralizar documentos, prazos e histórico de cada cliente. Dessa forma, a equipe usa a tecnologia a favor da análise, e não do retrabalho.
Além disso, vale acompanhar as entregas que já estão em curso. A primeira entrega mensal da DeRE e a escrituração de IBS e CBS na fase de testes mostram como a rotina contábil está sendo construída em etapas. O cálculo da alíquota da CBS completa o quadro da transição.
Erros que devem ser evitados
Primeiro, o erro mais comum é testar com a credencial antiga. Sem a chave nova, a chamada falha e a equipe conclui, por engano, que a API está fora do ar. Além disso, importar os dados sem plano de conferência só transfere o trabalho manual para dentro do sistema.
Também é preciso cuidado com permissões. Um procurador sem acesso ao serviço certo não consegue consultar a apuração. Por isso, vale revisar os perfis antes de começar a integração.
Por fim, evite tratar a API como fonte única de verdade sem controle. Além disso, a conferência periódica entre o sistema, a escrituração e o documento fiscal continua necessária. Portanto, a automação reduz esforço, mas não substitui a análise.
Em resumo
- A Receita Federal liberou as versões 2.0 das APIs de apuração de débitos e créditos da CBS;
- As interfaces funcionam em produção restrita (testes) e produção beta, com consultas incrementais;
- Quem já tem chave precisa cancelar a credencial antiga e gerar uma nova;
- A documentação técnica está em docs.receitafederal.gov.br/apuracao-cbs;
- Novos serviços, como consulta de pagamentos e emissão de DARF, estão previstos para novembro de 2026;
- A liberação não cria obrigação nova nem antecipa a cobrança plena, prevista para 2027.