Criar modelos de email para eventos transacionais

  • Artigo

Este artigo descreve como criar, carregar e configurar modelos de email para eventos transacionais no Microsoft Dynamics 365 Commerce.

O Dynamics 365 Commerce fornece uma solução pronta para o envio de emails que alertam clientes sobre eventos transacionais. Por exemplo, os emails podem ser enviados quando uma ordem é feita, quando está pronta para retirada ou quando for enviada. Este artigo descreve as etapas para criar, carregar e configurar os modelos de email usados para enviar emails transacionais.

Tipos de notificação

As notificações podem ser configuradas para informar os clientes por email quando ocorrem eventos específicos como parte da ordem e do ciclo de vida do cliente. Para configurar as notificações, você deve mapear um modelo de email para um tipo de notificação criando um perfil de notificação por email no Commerce. Para obter mais informações sobre como configurar perfis de notificação por email, consulte Configurar um perfil de notificação por email.

O Dynamics 365 Commerce oferece suporte aos seguintes tipos de notificação:

Ordem criada

O tipo de notificação ordem criada é disparado quando uma nova ordem de venda é criada no Commerce headquarters.

Observação

O tipo de notificação de ordem criada não é disparado para transações cash and carry que ocorrem em um terminal de ponto de venda (PDV). Nesse caso, um recibo enviado por email e/ou impresso é gerado. Para obter mais informações, consulte Enviar recibos por email no Store Commerce.

Ordem confirmada

O tipo de notificação ordem confirmada é disparado quando um documento de confirmação da ordem é gerado para uma ordem de venda no Commerce headquarters.

Separação concluída

O tipo de notificação separação concluída é disparado quando uma lista de separação de uma ordem é marcada como concluída no Commerce headquarters.

Observação

O tipo de notificação de separação concluída não é disparado quando um item é marcado como separado em um terminal de PDV.

Remessa concluída

O tipo de notificação remessa concluída é disparado quando uma guia de remessa de uma ordem é marcada como concluída no Commerce headquarters em um terminal de PDV.

O tipo de notificação de remessa concluída oferece suporte aos espaços reservados para email adicionais a seguir para facilitar a "ordem pronta para retirada" e a funcionalidade de pesquisa de ordens de emails transacionais.

Nome do espaço reservado Finalidade
pickupstorename O nome da loja em que a ordem está disponível para retirada.
pickupstoreaddress O endereço da loja em que a ordem está disponível para retirada.
pickupstoreopenfrom O horário de abertura da loja de retirada.
pickupstoreopento O horário de fechamento da loja de retirada.
pickupchannelid A ID do canal de armazenamento da loja de retirada.
packingslipid A ID da guia de remessa da ordem que será retirada.
confirmationid A ID da confirmação de ordem da ordem que será retirada. (Às vezes, essa ID é referida como ID de referência do canal).

Para obter mais informações sobre os recursos de check-in e pesquisa de ordens do cliente, consulte Configurar detecção de área geográfica e redirecionamento e Habilitar pesquisa de ordem para finalização de compra do convidado.

Ordem pronta para retirada

O tipo de notificação ordem pronta para retirada é disparado quando uma ordem é marcada como embalada e o modo de entrega é definido como retirada pelo cliente em uma ou mais linhas da ordem.

Observação

O tipo de notificação de ordem pronta para retirada foi preterido em favor do tipo de notificação de remessa concluída. Esse tipo de notificação é personalizado pelo modo de entrega.

Ordem remetida

O tipo de notificação ordem enviada é disparado quando uma ordem com um modo de entrega que não seja na loja é faturada.

Observação

O tipo de notificação de ordem enviada foi preterido em favor do tipo de notificação de ordem faturada. Esse tipo de notificação é personalizado pelo modo de entrega.

Ordem faturada

O tipo de notificação ordem faturada é disparado quando uma ordem é faturada no PDV ou no Commerce headquarters.

Emitir cartão-presente

O tipo de notificação emitir cartão-presente é disparado quando uma ordem de venda que contém um produto do tipo de cartão-presente é faturada.

Observação

O email de notificação de emissão de cartão-presente é enviado ao destinatário do cartão-presente. O destinatário do cartão-presente é especificado no Commerce headquarters, em uma linha da ordem de venda individual na guia Remessa em Detalhes da linha. Ele pode ser especificado manualmente ou de forma programática.

O tipo de notificação de emissão de cartão-presente oferece suporte aos seguintes espaços reservados adicionais:

