Nox. Sistemas WhatsApp
🧾 Reforma tributária na rotina

API da CBS: como conferir os débitos com as notas da loja

Para o dono do comércio e o contador que o atende: o que muda quando a consulta da CBS deixa de passar só pelo escritório, o que separar antes de abrir o extrato e como ler uma diferença sem tirar conclusão apressada.

Leitor principal: dono do comércio que emite NF-e e NFC-e. Leitor técnico: contador que acompanha a apuração da CBS e pode recomendar a rotina de conferência.

Ver o checklist Solicitar demonstração

O que muda quando a consulta da CBS chega à loja

Hoje, na maioria dos comércios, quem consulta a situação fiscal da empresa na Receita Federal é o escritório contábil. O dono recebe um resumo, uma guia ou um aviso. Com a reforma tributária do consumo, ganhou força a previsão de que a Receita Federal ofereça, sem custo, interfaces de programação (as APIs, canais pelos quais um sistema conversa direto com outro) para consultar informações da CBS, a Contribuição sobre Bens e Serviços. Na prática, isso significa que o extrato que antes só o escritório abria pode passar a ser lido também pela empresa ou pelo sistema que ela usa.

Antes de tratar data de liberação e escopo como certos, confira no ato ou no comunicado oficial da Receita Federal o que estará disponível (débitos, créditos, pagamentos, guias) e a partir de quando. Esse tipo de cronograma já foi ajustado mais de uma vez na reforma, e a data divulgada em uma postagem pode não ser a que vale.

O ponto deste guia não depende da data: quando a Receita passa a mostrar, de forma direta, o que ela registrou a partir das notas da empresa, a loja precisa ter do seu lado uma relação organizada do que emitiu, cancelou, devolveu e comprou. Sem isso, a consulta mostra um número que ninguém na loja consegue explicar.

Por que isso importa no balcão, e não só no escritório

O contraste é este: até aqui, a consulta passava pelo escritório e a diferença, quando aparecia, era investigada por quem tinha a apuração na mão. Com um canal direto, a mesma informação pode estar disponível para a loja, mas a responsabilidade de explicar cada documento continua começando onde a nota nasceu, que é o caixa, o balcão e a entrada de mercadoria.

A CBS é calculada a partir dos documentos fiscais. Desde a fase de testes de 2026, com alíquota de 0,9% para a CBS e 0,1% para o IBS prevista na Lei Complementar 214/2025, as informações desses tributos passaram a fazer parte da NF-e e da NFC-e. Pelo Ato Conjunto RFB/CGIBS nº 1/2026, a Receita e o Comitê Gestor adiaram a rejeição automática de documentos sem algumas dessas informações, mas deixaram claro que a obrigação de informar não foi suspensa. Ou seja: a nota pode ter sido autorizada com dado incompleto, e esse dado vai aparecer em algum momento na consulta.

Para o dono, o risco não é a consulta em si. O risco é descobrir uma divergência sem saber de qual nota ela veio, já perto de um fechamento, com a equipe tentando lembrar o que aconteceu num dia de movimento. Para o contador, o risco é receber a pergunta do cliente sobre um número que ele ainda não conferiu e ter de reconstruir o mês a partir de arquivos espalhados.

A consulta direta encurta o caminho até a informação, mas não encurta o caminho até a explicação. Esse caminho continua passando pelos documentos da loja.

Um exemplo do começo ao fim

Exemplo ilustrativo

Loja de utilidades que confere o primeiro extrato da CBS com a contabilidade

  • Quem: uma loja de utilidades domésticas com dois caixas e venda a empresas no balcão
  • Regime: empresa fora do Simples Nacional, que já informa CBS e IBS nas notas desde a fase de testes
  • Documentos: NFC-e no varejo, NF-e nas vendas a empresas e nas devoluções a fornecedor
  • Operação analisada: vendas e devoluções de um mês, dentro do mesmo estado
  • Quem consulta: a contabilidade, com a loja acompanhando a conferência
  • Exemplo ilustrativo: o que o extrato traz depende do escopo que a Receita confirmar

A contabilidade abre a consulta do mês e encontra uma relação de documentos e um total de CBS. A dona da loja pergunta se aquilo bate com o que o sistema mostra. A resposta honesta é: ainda não se sabe, porque ninguém comparou documento por documento.

