Referencia de variables de notificación

Las notificaciones enviadas desde tu tienda se renderizan en Liquid. Liquid es un lenguaje de programación simple y fácil de usar de Shopify. Es el mismo lenguaje de programación en el que se basan nuestras plantillas de la Tienda de plantillas.

Para editar las notificaciones que se envían desde tu tienda, puedes realizar personalizaciones básicas a tus plantillas de notificación.

Para solicitar ayuda con cambios más avanzados o para realizar cambios en las plantillas de notificación personalizadas, puedes comunicarte con la comunidad en nuestros foros; ahí encontrarás muchas veces consejos amables y útiles. También puedes considerar contratar a un Shopify Expert para que haga las personalizaciones por ti.

Aquí hay una lista de plantillas de notificaciones de Liquid que puedes personalizar desde el panel de control de tu tienda:

  • Carritos abandonados
  • Contacto del cliente
  • Invitación a la cuenta de cliente
  • Bienvenida a la cuenta del cliente
  • Renovación de contraseña de la cuenta de cliente
  • Borrador de factura de pedido
  • Solicitud de envío
  • Se ha creado una tarjeta de regalo
  • Pedido nuevo
  • Nuevo pedido (móvil)
  • Pedido cancelado
  • Confirmación del pedido
  • Recibo de TPV y móvil
  • Reembolso de pedido
  • Confirmación de envío
  • Actualización de envío

Todas las plantillas en tu panel de control tienen acceso a las propiedades de sus pedidos correspondientes:

Propiedades de pedidos

Varias propiedades de un pedido están disponibles directamente usando Liquid, en plantillas y en scripts adicionales.

Las propiedades de un pedido están disponibles en las siguientes plantillas:

  • Confirmación del pedido
  • Pedido nuevo
  • Nuevo pedido (móvil)
  • Confirmación de envío
  • Actualización de envío
  • Scripts adicionales
  • Solicitud de envío
Propiedad Descripción
Identificación

Una identificación única en sistema del pedido para uso interno. Usa esta función, por ejemplo, para generar un enlace al pedido en el panel de control de tu tienda. Por ejemplo, en tu plantilla de **Nuevo pedido** colocarías:

<a href="{{ shop.url }}/admin/orders/{{ id }}">Ver pedido</a>

Correo electrónico
El correo electrónico asociado al pedido.
Nombre
Normalmente, es un símbolo de numeral seguido del número de pedido, por ejemplo, Pedido #1004.
order_name
Igual que el nombre.
order_number
Número único del pedido, por ej. 1004, sin el prefijo del símbolo numeral, o cualquier prefijo o sufijo agregado por el propietario de la tienda en las preferencias de su tienda.
created_at
La fecha y hora en que el cliente creó el pedido, por ej. 2009-05-30T17:43:51+02:00. Puedes dar formato usando el filtro de fecha.
Etiquetas Devuelve una matriz de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta nuestra documentación de referencia de Liquid para más detalles.
Transacción Las notificaciones tienen acceso a cada propiedad de la transacción. Consulta nuestra documentación de API de transacciones aquí para ver una lista completa de las propiedades.
tax_price
Los impuestos totales de todos los artículos en el pedido.
tax_lines

Impuestos desglosados por 'nivel' de imposición:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}

tax_line.title
El nombre del impuesto, por ej. QST o IVA.
tax_line.price
El monto.
tax_line.rate
La tasa. Devolverá 0,175 si es 17,5%.
tax_line.rate_percentage
La tasa de impuestos en forma legible para personas. Devolverá 17,5 si la tasa es 0,175.
Cliente
Objeto de cliente que contiene los atributos de salida del cliente.
billing_address
La dirección de facturación.
billing_address.first_name
Primer nombre del cliente.
billing_address.last_name
Apellido del cliente.
billing_address.company
Nombre de la empresa para la facturación.
billing_address.phone
Número de teléfono de la dirección de facturación.
shop.name
Nombre de tu tienda.
shop.phone
El número de teléfono de tu tienda.
subtotal_price
Suma de los precios de los artículos individuales del pedido después de aplicar cualquier descuento en un artículo o en el carrito. El subtotal no incluye impuestos (a menos que los impuestos estén incluidos en los precios) ni costos de envío.
Descuentos
Una lista de descuentos.
discounts_amount
Monto del descuento aplicado en todos los descuentos (p. ej. +$5,00).
discounts_savings
Monto ahorrado en todos los descuentos (por ej. -$5,00).
total_price

