CBS: Receita muda regras de consulta via API e limita acessos diários

A Receita Federal atualizou, em 14 de setembro de 2026, as regras de funcionamento das APIs usadas para apurar a CBS (Contribuição sobre Bens e Serviços). A mudança afeta diretamente os sistemas de empresas e escritórios de contabilidade que se conectam automaticamente à Receita para consultar débitos, créditos e pagamentos relacionados ao novo tributo. Se sua empresa usa ou pretende usar esse tipo de integração, vale entender o que muda na prática.

O que muda

A revisão altera o conteúdo das notificações enviadas aos sistemas integrados e o caminho para baixar os arquivos com os resultados das consultas. Na prática, depois que uma solicitação é concluída, o sistema da empresa precisa buscar um link temporário e seguro para então baixar o arquivo. Esse link tem prazo de validade e, se expirar, é preciso solicitar um novo endereço.

Outra mudança importante é a adoção de consultas incrementais: em vez de baixar todos os dados novamente a cada consulta, o sistema recebe apenas o que foi incluído ou atualizado desde a última vez. Isso reduz o tamanho dos arquivos e o tempo de processamento, o que tende a tornar as integrações mais rápidas e menos pesadas para quem opera sistemas contábeis e financeiros.

Quem é afetado

A mudança atinge principalmente desenvolvedores e equipes de tecnologia responsáveis por integrar sistemas de empresas e escritórios de contabilidade às APIs da CBS. Isso inclui softwares que consultam débitos, créditos, pagamentos e recolhimentos feitos pelo adquirente, além da emissão de guias de recolhimento (DARF) para o Recolhimento pelo Adquirente e para o Pagamento do Contribuinte. Empresas que ainda não usam integração automática não sentem efeito imediato, mas devem ficar atentas, já que essas conexões tendem a se tornar cada vida mais comuns com a chegada definitiva da CBS.

Também merece atenção o calendário de testes: as APIs voltadas aos fluxos de pagamento, como o Split Payment (mecanismo que já separa o valor do imposto no momento da transação), começaram sua fase de testes específicos em meados de outubro de 2026. Isso significa que o sistema ainda está em ajuste e pode passar por novas atualizações até a entrada em operação plena.

Como se preparar

Para quem desenvolve ou mantém sistemas integrados, o primeiro passo é revisar a documentação técnica atualizada e adaptar o fluxo de recebimento de notificações e download de arquivos. É importante respeitar o limite de quatro chamadas diárias por API de abertura e preparar o sistema para consultar o status da solicitação quando a notificação automática não chegar, já que o uso de webhook (aviso automático enviado pela Receita) é opcional.

A Receita também recomenda cuidados de segurança, como usar conexões protegidas (HTTPS), restringir o acesso ao canal que recebe as notificações e evitar que os links temporários de download fiquem registrados em logs ou mensagens de erro. Negligenciar esses pontos pode expor dados sensíveis da empresa durante o processo de integração.

Na prática, quem depende de contabilidade terceirizada ou de softwares de gestão deve perguntar ao fornecedor do sistema ou ao escritório contábil se as adaptações já estão em andamento. Como as APIs gratuitas da CBS serão liberadas em fases, nos ambientes de Produção Restrita e Produção Beta, o ideal é acompanhar os prazos junto com quem cuida da parte técnica e fiscal do negócio, evitando surpresas quando a apuração da CBS passar a valer de forma mais ampla.