A equipe decide fazer a conferência em etapas, sem discutir o total antes de olhar a origem. O objetivo é separar três grupos: documentos que aparecem nos dois lados e batem, documentos que aparecem em um lado só e documentos que aparecem nos dois lados com informação diferente.

  1. Separar o que a loja emitiu

    A loja tira do sistema a relação de NFC-e e NF-e do mês, com número, série, data, situação (autorizada, cancelada, denegada) e os XML correspondentes. Inclui as notas emitidas em contingência e confere se todas tiveram retorno de autorização.

  2. Separar o que mudou depois da emissão

    A equipe lista cancelamentos, devoluções de clientes, devoluções a fornecedor e notas complementares do período. Esses eventos mudam o que deveria ser considerado e, se não estiverem amarrados à nota original, viram diferença sem explicação.

  3. Comparar com o que a Receita registrou

    A contabilidade cruza a relação da loja com a relação da consulta. Aparecem duas notas canceladas que a loja tratava como inexistentes e uma devolução de cliente que, na loja, foi feita só como troca no caixa, sem documento.

  4. Decidir quem resolve cada ponto

    As notas canceladas são conferidas pelo evento de cancelamento: se o evento foi registrado, a contabilidade verifica como ele aparece na consulta. A troca sem documento vai para a contabilidade decidir o tratamento, e a loja ajusta o procedimento de devolução no balcão.

  5. Registrar e guardar

    A equipe guarda a relação comparada, a decisão de cada divergência e quem decidiu. No mês seguinte, a conferência começa por esses pontos, e não do zero.

O que conferir antes de abrir a consulta

A comparação só funciona se a loja tiver, do seu lado, a mesma unidade de informação que a Receita usa: o documento fiscal. Total de vendas do caixa não serve para isso, porque mistura o que foi vendido com o que foi documentado.

Dado ou documentoOnde estáPara que serve na conferência
XML das notas emitidas (NF-e e NFC-e)Sistema emissor da lojaÉ a prova do que foi informado em cada documento, inclusive os campos de CBS e IBS
Situação de cada notaRetorno da autorização e eventos registradosSepara autorizada, cancelada e denegada, que não devem ser tratadas do mesmo jeito
Eventos de cancelamentoSistema emissor e portal da NF-eExplica nota que aparece na consulta mas a loja considera desfeita
Notas emitidas em contingênciaFila de transmissão do emissorConfirma se toda nota em contingência foi transmitida e autorizada
Devoluções e notas complementaresEntradas e saídas do períodoMostra o que altera o débito e precisa estar ligado à nota original
XML das comprasEntrada de mercadoriaBase para a contabilidade conferir créditos, quando a consulta trouxer esse lado
Cadastro fiscal dos produtosCadastro do sistemaAjuda a entender por que um item saiu com uma classificação e não outra

Como ler uma diferença sem concluir errado

Diferença entre a consulta e o sistema da loja não é, por si só, imposto a mais ou a menos. Ela pode vir de tempo (nota emitida no último dia do mês e processada depois), de evento (cancelamento ou devolução que um lado ainda não considerou), de dado (campo de CBS ou IBS preenchido de forma diferente do esperado) ou de documento que não existe (venda sem nota, troca sem documento).

Por isso a leitura começa pela lista e não pelo total. Primeiro, confira se os mesmos documentos estão nos dois lados. Depois, para os que estão nos dois, confira se a informação coincide. Só no fim olhe o valor consolidado, que é consequência dessas duas etapas.

Também vale separar informação de cobrança. O que aparece em uma consulta é o que a Receita registrou; o que efetivamente vira débito a pagar depende da apuração, dos créditos, das compensações previstas e, na fase de testes de 2026, das regras de dispensa ligadas ao cumprimento das obrigações acessórias. Quem fecha essa leitura é a contabilidade.

Por fim, não ajuste o sistema da loja para fazer o número bater. Se a diferença tem origem em uma nota com dado errado, a correção passa pelo instrumento cabível para aquele documento, e a contabilidade indica qual é.

Limite de aplicação

Este guia trata da conferência de documentos de uma empresa fora do Simples Nacional, que já informa CBS e IBS nas notas. Para o Simples, os documentos com as novas informações seguem cronograma próprio, a partir de 2027, conforme o Ato Conjunto RFB/CGIBS nº 4/2026. O escopo exato da consulta por API (débitos, créditos, pagamentos ou guias) e a data de liberação devem ser confirmados no comunicado oficial da Receita Federal antes de virar rotina.

Quem faz o quê

A consulta direta pode dar à loja acesso à mesma informação que o escritório vê. Isso não transfere a decisão fiscal para o balcão nem para o sistema. Cada parte continua com uma função clara.