Nome do espaço reservado Finalidade
giftcardnumber O número do cartão-presente para produtos do tipo de cartão-presente.
availablebalance O saldo restante disponível no cartão-presente.
giftcardmessage A mensagem do cartão-presente para produtos do tipo de cartão-presente.
giftcardpin O PIN (número de identificação pessoal) do cartão-presente para produtos do tipo de cartão-presente. (Este espaço reservado é específico de cartões-presente externos).
giftcardexpiration A data de vencimento do cartão-presente para produtos do tipo de cartão-presente. (Este espaço reservado é específico de cartões-presente externos).
giftcardrecipientname O nome do destinatário do cartão-presente para produtos do tipo de cartão-presente.
giftcardbuyername O nome do comprador do cartão-presente para produtos do tipo de cartão-presente.

Para obter mais informações sobre vales-presentes, consulte Vales-presente digitais de comércio eletrônico e Suporte a vales-presentes externos.

Cancelamento da ordem

O tipo de notificação cancelamento da ordem é disparado quando uma ordem é cancelada no Commerce headquarters.

Cliente criado

O tipo de notificação cliente criado é disparado quando uma entidade de cliente é criada no Commerce headquarters.

Para habilitar as notificações geradas para o cliente no Commerce headquarters acesse Retail e Commerce > Configuração do headquarters > Parâmetros > Parâmetros do Commerce > Geral. Na lista suspensa Perfil de notificação por email, selecione um perfil de notificação por email que contém o tipo de notificação criada pelo cliente.

Por padrão, os eventos criados pelo cliente são carregados no headquartes com o trabalho em lote Sincronizar clientes e solicitações de canal. Se você deseja usar uma chamada de serviço em tempo real para enviar esses eventos, defina a ID do email do modelo criado pelo cliente para newCust. No entanto, isso não é recomendável porque as chamadas em tempo real do serviço são chamadas do tipo "Acione e esqueça" e não têm a lógica de fallback ou de repetição que os trabalhos em lote fornecem.

Observação

Ao habilitar notificações criadas pelo cliente, os clientes criados em todos os canais da entidade legal receberão um cliente criado por email. No momento, as notificações criadas pelo cliente não podem ser limitadas a um único canal.

Quando solicitado por meio do trabalho em lotes, o tipo de notificação criado pelo cliente oferece suporte ao seguinte espaço reservado.

Nome do espaço reservado Descrição
customername O nome e o sobrenome do cliente que criou uma conta.

Quando solicitado por meio de uma chamada de serviço em tempo real, o tipo de notificação criado pelo cliente oferece suporte ao seguinte espaço reservado.

Nome do espaço reservado Descrição
Nome O nome e o sobrenome do cliente que criou uma conta.
Email O endereço de email do cliente que criou uma conta.
Telefone O número de telefone do cliente que criou uma conta.
URL A URL fornecida pelo cliente quando ele criou a conta.

Cliente potencial B2B aprovado

O tipo de notificação cliente potencial B2B aprovado é disparado quando uma solicitação de integração de um cliente potencial é aprovada no Commerce headquarters. Para obter mais informações sobre como aprovar ou rejeitar clientes potenciais B2B, consulte Configurar o usuário administrador para um novo parceiro comercial.

O tipo de notificação de aprovação de cliente potencial B2B oferece suporte aos seguintes espaços reservados adicionais:

Nome do espaço reservado Finalidade
firstname O primeiro nome do cliente potencial B2B conforme inserido no aplicativo.
lastname O sobrenome do cliente potencial B2B conforme inserido no aplicativo.
company O nome da empresa do candidato conforme inserido no aplicativo.
email O endereço de email do cliente potencial conforme inserido no aplicativo.
zipcode O CEP do endereço principal do cliente potencial.
comments O comentário inserido pelo cliente potencial no aplicativo.
storename O nome do canal em que o cliente potencial foi criado.
storeurl Vazio por padrão. Uma extensão personalizada deve ser criada para que este espaço reservado seja usado.

Cliente potencial B2B rejeitado

O tipo de notificação cliente potencial B2B rejeitado é disparado quando uma solicitação de integração de um cliente potencial é rejeitada no Commerce headquarters. Para obter mais informações sobre como aprovar ou rejeitar clientes potenciais B2B, consulte Configurar o usuário administrador para um novo parceiro comercial.

O tipo de notificação de rejeição de cliente potencial B2B oferece suporte aos seguintes espaços reservados adicionais:

Nome do espaço reservado Finalidade
firstname O primeiro nome do cliente potencial B2B conforme inserido no aplicativo.
lastname O sobrenome do cliente potencial B2B conforme inserido no aplicativo.
company O nome da empresa do candidato conforme inserido no aplicativo.

Criar um modelo de email

Para poder mapear um evento transacional específico para um modelo de email, você precisa criar o modelo.

