Sua empresa poderá receber mais informações sobre pagamentos da CBS diretamente dos sistemas da Receita Federal. Mas, quando esses registros chegarem ao ERP, a equipe conseguirá identificar a operação que originou cada valor, conferir o período de apuração e explicar eventuais diferenças?

As APIs da CBS em novembro de 2026 avançam para uma nova etapa, segundo o cronograma divulgado pela Receita Federal em 14 de setembro: duas consultas da Apuração Assistida da Contribuição sobre Bens e Serviços estão previstas para o início do mês — pagamentos que extinguem débitos do contribuinte e recolhimentos realizados por ele na condição de adquirente. A implantação foi anunciada de forma gradual, nos ambientes de Produção Restrita (Piloto da CBS) e Produção Beta. A disponibilidade efetiva deve ser confirmada para cada serviço e ambiente.

Para distribuidoras, atacadistas, indústrias e grupos com grande volume documental, a novidade ultrapassa a integração tecnológica. Ela amplia as possibilidades de acompanhar informações de arrecadação e compará-las com documentos fiscais, registros financeiros e dados internos. A API transporta a informação; o controle depende de conseguir interpretá-la, conciliá-la e acompanhar o que ficou pendente.

Quais novas consultas da CBS estão previstas para novembro de 2026?

O anúncio da Receita organiza a evolução das APIs da CBS em etapas. As consultas de débitos e créditos foram posicionadas para o início de outubro. Já o início de novembro concentra os serviços de consulta de pagamentos e recolhimentos como adquirente. Uma etapa posterior, prevista para o final do mês, contempla a emissão de DARF relacionada ao Recolhimento pelo Adquirente (RAD) e ao Pagamento pelo Contribuinte (PCONT).

Esse calendário consta da comunicação oficial da Receita Federal. É importante separar três situações: existir documentação publicada, existir um serviço disponível em determinado ambiente e existir autorização para uma empresa consumi-lo. Nenhuma delas, isoladamente, comprova disponibilidade universal na data da leitura.

Qual é a diferença entre consultar pagamentos e recolhimentos como adquirente?

As duas consultas observam movimentos relacionados à CBS, mas partem de perspectivas diferentes. Entender essa distinção é essencial para definir a quem pertence cada registro e qual área deverá conferi-lo.

Consulta de pagamentos: a visão do contribuinte cujo débito é extinto

Conforme a documentação oficial de pagamentos da CBS, o serviço retorna atualizações dos pagamentos que extinguem débitos do contribuinte. Ele considera tanto pagamentos efetuados pelo próprio contribuinte quanto recolhimentos realizados por seus adquirentes.

Imagine uma indústria que precisa acompanhar a extinção de débitos de CBS. Sua equipe poderá analisar informações de pagamentos próprios e, nas situações aplicáveis, recolhimentos relacionados a operações com clientes adquirentes. O desafio será associar os retornos ao período e aos registros internos correspondentes, respeitando a natureza de cada pagamento.

Consulta de recolhimentos: a visão de quem atua como adquirente

A consulta de recolhimentos como adquirente abrange registros de CBS recolhida na modalidade RAD. Aqui, a empresa observa os recolhimentos que efetuou nessa condição. A estrutura documentada prevê informações como identificação do fornecedor, chave do documento fiscal eletrônico, período de apuração, número do DARF e composição de valores, conforme o preenchimento do retorno.

Portanto, uma distribuidora poderá precisar conciliar um recolhimento efetuado como adquirente com o fornecedor e a operação de compra correspondente. Já esse fornecedor, sob a perspectiva de contribuinte, poderá acompanhar a informação entre os pagamentos associados à extinção de seus débitos, quando aplicável. O mesmo contexto econômico pode exigir conferências distintas em cada empresa.

Essas consultas não são sinônimos de split payment operacionalmente disponível para qualquer transação, nem substituem o serviço separado de emissão de DARF. As modalidades e seus efeitos dependem das regras e das condições aplicáveis.

O que muda com as consultas incrementais da CBS?

As novas APIs foram desenhadas para devolver informações incluídas ou atualizadas desde consultas anteriores, em vez de exigir a recuperação integral dos dados a cada execução. Isso pode reduzir arquivos, tráfego e esforço de processamento. Porém, também faz da continuidade das consultas parte da confiabilidade da integração.

