ERP Protheus · Reforma Tributária

NF-e de Teste para IBS/CBS no Protheus: O Ensaio Geral Antes do Go-Live

A janela para errar de graça está aberta — e tem prazo. Veja como emitir a NF-e de teste com IBS/CBS no ambiente de homologação e o que realmente validar no XML antes da obrigatoriedade.

16 jun 2026 8 min de leitura NF-e IBS/CBS
Voltar para o Blog

Toda virada de sistema fiscal tem um momento de verdade — e, com a Reforma, ele tem data marcada. Antes que o IBS e a CBS se tornem obrigatórios, existe uma janela preciosa para errar de graça: o ambiente de homologação. É lá que a NF-e de teste funciona como o seu ensaio geral, revelando os problemas enquanto eles ainda não custam nada.

Neste guia prático, você vai ver como emitir a NF-e de teste com IBS/CBS a partir do Protheus, o que realmente conferir no XML e quais cenários não podem ficar de fora — para chegar ao go-live sem surpresas.

Por Que a NF-e de Teste É Inegociável

A lógica do ambiente de homologação é simples e poderosa: o que a SEFAZ aceita em homologação, tende a aceitar em produção. E o que ela rejeita ali, você corrige antes de afetar a operação real. Pular essa etapa é apostar o seu faturamento em um único lançamento.

O risco do "vamos direto para produção" é concreto: se o Protheus não gerar os campos corretamente, a nota é rejeitada sem aviso. Em produção, isso significa cliente esperando, expedição parada e a equipe correndo atrás do erro com a operação travada.

🎯 A NF-e de teste transforma um risco de produção em um aprendizado de homologação. É a diferença entre descobrir o problema no ensaio ou na estreia.

A Janela de Teste Tem Prazo

Pela NT 2025.002, o calendário de obrigatoriedade do IBS/CBS na NF-e está definido — e é ele que delimita o seu tempo de ensaio:

  • 01/07/2026 — obrigatoriedade em ambiente de homologação
  • 03/08/2026 — obrigatoriedade em produção (emitentes do Regime Normal, CRT 3)
  • 01/09/2026 — devolução passa a referenciar obrigatoriamente o documento de origem
  • 04/01/2027 — obrigatoriedade em produção para Simples Nacional e MEI

Tradução prática: a fase de opcionalidade é o seu campo de testes. Quanto antes você emitir e validar, mais tempo terá para corrigir parametrização — em vez de fazer isso sob a pressão do prazo.

Preparando o Protheus para Emitir a NF-e de Teste

Antes de transmitir a primeira nota, garanta a base:

  • Pacote e nfesefaz atualizados: aplique a versão recente que contempla os campos de IBS/CBS. Se você tem o nfesefaz customizado, compatibilize as customizações antes de validar em base de teste.
  • Release compatível e Configurador de Tributos parametrizado — com as regras e o cClassTrib vinculado aos produtos.
  • Certificado e ambiente apontados para homologação.

Passo a Passo: Emitindo a NF-e de Teste em Homologação

  1. Aponte para o ambiente de homologação. Configure a emissão para tpAmb = 2. A nota não terá efeito fiscal e carregará a tarja de homologação — é exatamente o que você quer nesta fase.
  2. Selecione itens representativos. Escolha produtos que cubram os diferentes comportamentos tributários do seu catálogo, não apenas o item mais simples.
  3. Emita e transmita. Gere a NF-e e transmita para a SEFAZ em homologação. Use a validação sintática do Protheus e a NT 2025.002 como checklist de campos obrigatórios.
  4. Leia o XML — não pare na autorização. Abra o XML e confira o conteúdo (próxima seção). Autorização não é prova de cálculo correto.
Emitir é metade do teste. A outra metade — a que separa o profissional do apressado — é abrir o XML e conferir, campo a campo, se a nota diz o que deveria dizer.

Como Ler o XML: o Grupo UB

As informações de IBS, CBS e Imposto Seletivo ficam no grupo UB (det/imposto/IBSCBS, ou gIBSCBS), que reúne diversos subgrupos. Ao validar a NF-e de teste, confira:

  • Presença dos subgrupos esperados para a operação (incluindo o grupo de tributação regular quando o cClassTrib exigir — é o que evita a rejeição 1065).
  • Coerência entre CST e cClassTrib — a maioria das rejeições nasce dessa combinação.
  • Valores que fazem sentido — confira se as bases e os percentuais batem com o que você parametrizou para teste. Esse julgamento é de negócio: você conhece sua operação melhor que qualquer sistema.

Os Cenários Que Você Precisa Testar

Uma única nota "que passou" não significa ambiente homologado. Cubra os cenários que representam o seu faturamento real:

  • Operação regular, reduzida e monofásica;
  • Suspensão, isenção e diferimento;
  • Devolução e operações interestaduais;
  • Os CFOPs mais usados, com os novos tributos.
📋 Para a visão completa do que validar além da emissão (CFOP, integração contábil, ECD e fluxo de caixa), combine este guia com o nosso checklist de homologação fiscal antes do go-live.

Como a Vanquish Code Conduz Seus Testes

A Vanquish Code é uma empresa full-service de TI especializada em ERP Protheus, com DBA e IA Agêntica sob o mesmo teto. Na rodada de testes de IBS/CBS:

  • Preparamos o ambiente — pacote, nfesefaz, release e Configurador.
  • Emitimos por cenário em homologação, cobrindo os comportamentos do seu catálogo.
  • Validamos o XML com você — grupo UB, CST, cClassTrib e valores.
  • Corrigimos a parametrização e reemitimos até o ambiente estar pronto para o go-live.

Conclusão: Ensaie Agora, Estreie Tranquilo

A NF-e de teste de IBS/CBS é o ensaio geral que a Reforma exige antes da estreia. Emitir em homologação, ler o grupo UB do XML e cobrir os cenários reais é o que transforma a obrigatoriedade em um não-evento — em vez de uma crise de produção. E o melhor momento para isso é enquanto a opcionalidade ainda existe.

A Vanquish Code conduz essa rodada de testes de ponta a ponta. Comece com um diagnóstico gratuito e chegue ao go-live com a confiança de quem já ensaiou.

Quer testar sua NF-e de IBS/CBS sem susto?

A Vanquish Code prepara o Protheus, emite as notas de teste por cenário e valida o XML com você — antes da obrigatoriedade. Comece com um diagnóstico gratuito.

Falar com um especialista

Perguntas Frequentes

No ambiente de homologação (tpAmb = 2), a nota não tem efeito fiscal e serve para validar o XML sem risco. A lógica é simples: o que a SEFAZ aceita em homologação tende a aceitar em produção, e o que rejeita em homologação você corrige antes de afetar a operação real.

Conforme a NT 2025.002, a obrigatoriedade em ambiente de homologação está prevista para 01/07/2026 e em produção para 03/08/2026 para emitentes do Regime Normal (CRT 3); para Simples Nacional e MEI, a previsão em produção é 04/01/2027. Por isso a janela de testes confortável é agora.

Não necessariamente. Autorização não é prova de cálculo correto, ainda mais com validações flexibilizadas em 2026. Você precisa abrir o XML e conferir o grupo UB: subgrupos presentes, CST e cClassTrib coerentes e valores compatíveis com o que parametrizou.

Aplicar o pacote e o nfesefaz recentes, compatibilizar eventuais customizações desse fonte, estar em uma release compatível e ter o Configurador de Tributos com as regras e o cClassTrib parametrizados. A Vanquish Code verifica esses pré-requisitos no diagnóstico gratuito.

Artigos Relacionados