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 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
nfesefazatualizados: aplique a versão recente que contempla os campos de IBS/CBS. Se você tem onfesefazcustomizado, 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
- 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. - Selecione itens representativos. Escolha produtos que cubram os diferentes comportamentos tributários do seu catálogo, não apenas o item mais simples.
- 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.
- 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
cClassTribexigir — é o que evita a rejeição 1065). - Coerência entre
CSTecClassTrib— 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.
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,cClassTribe 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.
