IBS e CBS na NF-e: checklist para testar ERP e emissão fiscal

IBS e CBS na NF-e do e-commerce exigem que a loja revise o ERP, os cadastros fiscais e o caminho entre pedido, faturamento e emissão. O teste deve cobrir vendas, cancelamentos e devoluções, além de conferir se os dados chegam corretamente ao documento fiscal. O prazo aplicável depende do regime tributário e do tipo de operação.

A NF-e passa a incluir informações ligadas ao IBS e à CBS conforme o leiaute e as regras técnicas aplicáveis. Isso exige que o ERP consiga montar, transmitir, armazenar e devolver esses dados sem quebrar o fluxo da venda. A reforma não transforma o teste em uma simples atualização de tela: também é preciso revisar cadastros e rotinas fiscais.

O leiaute técnico define a estrutura dos campos do documento; a Nota Técnica 2025.002 detalha a adequação da NF-e e da NFC-e à Reforma Tributária do Consumo. No Portal Nacional da NF-e, a versão indicada como vigente na consulta de 20 de outubro de 2026 é a NT 2025.002 v.1.52, publicada em 1º de outubro de 2026. Confirme com o fornecedor do ERP qual versão e quais esquemas estão implementados no ambiente de teste.

O calendário não é igual para toda loja. Segundo as orientações da Receita Federal, o cronograma distingue documentos e situações: a emissão de NF-e para contribuintes do IBS e da CBS que não sejam contribuintes do ICMS tem marco em 1º de dezembro de 2026; documentos de contribuintes do Simples Nacional entram no cronograma em 1º de janeiro de 2027. Para os demais cenários, valide o enquadramento com o contador e consulte o cronograma atualizado. A data de publicação de um leiaute e a data de início da obrigatoriedade são marcos diferentes.

Há também uma distinção importante entre obrigação e rejeição. Em 6 de agosto de 2026, o CGIBS e a Receita Federal esclareceram que o adiamento das regras de validação evita a rejeição automática pela ausência de determinados campos, mas não suspende a obrigação de prestar as informações conforme o cronograma. Portanto, uma nota autorizada não é, por si só, prova de que o cadastro e o cálculo estão corretos.

Comece pelos dados que alimentam o cálculo fiscal e chegam ao XML da NF-e. O ERP precisa relacionar o produto, a operação e o enquadramento tributário correto; não basta copiar um código para todos os itens da loja.

Checklist de cadastros

• Regime tributário e estabelecimento: confira o regime da empresa, o cadastro fiscal de cada filial e os parâmetros de emissão. Não presuma que todas as unidades compartilham as mesmas configurações.
• Produtos: revise descrição, NCM, unidade, origem e demais informações já usadas no cálculo fiscal. Verifique produtos com variações, kits, brindes e itens cadastrados duplicados.
• Classificação de IBS e CBS: peça ao contador a validação do CST-IBS/CBS e do cClassTrib aplicáveis. Esses códigos representam o tratamento tributário da operação; a escolha depende do produto e do contexto fiscal, não apenas da categoria comercial.
• Regras por operação: confira venda nacional, venda interestadual, venda para pessoa jurídica, bonificação, remessa e outras operações realmente realizadas pela loja. A mesma mercadoria pode exigir tratamento diferente conforme a operação.
• Frete, desconto e acréscimos: confirme como o sistema compõe a base e os totais da nota em cada cenário. Não configure regras fiscais por conta própria: valide os critérios com o contador.
• Dados do cliente e destino: confira endereço, UF, país, indicador de contribuinte e demais dados que o ERP usa para definir o documento e a tributação.

Confira também os parâmetros técnicos

Peça ao fornecedor uma demonstração do XML gerado, não apenas uma confirmação de que o sistema está “adaptado”. Verifique se os grupos e campos esperados aparecem nos itens e nos totais, se os códigos são aceitos pelo leiaute vigente e se o XML autorizado fica associado ao pedido correto.

Se a loja vende moda, por exemplo, teste uma peça avulsa, uma variação de cor e tamanho e um kit promocional. A venda do kit precisa manter coerência entre composição, estoque, valor e tributação. Esse teste ajuda a localizar falhas de cadastro que uma venda simples não revela.

Faça os testes em ambiente de homologação sempre que disponível e documente o resultado esperado com o contador. O objetivo é verificar todo o ciclo, do pedido recebido da loja virtual até a nota ou o evento fiscal correspondente.

