A Receita Federal disponibilizou, em 28 de outubro de 2026, a versão 2.0 das APIs destinadas à consulta de débitos e créditos da Contribuição sobre Bens e Serviços (CBS). A atualização permite que empresas, profissionais da contabilidade e desenvolvedores integrem informações da apuração do novo tributo aos próprios sistemas de gestão fiscal.
A novidade faz parte da preparação tecnológica para a implementação da Reforma Tributária sobre o consumo e busca facilitar o acompanhamento das obrigações tributárias por meio de ferramentas automatizadas. Com a integração, os contribuintes podem consultar informações diretamente em seus sistemas, sem depender exclusivamente de acessos manuais aos ambientes digitais do Fisco.
Os serviços estão disponíveis nos ambientes de Produção Restrita, voltado à realização de testes, e Produção Beta. Para utilizar as funcionalidades, é necessário gerar uma credencial de acesso nos canais disponibilizados pela Receita Federal.
Leia mais:
Receita cria piloto para testar CBS, o ‘IVA brasileiro’
Como funcionam as novas APIs 2.0 da CBS?
As interfaces de programação de aplicações, conhecidas como APIs, permitem a comunicação entre diferentes sistemas. Na prática, uma empresa pode conectar seu software de gestão empresarial às ferramentas da Receita Federal para obter informações relacionadas à apuração da CBS.
Isso representa uma mudança importante para departamentos fiscais e escritórios contábeis que administram um grande volume de documentos e operações.
Em vez de consultar individualmente cada informação nos portais governamentais, os sistemas integrados podem recuperar os dados automaticamente e utilizá-los em processos internos de conferência, acompanhamento e controle tributário.
A versão 2.0 contempla dois serviços principais: consulta de débitos e consulta de créditos apurados da CBS.
Quais informações podem ser consultadas pelas empresas?
Consulta de débitos da CBS
A funcionalidade permite acompanhar os valores devidos e identificar os documentos e operações que deram origem às obrigações tributárias.
Entre as informações disponibilizadas estão a origem do débito, os documentos fiscais relacionados, as datas de emissão, registro e atualização, além dos valores apurados.
Também é possível verificar a situação de cada obrigação, identificando registros classificados como devedores, suspensos ou extintos.
Esses dados podem ajudar as empresas a organizar o planejamento financeiro e identificar eventuais pendências antes que elas comprometam a regularidade fiscal.
Consulta de créditos tributários
A segunda funcionalidade permite acompanhar os créditos registrados na apuração da CBS.
O sistema apresenta informações sobre os valores apropriados, isto é, aqueles reconhecidos e liberados para utilização, além das parcelas que ainda estão aguardando apropriação.
Também é possível identificar créditos utilizados e não utilizados.
Para uma empresa que compra mercadorias e contrata serviços relacionados à sua atividade econômica, por exemplo, acompanhar essas informações é importante para conferir os valores registrados e avaliar os efeitos tributários das operações.
Segundo a Receita Federal, os dados disponibilizados pelas APIs são extraídos da mesma base utilizada pelo serviço Minha Apuração Assistida de CBS. Isso permite manter a integração com as informações processadas a partir dos documentos fiscais e eventos registrados no ambiente de apuração.
Consultas incrementais tornam a integração mais eficiente
Uma das principais melhorias da versão 2.0 é a introdução das consultas incrementais.
Nesse modelo, o sistema não precisa solicitar novamente todo o histórico de informações a cada consulta. Em vez disso, recupera os registros novos e as alterações realizadas desde a última atualização.
A mudança reduz o volume de dados transmitidos e pode diminuir o tempo necessário para processamento das informações.
O recurso é especialmente relevante para empresas com grande quantidade de operações fiscais e desenvolvedoras de softwares contábeis, que precisam administrar bases extensas de documentos e movimentações.
Na prática, uma empresa poderá atualizar seus registros internos sem precisar transferir repetidamente informações que já foram consultadas anteriormente.
Como gerar a credencial para acessar as APIs da CBS?
O acesso aos serviços depende da emissão de uma chave de autenticação. O procedimento deve ser realizado pelo próprio contribuinte ou por seu procurador digital autorizado.
A opção para gerar a credencial, identificada como “Gerar Credencial de Acesso”, está disponível nos seguintes ambientes:
- Portal Serviços da Receita Federal;
- Portal Tributação sobre Consumo (Beta).
Um detalhe importante envolve os usuários que já possuíam uma chave de acesso anterior. Para utilizar a versão atualizada das APIs, será necessário cancelar a credencial antiga e emitir uma nova.
Depois da geração, a equipe responsável pela integração deverá configurar o acesso conforme as especificações técnicas da Receita Federal.
A documentação oficial está disponível em docs.receitafederal.gov.br/apuracao-cbs.
Quais outras funcionalidades da CBS devem chegar em novembro?
A disponibilização das consultas de débitos e créditos representa uma etapa da ampliação dos serviços digitais relacionados à apuração do novo tributo.
O cronograma técnico divulgado pela Receita Federal prevê outras funcionalidades para novembro de 2026.
No início do mês, estavam previstas APIs para consulta de pagamentos e recolhimentos realizados pelo adquirente. Já para o final de novembro, a programação contemplava serviços relacionados à emissão do Documento de Arrecadação de Receitas Federais (DARF).
As modalidades previstas são o Recolhimento pelo Adquirente (RAD) e o Pagamento do Contribuinte (PCONT).
Com essas ferramentas, a expectativa é ampliar a integração entre os sistemas empresariais e os procedimentos de apuração e pagamento da CBS.
O que muda para empresas e profissionais da contabilidade?
A atualização das APIs reforça a digitalização dos processos fiscais e exige atenção das empresas que utilizam sistemas próprios ou plataformas de gestão integradas.
Departamentos tributários, escritórios contábeis e desenvolvedoras de software devem avaliar a compatibilidade de suas ferramentas com a versão 2.0, atualizar credenciais e revisar as rotinas de consulta.
A automação pode reduzir tarefas repetitivas, facilitar a identificação de inconsistências e melhorar o acompanhamento dos créditos e débitos tributários.
A iniciativa também integra a preparação para a transição estabelecida pela Reforma Tributária, que prevê a substituição gradual de tributos sobre o consumo pela CBS e pelo Imposto sobre Bens e Serviços (IBS).
Nesse cenário, acompanhar as atualizações tecnológicas da Receita Federal será importante para evitar dificuldades operacionais e preparar os sistemas empresariais para as novas exigências fiscais.
Imagem: Reprodução/Seu Crédito Digital