Nas especificações de pagamentos e recolhimentos, quando existe solicitação concluída nos últimos três meses, a busca considera a atualização da consulta concluída mais recente, com recorte limitado aos últimos oito dias. Sem consulta concluída nesse período, a regra descrita começa no primeiro dia do mês corrente. Essa lógica deve ser considerada no desenho da rotina e na recuperação de falhas; não convém tratar a API incremental como um arquivo histórico irrestrito.

Uma integração pode funcionar hoje e ter deixado de buscar alterações em dias anteriores. Por isso, não basta registrar que uma chamada terminou: é necessário manter histórico de execuções concluídas, horários, retornos recebidos, eventos reprocessados e lacunas que precisem de investigação.

Como funciona o processamento das novas APIs na prática?

As consultas são assíncronas. Em linguagem operacional, isso significa que a solicitação aceita pela Receita não entrega imediatamente todos os registros finais. Primeiro, o sistema recebe um tíquete de solicitação. Depois, acompanha o processamento até obter o arquivo de retorno.

A documentação das regras comuns e as perguntas frequentes técnicas descrevem este percurso:

1. O sistema obtém um token de acesso e solicita a consulta para o CNPJ base, conforme as credenciais e autorizações do serviço.
2. A Receita retorna um tiqueteSolicitacao, que identifica o pedido aceito para processamento.
3. A conclusão pode ser acompanhada por webhook opcional ou pela consulta de situação. Quando houver webhook, a configuração e a proteção do endpoint precisam ser verificadas.
4. Com a situação concluída, a integração obtém uma urlAssinada e baixa o arquivo JSON para processamento interno.
5. A empresa registra o recebimento, relaciona os dados aos seus controles e encaminha diferenças para análise.

Na documentação consultada em 26 de outubro de 2026, o limite indicado é de até quatro solicitações de abertura por dia, por credencial e por API, e o arquivo fica disponível por até 48 horas após o aviso de prontidão, observada a expiração da URL assinada. O tempo limite de processamento documentado é de até quatro horas. Esses parâmetros exigem planejamento de agenda, monitoramento de falhas e controle da recuperação dos arquivos. Também devem ser reconferidos na versão vigente antes da implantação.

Para TI, há uma preocupação adicional: tokens e URLs assinadas são informações sensíveis e não devem aparecer em logs abertos. A EloFiscal já abordou a gestão de credenciais em seu artigo sobre acesso às APIs da Reforma Tributária. Para o Fiscal, o essencial é receber a confirmação de que os dados foram efetivamente processados — e não apenas de que a requisição foi aceita.

Por que receber pagamentos automaticamente não significa conciliar a CBS?

Uma consulta bem-sucedida confirma que determinado conjunto de dados foi retornado. Ela não assegura, sozinha, que os registros estejam associados ao fornecedor correto, ao documento esperado, ao pagamento identificado no Financeiro ou ao período de apuração utilizado pela equipe fiscal.

Há pelo menos quatro estados diferentes para uma informação: recebida, identificada, conciliada e explicada. Um arquivo JSON pode estar armazenado sem que ninguém saiba a qual operação ele pertence. Um recolhimento pode estar identificado, mas apresentar diferença em relação ao controle interno. E uma diferença pode decorrer de atualização ainda não processada, agrupamento, período distinto ou classificação inadequada — sem que isso demonstre, por si só, irregularidade tributária.

O método de conciliação precisa trabalhar com chaves consistentes. Conforme o tipo de registro e os campos efetivamente preenchidos, isso pode envolver CNPJ, identificação do fornecedor ou adquirente, chave do documento fiscal eletrônico, número do DARF, período de apuração, data da arrecadação e valores. Nem todo retorno terá a mesma granularidade ou permitirá correspondência automática de um para um com lançamentos bancários e documentos.

É nesse ponto que a integração técnica encontra a gestão: a equipe precisa definir quais correspondências podem ser automatizadas, quais exceções exigem julgamento humano e como registrar a conclusão de cada investigação. Essa disciplina também é importante na conciliação entre documentos, escrituração e fechamento fiscal.

Exemplo: como uma distribuidora pode conciliar um recolhimento da CBS?

Considere uma situação hipotética. Uma distribuidora trabalha com centenas de fornecedores e utiliza sistemas separados para compras, gestão de documentos fiscais, contas a pagar e apuração. Em uma operação sujeita ao mecanismo aplicável, ela efetua um recolhimento de CBS na condição de adquirente.

