APIs 2.0 de apuração da CBS em produção restrita e beta: o que a liberação exige da integração do ERP

A integração entre o ERP e a apuração assistida da CBS deixou de ser tema de desenho e passou a ser tema de execução. A Receita Federal liberou, na quarta-feira de 28 de outubro, as versões 2.0 das APIs para consulta à apuração de débitos e créditos de CBS, com dados disponíveis tanto em produção restrita (testes) quanto em produção (beta). A atualização é relevante para empresas que já mantêm ou planejam interfaces automáticas com os serviços de tributação sobre consumo, porque altera o pré-requisito de acesso — credenciais antigas precisam ser substituídas — e formaliza o conjunto de dados que o sistema do contribuinte passa a poder recuperar.

O que mudou

A Receita Federal informa que foram liberadas as versões 2.0 das APIs para consulta à apuração de débitos e créditos de CBS, disponibilizadas para consulta de dados de produção restrita (testes) e de produção (beta). A publicação é apresentada como desdobramento de matéria anterior, de setembro, sobre a publicação de nova documentação técnica das APIs de apuração de CBS. A nova versão permite consultas incrementais de débitos e créditos apurados.
Para a área fiscal e de tecnologia, a mudança é de natureza prática: a mesma base de dados que alimenta o serviço Minha Apuração Assistida de CBS do portal passa a estar acessível por interface de sistema, sincronizada em relação ao processamento dos documentos fiscais e eventos.

Consulta de débitos: o que o ERP recebe

A consulta de débitos de CBS retorna ao sistema do contribuinte informações relativas à origem do débito e ao documento fiscal de referência, às datas de emissão, registro e atualização, além dos valores do tributo conforme o estado em que se encontra — suspenso, extinto, devedor, entre outros.

Esse conjunto tem consequência direta para a rastreabilidade. A presença do documento fiscal de referência e das três datas no retorno permite que a área fiscal associe cada débito a um documento específico e identifique a posição temporal do registro, em vez de trabalhar apenas com o valor consolidado. A distinção de estado do tributo — suspenso, extinto, devedor — é o elemento que separa, no retorno da API, aquilo que ainda é exigência daquilo que já foi extinto, informação necessária para qualquer conciliação entre a apuração do ERP e a apuração assistida.

Consulta de créditos: parcela apropriada e a apropriar

A consulta de créditos de CBS oferece informações sobre os valores apurados, incluindo a parcela apropriada — liberada para utilização — e a parcela a apropriar, utilizada e não utilizada.

A granularidade descrita é o ponto de atenção operacional. O crédito não é devolvido como valor único: o serviço distingue o que já está liberado para uso do que permanece em processo de apropriação, e dentro dessa segunda parcela separa o que já foi utilizado do que ainda não foi. Para o ERP, isso significa que a interface não substitui apenas um relatório de saldo; ela fornece a decomposição necessária para controlar crédito disponível, crédito consumido e crédito pendente de liberação, cada um com tratamento distinto na apuração.

Credencial de acesso: pré-requisito e ponto de ruptura

O acesso às APIs exige que o contribuinte, ou seu procurador digital, obtenha uma chave por meio do serviço digital “Gerar Credencial de Acesso”, disponível nos portais Serviços da Receita Federal e Tributação sobre Consumo (Beta). Contribuintes que já possuam chaves geradas precisarão cancelá-las e gerar novas chaves para ter o acesso.

Esse é o item de maior risco imediato para integrações já implantadas. A exigência de cancelamento das chaves existentes e de geração de novas significa que a substituição da credencial é condição de acesso, e não uma etapa opcional de melhoria. Do ponto de vista de governança, a credencial deixa de ser detalhe de infraestrutura e passa a ser item de controle: quem a detém tem acesso a dados de apuração de débitos e créditos, seja o próprio contribuinte, seja o procurador digital habilitado.

Consistência de dados entre portal e sistema

Os dados obtidos pelas APIs vêm da mesma base que fornece informações ao serviço Minha Apuração Assistida de CBS do portal, estando sincronizados em relação ao processamento dos documentos fiscais e eventos.

A afirmação é relevante para o desenho do processo de conciliação. Como a origem é comum, a comparação entre o que o ERP apurou e o que a Receita Federal apresenta não depende de duas fontes distintas que precisariam ser harmonizadas previamente: a referência é a mesma base, atualizada conforme o processamento de documentos e eventos. Não foi informado, porém, latência de sincronização, periodicidade de atualização nem critérios de retificação.

Impactos para a integração com ERP

O que é possível afirmar é o escopo funcional que a interface precisa acomodar: leitura de débitos com documento de referência, datas e estado do tributo; leitura de créditos com segregação entre parcela apropriada e a apropriar, utilizada e não utilizada; e renovação prévia de credencial como etapa obrigatória de acesso. Esses três blocos definem o que a camada de integração precisa tratar, independentemente da tecnologia adotada.

Conclusão e próximos passos

A liberação das versões 2.0 consolida três elementos: as APIs de apuração de CBS estão disponíveis para consulta em produção restrita e em produção beta; o acesso depende de credencial obtida no serviço digital próprio, com cancelamento e regeneração das chaves já existentes; e o retorno abrange débitos com documento de referência, datas e estado do tributo, e créditos segmentados entre parcela apropriada e a apropriar, utilizada e não utilizada, a partir da mesma base do Minha Apuração Assistida de CBS.

Como próximos passos, cabe acompanhar a liberação dos novos serviços vinculados à apuração de CBS previstos para novembro e utilizar a documentação técnica publicada pela Receita Federal como referência de integração. Antes disso, o pré-requisito de credencial deve ser tratado como atividade de planejamento: mapear as chaves em uso, programar o cancelamento e a geração de novas chaves e verificar o impacto disso nas interfaces já em operação.