Las notificaciones por correo de StoreFront están diseñadas para proveer información importante a los clientes y a los propietarios de las tiendas. Estas notificaciones se crean con la ayuda de etiquetas de HTML y usan variables especiales para mostrar la información del pedido real en los correos electrónicos.
A continuación se describe la lista de variables disponibles y da ejemplos de su uso.
Hay notificaciones por correo electrónico que se pueden personalizar en los planes Venture y superiores.
Variables de la información del cliente
| Nombre | Descripción |
|---|---|
| ${customer.name} | Muestra el nombre del cliente. |
| ${customer.email} | Muestra el correo electrónico del cliente. |
| ${customer.membership_name} | Muestra el nombre del grupo del cliente. |
| ${customer.membership+id} | Muestra la ID de grupo del cliente. |
Variables de la información del pedido
| Nombre | Descripción |
|---|---|
<#list order.items as orderItem> </#list> |
Muestra la lista de productos pedidos. |
| ${orderItem.name} | Muestra el nombre del producto. |
| ${orderItem.sku} | Muestra la SKU del producto. |
| <#noescape>${orderItem.description}</#noescape> | Muestra la descripción del producto. |
| ${orderItem.customerUrl} | Invoca la URL de la página del producto. |
| ${orderItem.imageUrl} | Muestra la imagen del producto. |
| ${orderItem.quantity} | Muestra la cantidad de artículos pedidos. |
| ${orderItem.price} | Muestra el precio del producto. |
| ${orderItem.isShippingRequired} | |
| ${orderItem.weight} | Muestra el peso del artículo pedido. |
| ${orderItem.subtotal} | Muestra el subtotal de artículos pedidos (precio del artículo x cantidad de artículos pedidos). |
| <#list orderItem.options as option> </#list> | Muestra la lista de opciones seleccionadas para el producto. |
| ${option.name} | Muestra el nombre de la opción. |
| ${option.value} | Muestra el monto del modificador del precio. |
| <#list orderItem.attributes as attribute> </#list> | Muestra la lista de atributos ocultos establecidos para el producto. |
| ${attribute.name} | Muestra el título del atributo oculto. |
| ${attribute.value} | Muestra el nombre del atributo oculto. |
| <#list orderItem.visibleAttributes as visibleAttribute> </#list> | Muestra la lista de atributos configurados para el producto. |
| ${visibleAttribute.name} | Muestra el título del atributo. |
| ${visibleAttribute.value} | Muestra el nombre del atributo. |
| <#list orderItem.files as file> </#list> | Muestra la lista de archivos adjuntos al producto. |
| ${file.description} | Muestra la descripción del archivo. |
| ${file.fileName} | |
| ${file.name} | Muestra el nombre del archivo. |
| ${file.type} | Muestra el tipo de archivo. |
| ${file.size} | Muestra el tamaño del archivo. |
| ${file.url} | Agrega un enlace de descarga al archivo. |
| ${order.number} | Muestra el número de pedido. |
| ${order.customerUrl} | Agrega el URL al perfil del cliente. Queda vacío si el pedido fue anónimo. |
| <@orderLink/> | Agrega el número de cliente. Si un cliente registrado hizo el pedido, contiene una URL a los antecedentes de pedidos del cliente. Si el cliente no está registrado, el número de pedido se visualizará como texto sin formato. |
| ${order.adminUrl} | Agrega un enlace al pedido en el Menú de Store. |
| ${order.dateCreated} | Muestra la fecha en la que se hizo el pedido. |
| ${order.paymentStatus} | Muestra el estado actual del pago del pedido. |
| <@paymentStatusColor/> | Cambia el color del elemento ${order.paymentStatus} según el estado del pago. |
| ${order.subtotal} | Muestra el subtotal del pedido. |
| ${order.total} | Muestra el total del pedido. |
| ${order.shippingCost} | Muestra la tarifa de envío del pedido. |
| ${order.weight} | Muestra el peso total de los artículos pedidos. |
| <#list order.taxes as tax> </#list> | Muestra una lista de los impuestos aplicados al pedido. |
| ${tax.name} | Muestra el nombre del impuesto. |
| ${tax.value} | Muestra el valor del impuesto. |
| <#list order.discounts as discount> </#list> | Muestra una lista del descuento aplicado al pedido. |
| ${discount.name} | Muestra el nombre del descuento. |
| ${discount.value} | Muestra el valor del descuento. |
| ${order.couponPercent} | Muestra el porcentaje del cupón de descuento aplicado al pedido. |
| ${order.couponName} | Muestra el nombre del cupón de descuento. |
| ${order.couponCode} | Muestra el código del cupón de descuento. |
| ${order.totalDiscount} | Muestra el monto del valor total del descuento aplicado al pedido. |
| ${order.isShippingRequired} | |
| ${order.shippingAddress} | Muestra la dirección de envío completa para el pedido. También es posible mostrar cada elemento de la dirección de envío por separado. |
| ${order.shippingAddress.name} | Muestra el nombre del cliente. |
| ${order.shippingAddress.companyName} | Muestra el nombre de la empresa que se especifica en la dirección de envío. |
| ${order.shippingAddress.street} | Muestra la calle que se especifica en la dirección de envío. |
| ${order.shippingAddress.city} | Muestra la ciudad que se especifica en la dirección de envío. |
| ${order.shippingAddress.country} | Muestra el país que se especifica en la dirección de envío. |
| ${order.shippingAddress.countryCode} | Muestra el código de país que se especifica en la dirección de envío del cliente. |
| ${order.shippingAddress.postalCode} | Muestra el código postal que se especifica en la dirección de envío. |
| ${order.shippingAddress.state} | Muestra el estado que se especifica en la dirección de envío. |
| ${order.shippingAddress.stateCode} | Muestra el código del estado que se especifica en la dirección de envío del cliente. |
| ${order.shippingAddress.phone} | Muestra el número de teléfono del cliente. |
| ${order.shippingAddress.province} | Muestra la provincia que se especifica en la dirección de envío. |
| ${order.shippingAddress.provinceCode} | Muestra el código de la provincia que se especifica en la dirección de envío del cliente. |
| ${order.billingAddress} | Muestra la dirección de facturación completa para el pedido. También es posible mostrar cada elemento de la dirección de facturación por separado. |
| ${order.billingAddress.name} | Muestra el nombre del cliente. |
| ${order.billingAddress.companyName} | Muestra el nombre de la empresa que se especifica en la dirección de facturación. |
| ${order.billingAddress.street} | Muestra la calle que se especifica en la dirección de facturación. |
| ${order.billingAddress.city} | Muestra la ciudad que se especifica en la dirección de facturación. |
| ${order.billingAddress.country} | Muestra el país que se especifica en la dirección de facturación. |
| ${order.billingAddress.countryCode} | Muestra el código del país que se especifica en la dirección de facturación del cliente. |
| ${order.billingAddress.postalCode} | Muestra el código postal que se especifica en la dirección de facturación. |
| ${order.billingAddress.state} | Muestra el estado que se especifica en la dirección de facturación. |
| ${order.billingAddress.stateCode} | Muestra el código del estado que se especifica en la dirección de envío del cliente. |
| ${order.billingAddress.phone} | Muestra el número de teléfono que se especifica en la dirección de facturación. |
| ${order.billingAddress.province} | Muestra la provincia que se especifica en la dirección de facturación. |
| ${order.billingAddress.provinceCode} | Muestra el código de la provincia que se especifica en la dirección de envío del cliente. |
| ${order.pickupTime} | Muestra la hora de la recolección seleccionada por un cliente. |
| ${order.isPaid} | |
| ${order.paymentMethod} | Muestra el título "Medio de pago:" y el nombre del medio de pago. |
| ${order.PaymentMethod.isOnline} | |
| ${order.PaymentMethod.instructionsTitle} | Muestra el título de las instrucciones de pago. |
| ${order.PaymentMethod.instructions} | Muestra el contenido de las instrucciones de pago. |
| ${order.PaymentMethod.name} | Muestra el nombre del medio de pago. |
| ${order.orderComments} | Muestra los comentarios del pedido. |
| ${order.privateAdminNotes} | Muestra las notas del pedido del personal agregadas por el propietario de la tienda. |
| ${order.isPaymentStatusUpdated} | |
| ${order.isFulfillmentStatusUpdated} | |
| ${order.fulfillmentStatus} | Muestra el estado actual de cumplimiento del pedido. |
| ${order.trackingNumber} | Muestra el número de seguimiento del pedido, si está habilitado. |
| ${order.trackingUrl} | Agrega la URL de la página de seguimiento del pedido para las opciones de envío calculadas por el transportista. |
| ${order.affiliateID} | Muestra la ID de la cuenta del pedido. |
| ${order.extraFields} | |
| <#list order.extraFields as extraField></#list> | Muestra la lista de campos adicionales del pedido. |
| ${extraField.key} | Muestra la clave del campo adicional. |
| ${extraField.value} | Muestra el valor del campo adicional. |
| ${extraField.title} | Opcional. Muestra el título del campo adicional. |
| ${extraField.orderDisplaySection} | Opcional. Muestra el título del campo adicional. |
| ${extraField.type} | Muestra el tipo de campo adicional. |
Variables de la información del producto
| Nombre | Descripción |
|---|---|
| ${product.name} | Muestra el nombre del producto. |
| ${product.sku} | Muestra la SKU del producto. |
| ${product.quantity} | Muestra la cantidad del producto. |
| ${product.adminUrl} | Muestra la URL de la página del producto en el Menú Store. |
| ${product.customerUrl} | Agrega la URL de la página del producto. |
| ${product.imageUrl} | Muestra la imagen del producto. |
| ${product.warningLimit} | Muestra la cantidad de elementos en stock que activa la "Notificación por bajo stock". |
| ${product.options} | |
| <#list product.options as option> </#list> | Muestra la lista de opciones de productos. |
| ${option.name} | Muestra el nombre de la opción. |
| ${option.value} | Muestra el valor de la opción seleccionada. |
| ${product.attributes} | |
| <#list product.attributes as attribute> </#list> | Muestra la lista de atributos ocultos establecidos para el producto. |
| ${attribute.name} | Muestra el título del atributo oculto. |
| ${attribute.value} | Muestra el nombre del atributo oculto. |
| <#list product.visibleAttributes as visibleAttribute> </#list> | Muestra la lista de atributos configurados para el producto. |
| ${visibleAttribute.name} | Muestra el título del atributo. |
| ${visibleAttribute.value} | Muestra el nombre del atributo. |
Variables para la información de la Store
| Nombre | Descripción |
|---|---|
| ${store.id} | Muestra la ID de la tienda. |
| ${store.name} | Muestra el nombre de la tienda. |
| ${store.logoUrl} | Invoca la URL del logotipo de la tienda. |
| <@storeLogo/> | Muestra el logotipo de la tienda. Si el logotipo no está especificado, muestra el nombre de la tienda. |
| ${store.storeUrl} | Invoca la URL del escaparate. |
| ${store.companyEmail} | Muestra el correo electrónico de la empresa, que se especifica en la configuración de la tienda. |
| ${store.customerOrdersPageUrl} | Invoca la URL de la página de antecedentes de pedidos del cliente. |
| <#list store.legalPages as page> </#list> | Muestra la lista de páginas legales. |
| ${page.name} | Muestra el nombre de una página legal determinada. |
| ${page.url} | Invoca la URL de una página legal determinada. |
| <@legalPages/> | Muestra la lista de páginas legales en una única cadena. |
| ${store.controlPanelUrl} | Agrega la URL https://my.e-shop.com/cp/ al mensaje. |
| ${store.egoodsLinkLifetime} | Muestra la duración del enlace de los productos-e. |
| ${store.egoodsMaxDownloadAttempts} | Muestra la cantidad máxima de intentos de descarga para los productos-e. |
| ${store.officeAddress} | Muestra la dirección física de la tienda que está especificada en la configuración de la tienda. |
| ${store.resetPasswordUrl} | Agrega la URL para restablecer contraseña de un cliente al mensaje. |
| ${store.businessRegistrationID} | Muestra la ID del registro comercial de la tienda (IVA). |
Variables de la información de la marca
| Nombre | Descripción |
|---|---|
| ${brand.name} | Muestra el nombre de la marca "Ecwid". |
| ${brand.logoUrl} | Invoca la URL del logotipo. |
Nota
Si un elemento contiene un subelemento, la solicitud se verá de la siguiente manera: ${order.shippingAddress.city}
La lista de elementos puede especificarse con esta construcción:
<#list order.items as orderItem>
${orderItem.name}
</#list>Cambiar el correo electrónico de confirmación de pedido
StoreFront ofrece mensajes predeterminados para las confirmaciones de pedidos pagados y no pagados que ayudan a mantener a sus clientes actualizados.
Los pedidos pagos generan el siguiente mensaje:
¡Gracias por su pedido en la tienda ${store.name}!
Le enviaremos un correo electrónico de notificación tan pronto se envíe su pedido.Los pedidos no pagados (por ejemplo, medios de pago fuera de línea) generan el siguiente mensaje:
¡Gracias por su pedido en la tienda ${store.name}!
Su pedido del ${order.dateCreated} se ha recibido y se procesará
tan pronto se reciba el pago.Puede personalizar estos mensajes para que coincidan con la voz de su tienda usando HTML.
La variable de ${store.name} muestra el nombre de su Store en el mensaje. Se puede colocar en cualquier parte del mensaje.
Eliminar el número de teléfono de la empresa del correo electrónico de confirmación del pedido
Si se proporcionó, añadimos en forma predeterminada el número de teléfono de la empresa a los mensajes de correo electrónico de confirmación de los pedidos. Si desea eliminar esta línea de sus mensajes de correo electrónico, borre la siguiente línea de código de las plantillas de Confirmación de pedidos:
<#if (store.officeAddress.phone)?has_content>
o bien, llame al <b>${store.officeAddress.phone}</b></#if>La variable ${store.officeAddress.phone} es responsable de que se muestre el número de teléfono en el correo electrónico. Si usted quita esta línea del código de la plantilla, no se mostrará el número de teléfono.
Usar los campos adicionales de pedidos
Los campos adicionales en los pedidos le permiten guardar información adicional sobre el pedido. Puede estar visible u oculta para el cliente.
Otras herramientas para trabajar con campos adicionales en los pedidos incluyen dos funciones y una matriz de objetos: getOrderExtraFieldValue("key"), getOrderExtraField("key"), order.extraFields.
Ejemplos
Mostrar todos los campos adicionales del pedido configurados para que sean visibles en los detalles del pedido (se especifica el título y la sección de visualización del pedido)
<#list order.extraFields as extraField>
<#if extraField.title?has_content && extraField.orderDisplaySection?has_content>
${extraField.title}: ${extraField.value}
</#if>
</#list>Imprimir el valor de un campo adicional específico del pedido
<#assign myExtraFieldValue = getOrderExtraFieldValue("askHowYouFoundUsApp")>
<#if myExtraFieldValue?has_content>
${myExtraFieldValue}
</#if>Aquí, askHowYouFoundUsApp es la clave de su campo adicional del pedido.
Imprimir los campos específicos de un campo adicional específico del pedido (elimine los campos que no necesita mostrar)
<#assign myExtraField = getOrderExtraField("askHowYouFoundUsApp")>
${myExtraField.key}
${myExtraField.value}
${myExtraField.type}
${myExtraField.orderDisplaySection}
${myExtraField.title}
Aquí, askHowYouFoundUsApp es la clave de su campo adicional del pedido.