Ao consumir a consulta de recolhimentos, seu sistema recebe um registro que precisa ser relacionado à compra. A equipe não deve iniciar a conferência apenas pelo valor: primeiro verifica o CNPJ do fornecedor e a chave do documento fiscal eletrônico, quando disponíveis. Em seguida, compara o período de apuração, a data de arrecadação, o número do DARF e a composição do valor com os controles internos pertinentes.

Se o valor retornado não coincidir com um lançamento esperado, a ocorrência entra em uma fila de análise. Compras confirma a operação e o fornecedor; o Financeiro verifica os controles de pagamento; o Fiscal avalia o enquadramento e a informação de arrecadação; TI confirma se o retorno foi recebido, interpretado e atualizado corretamente. O histórico registra a hipótese investigada, a evidência consultada, o responsável e o desfecho.

O fornecedor, por sua vez, poderá analisar a operação pela consulta de pagamentos que extinguem seus débitos, quando essa informação estiver disponível e a modalidade for aplicável. Assim, a mesma situação exige conciliação da distribuidora como adquirente e do fornecedor como contribuinte, sem presumir que os sistemas de ambos apresentem exatamente a mesma tela ou o mesmo agrupamento.

Esse exemplo não representa um cliente real, não pressupõe recolhimento obrigatório em todas as compras e não indica automaticamente erro, perda de crédito ou penalidade. Seu objetivo é demonstrar por que identificadores consistentes e uma trilha de conferência são indispensáveis mesmo quando a coleta é automática.

Como Fiscal, Financeiro e TI devem dividir as responsabilidades?

A gestão das novas consultas não deve ficar concentrada no fornecedor do ERP. A tecnologia executa a comunicação, mas a empresa precisa estabelecer quem responde pela interpretação dos dados e por cada exceção.

A matriz é uma recomendação de governança, não uma obrigação legal universal. Seu propósito é impedir que um registro fique invisível porque todos presumiram que outra área o acompanharia. Também ajuda a Controladoria a distinguir uma diferença fiscal efetiva de uma informação ainda pendente de integração ou análise.

O que revisar antes de utilizar as consultas da CBS?

A preparação deve começar com uma avaliação da cadeia de informação. Para cada serviço previsto, a empresa precisa documentar o ambiente autorizado, os dados esperados, as dependências e a forma de comprovar que o processo funcionou de ponta a ponta.

1. Disponibilidade e ambiente: confirmar na Receita e com o fornecedor de tecnologia quais serviços foram efetivamente liberados, para quais participantes e em quais ambientes.
2. Credenciais e autorização: revisar acesso, tokens, CNPJ base, permissões e responsabilidades de manutenção, sem expor informações sensíveis.
3. Fluxo assíncrono: testar solicitação, recebimento do tíquete, acompanhamento da situação, obtenção da URL assinada e download dentro do prazo.
4. Continuidade incremental: registrar consultas concluídas e criar alerta quando uma rotina não executar ou não processar o resultado esperado.
5. Chaves de conciliação: verificar se ERP, documentos, fiscal e financeiro utilizam identificadores que permitam relacionar fornecedor, operação, período e valor.
6. Exceções e responsáveis: definir quem recebe divergências, quais evidências serão necessárias e como ocorrerão correção, reprocessamento e encerramento.
7. Teste ponta a ponta: acompanhar uma amostra de retornos, da solicitação à conferência final, registrando o que foi comprovado e o que continua pendente.

Uma empresa que já utiliza ERP não precisa necessariamente trocar de sistema. Ela precisa avaliar se sua arquitetura atual consegue incorporar os novos retornos com rastreabilidade, conciliá-los aos controles existentes e dar visibilidade às exceções. O guia da EloFiscal sobre integração das APIs da CBS aprofunda a etapa anterior, relacionada à circulação de dados da apuração.

Como a operação fiscal por evidência contribui para essa preparação?

As consultas de novembro tornam mais evidente uma necessidade que já existe na rotina fiscal: conectar a informação recebida a seu contexto. Um registro de arrecadação só ajuda a equipe quando pode ser confrontado com documentos, cadastros, eventos, controles internos e decisões anteriores.

A EloFiscal atua nesse território ao apoiar a centralização de documentos fiscais, a visibilidade de pendências, a rastreabilidade e a análise das informações que alimentam a operação. Sua proposta é complementar o ERP e reduzir a dependência de buscas e controles paralelos. Isso não significa afirmar que a plataforma já consome os novos endpoints de pagamentos e recolhimentos da CBS; eventual integração específica precisa ser confirmada com a equipe de Produto.

