No final de 2025, a Receita Federal deu um passo decisivo para a viabilização da Reforma Tributária: a liberação da API de Consulta à Apuração da CBS (Contribuição sobre Bens e Serviços). Para as Software Houses, isso não é apenas uma “atualização de sistema”, mas a abertura de um canal direto de comunicação entre o ERP e a base de dados do Fisco em tempo real.
O Que a Nova API Permite Consultar?
A API foi projetada para retornar dados estruturados (JSON) que permitem ao software de gestão validar se a apuração interna está batendo com a visão do governo. Atualmente, o serviço retorna:
- Débitos de CBS: Relativos ao mês corrente e anterior (período de ajuste).
- Créditos: Informações sobre créditos tributários processados.
- Pagamentos: Dados sobre a extinção dos débitos via pagamentos efetuados.
Neste momento, a funcionalidade opera em Produção Restrita. Isso significa que apenas as empresas participantes do projeto-piloto podem realizar os testes, utilizando documentos fiscais simulados. A liberação para todos os contribuintes está confirmada para janeiro de 2026.
Ecossistema de APIs da Reforma Tributária
A API da CBS é apenas uma peça do quebra-cabeça. Outros serviços essenciais já estão com endpoints disponíveis ou em fase final de homologação:
1. API do Portal da Conformidade Fácil
Gerenciada pelo ENCAT, esta API é vital para manter o ERP atualizado com as tabelas de codificação da reforma.
- Função: Retorna tabelas de CST e cClassTrib (Classificação Tributária).
- Endpoint:
https://cff.svrs.rs.gov.br/api/v1/consultas/classTrib - Dica Técnica: A orientação é realizar apenas um “GET” diário por empresa, evitando loops desnecessários.
2. API da Calculadora de Consumo
Um serviço do SERPRO que ajuda a simular o cálculo do IVA Dual (IBS e CBS) com base nas novas alíquotas de teste (0,9% e 0,1%).
- Acesso: Disponível no portal piloto-cbs.tributos.gov.br.
Desafios de Integração: Autenticação e Procuradores
Diferente de webservices antigos baseados apenas em CNPJ, as novas APIs da Receita Federal exigem autenticação mútua com certificado digital (TLS 1.2).
- Procuradores Digitais: Uma funcionalidade importante é a capacidade de procuradores gerarem suas próprias credenciais para as APIs, desde que a relação contribuinte-procurador esteja devidamente habilitada no portal.
O Futuro Próximo: Split Payment em 2027
Embora as APIs de consulta estejam focadas na apuração, a Receita já sinalizou que a infraestrutura para o Split Payment (recolhimento automático no ato do pagamento) será o próximo grande desafio tecnológico, com implementação gradual prevista a partir de 2027.
Implemente a Reforma com Código de Quem Entende
Não perca tempo tentando decifrar manuais complexos sozinho. O Regys.com.br fornece fontes de aplicativos de documentos fiscais com suporte incluso e atualização para a Reforma Tributária. Garanta que seu ERP consuma as novas APIs da Receita com segurança e eficiência, contando com o auxílio de quem acompanha cada Nota Técnica lançada.
Referências Utilizadas e Validadas
BRASIL. Ministério da Fazenda. Receita Federal. Orientações da Reforma Tributária para 2026. Portal Gov.br, 2025. Disponível em: https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/acoes-e-programas/programas-e-atividades/reforma-consumo/orientacoes-2026. Acesso em: 06 jan. 2026.
ENCAT. Notícias – Portal da Conformidade Fácil: Liberada API de integração. Porto Alegre: SVRS, 2025. Disponível em: https://dfe-portal.svrs.rs.gov.br/Cff/Noticias/2967. Acesso em: 06 jan. 2026.
RECEITA FEDERAL. Receita libera API para consulta à apuração de CBS. Portal Gov.br, dez. 2025. Disponível em: https://www.gov.br/receitafederal/pt-br/assuntos/noticias/2025/dezembro/receita-libera-api-para-consulta-a-apuracao-de-cbs. Acesso em: 06 jan. 2026.
Descubra mais sobre Régys Borges da Silveira
Assine para receber nossas notícias mais recentes por e-mail.
Bom dia,
Estão liberadas sim e para todas as empresas, desde o início de janeiro.
Depois de muita luta eu consegui encontrar os endPoints e já tenho quase tudo funcionando.
Só para compartilhar, o processo é seguinte:
1 – A empresa precisa gerar uma credencial no gov.br (clientID e secretID);
2 – De posse dessa credencial, aciona-se a rota https://api.receitafederal.gov.br/token, onde é retornado um token;
3 – Com o token, deve ser feito um request um código de tiquete (outra rota). Esse código de tiquete eh retornado via webHook;
4 – De posse do tiquete, aciona-se uma tereceira rota para baixar um arquivo json com dados da apuração.
As etapas anteriores, já consegui fazer funcionar 100%.
Somente esta busca do arquivo que ainda não concluí. Até consegui fazer o request com êxito, mas o responsde está retornando em branco.
Continuo tentando, rs.
Caso queira mais detalhes, é só avisar.
Obrigado!
Então, eles ainda não fecharam todos os endpoints, dias atrás houve uma paletra online inclusive falando da calculadora e disso, eles liberaram com algumas coisas por fazer.
Bom dia,
Alguns endpoints do projeto piloto nós já vimos utilizando desde ano passado, mesmo não participando do projeto piloto e funciona legal. Só não pode abusar nas requisições, rs.
Nessas 3 opções que você cita (consulta débitos, créditos e pagamentos), não encontrei documentação em nenhum lugar.
Você saberia dizer quais as rotas dessas consultas?
Obrigado
Ainda estão liberados somente para participantes do piloto, devemos ter novidades nos próximos meses.