ResponsávelParticipação no processo
EmpresaEmitir os documentos de cada operação, registrar cancelamentos e devoluções com documento, manter os XML organizados e entregar a relação do mês à contabilidade
ContabilidadeLer a consulta, comparar com os documentos, decidir o tratamento de cada divergência e orientar a correção cabível
Fornecedor do ERPExplicar como as notas, os eventos e as compras ficam registrados no sistema, apoiar a configuração prevista na implantação e orientar o uso
Equipe que operaEmitir a nota no momento da venda, não fazer troca ou devolução sem documento e avisar quando uma nota ficar pendente ou em contingência

Erros e sinais de divergência

Os pontos abaixo não são estatística; são situações que fazem a consulta e o sistema da loja contarem histórias diferentes, com a primeira ação para cada uma.

⚠️

Nota cancelada aparece na consulta

O total registrado fica acima do que a loja considera vendido, e ninguém sabe se o cancelamento chegou a valer

Primeira açãoLocalizar o evento de cancelamento e confirmar se foi registrado dentro do prazo; levar o caso à contabilidade se não estiver
⚠️

Troca ou devolução feita só no caixa, sem documento

A loja trata a venda como desfeita, mas o documento original continua valendo para a Receita

Primeira açãoLevar à contabilidade para decidir o tratamento e passar a registrar devolução com documento
⚠️

Nota em contingência que não foi transmitida

A venda existe na loja e não existe na consulta, o que pode gerar problema maior do que a diferença em si

Primeira açãoConferir a fila de transmissão do emissor e regularizar com a orientação da contabilidade
⚠️

Campo de CBS ou IBS preenchido de forma diferente entre produtos parecidos

A consulta mostra valores que não seguem a lógica que a loja esperava

Primeira açãoSeparar os itens, conferir o cadastro fiscal e validar a classificação com a contabilidade antes de alterar
⚠️

Conferência feita só pelo total do mês

Diferenças que se compensam ficam escondidas e reaparecem depois

Primeira açãoComparar documento por documento antes de olhar o total

Informações para reunir antes de conferir a CBS com a contabilidade

Use esta lista no fechamento de cada mês. Ela serve tanto para a conferência feita pelo escritório quanto para a consulta que a própria loja vier a fazer.

Informação a separarPara que ela serve na conferência
Relação de notas emitidas no mês, com número, série e dataTer a lista que será comparada com a consulta
XML de todas as notas emitidasConferir o que foi informado em cada documento
Situação de cada nota (autorizada, cancelada, denegada)Separar o que vale do que não vale
Eventos de cancelamento e correção do períodoExplicar notas que um lado considera e o outro não
Notas emitidas em contingência e seu retornoGarantir que nenhuma venda ficou fora da Receita
Devoluções de clientes e a fornecedores, com documentoLigar cada devolução à nota original
XML das compras do mêsPermitir à contabilidade conferir o lado dos créditos
Mudanças feitas no cadastro fiscal dos produtosEntender por que um item mudou de tratamento no meio do mês
Divergências do mês anterior e a decisão tomadaComeçar a conferência pelo que já se sabe

Como fica esse processo na Nox

Na Nox, a parte fiscal é alimentada pela própria operação: venda, compra e devolução geram os documentos e as informações que a contabilidade precisa, sem redigitação. É isso que deixa o histórico de notas pronto para ser comparado com o que a Receita mostrar. O processo abaixo descreve a rotina; os detalhes de cada etapa são apresentados na demonstração.

  • Emitir a nota na vendaO caixa ou o balcão emite a NFC-e ou a NF-e no momento da venda, a partir dos produtos cadastrados. A nota fica registrada no movimento da empresa junto com a venda que a originou.
  • Manter o cadastro fiscal dos produtosOs campos fiscais do produto (NCM, CEST, CFOP, CST/CSOSN, origem) ficam no cadastro e são usados na emissão. Mudanças são feitas a partir da orientação validada pela contabilidade.Depende de configuração: As regras fiscais de cada operação são definidas e validadas na implantação, com a contabilidade da empresa.
  • Dar entrada nas compras pelo XMLA entrada de mercadoria é feita pelo XML da NF-e do fornecedor, o que atualiza custo e estoque e mantém o documento de compra junto com o movimento.
  • Separar o mês para a contabilidadeNo fechamento, a loja consulta as notas por período e organiza os documentos e arquivos que a contabilidade precisa, saídos do próprio movimento.Depende de configuração: O formato da entrega e a forma de envio ao escritório dependem da configuração definida na implantação; é ponto a ver na demonstração.
  • Conferir com a consulta da ReceitaCom a relação do sistema em mãos, a contabilidade compara com a consulta da CBS e devolve à loja só os pontos que precisam de ação no balcão ou no cadastro.Depende de configuração: Integração direta do sistema com a API da Receita não está prevista neste guia; a conferência é feita a partir das informações que o sistema organiza.