Para criar um modelo de email, siga estas etapas.

  1. No Commerce headquarters, acesse Varejo e Comércio > Configuração do headquarters > Modelos de email da organização ou Administração da organização > Configuração > Modelos de email da organização.

  2. Selecione Novo.

  3. Em Geral, defina os seguintes campos:

    • ID do email – a ID do email é o identificador exclusivo de um modelo. É o valor exibido ao selecionar um modelo a ser mapeado para um evento.
    • Descrição do email – você pode usar este campo opcional para fornecer uma descrição do modelo. O valor inserido aparece somente em Commerce headquarters.
    • Nome do remetente – o nome inserido aparece no campo "de" da maioria dos clientes de email.
    • Email do remetente – insira o endereço de email que deve ser usado para emails enviados usando esse modelo.
    • Código do idioma padrão – esse campo especifica a versão localizada do email enviado por padrão, caso nenhum idioma seja especificado pelo canal que invoca esse modelo.

  4. Em Conteúdo da mensagem de email, selecione Novo.

  5. No campo Idioma, insira o idioma do modelo de email. Você poderá adicionar mais idiomas e modelos localizados posteriormente.

  6. No campo Assunto, insira o assunto do email que deve aparecer no campo de assunto do email.

  7. Selecione Editar para carregar seu modelo de email.

Crie um corpo de mensagem de email usando HTML

O corpo da mensagem do email é composto em HTML. Você pode usar qualquer layout, estilo e marca permitidos por HTML e CSS (Folhas de Estilos em Cascata). Também poderá usar imagens se você hospedá-las em um ponto de extremidade Web disponível publicamente. Para adicionar uma imagem, insira o URL da imagem no atributo src da tag <img> em HTML.

Observação

Os clientes de email impõem limitações de estilo e layout que podem exigir ajustes no HTML e CSS que você usa para o corpo da mensagem. Recomendamos que você se familiarize com as práticas recomendadas para criar HTML que receberá suporte dos clientes de email mais conhecidos.

Adicionar espaços reservados ao corpo da mensagem de email

Seu email pode conter espaços reservados que são substituídos por valores específicos do cliente e de transação, quando o email é gerado. Os espaços reservados estão sempre entre sinais de porcentagem (%) e 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>

Espaços reservados de ordens (nível de ordem de venda)

Os espaços reservados a seguir recuperam e mostram dados definidos no nível de ordem de venda (em oposição ao nível de linha de venda).

Nome do espaço reservado Finalidade
customername O nome do cliente que fez a ordem.
customeraddress O endereço do cliente.
customeremailaddress O endereço de email inserido pelo cliente na finalização da compra.
salesid A ID de vendas da ordem.
orderconfirmationid A ID do canal cruzado que foi gerada na criação da ordem.
channelid A ID do canal de varejo ou online para o qual a ordem foi feita.
deliveryname O nome que é especificado para o endereço de entrega.
deliveryaddress O endereço de entrega para ordens remetidas.
deliverydate A data de entrega.
shipdate A data de remessa.
modeofdelivery O modo de entrega da ordem.
ordernetamount O valor total da ordem, menos o imposto total.
discount O total de descontos da ordem.
charges O total de encargos da ordem.
tax O total de impostos da ordem.
total O valor total da ordem.
storename O nome da loja em que foi feita a ordem.
storeaddress O endereço da loja que fez a ordem.
storeopenfrom O horário de abertura da loja que fez a ordem.
storeopento O horário de fechamento da loja que fez a ordem.
pickupstorename O nome da loja em que a ordem será retirada.*
pickupstoreaddress O endereço da loja em que a ordem será retirada.*
pickupopenstorefrom O horário de abertura da loja em que a ordem será retirada.*
pickupopenstoreto O horário de fechamento da loja em que a ordem será retirada.*
pickupchannelid A ID de canal do armazenamento especificado para um modo de entrega de retirada.*
packingslipid A ID da guia de remessa que foi gerada quando as linhas de uma ordem foram embaladas.*

* Estes espaços reservados retornam dados somente quando são usados para o tipo de notificação Ordem pronta para retirada.

Espaços reservados da linha de ordem (nível da linha de venda)

Os espaços reservados a seguir recuperam e mostram dados de produtos individuais (linhas) na ordem de venda.

Nome do espaço reservado Finalidade
productid

A ID do produto. Esta ID é responsável por grades.

