A API de apuração da CBS ganhou uma nova documentação técnica em 14 de setembro de 2026. A Receita Federal prevê liberar os novos formatos gradualmente a partir de outubro, nos ambientes de produção restrita do Piloto da CBS e de Produção Beta. Para a empresa, o aviso não significa que todo CNPJ precise desenvolver uma integração imediatamente. Significa que fiscal, contabilidade, tecnologia e fornecedor do sistema já têm uma referência concreta para organizar testes.
O ponto central da atualização é a consulta incremental. Em vez de baixar novamente todo o conjunto de informações, a aplicação poderá pedir apenas débitos, créditos ou pagamentos incluídos e alterados desde a consulta anterior. Isso tende a reduzir o tempo de processamento e o tamanho dos arquivos, segundo a Receita.
O que a Receita publicou sobre a API de apuração da CBS?
A notícia oficial de 14 de setembro apresenta o cronograma de novos formatos gratuitos para consultar informações da Contribuição sobre Bens e Serviços (CBS). O anúncio inclui consultas de débitos, créditos, pagamentos e recolhimentos feitos pelo adquirente, além de serviços relacionados à emissão de DARF.
A documentação da apuração da CBS já reúne os guias de integração, as consultas assíncronas e as estruturas de retorno. Publicar a documentação antes de liberar todas as funções dá tempo para que fornecedores estudem contratos, autenticação, webhooks, arquivos e tratamento de erros.
Esse tema é diferente da explicação tributária básica. Se a dúvida ainda é o que o novo tributo substitui ou quando começa a transição, veja primeiro o guia sobre CBS e IBS. Aqui, o foco é a conexão entre sistemas e a apuração assistida.
O que são consultas incrementais e por que elas importam?
Uma consulta completa entrega todo o conjunto previsto pelo serviço, mesmo que pouca coisa tenha mudado. Uma consulta incremental concentra o retorno nas inclusões e atualizações ocorridas depois da referência anterior.
Pense em uma empresa que processa milhares de transações. Se dez registros mudaram desde a última sincronização, receber somente essas mudanças evita transportar e reprocessar o arquivo inteiro. O benefício potencial aparece em três pontos:
- menos volume trafegado: arquivos menores exigem menos transferência e armazenamento temporário;
- processamento mais dirigido: a aplicação concentra esforço nas alterações;
- conciliação mais frequente: atualizações menores podem entrar em rotinas recorrentes, desde que a integração controle a sequência corretamente.
“Incremental” não significa “automático” nem “sem conferência”. O sistema ainda precisa registrar a referência de cada consulta, evitar duplicidades, tratar retificações e demonstrar quais dados chegaram. Sem rastreabilidade, uma integração rápida pode produzir uma conciliação difícil de auditar.
Qual é o cronograma divulgado para 2026?
O cronograma publicado pela Receita se estende de outubro ao fim de novembro de 2026. Ele se refere aos ambientes do Piloto da CBS e de Produção Beta mencionados no anúncio.
- Início de outubro: consultas de débitos e créditos.
- Início de novembro: consultas de pagamentos e de recolhimentos na condição de adquirente.
- Final de novembro: emissão de DARF para recolhimento como adquirente (RAD) e para pagamento do contribuinte (PCONT).
As datas orientam planejamento e testes. Elas não devem ser lidas como uma ordem para toda empresa ativar uma integração no primeiro dia de cada etapa. O responsável fiscal deve confirmar se o CNPJ participa do ambiente, qual função será usada e quem opera a tecnologia.
O cronograma também pode receber revisões. Registre a data da documentação usada no projeto e confira a página oficial antes de aprovar uma implantação.
Como funciona o fluxo assíncrono em linguagem de negócio?
As regras comuns das APIs assíncronas descrevem um processo em etapas. “Assíncrono” quer dizer que o pedido é recebido primeiro e o arquivo final fica pronto depois; a resposta completa não volta na mesma chamada.
Em uma visão simplificada:
- O sistema da empresa se autentica e envia uma solicitação, informando um endereço HTTPS para retorno, conhecido como webhook.
- A API valida se esse endereço está acessível e registra a solicitação.
- O processamento acontece em segundo plano e gera um identificador para acompanhamento.
- Quando termina, o serviço avisa o webhook ou permite consultar a situação.
- Em caso de sucesso, o retorno informa um endereço temporário para baixar o arquivo.
Esse desenho evita manter uma conexão aberta durante um processamento potencialmente longo. Também cria responsabilidades. O webhook precisa permanecer disponível, as notificações devem ser validadas e as falhas precisam de retentativa controlada.
A documentação consultada em 15 de setembro informa três parâmetros: limite de quatro aberturas por dia, processamento de até quatro horas e arquivo disponível por 48 horas depois do aviso. Esses números são técnicos e podem mudar. O fornecedor deve conferi-los durante o desenvolvimento, em vez de copiá-los deste artigo como configuração permanente.
Quais cuidados de segurança entram no projeto?
A integração usa credenciais e token de acesso. O retorno pode conter uma URL assinada que autoriza o download do arquivo enquanto estiver válida. Por isso, o documento oficial orienta tratar essa URL como segredo temporário.
Na prática, um projeto deve prever pelo menos:
- webhook exclusivo em HTTPS, com certificado válido;
- credenciais guardadas fora do código-fonte e com acesso restrito;
- tokens e URLs assinadas fora de logs, emails e ferramentas de métricas;
- registro do identificador da solicitação, horário, resultado e correlação, sem dados sensíveis;
- controle de repetição para não processar a mesma notificação duas vezes;
- consulta de situação como recuperação quando o webhook não receber o aviso;
- política para descartar links e arquivos temporários depois do uso.
Esses controles não são detalhes “só da TI”. Uma falha pode causar indisponibilidade, duplicar informações na apuração ou expor dados tributários. Fiscal e tecnologia devem aprovar juntos o que será registrado e por quanto tempo.
Piloto e Produção Beta significam cobrança antecipada?
Não. O FAQ oficial do Piloto da CBS define a produção restrita como um ambiente de testes, colaboração e simulação. As operações simuladas no Piloto não produzem efeitos fiscais, cadastrais, jurídicos ou obrigacionais. A participação ocorre por convite formal da Receita.
Produção Beta e Piloto também não são sinônimos de liberação irrestrita para qualquer empresa. Cada equipe precisa confirmar o ambiente, as credenciais e as autorizações que se aplicam ao seu caso.
Essa distinção evita dois erros. O primeiro é ignorar a documentação por achar que tudo está distante. O segundo é tratar um cronograma de testes como obrigação universal já em produção. A postura equilibrada é preparar processos, validar sistemas e acompanhar as versões oficiais.
Checklist para ERP, TI, fiscal e contabilidade
Use a documentação como pauta de uma reunião com os responsáveis pelo processo. O objetivo é sair com donos e datas, não apenas com a frase “o fornecedor está vendo”.
Perguntas para o fornecedor do ERP
- O produto pretende consumir diretamente a API de apuração da CBS?
- Qual versão da documentação está sendo usada?
- Em qual ambiente e com quais CNPJs os testes serão feitos?
- Como a integração controla consultas incrementais, retificações e duplicidades?
- Como credenciais, tokens, webhooks e URLs temporárias serão protegidos?
Perguntas para fiscal e contabilidade
- Quem conciliará o retorno da API com documentos e lançamentos internos?
- Qual evidência será guardada para explicar diferenças?
- Quem aprova a emissão e o pagamento de um DARF?
- Como uma falha de integração entra no fechamento do período?
- Qual relatório permitirá acompanhar pendências sem expor dados sensíveis?
Também vale revisar os campos de CBS e IBS nos documentos fiscais e o efeito do split payment no fluxo de caixa. A API é uma parte do processo; documento, apuração, pagamento e conciliação precisam conversar.
Preparar agora não significa implantar no escuro
A nova documentação reduz a incerteza técnica, mas não substitui o desenho do processo da empresa. O próximo passo é identificar quem responde pela integração, quais funções realmente serão usadas e como os resultados serão conciliados.
Antes de investir em uma mudança, confirme escopo, ambiente e versão com o fornecedor. Em paralelo, o planejamento tributário da Contclaro ajuda a conectar a mudança tecnológica aos impactos em documentos, créditos, pagamentos e caixa. Assim, tecnologia e tributo avançam no mesmo plano.
Conteúdo informativo, atualizado em 15 de setembro de 2026. Documentação, limites e cronogramas de APIs podem mudar; consulte as páginas oficiais antes de desenvolver ou colocar uma integração em produção.