Total del pedido (subtotal + costo de envío - descuento de envío + impuestos).

financial_status
El estado actual de pago. Nulo, 'pendiente', 'autorizado', 'pagado', 'anulado', o 'reembolsado'.
requires_shipping
(booleano) Devuelve verdadero si hay al menos un artículo en el pedido que requiere envío.
shipping_method.title
El nombre de la tarifa de envío, por ej. "Envío estándar".
shipping_method.price
Igual que shipping_price a continuación.
shipping_price

El precio de envío.

Ejemplo: {{ shipping_price | money }}

shipping_address
La dirección de envío.
shipping_address.first_name
El primer nombre para la dirección de envío.
shipping_address.company
Nombre de la empresa para la dirección de envío.
shipping_address.phone
Número de teléfono de la dirección de envío.
line_items
Lista de todos los Artículos en el pedido.
item_count
Una suma de todas las cantidades de los artículos.
fulfillment_status
El estado actual de la preparación del pedido. 'No enviado', 'parcial' o 'enviado'.
Nota
La nota que se adjunta al pedido. La nota puede obtenerse del cliente y/o editarse en la pantalla de detalles del pedido en tu interfaz de panel de control.
atributos

Cualquier atributo que se adjuntó al pedido.

Ejemplo: {{ attributes.gift-note }}

referring_site

Contiene la URL del referente que llevó al cliente a tu tienda.

Ejemplo: https://www.google.com/?s=great+products

landing_site

Contiene la ruta del sitio al que llegó el cliente. Esta es la primera página que el cliente vio cuando llegó a la tienda.

Ejemplo: /products/great-product?ref=my-tracking-token

landing_site_ref

Revisa el sitio de llegada y extrae un parámetro de referencia. Los parámetros de referencia pueden ser: ref, fuente, r.

Si el landing_site fue /products/great-product?ref=my-tracking-token, entonces landing_site_ref será my-tracking-token. Puedes realizar una acción determinada si tu ref es igual a cierto valor:

{% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
cancelado
(booleano) Devuelve verdadero si el pedido se ha cancelado.
cancelled_at
La hora en que se canceló el pedido.
cancel_reason
El motivo seleccionado al cancelar el pedido. 'inventario', 'cliente', 'fraude' u 'otro'.
has_high_risks?

Devuelve verdadero si el pedido tiene alto riesgo

unique_gateways

Devuelve una lista de proveedores de pago únicos en un pedido. Por ejemplo, si alguien pagó con una Visa, una Mastercard y efectivo, la lista sería "shopify_payments, efectivo".

ubicación (POS solamente)

Muestra la ubicación física del pedido. Hay varias propiedades de ubicación disponibles, disponibles aquí. Puedes configurar sucursales en el área sucursales del panel de control.

order_status_url

Devuelve el enlace a la página de estado de este pedido.

fulfilled_line_items (obsoleto)
Lista de Artículos que se han enviado.
unfulfilled_line_items (obsoleto)
Lista de Artículos cuyo proceso de envío no se ha completado.

Propiedades de pedido preliminar

Las propiedades de pedido preliminar están disponibles en la plantilla de correo electrónico de Factura de pedido preliminar, con el que se notifica a tus clientes sobre facturas pendientes.

Propiedad Descripción
Identificación
Una identificación única del pedido preliminar para uso interno.
invoice_url
Un enlace que puede usar el cliente para pagar la factura utilizando el pago seguro de Shopify.
reserve_inventory_until

La fecha y hora hasta la cual los artículos del pedido preliminar están reservadas, por ejemplo, 2015-05-30T17:43:51+02:00.

Puede dar formato a fechas usando el filtro de fecha de Liquid.

usuario
El último empleado que modificó el pedido preliminar.
user.name
El nombre del último empleado que modificó el pedido preliminar.
user.email
El correo electrónico del último empleado que modificó el pedido preliminar.
Correo electrónico
El correo electrónico asociado al pedido preliminar.
Nombre
El número único del pedido preliminar, precedido de un símbolo numeral #.
número
El número único de pedido preliminar sin prefijo ni sufijo.
created_at

La fecha y hora en que el cliente creó el pedido preliminar, por ejemplo, 2009-05-30T17:43:51+02:00.

Puede dar formato a fechas usando el filtro de fecha de Liquid.

Etiquetas Devuelve una matriz de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta nuestra documentación de referencia de Liquid para más detalles.
tax_price
Los impuestos totales de todos los artículos en el pedido preliminar.
tax_lines

Impuestos desglosados por 'nivel' de imposición:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title
El nombre del impuesto, por ej. QST o IVA.
tax_line.price
El monto del impuesto.
tax_line.rate
La tasa de impuesto en forma decimal. Por ejemplo, una tasa de impuesto de 17,5% devolverá 0,175.
tax_line.rate_percentage
La tasa de impuesto en forma porcentual. Por ejemplo, una tasa de 0,175 devolverá 17,5.
Cliente
Objeto de cliente que contiene los atributos de salida del cliente.
billing_address
La dirección de facturación del pedido preliminar.
billing_address.first_name
El primer nombre del cliente.
billing_address.last_name
El apellido del cliente.
billing_address.company
El nombre de la empresa en la dirección de facturación.
billing_address.phone
El número de teléfono de la dirección de facturación.
shop.name
El nombre de tu tienda.
shop.phone
El número de teléfono de tu tienda.
subtotal_price
Suma de los precios de los artículos individuales del pedido después de aplicar cualquier descuento en un artículo o en el carrito. El subtotal no incluye impuestos (a menos que los impuestos estén incluidos en los precios) ni costos de envío.
Descuentos
Una lista de descuentos.
discounts_amount
Monto del descuento aplicado en todos los descuentos (p. ej. +$5,00).
discounts_savings
Monto ahorrado en todos los descuentos (por ej. -$5,00).
total_price
Precio total del pedido (subtotal + costo de envío - descuento de envío + impuestos).
requires_shipping
Devuelve verdadero si hay al menos un artículo en el pedido preliminar que requiere envío. Devuelve falso si no hay artículos en el pedido preliminar que requieran envío.
shipping_method.title
El nombre de la tarifa de envío, por ejemplo Envío Estándar.
shipping_method.price
El precio del método de envío. Devuelve la misma información que en shipping_price.
shipping_price

El precio de envío.

Puedes dar formato a este monto usando los filtros de dinero de Liquid.

shipping_address

La dirección de envío.

Nota: a diferencia de pedidos normales, la dirección de envío de un pedido preliminar puede estar incompleta.

shipping_address.first_name
El primer nombre para la dirección de envío.
shipping_address.company
El nombre de la empresa en la dirección de envío.
shipping_address.phone
El número de teléfono de la dirección de envío.
line_items
Una lista de todos los artículos en el pedido preliminar.
item_count
Una suma de todas las cantidades de artículos en el pedido preliminar.
Nota
La nota que se adjunta al pedido preliminar. La nota puede obtenerse del cliente y editarse en la pantalla de detalles del pedido preliminar en tu panel de control de Shopify.
Ubicación

La ubicación física del pedido. Hay varias propiedades de ubicación disponibles.

Puedes configurar áreas enSucursales de tu panel de control de Shopify.

propiedades de línea de producto

Cada line en la lista line_items tiene las siguientes propiedades:

Propiedad Descripción
line.applied_discounts (solo POS y pedidos preliminares)
Lista de descuentos aplicados a este artículo (cada descuento tiene las propiedades título, código, monto, ahorro y tipo).
line.custom (solo pedidos preliminares)
(booleano) Devuelve verdadero si el artículo es un artículo personalizado para un pedido preliminar.
line.grams
Peso de un artículo.
line.image
Devuelve la URL de la imagen asociada a esta línea de pedido. También puedes usar el filtro img_url para obtener tamaños de imagen específicos, por ejemplo {{ line.image | img_url: 'small' }}
line.line_price
El precio multiplicado por la cantidad de artículos.
line.price
El precio de un artículo.
line.properties
Devuelve una variedad de informaciones personalizadas de un artículo. El cliente especifica las propiedades de artículos en la página del producto, antes de agregarlo al carrito.
line.quantity
La cantidad de dicho artículo.
line.requires_shipping
(booleano) Devuelve verdadero si la variante del artículo tiene marcada la casilla **Este es un producto físico** en la página del producto.
line.sku
SKU asociado al producto.
line.taxable
(booleano) Devuelve verdadero si la variante del artículo tiene marcada la casilla 'Cobrar impuestos en este producto' en la página del producto.
line.title
El nombre del producto seguido de un guión seguido del nombre de la variante. El nombre de la variante no está incluido cuando es “Título Predeterminado”.
line.variant.barcode
Código de barras asociado al producto.
line.variant.image
La imagen de la variante del producto. Solo devuelve una imagen si hay una imagen específica asignada a la variante en el artículo.
line.product.vendor
Proveedor del artículo.

Propiedades de reembolsos

Estas propiedades adicionales están disponibles en la plantilla de correo electrónico de Reembolsos. Esta plantilla de correo electrónico se utiliza para notificar a tus clientes que se ha aplicado un reembolso (completo o parcial) a su pedido. Puedes usar cualquier variable disponible para la plantilla de notificación de Correo electrónico de pedido, además de las siguientes variables:

Propiedad Descripción
Cantidad
El monto de dinero reembolsado.
refund_line_items
Una lista de Refund_line_items que serán reembolsados.

Refund_line_item properties

Cada línea de reembolso en la lista de artículos de reembolso tiene las siguientes propiedades:

Propiedad Descripción
refund_line.line_item
El artículo (line_item) que se reembolsa. Tiene acceso a todas las propiedades de line_item.
refund_line.quantity
La cantidad del artículo que se reembolsará.

Propiedades de proceso de envío

Estas propiedades adicionales están disponibles en las plantillas de correo electrónico de Confirmación de envío, Actualización de envío y Solicitud de proceso de envío.

La Confirmación de envío y la Actualización de envío se utilizan para notificar a tus clientes que algunos o todos los artículos en su pedido se han enviado satisfactoriamente o se han actualizado con nueva información de envío.

La plantilla de correo electrónico de Solicitud de proceso de envío se utiliza para cualquier servicio de envío personalizado definido en el panel de control de tu tienda. Para agregar un servicio de envíos personalizado, entra en Configuración > Páginas de envío y baja hasta la sección "Proceso de envío/Dropshipping".

Propiedad Descripción
service_name
El nombre del servicio personalizado se define en la página Configuración > Página de envío. (Solo solicitud de proceso de envío)
fulfillment.estimated_delivery_at
Una fecha estimada de entrega basada en el número de rastreo (si está disponible) proporcionado por uno de los siguientes operadores: USPS, FedEx, UPS, Canada Post (solo en Canadá). Esta propiedad solo está disponible cuando se usan las tasas calculadas de transportista.
fulfillment.fulfillment_line_items
Una lista de Fulfillment_line_items para ser preparados.
fulfillment.item_count
Una suma de todas las cantidades de los artículos. El número total de artículos que serán preparados.
fulfillment.requires_shipping
(booleano) Devuelve verdadero si este proceso de envío requiere envío.
fulfillment.tracking_company
La empresa que realiza el rastreo.
fulfillment.tracking_numbers
Una lista de números de rastreo.
fulfillment.tracking_urls
Una lista de URL de rastreo.
items_to_fulfill (obsoleto)
Lista Artículos que serán preparados por este Servicio de envíos personalizado. (Solo solicitud de proceso de envío)
items_to_fulfill_count (obsoleto)
El número total de artículos que deben ser preparados en esta solicitud. (Solo solicitud de proceso de envío)

Fulfillment_line_item properties

Cada fulfillment_line en la lista fulfillment_line_items tiene las siguientes propiedades:

Propiedad Descripción
fulfillment_line.line_item
El line_item a ser surtido. Tiene acceso a todas las propiedades del line_item.
fulfillment_line.quantity
La cantidad del artículo que se surtirá.

Propiedades de descuento

Propiedad Descripción
discounts.first.code
El código que el cliente ingresa para aplicar el descuento. Debe ingresarse en un bucle si quieres permitir que se apliquen varios códigos de descuento.
discounts.first.amount
El monto descontado del total del pedido.
discounts.first.savings
La cantidad de dinero que el cliente ahorra gracias al código de descuento.
discounts.first.type
El tipo de descuento (FixedAmountDiscount, PercentageDiscount,1 or ShippingDiscount).

Propiedades de notificación por correo electrónico

Propiedad Descripción
shop.email_logo_url
El url del logotipo especificado en la sección Personalizar plantillas de correo electrónico del panel de control.
shop.email_logo_width
El ancho del logotipo (píxeles) especificado en la sección Personalizar plantillas de correo electrónico del panel de control.
shop.email_accent_color
El código HEX del tono de color especificado en la sección Personalizar plantillas de correo electrónico del panel de control.

¿Estas listo(a) para comenzar a vender con Shopify?

Pruébala gratis