Criar modelos de e-mail para eventos transacionais
Este artigo descreve como criar, carregar e configurar modelos de e-mail para eventos transacionais no Microsoft Dynamics 365 Commerce.
O Dynamics 365 Commerce fornece uma solução de origem para enviar e-mails que alertam os clientes para eventos transacionais. Por exemplo, é possível enviar e-mails quando uma encomenda é efetuada, está pronta para ser levantada ou foi enviada. Este artigo descreve os passos para criar, carregar e configurar os modelos de e-mail que são utilizados para enviar e-mails transacionais.
Tipos de notificação
As notificações podem ser configuradas para informar os clientes por e-mail quando ocorrem eventos específicos como parte do ciclo de vida da encomenda e do cliente. Para configurar notificações, tem de mapear um modelo por e-mail para um tipo de notificação ao criar um perfil de notificação por e-mail do Commerce. Para informações sobre como configurar perfis de notificação por e-mail, consulte Configurar um perfil de notificação por e-mail.
O Dynamics 365 Commerce suporta os seguintes tipos de notificação.
Encomenda criada
O tipo de notificação encomenda criada é acionado quando uma nova ordem de venda é criado no Commerce headquarters.
Nota
O tipo de notificação de encomenda criada não é acionado para transações de pronto pagamento que ocorrem num terminal de ponto de venda (POS). Neste caso, em vez disso, é gerado um recibo enviado por e-mail e/ou impresso. Para mais informações, consulte Enviar recibos por e-mail a partir do Store Commerce.
Encomenda confirmada
O tipo de notificação encomenda confirmada é acionado quando é gerado um documento de confirmação de encomenda para uma ordem de venda a partir do Commerce headquarters.
Recolha concluída
O tipo de notificação recolha concluída é acionado quando uma lista de recolhas de uma encomenda é marcada como concluída no Commerce headquarters.
Nota
O tipo de notificação de recolha concluída não é acionado quando um item é marcado como recolhido num terminal de POS.
Embalagem concluída
O tipo de notificação embalamento concluído é acionado quando um documento de guia de remessa é gerado para uma encomenda no Commerce headquarters num terminal de POS.
O tipo de notificação de embalamento concluído suporta os marcadores de posição de e-mail adicionais que se seguem para facilitar a funcionalidade de "encomenda pronta para recolha" e de procura de encomendas a partir de e-mails transacionais.
| Nome do marcador de posição | Finalidade |
|---|---|
pickupstorename |
O nome da loja onde a encomenda está disponível para recolha. |
pickupstoreaddress |
O endereço da loja onde a encomenda está disponível para recolha. |
pickupstoreopenfrom |
A hora de abertura da loja de recolha. |
pickupstoreopento |
A hora de encerramento da loja de recolha. |
pickupchannelid |
O ID do canal da loja de recolha. |
packingslipid |
O ID da guia de remessa da encomenda que vai ser recolhida. |
confirmationid |
O ID da confirmação da encomenda que vai ser recolhida. (Este ID é, por vezes, referido como o ID de referência do canal). |
Para mais informações sobre as caraterísticas de check-in de clientes e de procura de encomendas, consulte Configurar a deteção e o redirecionamento de áreas geográficas e Ativar a procura de encomendas para finalização de compras de convidados.
Encomenda pronta para levantamento
O tipo de notificação encomenda pronta para recolha é acionado quando uma encomenda é marcada como embalada e o modo de entrega é definido como Recolha pelo cliente numa ou mais linhas de encomenda.
Nota
O tipo de notificação de encomenda pronta para recolha foi preterido a favor do tipo de notificação de embalamento concluído. Este tipo de notificação é personalizado pelo modo de entrega.
Encomenda enviada
O tipo de notificação encomenda enviada é acionado quando é faturada uma encomenda que tem um modo de entrega que não é recolha na loja.
Nota
O tipo de notificação de encomenda enviada foi preterido a favor do tipo de notificação de encomenda faturada. Este tipo de notificação é personalizado pelo modo de entrega.
Encomenda faturada
O tipo de notificação encomenda faturada é acionado quando uma encomenda é faturada no POS ou no Commerce headquarters.
Emitir cartão de oferta
O tipo de notificação de emitir cartão de oferta é acionado quando uma ordem de venda que contém um produto do tipo de cartão de oferta é faturada.
Nota
O e-mail de notificação de emissão do cartão de oferta é enviado para o destinatário do cartão de oferta. O destinatário do cartão de oferta é especificado no Commerce headquarters, numa linha individual da ordem de venda no separador Embalamento sob Detalhes da linha. Pode ser especificado manualmente ou de forma programática.
O tipo de notificação de emissão de cartão de oferta suporta os marcadores de posição adicionais que se seguem.
| Nome do marcador de posição | Finalidade |
|---|---|
giftcardnumber |
O número do cartão de oferta, para produtos do tipo cartão de oferta. |
availablebalance |
O saldo restante no cartão de oferta. |
giftcardmessage |
A mensagem do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardpin |
O número de identificação pessoal (PIN) do cartão de oferta, para produtos do tipo cartão de oferta. (Este marcador de posição é específico de cartões de oferta externos). |
giftcardexpiration |
A data de validade do cartão de oferta, para produtos do tipo cartão de oferta. (Este marcador de posição é específico de cartões de oferta externos). |
giftcardrecipientname |
O nome do destinatário do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardbuyername |
O nome do comprador do cartão de oferta, para produtos do tipo cartão de oferta. |
Para mais informações sobre cartões de oferta, consulte Cartões de oferta digitais de comércio eletrónico e Suporte para cartões de oferta externos.
Cancelamento da encomenda
O tipo de notificação cancelamento da encomenda é acionado quando uma encomenda é cancelada no POS ou no Commerce headquarters.
Cliente criado
O tipo de notificação criada pelo cliente é acionado quando uma nova entidade de cliente é criada no Commerce headquarters.
Para ativar notificações criadas pelos cliente, no Commerce headquarters, aceda a Retail e Commerce > Configuração do Headquarters > Parâmetros > Parâmetros do Commerce > Geral. Na lista pendente Perfil de notificação por e-mail, selecione um perfil de notificação por e-mail que contenha o tipo de notificação criada pelo cliente.
Por predefinição, os eventos criados pelos clientes são carregados para o headquarters com a tarefa de lote Sincronizar clientes e pedidos de canal. Se pretender utilizar uma chamada de serviço em tempo real para enviar estes eventos, defina o ID de e-mail do modelo criado pelo cliente como newCust. No entanto, isto não é recomendado porque as chamadas de serviço em tempo real são chamadas "disparar e esquecer" e não têm lógica de contingência ou de repetição que as tarefas de lote fornecem.
Nota
Quando ativa notificações criadas pelos clientes, os clientes criados em todos os canais da entidade legal receberão um e-mail criado pelo cliente. Atualmente, as notificações criadas pelos clientes não podem ser limitadas a um único canal.
Quando invocado através da tarefa de lote, o tipo de notificação criado pelo cliente suporta o marcador de posição que se segue.
| Nome do marcador de posição | Descrição |
|---|---|
| customername | O nome próprio e o apelido do cliente que criou uma conta. |
Quando invocado através de uma chamada de serviço em tempo real, o tipo de notificação criado pelo cliente suporta os marcadores de posição que se seguem.
| Nome do marcador de posição | Descrição |
|---|---|
| Nome | O nome próprio e o apelido do cliente que criou uma conta. |
| O endereço de e-mail do cliente que criou uma conta. | |
| Telefone | O número de telefone do cliente que criou uma conta. |
| URL | O URL fornecido pelo cliente quando criou a conta. |
Potencial interessado B2B aprovado
O tipo de notificação potencial interessado B2B aprovado é acionado quando um pedido de integração de um potencial interessado é aprovado no Commerce headquarters. Para mais informações sobre como aprovar ou rejeitar potenciais interessados B2B, consulte Configurar o utilizador administrador para um novo parceiro de negócios.
O tipo de notificação de potencial interessado B2B aprovado suporta os marcadores de posição adicionais que se seguem.
| Nome do marcador de posição | Finalidade |
|---|---|
firstname |
O nome próprio do potencial interessado B2B, tal como é introduzido na aplicação. |
lastname |
O apelido do potencial interessado B2B, tal como é introduzido na aplicação. |
company |
O nome da empresa do candidato, tal como é introduzido na aplicação. |
email |
O endereço de e-mail do potencial interessado, tal como é introduzido na aplicação. |
zipcode |
O código postal do endereço principal do potencial interessado. |
comments |
O comentário que o potencial interessado introduziu na aplicação. |
storename |
O nome do canal onde foi criado o potencial interessado. |
storeurl |
Vazio por predefinição. Tem de ser criada uma extensão personalizada para utilizar este marcador de posição. |
Potencial interessado B2B rejeitado
O tipo de notificação potencial interessado B2B rejeitado é acionado quando um pedido de integração de um potencial interessado é rejeitado no Commerce headquarters. Para mais informações sobre como aprovar ou rejeitar potenciais interessados B2B, consulte Configurar o utilizador administrador para um novo parceiro de negócios.
O tipo de notificação de potencial interessado B2B rejeitado suporta os marcadores de posição adicionais que se seguem.
| Nome do marcador de posição | Finalidade |
|---|---|
firstname |
O nome próprio do potencial interessado B2B, tal como é introduzido na aplicação. |
lastname |
O apelido do potencial interessado B2B, tal como é introduzido na aplicação. |
company |
O nome da empresa do candidato, tal como é introduzido na aplicação. |
Criar um modelo de e-mail
Antes de poder mapear um evento transacional específico para um modelo de e-mail, tem de criar o modelo.
Para criar um modelo de e-mail, siga estes passos.
No Commerce headquarters, aceda a Retail e Commerce > Configuração do Headquarters > Modelos de e-mail da organização ou Administração da organização > Configuração > Modelos de e-mail da organização.
Selecione Novo.
Em Geral, defina os seguintes campos:
- ID de E-mail — O ID de e-mail é o identificador exclusivo de um modelo. É o valor que é mostrado quando seleciona um modelo a mapear para um evento.
- Descrição do e-mail — Pode utilizar este campo opcional para fornecer uma descrição do modelo. O valor introduzido aparece apenas no Commerce headquarters.
- Nome do remetente — O nome que introduzir aparece no campo "de" da maioria dos clientes de e-mail.
- E-mail do remetente — Introduza o endereço de e-mail que deve ser utilizado para os e-mails enviados com este modelo.
- Código de idioma predefinido — Este campo especifica a versão localizada do e-mail que é enviada por predefinição, se o canal que invoca este modelo não especificar um idioma.
Em Conteúdo da mensagem de e-mail, selecione Novo.
No campo Idioma, introduza o idioma do modelo de e-mail. Pode adicionar mais idiomas e modelos localizados mais tarde.
No campo Assunto, introduza o assunto do e-mail que deve aparecer no campo de assunto do e-mail.
Selecione Editar para carregar o seu modelo de e-mail.
Criar um corpo de mensagem de e-mail utilizando HTML
O corpo da mensagem do seu e-mail é composto em HTML. Pode utilizar qualquer esquema, estilo e imagem corporativa permitidos por HTML e Cascading Style Sheets (CSS) incorporado. Também pode utilizar imagens, se as alojar num ponto final da Web publicamente disponível. Para adicionar uma imagem, introduza o URL da imagem no atributo src da etiqueta HTML <img>.
Nota
Os clientes de e-mail impõem limitações de esquema e estilo que podem exigir ajustes para HTML e CSS que utiliza para o corpo da mensagem. Recomendamos que se familiarize com as melhores práticas para criar HTML que os clientes de e-mail mais populares irão suportar.
Adicionar marcadores de posição ao corpo da mensagem de e-mail
O seu e-mail pode conter marcadores de posição que são substituídos por valores específicos do cliente e da transação quando o e-mail é gerado. Os marcadores de posição estão sempre rodeados por sinais de percentagem (%) e são inseridos diretamente no documento HTML.
Veja aqui um exemplo.
<p>
Hello %customername%,<br />
Order number %salesid%, can be picked up from the <b>%pickupstorename%</b> store.
</p>
Marcadores de posição de encomenda (nível da ordem de venda)
Os marcadores de posição que se seguem recuperam e mostram dados que são definidos ao nível da ordem de venda (por oposição ao nível da linha de venda).
| Nome do marcador de posição | Finalidade |
|---|---|
customername |
O nome do cliente que fez a encomenda. |
customeraddress |
O endereço do cliente. |
customeremailaddress |
O endereço de e-mail que o cliente introduziu aquando da finalização da compra. |
salesid |
O ID de vendas da encomenda. |
orderconfirmationid |
O ID entre canais que foi gerado aquando da criação da encomenda. |
channelid |
O ID do canal de retalho ou online através do qual a encomenda foi feita. |
deliveryname |
O nome que é especificado como o endereço de entrega. |
deliveryaddress |
O endereço de entrega das encomendas enviadas. |
deliverydate |
A data de entrega. |
shipdate |
A data de envio. |
modeofdelivery |
O modo de entrega da encomenda. |
ordernetamount |
O montante total da encomenda, menos o imposto total. |
discount |
O desconto total da encomenda. |
charges |
Os custos totais da encomenda. |
tax |
O imposto total da encomenda. |
total |
Os montantes totais da encomenda. |
storename |
O nome da loja em que a encomenda foi feita. |
storeaddress |
O endereço da loja que fez a encomenda. |
storeopenfrom |
O horário de abertura da loja que fez a encomenda. |
storeopento |
O horário de encerramento da loja que fez a encomenda. |
pickupstorename |
O nome da loja onde a encomenda será recolhida.* |
pickupstoreaddress |
O endereço da loja onde a encomenda será recolhida.* |
pickupopenstorefrom |
O horário de abertura da loja onde a encomenda será recolhida.* |
pickupopenstoreto |
O horário de encerramento da loja onde a encomenda será recolhida.* |
pickupchannelid |
O ID do canal da loja que é especificado para um modo de entrega de recolha.* |
packingslipid |
O ID da guia de remessa que foi gerada quando as linhas de uma encomenda foram embaladas.* |
* Estes marcadores de posição só devolvem dados quando são utilizados para o tipo de notificação Encomenda pronta para recolha.
Marcadores de posição de linha de encomenda (nível da linha de venda)
Os marcadores de posição que se seguem obtêm e mostram dados para produtos individuais (linhas) na ordem de venda.
| Nome do marcador de posição | Finalidade |
|---|---|
productid |
O ID do produto. Este ID tem em conta as variantes.
Nota: Este marcador de posição foi preterido a favor de |
lineproductrecid |
O ID do produto. Este ID tem em conta as variantes. Identifica de forma exclusiva um item ao nível da variante. |
lineitemid |
O ID ao nível do produto, do produto. (Este ID não considera as variantes.) |
lineproductvariantid |
O ID da variante de produto. |
lineproductname |
O nome do produto. |
lineproductdescription |
A descrição do produto. |
linequantity |
O número de unidades que foram encomendadas para a linha, mais a unidade de medida (por exemplo, cd ou par). |
lineunit |
A unidade de medida da linha. |
linequantity_withoutunit |
O número de unidades que foram encomendadas para a linha, sem a unidade de medida. |
linequantitypicked |
Quando o evento PickOrder é utilizado, o número de unidades que foram recolhidas. Caso contrário, 0 (zero). |
linequantitypicked_withoutunit |
Quando o evento PickOrder é utilizado, o número de unidades que foram recolhidas, sem a unidade de medida. Caso contrário, 0 (zero). |
linequantitypacked |
Quando são utilizados os eventos PackOrder e Encomenda pronta para recolha, o número de unidades que foram embaladas. Caso contrário, 0 (zero). |
linequantitypacked_withoutuom |
Quando são utilizados os eventos PackOrder e Encomenda pronta para recolha, o número de unidades que foram embaladas, sem a unidade de medida. Caso contrário, 0 (zero). |
linequantityshipped |
Sempre 0, exceto quando são utilizados eventos específicos, como descrito na linha que se segue. |
linequantityshipped_withoutuom |
Quando o evento ShipOrder é utilizado, o número de unidades que foram recolhidas, sem a unidade de medida. Caso contrário, 0 (zero). |
lineprice |
O preço de uma única unidade. |
linenetamount |
O preço da linha após a aplicação do número de unidades e do desconto. |
linediscount |
O desconto para uma unidade individual. |
lineshipdate |
A data de envio da linha. |
linedeliverydate |
A data de entrega da linha. |
linedeliverymode |
O modo de entrega da linha. |
linedeliveryaddress |
O endereço de entrega da linha. |
linepickupdate |
A data de recolha que o cliente especificou, para encomendas que utilizam um modo de entrega de recolha. |
linepickuptimeslot |
O intervalo de tempo da recolha que o cliente especificou, para encomendas que utilizam um modo de entrega de recolha. |
giftcardnumber |
O número do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardbalance |
O saldo do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardmessage |
A mensagem do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardpin |
O PIN do cartão de oferta, para produtos do tipo cartão de oferta. (Este marcador de posição é específico de cartões de oferta externos). |
giftcardexpiration |
A data de validade do cartão de oferta, para produtos do tipo cartão de oferta. (Este marcador de posição é específico de cartões de oferta externos). |
giftcardrecipientname |
O nome do destinatário do cartão de oferta, para produtos do tipo cartão de oferta. |
giftcardbuyername |
O nome do comprador do cartão de oferta, para produtos do tipo cartão de oferta. |
lineproductvariantinfo |
As dimensões da variante para a linha. |
Formato dos marcadores de posição da linha de encomenda no corpo da mensagem de e-mail
Quando criar o HTML para as linhas de encomenda individuais no corpo da mensagem de e-mail, rodeie o bloco de repetição de HTML e marcadores de posição para as linhas com os marcadores de posição que se seguem. Repare que os marcadores de posição estão dentro de etiquetas de comentário HTML.
<!--%tablebegin.salesline%-->
(Insert the repeating block of HTML and placeholders for individual lines here.)
<!--%tableend.salesline%-->
Veja aqui um exemplo.
<table>
<tr>
<td>Product name</td>
<td>Quantity</td>
<td>Price</td>
</tr>
<!--%tablebegin.salesline%-->
<tr>
<td>%lineproductname%</td>
<td>%linequantity_withoutunit%</td>
<td>%lineprice%</td>
</tr>
<!--%tableend.salesline%-->
</table>
Criar um modelo para recibos enviados por e-mail
Os recibos podem ser enviados por e-mail aos clientes que fazem compras num ponto de venda (POS) de retalho. Em geral, os passos para criar o modelo de recibo enviado por e-mail são os mesmos que os passos para criar modelos para outros eventos transacionais. No entanto, são necessárias as seguintes alterações:
- O marcador de posição %message% é utilizado para inserir o texto do recibo no e-mail. Para garantir que o corpo do recibo é composto corretamente, rodeie o marcador de posição %message% com as etiquetas HTML <pre> e </pre>.
- O marcador de posição %receiptid% pode ser utilizado para mostrar um código QR ou um código de barras que represente o ID do recibo. (Os códigos QR e os códigos de barras são gerados dinamicamente e fornecidos por um serviço de terceiros). Para mais informações sobre como mostrar um código QR ou um código de barras num recibo enviado por e-mail, consulte Adicionar um código QR ou código de barras a e-mails transacionais e de recibos.
Carregar o HTML de e-mail
Depois de ter criado e testado o HTML para o corpo da mensagem, tem de ser carregado para o Commerce headquarters. Atualmente, não é possível exportar HTML de e-mail. Por conseguinte, é necessário manter a cópia principal do HTML fora do Commerce headquarters.
Para carregar um HTML de modelo de e-mail novo ou editado, siga estes passos.
- No Commerce headquarters, aceda a Retail e Commerce > Configuração do Headquarters > Modelos de e-mail da organização.
- Selecione a linha do idioma para o qual pretende adicionar ou substituir o HTML. Alternativamente, selecione Novo para criar uma linha para um novo idioma.
- Selecione Editar.
- Na caixa de diálogo apresentada, selecione Navegar. Navegue até ao documento HTML que pretende carregar, selecione-o e, em seguida, selecione Abrir.
- Selecione Carregar.
- Depois de o HTML de e-mail aparecer na janela de pré-visualização, selecione OK.
- Certifique-se de que a caixa de verificação Tem corpo está selecionada para a linha.
Se já tiver configurado o Commerce headquarters para enviar e-mail, o seu e-mail novo ou atualizado será enviado a todos os clientes que efetuem uma transação que invoque o evento que está mapeado para o modelo.
Para mais informações sobre como configurar e-mails no Dynamics 365 Commerce, consulte Configurar e enviar e-mails.