📅 Data de publicação: 05/02/2026
✍️ Autor: Fabrizio Augusto Ventavolo
🎯 Objetivo
Orientar como identificar e contornar cenários em que o Protheus/TSS processa NF-e em um ambiente diferente do esperado (ex.: TSS/SEFAZ em HOMOLOGAÇÃO quando a operação deveria estar em PRODUÇÃO), ocasionando inconsistências como:
NF-e com chaves diferentes entre homologação e produção;
status divergente entre Monitoramento SEFAZ e Portal NF-e;
necessidade de recuperar registros para permitir novo fluxo de cancelamento/consulta.
🧩 Quando esse cenário costuma aparecer
Você pode estar diante desse caso quando houver um ou mais sinais:
✅ No Protheus, o Monitor retorna “015 – Cancelamento autorizado”, mas a operação “não fecha” corretamente no ERP (ou vice-versa).
🌐 No Portal da NF-e, a mensagem indica “NF-e cancelada pelo emitente”, enquanto no Protheus o status parece “travado”, inconsistente, ou remetendo a outro ambiente.
🔁 A mesma nota passa a ter duas chaves (uma associada a produção e outra a homologação).
⚙️ Ao processar pelo Monitoramento SEFAZ, o sistema evidencia Ambiente 2 – Homologação quando a expectativa era Ambiente 1 – Produção.
🧠 Causa mais comum
⚠️ Divergência de parametrização/roteamento do TSS
Mesmo existindo TSS de Produção e TSS de Homologação, o fluxo de comunicação pode “cair” no ambiente incorreto por conta de:
Parametrizações do TSS/Entidade apontando para HOMOLOGAÇÃO SEFAZ;
Configuração de certificados/entidades e serviços que fazem o Protheus “escolher” o serviço de homologação;
Ambientes (Protheus/TSS) coexistindo e o processo ser executado com fila/roteamento indevido;
Evidência no Monitor de que a execução foi forçada/assumida em Ambiente 2.
🔎 Checklist de diagnóstico (recomendado)
🧾 1) Validar o que está sendo processado
📌 Número da NF-e (e Série, se aplicável)
🔑 Chave de acesso que o Protheus está usando no momento do processamento
🧭 Identificar se existe outra chave relacionada ao mesmo documento (produção x homologação)
🧰 2) Confirmar o ambiente do processamento no Monitoramento SEFAZ
Verificar a indicação de Ambiente no processamento
Confirmar se o retorno do cancelamento/consulta está coerente com o ambiente esperado
⚙️ 3) Conferir o “par” de TSS (Produção e Homologação)
Mesmo sem alterar nada, documente:
Nome do serviço TSS (produção/homologação)
Portas de comunicação (TCP/HTTP/WEBAPP/REST)
Alias do banco do TSS (produção/homologação)
Certificado aplicado em cada ambiente
✅ Boas práticas: manter um “mapa” interno com qual TSS atende qual ambiente, incluindo entidade, certificado e portas.
🛠️ Contorno aplicado (quando necessário) — Recuperar registros para permitir novo fluxo
Em alguns casos, o Protheus fica com registros “marcados” como excluídos/cancelados em tabelas transacionais, impedindo a reexecução correta do cancelamento/consulta.
🧷 O que geralmente precisa ser avaliado
Marcação de exclusão lógica:
D_E_L_E_T_Campos de observação/data de cancelamento (varia por tabela)
🛡️ Atenções antes de qualquer ajuste em banco
✅ Executar backup e/ou garantir ponto de restauração
✅ Registrar evidências (prints / recnos / horários)
✅ Realizar em janela controlada
✅ Preferir análise em HOMOLOGAÇÃO antes de replicar qualquer abordagem
✅ Todo ajuste deve ser rastreável, com identificação de tabelas e recnos envolvidos
⚠️ Importante: a recuperação de registros é um contorno técnico para restabelecer consistência do fluxo. A causa raiz precisa ser tratada via parametrização/roteamento do TSS e, quando necessário, via suporte TOTVS.
✅ Resultado esperado após o contorno
Protheus volta a permitir o fluxo (consulta/cancelamento) sem travas internas;
O Monitoramento SEFAZ retorna o cancelamento de forma coerente;
O Portal NF-e reflete corretamente o status;
Fica evidenciado se o processamento está ocorrendo em Ambiente 1 ou Ambiente 2.
📣 Próximo passo obrigatório: acionar a TOTVS (causa raiz)
🧾 O que levar na abertura do chamado
Número da NF-e e chaves envolvidas (produção e homologação, se existirem)
Evidência do ambiente processado (Monitoramento SEFAZ mostrando Ambiente 2, por exemplo)
Versão do TSS e do Protheus
Resumo de como o fluxo deveria funcionar (produção → produção / homologação → homologação)
Evidências do comportamento divergente
🎯 Objetivo do chamado TOTVS: orientar/corrigir qual parâmetro/roteamento define o ambiente SEFAZ efetivo, evitando “mistura” de ambientes e duplicidade de chaves.
✅ Boas práticas para evitar recorrência
🧭 Padronizar um checklist interno de “antes de emitir/cancelar” (ambiente Protheus, ambiente TSS, entidade/certificado)
🗂️ Manter controle de certificados por ambiente (produção ≠ homologação)
🧪 Executar testes controlados quando houver atualização de TSS, certificado ou entidade
🧾 Sempre registrar evidências quando aparecer chave duplicada (produção/homologação)
❓ FAQ
1) ❓ Por que surgem duas chaves para “a mesma nota”?
Porque o processamento pode ter sido executado em ambientes diferentes do SEFAZ (produção x homologação), gerando registros distintos e chaves diferentes conforme o ambiente de comunicação.
2) ❓ Se o Portal NF-e mostra “cancelada”, por que o Protheus pode não refletir corretamente?
Quando existe divergência de ambiente ou inconsistência transacional, o Protheus pode manter registros internos “travados” (ex.: exclusão lógica / campos de cancelamento), impedindo a atualização correta do status.
3) ❓ Posso resolver só “ajustando no banco”?
Ajuste em banco pode destravar o fluxo e recuperar consistência, mas não elimina a causa raiz. O correto é corrigir o roteamento/parametrização do TSS/ambiente SEFAZ e validar com a TOTVS.
4) ❓ Como confirmo em qual ambiente o TSS processou?
Pelas evidências do Monitoramento SEFAZ (Ambiente 1 ou 2), registros gerados, e validação da chave/retorno esperado para o ambiente.
5) ❓ O chamado deve ser encerrado após o cancelamento funcionar?
Nem sempre. Se o problema envolver divergência de ambiente, o ideal é manter o chamado em aberto até a orientação/correção definitiva (especialmente quando há risco de recorrência).
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria