Referencia de variables de notificaciones

Las notificaciones que se envían desde la tienda se generan con Liquid. Liquid es el lenguaje de programación de Shopify, sencillo y fácil de usar. Es el mismo lenguaje de programación en el que se crean los temas de la Tienda de temas.

Para editar las notificaciones que se envían desde la tienda, puedes hacer personalizaciones básicas en las plantillas de notificaciones. Para ver la lista completa de notificaciones que puedes personalizar, ve a la página Notificaciones en el panel de control de Shopify.

Para obtener ayuda con cambios más avanzados o para hacer cambios en plantillas de notificaciones personalizadas, puedes acudir a la comunidad en nuestros foros, o también puedes contratar a un Shopify Partner para que haga las personalizaciones por ti. Más información sobre cómo contratar a un Shopify Partner.

Propiedades del pedido

Muchas propiedades de un pedido están disponibles directamente en Liquid y en las plantillas.

Descripciones de las propiedades de Liquid que puedes usar con el objeto order en las plantillas de notificación
PropiedadDescripción
id

Un identificador único del pedido a nivel de sistema para uso interno. Usa el siguiente ejemplo para generar un enlace al pedido en el panel de control de la tienda. Por ejemplo, en la plantilla Nuevo pedido puedes agregar el siguiente código:

Ver pedido
emailEl correo electrónico asociado al pedido.
name

Por lo general, es el símbolo # seguido de order_number.

Ejemplo: #1004

order_nameIgual que el nombre.
order_number

Número único del pedido de la tienda, sin el prefijo # ni ningún prefijo o sufijo que la persona propietaria de la tienda haya agregado a la identificación de pedido en las preferencias de la tienda.

Ejemplo: 1004

confirmation_number

Un identificador alfanumérico generado de forma aleatoria para el pedido que puede mostrarse al cliente en lugar del nombre secuencial del pedido. No se garantiza que este valor sea único.

Ejemplo: XPAV284CT

created_at

La fecha y hora en que el cliente creó el pedido. Puedes dar formato a este valor con el filtro de fecha.

Ejemplo: 2009-05-30T17:43:51+02:00

payment_terms

Las condiciones de pago especifican la fecha en que debe pagarse el pedido.

Consulta cómo agregar condiciones de pago a las facturas de pedidos.

Para obtener más información, consulta la referencia de Liquid para payment_terms.

destinationEl destino al que se deben enviar los artículos.
tagsDevuelve un arreglo de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Es posible que las etiquetas aplicadas dinámicamente por las aplicaciones o funciones de la plataforma, como la etiqueta Shopify Collective, no estén disponibles cuando se genera el correo electrónico de notificación. Para detectar artículos de una función específica, revisa en su lugar las etiquetas a nivel de producto en cada línea de artículo. Consulta la documentación de referencia de Liquid para obtener más detalles.
transactionsDevuelve una lista de transacciones del pedido.
tax_priceLa suma de los impuestos de todos los artículos del pedido.
tax_lines

Impuestos desglosados por tipo de impuesto:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleEl nombre del impuesto. Por ejemplo, QST o IVA.
tax_line.priceEl importe del impuesto.
tax_line.rateLa tasa de impuestos como decimal. Devuelve 0,175 si es 17,5 %.
tax_line.rate_percentageLa tasa de impuestos en un formato legible. Devuelve 17,5 si la tasa es 0,175.
customerObjeto del cliente que contiene los atributos de la salida de customer.
billing_addressLa dirección de facturación.
billing_address.first_nameNombre del cliente.
billing_address.last_nameApellido del cliente.
billing_address.companyNombre de la empresa para la facturación.
billing_address.phoneNúmero de teléfono de la dirección de facturación.
shop.nameNombre de la tienda.
shop.phoneNúmero de teléfono de la tienda.
subtotal_priceSuma de los precios de las líneas de artículo del pedido después de descontar cualquier descuento por línea de artículo o del carrito. El subtotal no incluye impuestos (a menos que los precios los incluyan), costos de envío ni propinas.
discountsUna lista de descuentos.
discounts_amount

El importe del descuento aplicado por todos los descuentos.

Ejemplo: +$5.00

discounts_savings

El importe del ahorro generado por todos los descuentos.

Ejemplo: -$5.00

total_price

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

financial_statusEl estado de pago actual. Uno de: nil, pending, authorized, paid, voided, refunded.
requires_shipping(booleano) Devuelve true si hay al menos un artículo del pedido que requiere envío.
shipping_method.title

El nombre de la tarifa de envío.

En las notificaciones para el cliente, el nombre de la tarifa de envío se traduce al idioma en el que el cliente completó la compra cuando ese idioma es distinto del idioma predeterminado de la tienda.

Ejemplo: Envío estándar
shipping_method.price

El precio del envío, incluidos los descuentos de envío.

Ejemplo: {{ shipping_method.price | money }}

shipping_price

El precio del envío.

Ejemplo: {{ shipping_price | money }}

shipping_addressLa dirección de envío.
shipping_address.first_nameEl nombre para la dirección de envío.
shipping_address.companyNombre de la empresa para la dirección de envío.
shipping_address.phoneNúmero de teléfono de la dirección de envío.
line_itemsLista de todas las líneas de artículo del pedido.
line_items_including_zero_quantityLista de todas las líneas de artículo del pedido, incluidas las que tienen cantidad cero. Las líneas de artículo tienen cantidad cero cuando están totalmente reembolsadas.
line_item_groups(Orders and POS only)Lista de todos los grupos de líneas de artículo que contienen componentes de líneas de artículo en el pedido.
item_countLa suma de las cantidades de todos los artículos.
fulfillment_statusEl estado actual de preparación del pedido. Uno de: unfulfilled, partial, fulfilled.
noteLa nota adjunta al pedido. Puede provenir del cliente o editarse en la pantalla de información del pedido en el panel de control.
attributes

Los atributos que se adjuntaron al pedido.

Ejemplo: {{ attributes.gift-note }}

metafields

Cualquier metacampo del pedido. Usa la siguiente sintaxis:

metafields.NAMESPACE.KEY

referring_site

Contiene la URL de la fuente de referencia que llevó al cliente a la tienda.

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

landing_site

Contiene la ruta de la página de destino que usó el cliente. Es la primera página que vio al llegar a la tienda.

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

landing_site_ref

Analiza la página de destino y extrae un parámetro de referencia. Los parámetros de referencia pueden ser: ref, source, r.

Si landing_site es /products/great-product?ref=my-tracking-token, entonces landing_site_ref es my-tracking-token. Puedes realizar una acción si el parámetro ref es igual a un valor específico:

{% if landing_site_ref == 'my-tracking-token' %} Mi acción... {% endif %}
cancelled(booleano) Devuelve verdadero si el pedido se canceló.
cancelled_atEl momento en que se canceló el pedido.
cancel_reasonMotivo seleccionado al cancelar el pedido. Puede ser: inventory, customer, declined, fraud o other.
has_high_risks?(deprecated)

Devuelve verdadero si el pedido tiene alto riesgo

unique_gateways

Devuelve una lista de proveedores de pagos distintos en un pedido. Por ejemplo, si alguien pagó con una Visa, una Mastercard y efectivo, la lista devuelta sería shopify_payments, cash.

location(POS only)

Muestra la sucursal física del pedido. Hay varias propiedades de la sucursal disponibles, enumeradas here. Puedes configurar las sucursales en la Locations area of the admin.

order_status_url

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

fulfilled_line_items(deprecated)Lista de line items que se han preparado.
unfulfilled_line_items(deprecated)Lista de line items que no se han preparado por completo.
b2b?

Devuelve true si el pedido es B2B. Usa la propiedad con variables B2B para mostrar información relevante, como el nombre de la empresa, la sucursal de la empresa y la dirección en los correos electrónicos. Por ejemplo, en pedidos B2B, podrías agregar un encabezado a una plantilla con la siguiente información:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

La company a la que vendes en un pedido B2B.

company.name

El nombre de la empresa en un pedido B2B.

company.id

La identificación de la empresa en un pedido B2B.

company_location

La location de la empresa en un pedido B2B. Una empresa que te compra puede tener más de una sucursal.

company_location.name

El nombre de la sucursal de la empresa en un pedido B2B.

company_location.id

El número de identificación de la sucursal de la empresa en un pedido B2B.

company_location.shipping_address

La shipping address de la sucursal de la empresa en un pedido B2B.

company_location.billing_address

La billing address de la sucursal de la empresa en un pedido B2B.

customer_order_url

La new order status page de un pedido para el que un cliente solicitó una devolución usando customer accounts.

Propiedades del pedido preliminar

