BRASÍLIA/DF — A Receita Federal informou nesta segunda-feira, 9 de novembro de 2026, que liberou as versões 2.0 das interfaces de programação de aplicativos (APIs) destinadas à consulta de débitos e créditos da Contribuição sobre Bens e Serviços (CBS). As ferramentas foram disponibilizadas em 28 de outubro e podem ser utilizadas nos ambientes de produção restrita, voltado a testes, e produção beta. A medida permite integrar sistemas empresariais à apuração do novo tributo, criado pela Reforma Tributária.
A principal novidade é a consulta incremental: em vez de recuperar repetidamente um grande conjunto de dados, a integração permite identificar inclusões e alterações na apuração. Há uma providência imediata para usuários atuais: contribuintes e procuradores digitais que já possuem chave de acesso precisam cancelar a credencial anterior e gerar uma nova para utilizar as APIs anunciadas.
O que a Receita Federal liberou em novembro de 2026?
O anúncio publicado em 9 de novembro confirma a disponibilidade de duas APIs na versão 2.0: uma para consultar débitos de CBS e outra para consultar créditos de CBS. A liberação técnica ocorreu em 28 de outubro. Portanto, a data da notícia não deve ser confundida com a data em que as interfaces começaram a ficar disponíveis.
A CBS substituirá o PIS e a Cofins a partir de 2027, conforme as regras de transição. A disponibilização de integrações em 2026 permite que empresas, escritórios contábeis e desenvolvedores ajustem rotinas antes do início da nova etapa tributária.
O que muda nas consultas de débitos da CBS?
A API de débitos fornece informações sobre a origem dos valores apurados, a identificação do documento fiscal relacionado, as datas de emissão, registro e atualização e a situação do tributo. Os dados podem indicar, por exemplo, saldos devedores, valores suspensos ou parcelas já extintas, conforme o processamento registrado pela administração tributária.
Como funciona a consulta de créditos da CBS?
Na API de créditos, o contribuinte pode acompanhar valores apurados, a parcela já apropriada — isto é, liberada para utilização —, a parcela ainda a apropriar e a distinção entre montantes utilizados e não utilizados.
É importante distinguir crédito calculado de crédito disponível: a existência de um valor no sistema não autoriza seu aproveitamento fora dos requisitos e das condições previstos na legislação.
O que são consultas incrementais e por que elas importam?
Uma consulta incremental apresenta inclusões e atualizações identificadas desde a referência da consulta anterior, segundo as regras técnicas do serviço. Dessa forma, um programa pode atualizar seus registros sem repetir, a cada chamada, a transferência integral dos mesmos dados.
A Receita explica que essa arquitetura busca reduzir o volume de informação trafegada e o tempo de processamento.
Como gerar a nova chave de acesso às APIs da CBS?
O interessado deve utilizar o serviço digital “Gerar Credencial de Acesso”, disponível no portal Serviços da Receita Federal (https://servicos.receitafederal.gov.br) ou no portal Tributação sobre Consumo (Beta) (https://consumo.tributos.gov.br). O acesso pode ser realizado pelo contribuinte ou por procurador digital autorizado, observados os requisitos do serviço.
Segundo o comunicado, as chaves já existentes precisam ser canceladas e substituídas. Por isso, escritórios e desenvolvedores devem revisar os sistemas que utilizam credenciais antigas antes de prosseguir com as integrações.
As novas APIs utilizam os mesmos dados do portal da Receita?
Sim. A Receita afirma que as consultas utilizam a mesma base de informações da funcionalidade “Minha Apuração Assistida de CBS”. Os resultados são sincronizados com o processamento de documentos fiscais eletrônicos e eventos que alimentam a apuração.
Ainda assim, os registros devem ser interpretados conforme o estado do processamento, porque atualizações posteriores podem modificar valores e situações de débito ou crédito.
As APIs estão prontas para uso definitivo em produção?
A Receita identifica dois ambientes: produção restrita (testes) e produção beta. Isso significa que o comunicado confirma a disponibilidade nesses ambientes, e não uma declaração de que todos os recursos planejados estejam concluídos ou de que as integrações dispensem validação técnica.
A documentação oficial prevê processamento assíncrono de determinadas consultas. Nessa modalidade, a solicitação pode gerar um identificador para acompanhamento, e o arquivo de retorno é obtido após a conclusão do processamento. Empresas de software precisam observar autenticação, limites de uso, tratamento de erros e segurança das informações.
Quais outras APIs da CBS estão previstas para novembro?
No comunicado de setembro, a Receita apresentou um cronograma para ampliar as consultas a pagamentos e a recolhimentos efetuados pelo adquirente. Também anunciou, para o final de novembro, serviços relacionados à emissão de DARF para Recolhimento pelo Adquirente (RAD) e para Pagamento do Contribuinte (PCONT).
A notícia de 9 de novembro informa que novos serviços vinculados à apuração da CBS serão disponibilizados ainda neste mês. A confirmação atual de liberação refere-se especificamente às APIs 2.0 de consulta de débitos e créditos. Os demais serviços devem ser acompanhados na documentação e em futuros comunicados oficiais.
O que contadores e empresas de software precisam fazer agora?
O primeiro passo é identificar quais sistemas já consultam a apuração da CBS e verificar se usam as credenciais anteriores. Depois, recomenda-se conferir a documentação técnica da versão vigente, atualizar a autenticação, testar chamadas nos ambientes disponíveis e validar o tratamento dos retornos.
Também é relevante comparar os dados obtidos com as informações da apuração assistida, revisar registros de notas fiscais e eventos e estabelecer procedimentos para tratar falhas de integração.
A liberação das APIs antecipa a cobrança integral da CBS?
Não. A disponibilização de uma interface de consulta é uma medida tecnológica, separada das regras de incidência e recolhimento do tributo. O calendário da Reforma Tributária continua subordinado à Constituição, à Lei Complementar nº 214/2025 e às alterações posteriores.
Em 2026 ocorre a fase de testes, com disciplina própria. A partir de 2027 começa a etapa em que a CBS substitui PIS e Cofins. A nova integração não altera, por conta própria, alíquotas, vencimentos ou obrigações legais. Seu objetivo é dar condições técnicas para acompanhar a apuração da nova contribuição federal sobre o consumo.
Onde consultar a documentação oficial das novas APIs?
A Receita mantém guias de integração, regras das solicitações e estruturas de retorno no endereço https://docs.receitafederal.gov.br/apuracao-cbs/. O material inclui orientações sobre consultas, autenticação, acompanhamento de solicitações e resultados. As equipes devem verificar a versão efetivamente publicada para cada serviço antes de colocá-lo em funcionamento.
A liberação das APIs 2.0 representa mais uma etapa de preparação dos sistemas fiscais para 2027. O principal cuidado imediato é atualizar as credenciais e confirmar a compatibilidade das integrações, sem confundir a disponibilidade de consultas com o lançamento de todos os serviços previstos para novembro.
Fontes oficiais consultadas
1. Receita Federal — Receita Federal libera acesso às novas APIs de apuração da CBS (09/11/2026)
3. Receita Federal — Documentação técnica da Apuração Assistida da CBS
4. Receita Federal — Regras comuns de solicitação e retorno das APIs assíncronas
5. Receita Federal — Entenda a Reforma Tributária do Consumo, transição
6. Câmara dos Deputados — Lei Complementar nº 214/2025, texto atualizado
Esta reportagem tem caráter informativo e foi elaborada com base na legislação e nas fontes oficiais consultadas na data da reportagem, incluindo comunicados da Receita Federal e documentação técnica. A disponibilidade de cada integração, seus requisitos de acesso e as regras de processamento devem ser conferidos nas versões vigentes dos serviços; o texto não substitui a análise técnica ou tributária de cada contribuinte.
