Novas APIs da CBS em novembro: como conciliar pagamentos e recolhimentos pelo adquirente com o ERP?
Consultar pagamentos e recolhimentos relacionados à CBS pode aprimorar o controle financeiro e fiscal do atacado. A integração, porém, exige identificar corretamente documentos, débitos, responsáveis e eventos. Sem correspondência verificável, uma atualização de API pode criar apenas mais um conjunto de números que precisam ser conciliados.
Que serviços a Receita incluiu no cronograma?
Em setembro de 2026, a Receita Federal apresentou uma evolução das interfaces técnicas de apuração da CBS. Além de consultas a débitos e créditos, o cronograma previa consultas a pagamentos e recolhimentos efetuados pelo adquirente a partir de novembro, em disponibilização gradual nos ambientes informados como piloto da CBS e produção beta. A documentação também indicou serviços de emissão de DARF para recolhimento pelo adquirente e para pagamento do contribuinte em etapa posterior.
Essa divisão é essencial. Consultar um registro não é a mesma coisa que gerar o documento de arrecadação, efetuar pagamento ou confirmar a baixa de um débito. O projeto de integração precisa representar essas situações como eventos distintos, com suas condições e seus responsáveis.
A documentação divulgada pela Receita em 14 de setembro organiza um cronograma técnico: consultas de débitos e créditos no começo de outubro, consultas de pagamentos e recolhimentos realizados pelo adquirente no início de novembro e serviços de emissão de DARF ao fim de novembro. A novidade não é apenas um endpoint adicional. As consultas incrementais retornam novos registros e atualizações de operações já consultadas, reduzindo volume de dados trafegados por grandes contribuintes. Os ambientes informados são produção restrita, piloto da CBS e produção beta, o que exige cuidado ao afirmar disponibilidade efetiva.
O objetivo de uma consulta desse tipo é permitir que o contribuinte ou seu sistema acompanhe informações relevantes sobre pagamentos registrados e eventuais atualizações, de acordo com a documentação oficial do serviço. Para uma distribuidora, o ganho operacional pode surgir na conciliação entre os documentos de origem, os débitos apurados e os eventos financeiros reconhecidos.
Isso não elimina a necessidade de verificar o vínculo correto. Uma empresa que consulta pagamentos em alta velocidade pode continuar com divergências se não consegue associar o evento à obrigação e ao período pertinentes.
Considere um exemplo hipotético de operação com nota emitida e pagamento registrado em data posterior. A conciliação precisa relacionar o débito correspondente ao fato documental e o evento financeiro ao sujeito e período corretos. Se uma API retornar atualização desse evento depois de uma primeira consulta, o ERP deve atualizar a informação anterior, sem contar um segundo pagamento. Esse cuidado vale ainda que o sistema só esteja em piloto.
Uma dúvida recorrente é se o retorno de pagamento prova que a mercadoria foi entregue ou aceita. Não. Documento fiscal, evento financeiro e execução comercial são fatos diferentes. É possível haver emissão seguida de cancelamento, devolução ou divergência de cobrança. O controle exige chaves de correspondência e interpretação de status, não apenas associação por valor monetário parecido.
O que é o recolhimento pelo adquirente?
A documentação distingue informações de recolhimentos realizados pelo adquirente, incluindo a referência ao RAD. O conceito deve ser tratado exatamente no escopo legal e técnico do serviço, sem ser equiparado a uma retenção obrigatória e generalizada em todas as compras de atacadistas. A natureza da operação e a etapa de implantação determinam como o evento deve ser interpretado.
No ERP, é importante identificar o sujeito responsável pelo recolhimento e a obrigação a que ele se refere. A baixa do documento financeiro de uma compra não comprova, isoladamente, que o recolhimento tributário correspondente foi reconhecido corretamente.
O RAD, ou Recolhimento pelo Adquirente, aparece na documentação de apuração da CBS como modalidade técnica específica. Não se deve apresentá-lo como sinônimo de split payment obrigatório em todas as vendas. Regras de incidência e responsabilidades podem variar e precisam ser verificadas no dispositivo legal e na documentação do serviço. A menção ao RAD no cronograma de APIs não prova que cada empresa de atacado deva utilizá-lo desde novembro de 2026.
A reconciliação deve registrar quem aparece como responsável pelo recolhimento, qual débito está sendo quitado e qual documento ou evento financeiro fornece o vínculo. Uma mesma empresa pode atuar como vendedora em uma operação e adquirente em outra, mas isso não autoriza aplicar a modalidade indiscriminadamente. O papel do ERP é preservar a distinção, não ocultá-la em um campo geral chamado “imposto pago”.
Como construir a conciliação em camadas?
A primeira camada é técnica: autenticação, coleta, recepção do retorno, controle de versão, verificação de duplicidade e registro de falhas. A segunda é fiscal e financeira: ligação com documento, período, contribuinte, valor devido, pagamento e evento de recolhimento. Somente depois de confrontar essas camadas uma divergência pode ser classificada como técnica, operacional ou material.
A empresa deve guardar histórico do retorno consultado, da decisão tomada e do momento em que o valor foi reconhecido internamente. Isso facilita a reconstrução de diferenças entre a visão da Tesouraria e a situação demonstrada na apuração.
Uma arquitetura de controle pode usar dois livros lógicos. O primeiro reúne documentos e apurações: chave da NF-e, estabelecimento, período, natureza da operação, débito e crédito. O segundo reúne eventos financeiros: recebimento, pagamento, eventual recolhimento pelo adquirente, identificador do retorno e status. A conciliação vincula os dois sem eliminar o histórico de atualizações. Diferenças precisam ser classificadas: evento ausente, atraso de retorno, documento sem chave, duplicidade ou divergência material.
Uma solução frágil permite que a TI apague o evento antigo quando chega nova versão, perdendo a trilha de auditoria. Uma solução mais confiável guarda a resposta anterior, registra quando e por que o status mudou e permite reprocessar a competência. Isso importa particularmente em fechamento, quando um pagamento localizado depois da primeira extração pode alterar a visão gerencial sem modificar o documento fiscal original.
Por que os eventos assíncronos merecem atenção?
Sistemas integrados não recebem necessariamente todas as informações no mesmo instante. Um pagamento pode ser registrado antes de determinada atualização de status; uma consulta incremental pode retornar alteração referente a operação já processada. Por isso, o projeto precisa prever novas consultas e reprocessamento de eventos, conforme o contrato do serviço.
Se o ERP considerar a ausência momentânea de retorno como prova de inadimplência, pode produzir relatórios incorretos. O tratamento deve distinguir dado ainda não recebido, erro de integração, ausência real de pagamento e divergência de valor.
Ao receber registros em momentos diferentes, o sistema pode interpretar a ausência provisória de um retorno como erro definitivo. Essa conclusão é arriscada. Um evento pode estar pendente de processamento, outra consulta pode falhar por indisponibilidade temporária e uma operação pode ter sido atualizada após a última sincronização. A integração precisa manter estados intermediários e executar reconciliação complementar antes de encerrar uma divergência.
O gestor deve pedir um teste de reprocessamento ao fornecedor: selecione uma competência com retorno inicial e alteração posterior, e observe se a solução atualiza o estado sem duplicar valores. Depois, simule falha de conexão e recuperação. O resultado tem mais valor que prometer “conciliação automática”, porque demonstra comportamento nos cenários que efetivamente exigem controle.
Quais indicadores e testes devem ser priorizados?
Um piloto deve acompanhar transações conciliadas, eventos sem vínculo, diferença de valores, atraso na atualização e tempo para resolução. Os testes precisam incluir duplicidade, pagamento parcial, estorno e mudanças referentes a períodos anteriores. Sempre que o endpoint não oferecer determinado comportamento, o roteiro deve ser ajustado ao contrato oficial.
A meta não é criar um painel bonito: é garantir que Fiscal, Tesouraria e TI compartilhem a mesma explicação dos dados. Essa consistência sustenta o controle de débitos e créditos durante a transição para a CBS.
Perguntas frequentes
Qual a diferença entre consulta de pagamentos e emissão de DARF?
A consulta retorna informações registradas; a emissão de DARF gera instrumento de arrecadação, conforme a modalidade prevista.
O que é RAD?
É a referência técnica ao recolhimento pelo adquirente, conforme as condições legais e o serviço divulgado.
As APIs já são obrigatórias para todos?
A disponibilização é gradual. É necessário verificar o ambiente e as exigências vigentes.
Como tratar retorno duplicado?
Com chaves persistentes, idempotência e histórico de processamento.
O que a distribuidora deve decidir agora?
A melhor decisão surge quando a equipe consegue indicar a regra aplicável, os documentos de suporte, o efeito operacional e as pendências ainda abertas. Números publicados por órgãos oficiais ajudam a identificar tendências e riscos, mas não substituem a análise do contribuinte. Cada revisão deve ter dono, prazo e conclusão registrada.
Uma arquitetura de conciliação bem definida permite testar integrações e identificar riscos antes de utilizá-las em decisões de caixa.