O que o sistema executa e o que continua sendo decisão fiscal

O sistema registra as operações, emite os documentos conforme as regras configuradas e organiza as informações do mês. Ele não decide sozinho o tratamento tributário de uma operação, não substitui a leitura da contabilidade sobre a consulta da Receita e não elimina a necessidade de conferir. O que ele faz é deixar cada número com um documento de origem, para que a divergência possa ser explicada.

Quer ver esse processo na rotina da sua loja?

Solicite uma demonstração da Nox voltada à emissão de notas, à entrada de mercadorias e à organização do mês para a conferência com a contabilidade.

Solicitar demonstração
Quer avaliar esse fluxo para uma empresa que você atende?

Veja como as notas, os eventos e as compras ficam organizados no sistema e quais informações podem chegar ao escritório para a conferência da CBS.

Avaliar o fluxo com a Nox

Perguntas complementares

A consulta por API substitui o contador?

Não. Ela pode dar acesso mais rápido à informação, mas a leitura do que é débito, do que é crédito e do que precisa ser corrigido continua sendo trabalho técnico. O caso concreto de cada empresa deve ser validado pela contabilidade.

A API da CBS já está disponível?

Data de liberação e escopo devem ser confirmados no comunicado ou ato oficial da Receita Federal. Cronogramas da reforma já foram ajustados, então não organize a rotina em cima de uma data divulgada só em postagens.

Se a consulta mostrar um valor, ele já é imposto a pagar?

Não necessariamente. A consulta mostra o que foi registrado; o débito a pagar depende da apuração, dos créditos e das regras do período. Em 2026, ano de testes previsto na Lei Complementar 214/2025, há regras próprias de compensação e dispensa, que a contabilidade aplica.

Minha empresa é do Simples. Isso já vale para mim?

Os documentos fiscais dos contribuintes do Simples entram no cronograma das novas informações em 1º de janeiro de 2027, segundo o Ato Conjunto RFB/CGIBS nº 4/2026. A organização dos documentos, porém, já vale como hábito desde agora. Confirme com a contabilidade como a sua empresa será tratada.

Nota autorizada sem os campos de CBS está regular?

Autorização não é o mesmo que conformidade. O Ato Conjunto RFB/CGIBS nº 1/2026 adiou a rejeição automática, sem suspender a obrigação de informar. Uma nota autorizada com dado faltando pode aparecer como divergência depois.

Posso corrigir a diferença mexendo no sistema da loja?

Não ajuste o sistema para o número bater. Descubra qual documento originou a diferença e use a correção cabível para aquele documento, conforme orientação da contabilidade. Mudanças de cadastro também passam por validação.

Preciso de algum programa para usar a API?

API é um canal entre sistemas, então o uso costuma depender de um software ou do escritório que faça a consulta. Quem vai consultar, com que acesso e com que frequência é decisão a tomar junto com a contabilidade, depois de o escopo oficial estar confirmado.

Próximo passo

Comece pelo checklist deste guia no próximo fechamento, mesmo antes de a consulta direta estar disponível. Se a relação de notas, eventos e devoluções sair organizada do sistema, a conferência com o que a Receita mostrar vira rotina, e não investigação. Para continuar, estes conteúdos respondem às dúvidas que costumam vir depois desta.

Solicitar demonstração

Leia a seguir

Conteúdos que respondem à próxima dúvida de quem chegou até aqui.

Fontes e referências

  1. Lei Complementar 214/2025 (IBS, CBS e fase de testes de 2026)
  2. Ato Conjunto RFB/CGIBS nº 1/2026 (adiamento das regras de validação de IBS e CBS)
  3. Ato Conjunto RFB/CGIBS nº 4/2026 (cronograma dos documentos fiscais)
  4. Receita Federal — portal oficial, para conferir data e escopo das APIs da CBS
  5. Acervo Nox: Relatório Documentos Fiscais Brasil 2026

Conteúdo editorial produzido pela equipe da Nox a partir das normas citadas; data de liberação e escopo das APIs devem ser conferidos no comunicado oficial da Receita Federal, e a aplicação ao caso concreto deve ser validada pela contabilidade da empresa. Publicado por Equipe Nox Tecnologia em 11 de outubro de 2026; última revisão em 11 de outubro de 2026.