📅 Data de publicação: 19/02/2026

❓ Dúvida

Como enviar automaticamente o XML e o DANFE (PDF) da NF-e por e-mail utilizando o TSS no Protheus?

🧩 Ambiente

• Cross Segmentos — TOTVS Backoffice (Linha Protheus)

• Documentos Eletrônicos — NF-e

• TSS (a partir da versão 12)

✅ Solução

📌 Entendimento rápido

• XML: o envio é automático no cenário com TSS (desde que o e-mail do destinatário esteja cadastrado corretamente).

• DANFE (PDF): requer parametrização no Wizard e a presença do artefato Printer/PDF Printer nas pastas do TSS.

🧭 Passo a passo

1) 🧙 Executar o Wizard de configuração da NF-e

1. Acesse a rotina NfeSefaz.

2. Clique em Wiz Config.

3. Avance o assistente até chegar na tela de SMTP (configuração de envio de e-mail).

2) 📬 Configurar SMTP e habilitar envio do DANFE

Na tela de SMTP do Wizard, localize o botão/opção “Enviar DANFE por e-mail” e selecione uma das opções:

• 0 — Desabilitado: não envia DANFE por e-mail

• 1 — Enviar DANFE do TSS: envia DANFE com layout padrão do TSS ✅ (mais comum e recomendado)

• 2 — Enviar DANFE do ERP: envia DANFE com layout do ERP (pode contemplar customizações — depende de ajuste específico)

⚠️ Importante: a configuração de e-mail precisa de autenticação. Preencha a senha da conta no Wizard; sem isso o TSS não conseguirá se comunicar com o servidor SMTP.

3) 🖨️ Instalar o “Printer/PDF Printer” no TSS (obrigatório para DANFE)

Para o TSS conseguir gerar o DANFE em PDF, é necessário ter o artefato Printer (ou PDF Printer) disponível nas pastas do SmartClient e do AppServer do TSS.

✅ Verifique e garanta que o componente esteja presente nas duas frentes:

• Pasta do SmartClient do TSS

• Pasta do AppServer do TSS

💡 Em Linux, recomenda-se garantir permissões amplas nas pastas envolvidas (ex.: permissões totais) para evitar falhas de execução do componente.

4) 🧪 Validar o envio

1. Transmita a NF-e normalmente.

2. Após autorização, valide se:

   • O XML foi anexado ao e-mail

   • O DANFE (PDF) foi anexado ao e-mail (quando habilitado)

🏷️ Opcional: logo no DANFE gerado pelo TSS

Se você envia o DANFE pelo TSS (opção 1) e precisa incluir o logotipo, crie o arquivo na pasta SYSTEM do TSS com o padrão:

• Nome do arquivo: LGRL<CNPJ>_DANFE.BMP

  • Exemplo: LGRL321999888000199_DANFE.BMP

• Formato: BMP 256 cores

• Dimensão recomendada: 95 x 95

⚠️ Observações importantes

• Em homologação, o e-mail pode ser direcionado automaticamente para o emitente (empresa) e não para o destinatário, dependendo do comportamento/validações do cenário.

• Se optar por “Enviar DANFE do ERP” (opção 2), normalmente existe dependência de customização/processo específico para o envio do PDF gerado pelo ERP.

❓ FAQ

1) O XML sempre é enviado automaticamente?

No cenário com TSS, sim — desde que o envio esteja corretamente parametrizado e o e-mail do destinatário esteja cadastrado.

2) Por que o DANFE não está indo, mas o XML vai?

Geralmente por um destes motivos:

• opção “Enviar DANFE por e-mail” está como 0

• falta do componente Printer/PDF Printer no TSS

• autenticação SMTP incompleta (ex.: senha não informada)

3) Qual opção devo usar: DANFE do TSS ou do ERP?

• TSS (opção 1): mais simples e padrão, layout do TSS.

• ERP (opção 2): indicado quando você precisa do layout/customização do ERP, mas exige configuração específica.

4) Em Linux, o que costuma travar?

Permissões de pastas/execução do componente (por isso a recomendação de permissões amplas nas pastas envolvidas).

5) Como colocar logo no DANFE do TSS?

Criando o arquivo BMP na pasta SYSTEM do TSS com o nome no padrão LGRL<CNPJ>_DANFE.BMP e dimensão recomendada.

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria