TSS

Páginas filhas
  • TSS0007 Padronização do Título e Texto do template de e-mail enviado pelo TSS


Conteúdo

01. Visão Geral

Por padrão, após a autorização de um documento eletrônico (NF-e, CT-e ou CT-eOS), o TSS envia ao e-mail do cliente/destinatário os arquivos XML de autorização e PDF do Documento Auxiliar.

Este e-mail tem como objetivo informar ao cliente o número, série, Razão Social, CNPJ do Emitente, Chave de Acesso e Protocolo junto à SEFAZ.

Por padrão, o e-mail encaminhado terá como título o nome da sua empresa e o tipo de documento que está sendo enviado. Porém, tanto o título do e-mail, quanto o texto do corpo de e-mail poderão ser customizados.

Abaixo, um exemplo de e-mail enviado após autorização de uma NF-e:

02. Configuração

Para modificar o texto do e-mail, é necessário alterar o arquivo chamado TotvsMail.html item (2) que está localizado na pasta mailtemplate item (1), presente no diretório raiz do TSS.

Também poderá ser utilizado um arquivo .html criado do zero, caso haja necessidade. 

Imagem com janela do sistema operacional windows aberta na pasta raiz do TSS com destaque em vermelhho para a localização da pasta mailtemplate

Imagem com janela do sistema operacional windows aberta na pasta mailtemplate do TSS com destaque em vermelho para o arquivo TotvsMail.html


O arquivo .HTML criado deverá conter o nome do documento template que deseja customizar.

Nomes de template aceitos atualmente:

Documento eletronico / EventoNome do arquivo .HTML
NfeNFe.html
Cancelamento de NF-eNFeCanc.html
Carta de Correção NF-eCCe.html
CT-eCTe.html
Carta de Correção ou Cancelamento de CT-e/CT-eOsEventoCTe.html

03. Alteração do título

Por padrão, o assunto do e-mail enviado conterá o nome de sua empresa utilizada para a autorização do documento + o nome do documento.

Caso deseje um título diferente do padrão, basta customizar através do arquivo .html, informando o título desejado na tag <TITLE>.

Por exemplo, ao criar um arquivo NFe.html conforme abaixo, o título de todos os e-mails do seu TSS para autorização de NF-e terão o título  "TOTVS S.A - Chegou a sua nota fiscal!"


NFe.html 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>TOTVS S.A - Chegou a sua nota fiscal!</title>
  <style type="text/css"> 
	<!-- 
	body {background-color: rgb(37, 64, 97);} 
	.style1 {font-family: Segoe UI,Verdana, Arial;font-size: 12pt;} 
	.style2 {font-family: Segoe UI,Verdana, Arial;font-size: 12pt;color: rgb(255,0,0)} 
	.style3 {font-family: Segoe UI,Verdana, Arial;font-size: 10pt;color: rgb(37,64,97)} 
	.style4 {font-size: 8pt; color: rgb(37,64,97); font-family: Segoe UI,Verdana, Arial;} 
	.style5 {font-size: 10pt} 
	--> 
  </style>
</head>
<body>
<table style="background-color: rgb(240, 240, 240); width: 500px; text-align: left; margin-left: auto; margin-right: auto;" id="total" border="0" cellpadding="12">
  <tbody>
    <tr>
      <td colspan="2">
      <p class="style1">Esta mensagem refere-se a Nota Fiscal Eletrônica Nacional de serie/número [<%=oNfe:_NFEPROC:_NFE:_InfNfe:_IDE:_Serie:Text+"/"%><%=oNfe:_NFEPROC:_NFE:_InfNfe:_IDE:_nNF:Text%>] emitida para:</p>
      </td>
    </tr>
    <tr>
      <td style="width: 250px; white-space: nowrap;">
      <p class="style1">Razão Social:<br /> 
	  CNPJ:<br />
      <br />
      </p>
      </td>
      <td width="326">
      <p class="style1">[<%=oNFe:_NFEPROC:_NFE:_InfNfe:_Dest:_xNome:TEXT%>]<br />
		[<%=IIF(Type("oNFe:_NFEPROC:_NFE:_InfNfe:_Dest:_CNPJ")=="O",TransForm(oNFe:_NFEPROC:_NFE:_InfNfe:_Dest:_CNPJ:TEXT,"@r 99.999.999/9999-99"),TransForm(oNFe:_NFEPROC:_NFE:_InfNfe:_Dest:_CPF:TEXT,"@r 999.999.999-99"))%>]<br />   
      </p>
      </td>
    </tr>
    <tr>
      <td colspan="2">
      <p class="style1">Para verificar a autorização da SEFAZ referente à nota acima mencionada, acesse o sitio <a href="http://www.nfe.fazenda.gov.br/portal"><span style="text-decoration: underline;">http://www.nfe.fazenda.gov.br/portal</span></a></p>		
      </td>
    </tr>
    <tr>
      <td style="white-space: nowrap;">
      <p class="style1">Chave de acesso: <br />
		Protocolo:<br /></p>
      </td>
      <td><span class="style1">[<%=oNFE:_NFEPROC:_NFE:_InfNfe:_ID:Text%>]<br />
		[<%=oNFE:_NFEPROC:_PROTNFE:_InfProt:_nProt:Text%>] </span></td>
    </tr>
    <tr>
      <td colspan="2">
      <p class="style1">Este e-mail foi enviado automaticamente pelo Sistema de Nota Fiscal Eletrônica (NF-e) da   <%=oNfe:_NFEPROC:_NFE:_InfNfe:_Emit:_xNome:TEXT%></p>
      </td>
    </tr>
    <tr>
      <td colspan="2" class="style4"><span class="style5"><em><span style="text-decoration: underline;">powered by Totvs Services - Totvs S/A</span></em><em></em></span></td>
    </tr>
  </tbody>
