BRASÍLIA/DF — A apuração da CBS começa a ganhar uma arquitetura muito diferente da rotina tradicional de baixar relatórios, importar arquivos completos e conferir manualmente grandes volumes de informação. A Receita Federal publicou nova documentação técnica para APIs que permitirão aos sistemas das empresas consultar débitos, créditos, pagamentos e recolhimentos ligados à Contribuição sobre Bens e Serviços.
A mudança atende sugestões de profissionais contábeis, desenvolvedores de software e empresas com grande volume de transações. O principal avanço é a consulta incremental: em vez de devolver toda a base a cada requisição, a API informará apenas registros incluídos ou modificados desde a consulta anterior.
A CBS passa a conversar diretamente com os sistemas das empresas
As novas interfaces fazem parte da Apuração Assistida. Na prática, ERPs, plataformas fiscais e softwares contábeis poderão buscar informações estruturadas diretamente no ambiente da Receita.
Isso não elimina a necessidade de conferência humana, mas muda a escala do processo. Uma empresa com milhares de documentos poderá automatizar a comparação entre seus próprios registros e aquilo que a plataforma da CBS reconhece como débito, crédito ou pagamento.
Consulta incremental é a principal mudança
Na versão anterior, uma consulta de grande volume poderia exigir repetição de informações já recebidas. Agora, a lógica passa a considerar o intervalo entre a consulta atual e a anterior.
A API de débitos, por exemplo, retorna débitos incluídos ou atualizados nesse período. A de créditos segue o mesmo princípio. A janela máxima prevista na documentação é de oito dias, exceto na primeira consulta, que retorna inclusões e alterações desde o primeiro dia do mês corrente.
Isso reduz arquivo e tempo de processamento
Para empresas com alto volume transacional, baixar novamente milhões de registros que não sofreram qualquer mudança seria custoso e pouco eficiente.
A consulta incremental reduz tráfego de dados, tamanho dos arquivos e processamento interno. Também facilita rotinas de reconciliação, porque o sistema pode trabalhar apenas sobre eventos novos ou alterados.
As APIs não respondem tudo na mesma chamada
A nova arquitetura é assíncrona. O sistema da empresa envia uma solicitação e recebe um tíquete, mas o arquivo final não volta imediatamente na mesma requisição.
Depois do processamento, a Receita envia ao webhook informado pelo contribuinte uma URL temporária para download do resultado. A documentação prevê tempo limite de processamento de até quatro horas.
Webhook passa a fazer parte da estrutura fiscal
Para consumir essas APIs, a empresa precisará disponibilizar uma URL HTTPS pública capaz de receber o retorno da Receita.
Isso aproxima ainda mais tecnologia e tributação. Não basta possuir um software que “acesse a Receita”; será necessário administrar autenticação, endpoint de retorno, segurança, logs e disponibilidade da integração.
OAuth 2.0 será usado na autenticação
A documentação exige credenciais válidas para o estabelecimento matriz e token obtido pela API de autenticação.
O protocolo utilizado é OAuth 2.0 no fluxo Client Credentials. O token é enviado nas chamadas das APIs e as orientações para geração de credenciais estão relacionadas ao ambiente Receita Integra.
Há limite de quatro solicitações por dia
A documentação comum das APIs assíncronas estabelece limite de quatro chamadas diárias no endpoint de abertura.
Esse detalhe torna a estratégia de integração importante. Empresas e softwares não poderão simplesmente disparar consultas continuamente sem considerar as restrições técnicas e a janela incremental de dados.
O arquivo ficará disponível por 48 horas
Quando a solicitação for concluída, o webhook recebe uma URL assinada para baixar o arquivo gerado.
Essa URL é válida por 48 horas. A Receita recomenda tratá-la como segredo temporário, evitando gravá-la em logs, mensagens de erro ou ferramentas de monitoramento que possam expor o acesso ao arquivo.
Outubro começa com débitos e créditos
O cronograma divulgado pela Receita prevê que as APIs de consulta de débitos e créditos sejam disponibilizadas no início de outubro de 2026 nos ambientes de produção restrita do piloto e produção beta.
Esses dois serviços formam a base da reconciliação da apuração: o sistema empresarial poderá confrontar o que reconhece internamente com os valores registrados na plataforma da CBS.
Pagamentos e recolhimentos chegam em novembro
No início de novembro, entram as APIs para consultar pagamentos de CBS e recolhimentos realizados na condição de adquirente.
A consulta de pagamentos abrange valores que extinguem débitos do contribuinte por três caminhos: pagamento realizado pelo próprio contribuinte, recolhimento efetuado por adquirente e split payment.
RAD também poderá ser acompanhado via API
A API de recolhimentos do adquirente permitirá consultar tanto o RAD — recolhimento pelo adquirente — quanto valores provenientes do split payment.
O retorno vincula os pagamentos ao período de apuração, fornecedor e chave do documento fiscal. Isso mostra como documento, pagamento e crédito passam a formar uma trilha digital conectada.
No fim de novembro chegam os DARFs
A Receita também programou para o final de novembro serviços para emissão de DARF de duas modalidades.
Uma delas é o RAD, em que o adquirente recolhe a CBS vinculada à operação nas hipóteses legais. A outra é o PCONT, pagamento do próprio contribuinte. A documentação e os serviços permitirão que esses fluxos sejam incorporados aos sistemas empresariais.
API da apuração não é a Calculadora de Tributos
É importante não confundir as duas soluções. A Receita também possui uma Calculadora de Tributos da Reforma destinada ao cálculo das operações e à identificação do tratamento tributário.
A calculadora trabalha com módulo local e integração com sistemas emissores. As novas APIs tratadas agora pertencem à Apuração Assistida e servem para consultar eventos já registrados na apuração, como débitos, créditos e pagamentos.
ERP, fiscal, contabilidade e tesouraria terão de compartilhar a mesma informação
A arquitetura revela para onde caminha a administração da CBS. O documento fiscal cria débitos e créditos; os pagamentos podem extinguir valores; RAD e split payment interferem na liquidação; e as APIs devolvem essas informações aos sistemas do contribuinte.
Isso reduz espaço para departamentos isolados. Fiscal, contabilidade, contas a pagar, contas a receber e tecnologia precisarão trabalhar sobre os mesmos identificadores e documentos.
2026 é o momento de construir a integração
Os serviços chegam primeiro aos ambientes de teste e beta justamente para permitir desenvolvimento antes da operação plena da CBS.
Para empresas de software e contribuintes de grande porte, esperar 2027 para iniciar a integração pode ser tarde. Será necessário testar autenticação, webhooks, leitura dos JSONs, tratamento de alterações e reconciliação dos dados com o ERP.
A Reforma Tributária, nesse ponto, deixa de ser apenas mudança de alíquota. A CBS nasce com uma infraestrutura em que nota fiscal, apuração, pagamento e crédito podem circular entre Fisco e empresa praticamente como dados de sistema para sistema.
Acompanhe o Radar da Reforma Tributária para acompanhar as APIs, a Apuração Assistida, o RAD, o split payment e os demais sistemas digitais do IBS e da CBS.
Fontes públicas: Receita Federal — “Receita Federal publica nova documentação técnica das APIs de apuração de CBS”, de 14 de setembro de 2026; Documentação oficial da Apuração CBS; guias de APIs assíncronas; documentação de consulta de débitos, créditos, pagamentos e recolhimentos; Programa Reforma Tributária do Consumo; Manual da Plataforma CBS.
Este conteúdo é informativo. A disponibilização das APIs segue cronograma técnico e ambientes específicos de produção restrita e produção beta. Empresas e desenvolvedores devem observar a documentação vigente, requisitos de autenticação, limites de consumo e eventuais atualizações antes de colocar integrações em produção.