Créditos de CBS: sua empresa sabe de onde eles vêm?
Como conferir créditos de CBS desde a nota do fornecedor
Para conferir créditos de CBS, use a chave do documento fiscal para comparar os dados da Receita Federal com a nota e o registro no ERP. Assim, a equipe consegue investigar a origem de uma diferença antes de considerar o valor no fechamento.
5 minutos de leitura.
O que mudou com as APIs da CBS
Em 9 de novembro de 2026, a Receita Federal comunicou a liberação da versão 2.0 das APIs de consulta a débitos e créditos da Contribuição sobre Bens e Serviços. Os serviços estavam disponíveis desde 28 de outubro nos ambientes de testes e de produção beta.
A consulta funciona por atualizações. Ou seja, retorna inclusões e mudanças dentro da janela prevista, em vez de trazer todo o histórico a cada solicitação. Além disso, a Receita processa a consulta de forma assíncrona. O sistema recebe um tíquete e obtém o resultado quando o processamento termina.
Por isso, uma consulta sem movimentos pode indicar que a janela não trouxe atualizações. Antes de investigar a ausência de um crédito, registre o ambiente e a data da última consulta concluída. Assim, a equipe mantém o contexto dos dados que recebeu.
O pedido da AFRAC para a transição
Em 12 de novembro, a AFRAC relatou reuniões em Brasília nas quais apresentou dificuldades para testar o ciclo completo da apuração assistida. Além disso, uma carta aberta datada de 10 de novembro reúne entidades do setor produtivo que pedem a ampliação dos testes para 2027.
O pedido das entidades tem caráter de proposta. Para as empresas, a medida prática é testar como os sistemas e as equipes lidam com documentos, eventos e diferenças de processamento enquanto acompanham as decisões oficiais sobre o cronograma.
Como interpretar os créditos de CBS retornados na consulta
A consulta usa o CNPJ base e traz a chave fiscal em cada registro de crédito. Com a chave em mãos, a equipe localiza o XML no recebimento. Em seguida, compara o documento com o pedido e o lançamento no ERP.
Os valores têm funções diferentes, conforme a etapa em que o crédito se encontra.
- O valor apurado indica quanto a Receita processou a partir do documento e da origem do crédito.
- O valor a apropriar indica a parcela que aguarda apropriação e, portanto, continua indisponível para uso.
- O valor apropriado indica quanto já ficou apto a compensar débitos. O saldo pode ser menor, porque parte desse montante já pode ter sido utilizada.
- O saldo credor mostra a parcela apropriada que permanece disponível.
Por exemplo, em um cenário hipotético, a consulta pode apresentar R$ 100 apurados, dos quais R$ 30 aguardam apropriação. Se a empresa já utilizou R$ 50 dos R$ 70 apropriados e não há outros eventos, o saldo credor é de R$ 20.
A chave da nota permite voltar do saldo exibido na consulta à operação que deu origem ao crédito.
O que conferir quando o fornecedor cancela uma nota
Imagine que um fornecedor cancele uma nota fiscal eletrônica e emita outra para a mesma compra. O pedido permanece, mas cada documento tem sua própria chave. Se o ERP ainda mostra a nota anterior, a equipe precisa identificar qual documento sustenta o registro interno.
Confirme o evento de cancelamento e recupere o XML da nova nota. Em seguida, compare as duas chaves com os registros do ERP e com as informações disponíveis na consulta fiscal. Além disso, confira as datas de emissão e atualização para entender a sequência dos eventos.
Se uma das chaves ainda não aparecer, verifique a janela consultada e a situação do processamento. Enquanto a equipe investiga, mantenha a ocorrência associada à compra original. Assim, as duas notas podem ser analisadas em conjunto.
O que as equipes podem testar antes do fechamento
Escolha uma amostra que inclua notas sem divergência, entregas parciais e notas canceladas com nova emissão. Em seguida, peça que cada área refaça o caminho da chave fiscal até o pedido e o lançamento. Por fim, anote em quais etapas as equipes precisaram recuperar dados fora do ERP.
- Compras confirma o pedido, a entrega e o contato com o fornecedor quando houver substituição do documento.
- Fiscal revisa documentos e eventos. Em seguida, compara os estágios do crédito e registra a decisão sobre cada exceção.
- Financeiro separa, na previsão de caixa, o saldo disponível dos créditos de CBS que ainda aguardam apropriação. Assim, estima o desembolso com base nos valores que pode usar.
- TI testa o processamento das respostas para que uma atualização não duplique o registro. A chave ajuda a localizar a nota, mas a análise também deve considerar a origem do crédito e o período de apuração.
Além disso, defina quem acompanha cada ocorrência até a resolução. Guardar a chave, o motivo da diferença e a decisão tomada facilita a revisão no fechamento seguinte.
Como a Actionsys ajuda com o GRA Cloud
O GRA Cloud da Actionsys atua no recebimento dos documentos fiscais. Ele associa notas a pedidos, aplica regras configuradas e sinaliza diferenças de quantidade, preço ou informação fiscal antes da integração ao ERP.
A Actionsys configura as tolerâncias, os responsáveis e os critérios de aprovação conforme a operação. Quando a validação encontra uma exceção, o responsável recebe a ocorrência para análise e registra a decisão. Dessa forma, Fiscal e Compras preservam o contexto que precisarão recuperar ao conferir os créditos de CBS.
A plataforma oficial da Receita apresenta os valores da apuração assistida. A Actionsys ajuda a organizar a etapa anterior para que a empresa tenha documentos e registros internos consistentes ao comparar essas informações.
Para avaliar essa etapa, escolha uma divergência recorrente e peça uma demonstração de como o GRA Cloud associa a nota ao pedido, aplica a regra de conferência e registra a tratativa.
Perguntas frequentes
- O valor apurado de CBS já está disponível para uso?
- Consulte o saldo credor, pois ele mostra quanto do crédito apropriado permanece disponível.
- Como conferir um crédito quando o fornecedor emite uma nova nota?
- Localize as duas chaves, confirme o cancelamento da nota original e compare o XML da nova nota com o pedido, a consulta fiscal e a entrada no ERP.
- Onde o GRA Cloud atua na conferência dos créditos de CBS?
- A plataforma organiza a entrada fiscal, relaciona documentos a pedidos e apoia o tratamento de divergências. Assim, a equipe dispõe de registros para a conferência posterior.
Entre em contato
Se a sua equipe precisa reconstruir o histórico de uma compra para explicar uma diferença no fechamento, converse com um especialista da Actionsys sobre como estruturar a conferência no recebimento fiscal.
Fontes consultadas
- Receita Federal | Documentação das APIs de apuração de CBS
- Receita Federal | Consulta de créditos de CBS em operações de consumo
- Carta aberta aos Poderes Executivo e Legislativo sobre a ampliação dos testes
- Actionsys | GRA Cloud e gestão do recebimento fiscal