Descripciones de propiedades de Liquid que puedes usar con el objeto de pedido preliminar en las plantillas de notificación
PropiedadDescripción
idUna identificación única del pedido preliminar para uso interno.
invoice_urlUn enlace para que el cliente pague la factura con el pago seguro de Shopify.
reserve_inventory_until

La fecha y la hora hasta las que se reservan las líneas de artículo del pedido preliminar, por ejemplo, 2015-05-30T17:43:51+02:00.

Puedes dar formato a las fechas usando el date filter de Liquid.

userLa última persona del personal que modificó el pedido preliminar.
user.nameEl nombre de la última persona del personal que modificó el pedido preliminar.
user.emailLa dirección de correo electrónico de la última persona del personal que modificó el pedido preliminar.
emailLa dirección de correo electrónico asociada al pedido preliminar.
nameEl único number del pedido preliminar, con el prefijo del signo de número #.
numberEl número único del pedido preliminar sin el prefijo o sufijo del pedido.
created_at

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

Puedes dar formato a las fechas usando el date filter de Liquid.

tagsDevuelve una lista con todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta la documentación de referencia de Liquid para más detalles.
tax_priceLa suma de los impuestos de todos los artículos del pedido preliminar.
tax_lines

Impuestos desglosados por tipo de impuesto:

