Como enviar XML e DANFE por e-mail no Protheus (TSS)
No Protheus, quem manda o XML e o DANFE da NF-e para o cliente não são os parâmetros de e-mail do sistema: é o TSS (TOTVS Service SPED), com uma configuração de SMTP própria. Veja como ligar o envio automático, escolher o DANFE, acompanhar o que foi enviado e o que conferir quando a nota é autorizada mas o e-mail não chega.
Como o Protheus envia o XML da nota por e-mail?
Pelo TSS. Depois que o SMTP é configurado e validado no assistente de configuração da rotina de NF-e, o TSS passa a enviar automaticamente o XML das próximas notas para o e-mail do destinatário. Segundo a TOTVS, ele monta o XML (e o PDF, se configurado) temporariamente e usa sempre o e-mail que está na nota.
Por isso, mexer nos parâmetros MV_REL do Configurador não muda o envio da NF-e: eles valem para relatórios e workflow (veja SMTP no Protheus). O e-mail da nota tem o seu próprio servidor, configurado no TSS.
Como configurar o SMTP do TSS?
- Abra a rotina NF-e Sefaz e clique em Wiz Config.
- Avance pelas telas de configuração do TSS até a tela de SMTP.
- Preencha servidor, porta, conta e senha. A TOTVS frisa que a configuração precisa de autenticação: sem a senha, o TSS não consegue falar com o servidor.
- Conclua o assistente. Com a validação OK, as próximas notas já saem por e-mail.
Configure pelo assistente
A validação do e-mail acontece no Wiz Config. Configurar direto na tabela do TSS é possível, mas a TOTVS avisa que, assim, não há como garantir o funcionamento.
Libere a rede
O servidor do TSS precisa alcançar o servidor SMTP escolhido, na porta configurada. Firewall bloqueando a saída é causa frequente de envio parado.
Fontes: TDN, TSS0029: processo de envio de DANFE por e-mail e Central de Atendimento TOTVS: como enviar DANFE e XML por e-mail via TSS.
Como enviar o DANFE em PDF junto com o XML?
Na tela de SMTP do Wiz Config existe a opção Enviar DANFE por e-mail, com três valores:
- 0: Desabilitado. Vai só o XML.
- 1: Enviar DANFE do TSS. Vai o DANFE com o layout padrão do TSS.
- 2: Enviar DANFE do ERP. Vai o DANFE gerado pelo Protheus, que pode ter o layout customizado. Exige um procedimento adicional (customização via RDMake) descrito pela TOTVS.
Para gerar o PDF, o TSS precisa do componente de impressão (printer) nas pastas Smartclient e Appserver do TSS. Em servidores Linux há restrições adicionais para o DANFE, documentadas pela TOTVS.
Como saber se o e-mail da nota foi enviado?
O TSS registra o estado do envio de cada nota no campo STATUSMAIL da tabela SPED050:
1: A transmitir
O e-mail ainda está na fila do TSS.
2: Transmitido
O TSS entregou o e-mail ao servidor SMTP.
3: Bloqueio de transmissão
O envio foi bloqueado. Veja o console.log do TSS.
"Transmitido" quer dizer que o TSS passou a mensagem ao seu servidor SMTP, não que ela chegou na caixa do cliente. O que acontece depois disso (aceita, recusada, em spam) só o servidor SMTP sabe. É aí que um relay com rastreio por mensagem faz diferença.
A nota foi autorizada mas o e-mail não chegou. O que conferir?
- E-mail do destinatário na nota. O TSS usa o e-mail que está na nota, que vem do cadastro do cliente. Vazio ou digitado errado, não tem para onde ir.
- Ambiente de homologação. Em homologação, a TOTVS envia o e-mail para o emitente, não para o destinatário.
- STATUSMAIL = 3 ou parado em 1. Erro de SMTP: veja o
console.logdo TSS. Autenticação, porta e rede são os suspeitos de sempre. - Office 365 com erro 535 5.7.139. O SMTP AUTH está desligado na conta. Veja SMTP do Office 365 parou no ERP.
- STATUSMAIL = 2, mas o cliente diz que não recebeu. O e-mail saiu do TSS. Ele pode ter sido recusado pelo provedor do cliente, caído no spam ou esbarrado no limite de envio da caixa usada como SMTP. Sem o registro do servidor SMTP, não dá para saber qual.
Qual SMTP usar no TSS?
Qualquer servidor que aceite usuário e senha funciona, mas uma caixa de usuário (Office 365, Gmail, hospedagem) não foi feita para isso. Ela tem limite diário de envio, depende da conta do funcionário e, no Office 365, perde o envio com usuário e senha por padrão no fim de dezembro de 2026.
Um relay SMTP resolve esses três pontos. Com o Sender25, a tela de SMTP do Wiz Config fica com:
- Servidor:
smtp-a.sender25.com - Porta:
2525(ou25), com TLS - Conta e senha: a credencial SMTP gerada no painel
- Remetente: um e-mail do seu domínio, autenticado no painel (SPF e DKIM)
E o ponto cego do STATUSMAIL = 2 some: no painel, cada e-mail de nota aparece com status de entrega, código de resposta do servidor de destino, tempo de entrega e provedor do cliente. Quando alguém disser "não recebi a nota", a resposta vem com dado.
Se a tela do seu TSS só aceitar a porta 587 ou a 465, fale com a gente antes de configurar.
Perguntas frequentes
O Protheus envia o XML da NF-e por e-mail automaticamente?
Sim. Depois que o SMTP é configurado e validado no Wiz Config da rotina NF-e Sefaz, o TSS passa a enviar automaticamente o XML das próximas notas para o e-mail do destinatário que está na nota.
Como enviar também o DANFE em PDF?
Na tela de SMTP do Wiz Config, use a opção Enviar DANFE por e-mail: 1 envia o DANFE com o layout padrão do TSS e 2 envia o DANFE gerado pelo ERP, que pode ter layout customizado. O TSS também precisa do componente de impressão nas pastas Smartclient e Appserver.
Por que o XML da nota não chegou ao cliente?
As causas mais comuns são: e-mail do destinatário ausente ou errado na nota, SMTP configurado fora do Wiz Config, rede do TSS sem acesso ao servidor SMTP, ambiente em homologação (o e-mail vai para o emitente) ou a mensagem recusada ou filtrada pelo provedor de destino.
Onde vejo se o e-mail da nota foi enviado?
No campo STATUSMAIL da tabela SPED050 do TSS: 1 a transmitir, 2 transmitido e 3 bloqueio de transmissão. Os erros aparecem no console.log do TSS.
Posso usar o Office 365 como SMTP do TSS?
Pode, mas a Microsoft passa a desligar por padrão o SMTP com usuário e senha no fim de dezembro de 2026. Um relay SMTP com usuário e senha evita esse problema.
Saiba se a nota chegou, não só se saiu
Configure o TSS no Sender25 e acompanhe a entrega de cada XML e DANFE. Teste 30 dias grátis, sem cartão.
Testar grátis por 30 dias Falar com a gente