Observação: este espaço reservado foi preterido em favor de lineproductrecid.
lineproductrecid A ID do produto. Esta ID é responsável por grades. Ele identifica exclusivamente um item no nível da grade.
lineitemid A ID do nível do produto. (Esta ID não é responsável por grades).
lineproductvariantid A ID da grade de produto.
lineproductname O nome do produto.
lineproductdescription A descrição do produto.
linequantity O número de unidades que foram solicitadas para a linha, mais a unidade de medida (por exemplo, ea ou par).
lineunit A unidade de medida da linha.
linequantity_withoutunit O número de unidades que foram solicitadas para a linha, sem a unidade de medida.
linequantitypicked Quando o evento PickOrder é usado, o número de unidades que foram coletadas. Caso contrário, 0 (zero).
linequantitypicked_withoutunit Quando o evento PickOrder é usado, o número de unidades que foram coletadas, sem a unidade de medida. Caso contrário, 0 (zero).
linequantitypacked Quando os eventos PackOrder e Ordem pronta para retirada são usados, o número de unidades que foram embaladas. Caso contrário, 0 (zero).
linequantitypacked_withoutuom Quando os eventos PackOrder e Ordem pronta para retirada são usados, o número de unidades que foram embaladas, sem a unidade de medida. Caso contrário, 0 (zero).
linequantityshipped Sempre 0, exceto quando eventos específicos são usados, conforme descrito na linha seguinte.
linequantityshipped_withoutuom Quando o evento ShipOrder é usado, o número de unidades que foram coletadas, sem a unidade de medida. Caso contrário, 0 (zero).
lineprice O preço de uma única unidade.
linenetamount O preço da linha depois do número de unidades e do desconto serem aplicados.
linediscount O desconto de uma unidade individual.
lineshipdate A data de remessa 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 retirada especificada pelo cliente para ordens que usam um modo de entrega de retirada.
linepickuptimeslot O intervalo de tempo de retirada especificado pelo cliente para ordens que usam um modo de entrega de retirada.
giftcardnumber O número do cartão-presente para produtos do tipo de cartão-presente.
giftcardbalance O saldo do cartão-presente para produtos do tipo de cartão-presente.
giftcardmessage A mensagem do cartão-presente para produtos do tipo de cartão-presente.
giftcardpin O PIN do cartão-presente para produtos do tipo de cartão-presente. (Este espaço reservado é específico de cartões-presente externos).
giftcardexpiration A data de vencimento do cartão-presente para produtos do tipo de cartão-presente. (Este espaço reservado é específico de cartões-presente externos).
giftcardrecipientname O nome do destinatário do cartão-presente para produtos do tipo de cartão-presente.
giftcardbuyername O nome do comprador do cartão-presente para produtos do tipo de cartão-presente.

Formato dos espaços reservados da linha de ordem no corpo da mensagem de email

Quando você criar o HTML para as linhas de ordem individuais no corpo da mensagem de email, coloque o bloco de repetição de HTML e os espaços reservados para as linhas com os espaços reservados a seguir. Observe que os espaços reservados estão dentro das tags 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>

Crie um modelo para recibos enviados por email

Os recibos podem ser enviados por email para clientes que fazem compras em um PDV (ponto de venda de varejo). Em geral, as etapas para a criação do modelo de recibo por email são as mesmas etapas para criar modelos para outros eventos transacionais. No entanto, são necessárias as seguintes alterações:

  • O espaço reservado %message% é usado para inserir texto do recibo no email. Para garantir que o corpo do recibo seja processado corretamente, coloque o espaço reservado %message% entre as marcas HTML <pre> e </pre>.
  • O espaço reservado %receiptid% pode ser usado para mostrar um código QR ou código de barras que representa a ID do recibo. (Os códigos QR e os códigos de barras são gerados dinamicamente e servidos por um serviço terceirizado). Para obter mais informações sobre como mostrar um código QR ou código de barras em um recibo enviado por email, consulte Adicionar um código QR ou código de barras a emails transacionais e de recebimento.

Carregar o HTML do email

Depois de criar e testar o HTML para o corpo da mensagem, ele deverá ser carregado para o Commerce headquarters. No momento, não é possível exportar o HTML do email. Portanto, você deve manter a cópia principal do seu HTML fora do Commerce headquarters.

Para carregar um HTML de modelo de email novo ou editado, siga estas etapas.

  1. Em Commerce headquarters, acesse Varejo e Comércio > Configuração do headquarters > Modelos de email da organização.
  2. Selecione a linha do idioma para o qual você deseja adicionar ou substituir o HTML. Outra opção é selecionar Novo para criar uma linha para um novo idioma.
  3. Selecione Editar.
  4. Na caixa de diálogo exibida, selecione Navegar. Navegue até o documento HTML a ser carregado, selecione-o e, depois, selecione Abrir.
  5. Selecione Carregar.
  6. Depois que o HTML do email aparecer na janela de visualização, selecione OK.
  7. Verifique se a caixa de seleção Tem corpo está marcada para a linha.

Se você já configurou o Commerce headquarters para enviar emails, seus emails novos ou atualizados serão enviados para todos os clientes que executam uma transação que invoca o evento mapeado para o modelo.

Para obter mais informações sobre como configurar emails no Dynamics 365 Commerce, consulte Configurar e enviar email.

Recursos adicionais

Configurar perfil de notificação por email

Configurar e enviar email

Configurar recebimentos de email

Enviar recibos por email do Store Commerce