</table>
<p class="style1"> </p>
</body>
</html>

Customização por entidade

Caso deseje que a customização seja exclusiva por entidade, basta adicionar o número da entidade no nome do arquivo .html.
Exemplo:  NFe_000001.html

04. Alteração do texto do e-mail

1º - É extremamente importante que seja feito um backup do arquivo TotvsMail antes de realizar qualquer alteração.

2º - O sistema lê o arquivo para envio dos e-mails. Abaixo modelo padrão com destaque para o trecho entre a expressão: <%= %>, que irá resultar na série da nota que foi emitida. Essas macro devem conter necessariamente trechos do XML resultante da autorização SEFAZ.

O modelo .html padrão contempla o esperado para o XML de autorização NF-e. Efetue as trocas (macro), conforme sua necessidade, em todos os parâmetros em que contiver a expressão: <%= %>.

05. Título do e-mail com conteúdo dinâmico retirado do XML

Também é possível customizar o título do e-mail adicionando informações do XML que será encaminhado por e-mail.

Por exemplo.: adicionar o número de série e ID da NF-e autorizada.


Para que o conteúdo saia no título, será necessário adicionar a informação dentro da tag <title> conforme detalhado no passo "03. Alteração do título".

No entanto, para que o valor fique dinâmico, deverá adicionar o "caminho" das tags XML que deseja apresentar no título entre a expressão: <%=Onfe:_  e  %>.   

As tags deverão estar separadas por :_ (dois pontos e underscore).

Veja o exemplo abaixo para adicionarmos ID e Série da nota no caso de NF-e autorizada:


Série da nota: <%=Onfe:_nfePROC:_NFe:_InfNfe:_ide:_serie:Text%>

e

ID da nota: <%=Onfe:_nfePROC:_NFe:_InfNfe:_ide:_nNF:Text%>


Verifique abaixo, que a expressão indica o caminho das tags XML Série e ID da Nota.  Adicionar essa expressão na tag <title> do documento Nfe.html


Exemplo: <title>  Série: <%=Onfe:_nfePROC:_NFe:_InfNfe:_ide:_serie:Text%> / ID:  <%=Onfe:_nfePROC:_NFe:_InfNfe:_ide:_nNF:Text%> </title>


Importante

  1. Cada documento eletrônico tem um padrão de tags diferente. O Exemplo acima é exclusivo para NF-e. Para demais documentos, consulte XML previamente para informar o contéudo corretamente.
  2. Note que a tag final que deseja mostrar deve ser adicionado o atributo  :Text.  Exemplo, se do XML abaixo eu quisesse a tag tpNF,  após informar todo o caminho da tag conforme acima, adicionar :Text no final, ficando ":_tpNF:Text"
XML de NF-e autorizada
<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">
	<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
		<infNFe Id="NFe351904XXXXX557250000000891100XXXXXX3" versao="4.00">
			<ide>
				<cUF>35</cUF>
				<cNF>10XXXX410</cNF>
				<natOp>VDA ICMS CST60</natOp>
				<mod>55</mod>
				<serie>666</serie>
				<nNF>1000</nNF>
				<dhEmi>2019-04-10T16:44:00-03:00</dhEmi>
				<dhSaiEnt>2019-04-10T16:44:00-03:00</dhSaiEnt>
				<tpNF>1</tpNF>
				<idDest>1</idDest>
				<cMunFG>3550308</cMunFG>
				<tpImp>1</tpImp>
				<tpEmis>1</tpEmis>
				<cDV>3</cDV>
				<tpAmb>2</tpAmb>
				<finNFe>1</finNFe>
				<indFinal>1</indFinal>
				<indPres>9</indPres>
				<procEmi>0</procEmi>
				<verProc>12.1.017 | 3.0</verProc>
			</ide>
			[...]
		</infNFe>
		[...]
	</NFe>
	<protNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">
		<infProt>
			<tpAmb>2</tpAmb>
			<verAplic>SP_NFE_PL009_V4</verAplic>
			<chNFe>351904XXXXXXXX555800000001091100XXXXXXX61</chNFe>
			<dhRecbto>2019-04-10T15:42:26-03:00</dhRecbto>
			<nProt>135190001641800</nProt>
			<digVal>lYV+WB8+PXXXXtnKd3Hi+BW8=</digVal>
			<cStat>100</cStat>
			<xMotivo>Autorizado o uso da NF-e</xMotivo>
		</infProt>
	</protNFe>
</nfeProc>