Receita libera APIs 2.0 de apuração da CBS: o que muda para você
A Receita Federal liberou as versões 2.0 das APIs de consulta a débitos e créditos de CBS. Entenda o que mudou, quem precisa gerar nova chave de acesso e quais passos seguir agora.
Por Equipe Contabilify · · 4 min de leitura
A Receita Federal liberou as versões 2.0 das APIs de consulta à apuração de débitos e créditos de CBS. Quem desenvolve sistemas, ou depende deles para fechar a apuração, precisa saber o que mudou e agir com antecedência. Neste post, a Contabilify resume a novidade e sugere os próximos passos.
O que mudou
As novas APIs foram liberadas em 28 de outubro. Elas permitem que o sistema da empresa ou do escritório consulte automaticamente os débitos e os créditos de CBS apurados, sem depender apenas de consultas manuais no portal. A Receita destaca que a nova versão traz consultas incrementais.
Há dois ambientes disponíveis:
- Produção restrita: voltado a testes.
- Produção (beta): com dados reais, ainda em fase beta.
O que cada consulta devolve
Na consulta de débitos, o sistema recebe informações como:
- a origem do débito e o documento fiscal de referência;
- as datas de emissão, registro e atualização;
- os valores do tributo, de acordo com a situação do débito (suspenso, extinto, devedor etc.).
Na consulta de créditos, o retorno mostra os valores apurados e detalha:
- a parcela apropriada, ou seja, liberada para uso;
- a parcela a apropriar;
- o que já foi utilizado e o que ainda não foi.
Mesma base do Minha Apuração Assistida
Os dados vêm da mesma base que alimenta o serviço Minha Apuração Assistida de CBS. Na prática, o que o sistema enxerga pela API deve estar alinhado ao que aparece no portal, já considerando o processamento dos documentos fiscais e dos eventos.
Como obter acesso
Para usar as APIs, o contribuinte ou seu procurador digital precisa gerar uma chave de acesso no serviço digital "Gerar Credencial de Acesso". Ele está disponível em dois portais:
- Serviços da Receita Federal;
- Tributação sobre Consumo (Beta).
Atenção: quem já tinha chaves geradas precisa cancelá-las e criar novas. Sem isso, o acesso às APIs 2.0 não funciona. Se a sua integração usa uma chave antiga, ela pode parar de responder até a troca.
Impacto para empresas, MEIs e contadores
Empresas
A consulta automatizada facilita o acompanhamento dos débitos e créditos de CBS dentro do ERP ou de outro sistema de gestão. Isso ajuda a conferir a origem de cada valor e a comparar a apuração com os documentos fiscais emitidos e recebidos. O ganho é maior para quem tem alto volume de notas e precisa de controle frequente.
Contadores e escritórios
Quando o contribuinte usa procurador digital, o escritório pode ser quem gera a credencial. Vale alinhar quem é responsável por isso e como a chave será guardada, já que ela dá acesso a informações fiscais sensíveis. Os escritórios também podem reunir dados de vários clientes em uma rotina padronizada de conferência, desde que tenham as procurações em ordem.
MEIs
O material divulgado pela Receita não detalha regras específicas para MEIs nem cria obrigação de uso das APIs. Na maioria dos casos, a consulta pelo portal já deve bastar. Quem tem contador ou sistema de gestão integrado deve perguntar se haverá alguma mudança na rotina.
Passos práticos
- Verifique se você usa chaves antigas. Se sua empresa, seu software ou seu escritório já gerou credenciais, cancele-as e emita novas.
- Defina quem gera a credencial. Pode ser o próprio contribuinte ou o procurador digital. Confirme se as procurações estão válidas.
- Comece pelo ambiente de testes. A produção restrita permite validar a integração antes de lidar com dados reais.
- Consulte a documentação técnica. A Receita mantém o material para integração em https://docs.receitafederal.gov.br/apuracao-cbs/. A equipe de TI ou o fornecedor do sistema deve revisar os detalhes.
- Compare com o portal. Confira se os dados das APIs batem com o Minha Apuração Assistida de CBS e investigue qualquer divergência.
- Acompanhe as novidades. A Receita informou que novos serviços via API ligados à apuração de CBS serão disponibilizados em novembro deste ano. O que eles farão ainda depende de divulgação oficial.
O que ainda é incerto
A liberação está em fase beta, então ajustes podem acontecer. O material também não informa prazos de obrigatoriedade nem o conteúdo dos serviços que virão em novembro. Por isso, não trate nada disso como regra definitiva: acompanhe os canais oficiais e confirme com seu contador ou fornecedor de sistema.
Como a Contabilify pode ajudar
A Contabilify acompanha as mudanças da reforma tributária e ajuda empresas a organizar a rotina fiscal e contábil para chegar preparadas à CBS. Para saber mais sobre nossos serviços, acesse contabilify.com.br e fale com nossa equipe.
Resumo
As APIs 2.0 de apuração da CBS ampliam as opções de consulta a débitos e créditos, com dados sincronizados com o portal. O primeiro passo é simples: gerar uma nova credencial, cancelando as antigas. Depois, é testar no ambiente restrito e acompanhar os novos serviços previstos para novembro.
Fontes e referências
- Receita Federal, 09/11/2026