1. Selecione pedidos representativos: inclua venda nacional, venda interestadual, consumidor final, cliente pessoa jurídica, cupom de desconto, frete cobrado e pedido com mais de um item.
2. Confira a entrada no ERP: compare itens, quantidades, preços, descontos, endereço, forma de pagamento e identificador do pedido com a plataforma da loja.
3. Gere a NF-e: revise os dados do XML e do DANFE. Confira os campos de IBS e CBS aplicáveis, a classificação informada, os valores por item e os totais consolidados.
4. Simule falhas recuperáveis: teste uma indisponibilidade temporária do serviço fiscal ou um retorno de rejeição. Veja se o ERP mantém o pedido, registra o motivo e permite corrigir e reenviar sem gerar duplicidade.
5. Teste cancelamento: em homologação, confira se o ERP envia o evento correto, registra o protocolo e atualiza o status do pedido e do estoque sem apagar o histórico fiscal.
6. Teste devolução e troca: simule devolução total e parcial, inclusive de pedido com vários itens. Confira a referência à operação original, os valores e a atualização do estoque e do financeiro.
7. Reconcilie o resultado: compare o pedido na plataforma, o registro no ERP, o XML autorizado e o status na ferramenta de emissão. Registre diferenças e responsáveis pela correção.

Cancelamento e devolução não são a mesma rotina. O cancelamento é um evento relacionado a uma nota já emitida e sujeito às regras aplicáveis; a devolução pode exigir documento fiscal próprio vinculado à operação de origem. Peça ao contador que confirme o procedimento correto para cada caso da loja.

A integração está consistente quando o mesmo pedido conserva seus dados essenciais em cada sistema e o documento fiscal retorna ao ERP com protocolo e situação corretos. Faça a conferência por identificador do pedido, não apenas pela soma diária de vendas.

Ponto de controle	O que comparar	Sinal de problema
Pedido da loja para o ERP	Itens, quantidades, valores, descontos e endereço	Pedido importado incompleto ou duplicado
Cadastro fiscal	Produto, operação e classificação validada	Regra genérica aplicada a itens ou operações diferentes
ERP para emissor	Dados da NF-e, XML gerado e versão do leiaute	Campos ausentes, valores divergentes ou erro de schema
Retorno da emissão	Chave, protocolo, autorização ou rejeição e mensagem	Nota autorizada sem atualização do pedido
Devolução e estoque	Documento relacionado, item devolvido e saldo atualizado	Estoque alterado sem registro fiscal ou duplicidade

Escolha alguns pedidos de teste e acompanhe-os de ponta a ponta. Se o cliente alterar endereço após a compra, por exemplo, identifique qual sistema é a fonte correta do dado e em que momento a mudança ainda pode afetar a emissão. Faça o mesmo para cancelamento, reenvio de pedido e sincronização de estoque.

Guarde evidências: XML, protocolo, mensagens de erro, versão do ERP, data do teste e identificação do pedido. Isso transforma um problema vago de “integração fiscal” em uma ocorrência reproduzível para o suporte do sistema.

O contador valida o tratamento tributário; o fornecedor do ERP confirma como o sistema implementa esse tratamento. A loja coordena o teste do fluxo operacional e verifica se os dados da plataforma chegam corretamente à emissão fiscal.

• Com o contador: confirme o regime da empresa, as operações abrangidas, a classificação fiscal dos produtos e operações, os procedimentos de devolução e a data aplicável ao seu caso.
• Com o fornecedor do ERP: pergunte qual versão da NT 2025.002 e dos esquemas está suportada, como ativar a emissão em homologação e onde consultar XML, protocolos, rejeições e logs.
• Com o emissor fiscal: verifique se há integração com o ERP, como ocorre a atualização de status e o que acontece quando a emissão falha ou precisa ser refeita.
• Com a equipe da loja: defina quem testa pedidos, quem autoriza alterações fiscais e como registrar incidentes sem editar manualmente dados já transmitidos.

Para optantes pelo Simples Nacional, não aplique automaticamente o calendário de outros regimes. A Receita Federal informa que as regras de IBS e CBS para esses contribuintes passam a produzir efeitos em 1º de janeiro de 2027; o detalhamento deve considerar também a opção de recolhimento e o enquadramento da empresa.

Antes de liberar mudanças no ambiente de produção, confirme estes pontos com os responsáveis fiscal e técnico:

• O regime tributário e o calendário aplicável foram confirmados com o contador.
• O ERP e o emissor usam o leiaute e as regras técnicas vigentes.
• Os cadastros de produto e as classificações foram revisados por operação.
• Pedidos comuns, promocionais e interestaduais foram testados em homologação.
• XML, totais, retorno de autorização e vínculo com o pedido foram conferidos.
• Cancelamentos, devoluções parciais e reenvios foram simulados.
• Há responsável, registro de evidências e procedimento para corrigir falhas.

A ausência de campos pode não causar rejeição automática durante o adiamento das validações, mas isso não deve ser tratado como dispensa de obrigação. Consulte a versão vigente da documentação e teste o fluxo com antecedência. Se a integração entre loja, ERP e emissão fiscal estiver gerando divergências, a WEHSOFT pode fazer um diagnóstico gratuito da operação pelo WhatsApp, com foco nos pontos de integração e no caminho do pedido até a nota.