Para conhecer os caminhos disponíveis e avaliar as necessidades da sua empresa, consulte a página de integrações da EloFiscal. A análise deve considerar as fontes de dados, os sistemas envolvidos e os pontos em que uma divergência deixaria de ser percebida.

Conclusão: a nova consulta precisa terminar em uma resposta confiável

O avanço das APIs da CBS pode tornar o acompanhamento de pagamentos e recolhimentos mais estruturado. Entretanto, o ganho não aparece automaticamente quando um sistema consegue baixar um arquivo. Ele surge quando a empresa sabe o que recebeu, a que operação o registro se refere, como o valor foi conferido e quem precisa agir diante de uma diferença.

Antes de ampliar as integrações, vale diagnosticar se documentos, ERP e Financeiro já contam uma história conciliável. Avalie com a EloFiscal os pontos de fragmentação da sua base documental e dos fluxos internos, para decidir quais controles devem ser preparados para a nova etapa da CBS.

Perguntas frequentes sobre as APIs da CBS em novembro de 2026

Quais APIs da CBS estão previstas para novembro de 2026?

Para o início de novembro, a Receita Federal programou a consulta de pagamentos e a consulta de recolhimentos como adquirente. Para o final do mês, anunciou serviços de emissão de DARF RAD e PCONT. A disponibilidade efetiva depende do ambiente, das autorizações e de eventuais atualizações no cronograma.

Qual é a diferença entre consulta de pagamentos e consulta de recolhimentos como adquirente?

A consulta de pagamentos acompanha registros que extinguem débitos do contribuinte, incluindo pagamentos próprios e recolhimentos de seus adquirentes. A consulta de recolhimentos como adquirente observa recolhimentos efetuados por quem está na posição de adquirente, na modalidade RAD.

O que significa consulta incremental da CBS?

Significa receber inclusões e atualizações dentro do intervalo definido pela documentação, em vez de solicitar novamente toda a base histórica. A regra publicada limita a janela de determinadas consultas aos últimos oito dias, consideradas as condições de consultas concluídas anteriormente.

As novas APIs da CBS já podem ser utilizadas por todas as empresas?

O anúncio oficial não comprova disponibilidade universal. A Receita previu liberação gradual em Produção Restrita e Produção Beta. A empresa deve confirmar o ambiente, suas credenciais, sua autorização e a disponibilidade real de cada serviço.

Quando a emissão de DARF por API está prevista?

Segundo o cronograma anunciado em setembro de 2026, a emissão de DARF para RAD e PCONT está prevista para o final de novembro de 2026. Emitir DARF é um serviço diferente de consultar pagamentos ou recolhimentos.

O webhook é obrigatório para acompanhar as solicitações?

Não. A documentação permite enviar o campo de retorno vazio e acompanhar a solicitação pelo serviço de consulta de situação. Caso a empresa utilize webhook, deve observar os requisitos de disponibilidade e as recomendações de segurança.

As APIs fazem a conciliação de pagamentos automaticamente?

Não. Elas fornecem informações estruturadas. Para conciliá-las, a empresa precisa associar os retornos aos registros internos, avaliar diferenças, preservar evidências e definir responsáveis pelo tratamento.

Quais equipes precisam participar da adaptação?

Fiscal, Financeiro e TI/ERP devem participar. Compras, Contabilidade e Controladoria também podem ser necessárias, conforme a operação. A divisão de tarefas depende da estrutura da empresa e dos sistemas utilizados.

Uma divergência entre a API e o ERP significa erro tributário?

Não necessariamente. Uma diferença pode refletir atualização ainda não processada, período distinto, identificação inadequada ou outro critério de registro. A equipe precisa investigar a causa e verificar os efeitos fiscais concretos antes de concluir que houve irregularidade.

Referências e fontes utilizadas

• Receita Federal — Nova documentação técnica das APIs de Apuração da CBS. Comunicado de 14 de setembro de 2026 e cronograma de disponibilização.
• Receita Federal — Consultar pagamentos de CBS. Documentação técnica, versão 1.2 de 14 de outubro de 2026.
• Receita Federal — Consultar recolhimentos de CBS como adquirente. Documentação técnica, versão 1.2 de 14 de outubro de 2026.
• Receita Federal — Regras comuns das APIs assíncronas da Apuração de CBS. Documentação técnica, versão 1.1 de 14 de outubro de 2026.
• Receita Federal — Dúvidas frequentes sobre as APIs da Apuração Assistida. Procedimentos de autenticação, consulta, retorno e restrições.