{% 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.

Ejemplos: QST o IVA

tax_line.priceEl importe del impuesto.
tax_line.rateLa tasa de impuestos en formato decimal. Por ejemplo, una tasa de impuestos de 17,5% devuelve 0.175.
tax_line.rate_percentageLa tasa de impuestos en formato de porcentaje. Por ejemplo, un rate de 0.175 devuelve 17.5.
customerObjeto del cliente que contiene los atributos de la salida de customer.
billing_addressLa billing address del pedido preliminar.
billing_address.first_nameEl nombre del cliente.
billing_address.last_nameEl apellido del cliente.
billing_address.companyEl nombre de la empresa en la dirección de facturación.
billing_address.phoneEl número de teléfono en la dirección de facturación.
shop.nameEl nombre de la tienda.
shop.phoneNúmero de teléfono de la tienda.
subtotal_priceSuma de los precios de las líneas de artículo del pedido preliminar después de restar cualquier descuento por línea de artículo o del carrito. El subtotal no incluye impuestos (a menos que los precios incluyan impuestos) ni costos de envío.
discountsUna lista de descuentos.
discounts_amount

Importe total de los descuentos aplicados.

Ejemplo: +$5.00

discounts_savings

Importe total del ahorro generado por todos los descuentos.

Ejemplo: -$5.00

total_priceEl precio total del pedido (subtotal + costo de envío - descuento de envío + impuestos).
amount_due_now

El importe a pagar de la factura del pedido preliminar.

requires_shippingDevuelve true si hay al menos un artículo en el pedido preliminar que requiere envío. Devuelve false si ningún artículo del pedido preliminar requiere envío.
shipping_method.title

El nombre de la tarifa de envío.

Ejemplo: Envío estándar

shipping_method.priceEl precio del método de envío. Devuelve la misma información que shipping_price.
shipping_price

El precio del envío.

Puedes dar formato a este importe con los money filters de Liquid.

shipping_address

La dirección de envío.

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

shipping_address.first_nameEl nombre para la dirección de envío.
shipping_address.companyEl nombre de la empresa en la dirección de envío.
shipping_address.phoneEl número de teléfono en la dirección de envío.
line_itemsUna lista de todas las line items del pedido preliminar.
item_countLa suma de todas las cantidades de artículos del pedido preliminar.
noteLa nota adjunta al pedido preliminar. La nota se puede obtener del cliente y también editar en la pantalla de información del pedido preliminar en el panel de control de Shopify.
metafields

Cualquier metacampo del pedido preliminar. Usa la siguiente sintaxis:

metafields.NAMESPACE.KEY

location

La sucursal física del pedido. Hay varias location properties disponibles.

Puedes configurar las sucursales en la página Locations del panel de control de Shopify.

b2b?

Devuelve true si el pedido es B2B. Usa la propiedad con variables B2B para mostrar información relevante, como el nombre de la empresa, la sucursal de la empresa y la dirección en los correos electrónicos. Por ejemplo, en pedidos B2B, podrías agregar un encabezado a una plantilla con la siguiente información:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

La company a la que vendes en un pedido B2B.

company.name

El nombre de la empresa en un pedido B2B.

company.id

La identificación de la empresa en un pedido B2B.

company_location

La location de la empresa en un pedido B2B. Una empresa que te compra puede tener más de una sucursal.

company_location.name

El nombre de la sucursal de la empresa en un pedido B2B.

company_location.id

El número de identificación de la sucursal de la empresa en un pedido B2B.

company_location.shipping_address

La shipping address de la sucursal de la empresa en un pedido B2B.

company_location.billing_address

La billing address de la sucursal de la empresa en un pedido B2B.

payment_methods

Una lista de formas de pago guardadas disponibles para procesar el total del pedido preliminar.

payment_method.payment_instrument

El instrumento de pago, con información sobre la forma de pago guardada.

payment_method.payment_instrument.payment_type

El tipo de forma de pago guardada. Por ejemplo: "credit_card, apple_pay"

payment_method.payment_instrument.credit_card_brand

La marca de la tarjeta, cuando `payment_type` es "credit_card"

payment_method.payment_instrument.credit_card_company

La entidad emisora de la tarjeta, cuando `payment_type` es "credit_card"

payment_method.payment_instrument.credit_card_company

Los últimos 4 dígitos de la tarjeta, cuando `payment_type` es "credit_card"

Propiedades del cronograma de pagos

Descripciones de las propiedades de Liquid que puedes usar con el objeto de cronograma de pagos en las plantillas de notificación
PropiedadDescripción
payment_schedule.amount_due

El monto a pagar de un cronograma de pagos.

Puedes dar formato a montos con monedas usando el money filter de Liquid.

payment_schedule.due_at

La fecha de vencimiento del cronograma de pagos.

Puedes dar formato a las fechas usando el date filter de Liquid.

payment_schedule.due_in_days

El número de días hasta la fecha de vencimiento si el cronograma de pagos sigue pendiente (sin pagar).

payment_schedule.due_later?

Devuelve verdadero si el cronograma de pagos no se ha pagado y su fecha de vencimiento está en el futuro.

payment_schedule.number_of_days_overdue?

El número de días desde la fecha de vencimiento cuando un cronograma de pagos está vencido.

payment_schedule.overdue?

Devuelve verdadero si el cronograma de pagos no se ha pagado y ya pasó su fecha de vencimiento.

Propiedades del estado de pago

Descripciones de las propiedades de Liquid que puedes usar con el objeto de estado de pago en las plantillas de notificación
PropiedadDescripción
has_pending_payment

(booleano) Devuelve verdadero si el pedido tiene una transacción con un pago pendiente.

Más información sobre los pagos pendientes.

buyer_action_required

(booleano) Devuelve verdadero si un pedido tiene una transacción con un pago pendiente y se requiere una acción del comprador para desbloquear el pago. Cuando este valor es verdadero y la forma de pago admite instrucciones de pago, buyer_pending_payment_instructions proporciona detalles que el cliente puede usar para completar la compra sin conexión.

Más información sobre el transaction object de Liquid.

Propiedades del componente de paquete

Cada bundle_component en la lista line_item.bundle_components tiene las siguientes propiedades. (Solo pedidos preliminares)

Descripciones de las propiedades de Liquid que puedes usar con el objeto componente de paquete en las plantillas de notificación
PropiedadDescripción
bundle_component.image_urlLa URL de la imagen del componente de paquete.
bundle_component.product.titleEl título del producto del componente de paquete.
bundle_component.quantityCantidad del componente de paquete.
bundle_component.variant.title

Los nombres actuales de los valores de la opción de la variante del componente de paquete, separados por caracteres /.

Ejemplo: pequeño / rojo

Propiedades del componente

Cada component en la lista line_item.components tiene las siguientes propiedades. (Solo pago abandonado) `

Descripciones de las propiedades de Liquid que puedes usar con el objeto componente en las plantillas de notificación
PropiedadDescripción
component.image_urlLa URL de la imagen del componente.
component.product.titleEl título del producto del componente.
component.quantityCantidad del componente.
component.variant.title

Los nombres actuales de los valores de la opción de la variante del componente, separados por caracteres /.

Ejemplo: pequeño / rojo

Propiedades de la línea de artículo

Cada line en la lista line_items o subtotal_line_items tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto de línea de artículo en las plantillas de notificación
PropiedadDescripción
line.applied_discounts(POS and draft orders only)Lista de descuentos aplicados a este artículo (cada descuento tiene las propiedades title, code, amount, savings y type).
line.bundle_components(Draft orders only)Lista de líneas de artículo que son bundle components de este artículo. Solo devuelve una lista si esta línea de artículo es un producto de paquete.
line.bundle_parent?(Draft orders only)(booleano) Devuelve verdadero si la línea de artículo es un producto de paquete.
line.components(Abandoned checkout only)Lista de líneas de artículo que son components de este artículo.
line.parent?(Abandoned checkout only)(booleano) Devuelve verdadero si la línea de artículo tiene componentes.
line.custom(Draft orders only)(booleano) Devuelve verdadero si el artículo es una línea de artículo personalizada de un pedido preliminar.
line.delivery_agreementEl Delivery Agreement asociado a esta línea de artículo.
line.gramsPeso de un solo artículo.
line.groupsEl Line item group del artículo.
line.imageDevuelve la URL de la imagen asociada a esta línea de artículo. También puedes usar el img_url filter para obtener tamaños de imagen específicos, por ejemplo {{ line.image | img_url: 'small' }}
line.line_priceEl precio multiplicado por la cantidad de ese artículo.
line.original_line_priceEl precio total de la cantidad de artículos incluidos en la línea, antes de aplicar los descuentos.
line.final_line_priceEl precio total de todos los artículos de la línea, incluidos todos los importes de descuentos a nivel de línea.
line.pre_tax_priceEl precio antes de impuestos por artículo, multiplicado por la cantidad comprada.
line.priceEl precio de un solo artículo.
line.product.metafields

Cualquier metacampo a nivel de producto. Usa la siguiente sintaxis:

line.product.metafields.NAMESPACE.KEY

line.product.titleEl nombre actual del producto.
line.product.vendorEl proveedor del artículo.
line.propertiesDevuelve una matriz de información personalizada de un artículo. Las Line item properties se especifican en la página de producto, antes de agregar un producto al carrito.
line.quantityCantidad de ese artículo.
line.current_quantityLa cantidad actual del artículo después de las eliminaciones.
line.requires_shipping(boolean) Devuelve true si la variante del artículo tiene activada la opción Producto físico en la página de producto.
line.selling_plan_allocationDevuelve un objeto selling_plan_allocation, que describe cómo un plan de venta, como una subscription, afecta a la línea de artículo.
line.taxable(boolean) Devuelve true si la variante del artículo tiene marcada la casilla de verificación "Cobrar impuestos en este producto" en la página de producto.
line.title

El nombre del producto en el momento de la venta, seguido de un guion y del nombre de la variante en el momento de la venta. El nombre de la variante no se incluye cuando es "Título predeterminado".

En las notificaciones para clientes, el nombre del producto y el de la variante se traducen al idioma en el que se completó el pago, cuando ese idioma es distinto del idioma predeterminado de la tienda.
line.urlLa URL relativa de la variante de la línea de artículo. La URL relativa no incluye la URL raíz de la tienda (mystore.myshopify.com).
line.variant.barcodeEl código de barras asociado a la variante de producto.
line.variant.compare_at_priceEl compare-at price asociado a la variante de producto.
line.variant.imageLa imagen de la variante de producto. Solo devuelve una imagen si hay una imagen específica asignada a la variante en la línea de artículo.
line.variant.metafields

Metacampos a nivel de variante. Usa la siguiente sintaxis:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuEl SKU asociado a la variante de producto.
line.variant.title

Los nombres actuales de los valores de opción de la variante, separados por el carácter /.

Ejemplo: pequeño / rojo

line.refunded.quantity(within refund notifications)

La cantidad de un artículo a reembolsar. Puedes usar esta propiedad para agregar un identificador a los artículos reembolsados en un pedido.

Por ejemplo: {% if line.refunded_quantity > 0 %}Identificador de línea reembolsada{% endif %}

Detecta artículos de Shopify Collective en las plantillas de notificación

La etiqueta Shopify Collective se aplica a un pedido después de enviar el correo electrónico de confirmación de pedido, por lo que {% if tags contains 'Shopify Collective' %} nunca es true en una plantilla de confirmación de pedido. Para detectar artículos de Shopify Collective, revisa en su lugar las etiquetas a nivel de producto en cada línea de artículo:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Propiedades del grupo de líneas de artículo

Cada line_item_group de la lista de line_item_groups tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto de grupo de líneas de artículo en las plantillas de notificación
PropiedadDescripción
line_item_group.display_titleEl título del grupo de líneas de artículo.
line_item_group.componentsLista de line item components que pertenecen al grupo.
line_item_group.imageLa imagen del grupo de líneas de artículo.
line_item_group.product_idEl ID de producto del grupo de líneas de artículo.
line_item_group.variantEl objeto de variante del grupo de líneas de artículo.
line_item_group.variant_idEl ID de variante del grupo de líneas de artículo.

Propiedades de los reembolsos

Descripciones de las propiedades de Liquid que puedes usar con el objeto de reembolso en las plantillas de notificación
PropiedadDescripción
amountEl monto reembolsado.
refund_line_itemsLista de refund line items que se van a reembolsar.

Propiedades de Refund_line_item

Cada refund_line de la lista de refund_line_items tiene las siguientes propiedades:

Descripciones de las propiedades de Liquid que puedes usar con el objeto de líneas de artículo de reembolso en las plantillas de notificación
PropiedadDescripción
refund_line.line_itemEl line_item que se está reembolsando. Tiene acceso a todas las line_item's properties.
refund_line.quantityLa cantidad de la línea de artículo que se va a reembolsar.

Propiedades de preparación de pedidos

Descripciones de las propiedades de Liquid que puedes usar con el objeto de preparación de pedidos en las plantillas de notificación
PropiedadDescripción
service_nameEl nombre del servicio personalizado tal como se define en la página Configuración > Envío y entrega. (Solo para solicitudes de preparación de pedidos)
fulfillment.estimated_delivery_atUna fecha de entrega estimada basada en el número de seguimiento (si está disponible) proporcionado por uno de los siguientes transportistas: USPS, FedEx, UPS, Canada Post (solo Canadá). Esta propiedad solo está disponible cuando se usan carrier-calculated rates.
fulfillment.fulfillment_line_itemsLista de fulfillment line items que se van a preparar.
fulfillment.item_countLa suma de todas las cantidades de artículos. El número total de artículos que se están preparando.
fulfillment.requires_shipping(booleano) Devuelve verdadero si esta solicitud de preparación de pedido requiere envío.
fulfillment.tracking_companyLa empresa que realiza el seguimiento.
fulfillment.tracking_numbersLista de números de seguimiento.
fulfillment.tracking_urlsLista de URL de seguimiento.
items_to_fulfill(deprecated)Lista de line items que preparará este servicio de logística personalizado. (Solo para la solicitud de preparación de pedido)
items_to_fulfill_count(deprecated)El número total de artículos que se prepararán en esta solicitud. (Solo para la solicitud de preparación de pedido)

Propiedades de Fulfillment_line_item

Cada fulfillment_line de la lista de fulfillment_line_items tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto de líneas de artículo de preparación en las plantillas de notificación
PropiedadDescripción
fulfillment_line.line_itemEl line_item que se está preparando. Tiene acceso a todas las line_item's properties.
fulfillment_line.quantityLa cantidad de la línea de artículo que se está preparando.

Propiedades del paquete preparado

Un paquete preparado incluye los artículos marcados como listos para retiro.

Descripciones de las propiedades de Liquid que puedes usar con el objeto de paquete preparado en las plantillas de notificación
PropiedadDescripción
item_countLa suma de todas las cantidades de artículos en el paquete preparado.
prepared_package_line_itemsLista de prepared package line items.

Propiedades de Prepared_package_line_item

Cada prepared_package_line_item de la lista de prepared_package_line_items tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto de línea de artículo de paquete preparado en las plantillas de notificación
PropiedadDescripción
line_itemEl line_item asociado. Tiene acceso a todas las line_item's properties.
quantityLa cantidad de la línea de artículo que se marcó como lista para retiro.

Propiedades de entrega

Descripciones de las propiedades de Liquid que puedes usar con el objeto de entrega en las plantillas de notificación
PropiedadDescripción
delivery_agreementsLista de todos los Delivery Agreements del pedido.
delivery_instructionsInformación de entrega local para compartir con el cliente. Esta información se controla con el campo Delivery information en la local delivery settings.
consolidated_estimated_delivery_timeInformación sobre fechas de entrega del pedido para compartir con el cliente. Esta información se controla con el ajuste Processing time que configuras en la página Shipping and delivery. Cuando el pedido tiene varias formas de entrega, se muestra una lista de formas de entrega y fechas.
has_multiple_delivery_methods(booleano) Devuelve verdadero si el pedido tiene varias formas de entrega.

Propiedades de Delivery Agreement

Descripciones de las propiedades de Liquid que puedes usar con el objeto Delivery Agreement en las plantillas de notificación
PropiedadDescripción
delivery_agreement.delivery_method_typeEl tipo de forma de entrega.
delivery_agreement.delivery_method_nameEl tipo de forma de entrega traducido al idioma en el que el comprador completó el pago, cuando ese idioma es distinto del idioma predeterminado de la tienda.
delivery_agreement.line_item_groupsLista de todos los line item groups que contienen componentes de líneas de artículo agrupados en el Delivery Agreement.
delivery_agreement.line_itemsLista de todas las line items asociadas con este Delivery Agreement.

Propiedades de descuentos

Hay dos tipos de propiedades de descuento.

discount_applications describen por qué y cómo se aplicó un descuento a un artículo.

discount_allocations describen cómo un descuento determinado afecta a una línea de artículo y cómo reduce el precio. Usa esta propiedad a nivel de línea de artículo.

Puedes combinar estas propiedades para mostrar la información sobre descuentos a nivel de línea de artículo o de pedido.

Ejemplo

Este ejemplo verifica si se aplicó un descuento a la línea de artículo. Si el descuento no se aplicó a nivel de pedido (all), se muestran el nombre y el importe del descuento.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

El resultado podría ser similar a lo siguiente:

SPRING5 (-$5.00)

Propiedades de discount_allocation

Cada discount_allocation de la lista de discount_allocations tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto discount_allocation en las plantillas de notificación
PropiedadDescripción
discount_allocation.amountEl importe que ahorra el cliente en una línea de artículo. Debe incluirse en un bucle si quieres permitir varios códigos de descuento.
discount_allocation.discount_applicationLa discount application que asigna el importe a la línea de artículo.

Propiedades de discount_application

Cada discount_application de la lista de discount_applications tiene las siguientes propiedades.

Descripciones de las propiedades de Liquid que puedes usar con el objeto discount_application en las plantillas de notificación
PropiedadDescripción
discount_application.target_selection

Describe cómo un descuento selecciona las líneas de artículo del carrito que recibirán el descuento. Una de las siguientes:

  • all: el descuento se aplica a todas las líneas de artículo.
  • entitled: el descuento se aplica a un subconjunto específico de líneas de artículo, a menudo definido por una condición.
  • explicit: el descuento se aplica a una línea de artículo o una línea de envío seleccionada de forma específica.
discount_application.target_typeEl tipo de elemento al que aplica el descuento (line_item o shipping_line).
discount_application.title

El nombre del descuento visible para el cliente.

Ejemplos: Welcome10 o CBBWQQAKYBYY

discount_application.total_allocated_amountEl importe total que el descuento resta al precio del pedido.
discount_application.typeEl tipo de descuento. Una de las siguientes opciones: automatic, discount_code, manual o script.
discount_application.valueEl valor del descuento.
discount_application.value_typeEl tipo de valor del descuento. Una de las siguientes opciones: fixed_amount o percentage.

Propiedades de la suscripción

Los detalles de un contrato de suscripción, el ciclo de facturación actual y sus líneas de artículo, forma de entrega y forma de pago están disponibles en todas las plantillas de correo electrónico de suscripción.

Para editar las plantillas de notificación de suscripción, instala la Shopify Subscriptions app y luego busca la plantilla en Configuración > Notifications, en la sección Suscripciones.

Propiedades del ciclo de facturación del contrato de suscripción

Para acceder a las propiedades del contrato de suscripción y su ciclo de facturación, usa el objeto subscription_contract_billing_cycle.

Ejemplo

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Resultado:

This contract is currently paused.

Propiedades

Descripciones de las propiedades de Liquid que puedes usar con el objeto de ciclo de facturación del contrato de suscripción en las plantillas de notificación
PropiedadDescripción
status El estado del contrato.

Uno de: active, paused, cancelled, failed, expired, stale,
delivery_method La forma de entrega de la suscripción.

Si la suscripción corresponde a un service or digital product, se devuelve nil.
billing_frequencyCon qué frecuencia se factura la suscripción.
delivery_frequency Con qué frecuencia se entrega la suscripción.
origin_order El pedido original con el que se creó la suscripción.

Si la suscripción no se creó a partir de un pedido de Shopify, se devuelve nil.
customerEl customer de la suscripción.
line_items Las line items del ciclo de facturación de la suscripción.
product_namesUna lista con los nombres de los productos incluidos en el ciclo de facturación de la suscripción.
update_payment_method_urlLa URL que el cliente puede usar para actualizar la forma de pago de este contrato.
shipping_address La dirección de envío de la suscripción.

Si la suscripción corresponde a un service or digital product, se devuelve nil.
billing_addressLa dirección de facturación de la suscripción.
subtotal_priceEl precio subtotal de las líneas de artículo de la suscripción.
shipping_priceEl precio de envío de la suscripción.
total_taxEl total de impuestos de la suscripción.
total_priceEl precio total de la suscripción.
total_discountsEl total de descuentos de la suscripción.
customer_self_serve_urlLa URL de autoservicio que el cliente puede usar para administrar sus suscripciones.
billing_attempt_expected_dateLa fecha de facturación de este ciclo.
next_billing_dateLa siguiente fecha de facturación no omitida después de este ciclo.
last_attempted_billing_dateLa última fecha en que se intentó facturar este ciclo.
days_overdueEl número de días de retraso en la facturación de este ciclo.
payment_instrumentEl payment instrument asociado al contrato de suscripción. Este instrumento de pago se usa para facturar al cliente.

Propiedades de las líneas de artículo del contrato de suscripción

Las propiedades de cada línea de artículo incluida en el ciclo de facturación. Accede a las propiedades de la línea de artículo del contrato a través de la propiedad principal subscription_contract_billing_cycle.line_items.

Ejemplo

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
Descripciones de las propiedades de Liquid que puedes usar con el objeto de línea de artículo del contrato de suscripción en las plantillas de notificación
PropiedadDescripción
urlLa URL de la página de información del producto para la variante de producto de la línea de artículo.
requires_shippingIndica si la línea de artículo requiere envío físico.
unit_price_measurementLa unit price measurement de la línea de artículo.
selling_plan_allocationLa selling plan allocation de la línea de artículo.

Propiedades de la forma de entrega del contrato de suscripción

Las propiedades de la forma de entrega usada en este ciclo de facturación. Accede a las propiedades de la forma de entrega a través de la propiedad principal subscription_contract_billing_cycle.delivery_method.

Ejemplo

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
Descripciones de propiedades de Liquid que puedes usar con el objeto de la forma de entrega del contrato de suscripción en las plantillas de notificación
PropiedadDescripción
titleEl nombre de la opción de envío asociada a la forma de entrega.
type El tipo de forma de entrega.

Uno de shipping, local o pick-up.

Propiedades del instrumento de pago del contrato de suscripción

Información sobre el instrumento de pago del contrato de suscripción. Este instrumento de pago se usa para facturar al cliente. Accede a las propiedades del instrumento de pago a través de la propiedad principal subscription_contract_billing_cycle.payment_instrument.

Ejemplo

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}
Descripciones de propiedades de Liquid que puedes usar con el objeto del instrumento de pago del contrato de suscripción en las plantillas de notificación
PropiedadDescripción
payment_type El tipo de forma de pago representada por el instrumento de pago.

Usa payment filters para mostrar una URL de imagen o un SVG.
credit_card_brandLa marca de la tarjeta de crédito.
credit_card_companyEl nombre de la empresa emisora de la tarjeta de crédito.
credit_card_last_four_digitsLos últimos 4 dígitos de la tarjeta de crédito.

Propiedades de las notificaciones por correo electrónico

Descripciones de propiedades de Liquid que puedes usar con el objeto de notificaciones por correo electrónico en las plantillas de notificación
PropiedadDescripción
shop.email_logo_urlLa URL del logo especificado en la sección Customize email templates del panel de control.
shop.email_logo_widthEl ancho del logo (píxeles) especificado en la sección Customize email templates del panel de control.
shop.email_accent_colorEl código HEX del color de acento especificado en la sección Customize email templates del panel de control.

Propiedades del crédito en tienda

Las propiedades con información sobre una emisión de store credit.

Descripciones de propiedades de Liquid que puedes usar con el objeto de crédito en tienda emitido en las plantillas de notificación
PropiedadDescripción
issued_store_credit.amount

El monto del crédito en tienda emitido.

Puedes dar formato a este importe con los money filters de Liquid.

issued_store_credit.expires_at

La fecha y la hora en que vencerá el crédito en tienda emitido.

Puedes formatear este valor con los date filters de Liquid.

issued_store_credit.balance_after_transaction

El saldo de la cuenta de crédito en tienda después de que se emitió el crédito.

Puedes dar formato a este importe con los money filters de Liquid.

customerObjeto del cliente que contiene los atributos de la salida de customer.