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

❓ Dúvida

Como enviar DANFE e XML por e-mail utilizando o TSS, garantindo que o envio esteja parametrizado corretamente no assistente (Wizard) do Protheus?

🧩 Ambiente

• Cross Segmentos — TOTVS Backoffice (Linha Protheus) — Documentos Eletrônicos / NFe (todas as versões)

• TSS — a partir da versão 12

✅ Solução

No cenário com TSS, o XML é enviado automaticamente. Já o envio do DANFE por e-mail depende de habilitação no Wizard e de pré-requisitos (principalmente o componente printer e, em Linux, permissões e autenticação SMTP).

🛠️ Passo a passo

🧙 1) Configure no Wizard (NFesefaz / Wiz Config)

1. Acesse a rotina NFesefaz.

2. Clique no botão Wiz Config.

3. Avance as etapas até chegar na tela de SMTP.

4. Localize a opção “Enviar DANFE por e-mail” e selecione uma das opções abaixo:

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

   • 1 — Enviar DANFE do TSS: envia com layout padrão do TSS

   • 2 — Enviar DANFE do ERP: envia com layout do ERP, podendo conter customizações (ex.: rdMake)

📌 Observação: se você precisa enviar o DANFE com layout customizado do Protheus, utilize a opção 2.

🖨️ 2) Garanta o componente “printer” no TSS

Para geração e envio do DANFE em PDF, é necessário que o arquivo/componente printer exista nas pastas do SmartClient e do AppServer do TSS.

✅ Valide também se o ambiente do TSS possui as dependências corretas para geração de PDF no sistema operacional utilizado (Windows/Linux/Mac).

🐧 3) Se o TSS estiver em Linux: permissões e autenticação

Quando o TSS estiver em Linux:

• Garanta que as pastas necessárias tenham permissões adequadas (em muitos cenários recomenda-se permissão total durante testes, para eliminar bloqueios de escrita/execução).

• Na configuração de e-mail, informe usuário e senha (autenticação) no Wizard.
  Sem autenticação, o TSS pode não conseguir se comunicar com o servidor SMTP.

🧪 4) Validação em homologação

Em ambientes de homologação, o envio de e-mail pode ser direcionado automaticamente para o emitente (empresa) e não para o destinatário da nota.
Isso é esperado em alguns cenários de validação/teste.

✅ Resultado esperado

• XML: envio automático conforme o fluxo padrão do TSS.

• DANFE: envio por e-mail conforme a opção selecionada no Wizard:

  • Layout TSS (opção 1) ou

  • Layout ERP/Protheus (opção 2, inclusive com customização).

🧠 FAQ

1) O XML sempre vai por e-mail?
No fluxo descrito, o envio do XML é automático; o foco da parametrização é habilitar/definir o envio do DANFE.

2) Qual opção devo usar para enviar o DANFE com layout do Protheus (customizado)?
Use 2 — Enviar DANFE do ERP.

3) O que é obrigatório para o DANFE em PDF ser gerado e enviado?
Ter o componente printer disponível no ambiente do TSS (SmartClient e AppServer), além de SMTP configurado corretamente.

4) Uso Linux e não está enviando. O que conferir primeiro?
Permissões das pastas do TSS e autenticação SMTP (senha informada no Wizard).

5) Em homologação, por que não chegou no e-mail do destinatário?
Porque em alguns cenários de homologação o envio é direcionado ao emitente para testes e validações.

👤 Autor

Fabrizio Augusto Ventavolo — Consultor Especialista TOTVS - Mastersiga Consultoria