A Receita Federal publicou em 14 de setembro de 2026 uma nova versão da documentação técnica das APIs de apuração da CBS. O material está disponível em docs.receitafederal.gov.br/apuracao-cbs e atende a pedidos de desenvolvedores, empresas de software e contribuintes de alto volume.
A mudança principal não está em um campo novo. Está no modelo de consulta.
O que muda: consulta incremental
Até agora, cada chamada devolvia o conjunto completo de dados. A partir da nova versão, as APIs retornam apenas as alterações ocorridas desde a última consulta.
Os ganhos declarados pela Receita são diretos: menos volume trafegado, menos tempo de processamento, menos consumo de recurso computacional e arquivos mais leves para armazenar e baixar.
O cronograma de disponibilização
Os serviços entram em duas ondas:
- Outubro de 2026. Consulta de débitos e consulta de créditos.
- Novembro de 2026. Consulta de pagamentos, consulta de remessa do adquirente, emissão de DARF para Remessa do Adquirente (RAD) e emissão de DARF para Pagamento do Contribuinte (PCONT).
Quem consome essas interfaces tem, portanto, poucas semanas até a primeira onda.
O que a consulta incremental transfere para o lado do contribuinte
Consulta completa é ineficiente, mas tem uma virtude: é idempotente. Se a chamada de ontem falhou, a de hoje traz tudo de novo e o estado se corrige sozinho. Consulta incremental não perdoa da mesma forma.
O modelo incremental exige que alguém, do lado do contribuinte, mantenha estado. Na prática, três responsabilidades novas aparecem no desenho da integração:
- Guardar o marcador da última consulta. A API responde a partir de um ponto de corte. Esse ponto precisa ser persistido de forma confiável, sobreviver a reinício de serviço e não ser compartilhado entre ambientes por engano. Um marcador de homologação aplicado em produção deixa a base em silêncio.
- Tratar falha e reprocessamento. Se a chamada falhou depois de a Receita já ter avançado o ponto de corte, ou se o processo caiu entre receber a resposta e gravá-la, existe um intervalo de dados que ninguém vai buscar de novo espontaneamente. O tratamento de erro precisa decidir explicitamente se avança o marcador ou não.
- Detectar o buraco silencioso. Este é o ponto mais delicado. Em modelo incremental, uma consulta que não trouxe nada é indistinguível de uma consulta que falhou em trazer o que deveria. Sem uma conferência periódica contra a base completa, a divergência não gera erro. Ela simplesmente existe.
Onde isso costuma morar em ambiente corporativo
Em empresas que operam Oracle EBS, SAP ou JDE integrados às soluções Thomson Reuters, esse tipo de consumo de API raramente está em uma tela que alguém abre. Está em job agendado, em middleware ou em rotina de integração que entrou em produção, funcionou, e desde então ninguém revisou.
Isso não é um problema quando a consulta é completa e autocorretiva. Passa a ser quando o modelo depende de estado bem gerenciado. A mesma rotina que hoje tolera uma falha ocasional sem consequência vai, no modelo novo, acumular divergência a cada falha não tratada.
A questão para levar à reunião de TI e fiscal não é se a integração funciona. É onde o controle de estado vai morar, quem é o dono dele, e qual conferência confirma que a base local reflete a base da Receita.
O que dá para fazer nas próximas duas semanas
O intervalo até outubro é curto, mas suficiente para o trabalho que importa:
- Inventariar quem chama. Levantar todos os processos que consomem as APIs de apuração da CBS, em quais ambientes, com qual frequência e sob qual credencial. Em ambientes grandes, esse levantamento costuma revelar chamadas esquecidas.
- Ler o leiaute novo antes de codificar. A documentação já está publicada. Definir o desenho do marcador de estado no papel custa menos do que descobrir o requisito durante o teste.
- Definir a conferência de integridade. Alguma rotina precisa comparar periodicamente o que a base local tem com o que a Receita tem. Mensal é um bom começo. Sem isso, o modelo incremental não tem rede de proteção.
- Nomear o dono. Fiscal e TI precisam concordar sobre quem monitora, quem é acionado quando a rotina falha e em quanto tempo. Integração sem dono é integração que só é olhada depois do prejuízo.
Uma observação sobre a direção da Reforma
A Receita atendeu a um pedido legítimo de quem tem alto volume, e o modelo incremental é a decisão técnica correta. Ele também move parte da complexidade para dentro da empresa.
Esse padrão vem se repetindo ao longo de 2026. A infraestrutura da Reforma Tributária tem cobrado menos cálculo e mais disciplina de integração e qualidade de dado. O motor fiscal entrega quando está bem configurado e bem alimentado. O trabalho que decide o resultado acontece antes dele.
Fonte: Receita Federal, 14/09/2026, “Receita Federal publica nova documentação técnica das APIs de apuração da CBS”. Documentação técnica: docs.receitafederal.gov.br/apuracao-cbs.
A WMX Consultoria atua há 20 anos na integração entre ERP e soluções fiscais Thomson Reuters. Se a sua empresa consome as APIs de apuração da CBS e precisa revisar o desenho da integração antes de outubro, fale com o nosso time.