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.
En esta página
- Propiedades del pedido
- Propiedades del pedido borrador
- Propiedades del cronograma de pagos
- Propiedades del estado del pago
- Propiedades del componente del paquete
- Propiedades del componente
- Propiedades del artículo de línea
- Propiedades del grupo de artículos de línea
- Propiedades de los reembolsos
- Propiedades del procesamiento del pedido
- Propiedades del paquete preparado
- Propiedades de la entrega
- Propiedades del descuento
- Propiedades de la suscripción
- Propiedades de la notificación por correo electrónico
- Propiedades del crédito de la tienda
Propiedades del pedido
Muchas propiedades de un pedido están disponibles directamente en Liquid y en las plantillas.
| Propiedad | Descripció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
|
email | El correo electrónico asociado al pedido. |
name |
Por lo general, es el símbolo # seguido de Ejemplo: #1004 |
order_name | Igual 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. |
destination | El destino al que se deben enviar los artículos. |
tags | Devuelve 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. |
transactions | Devuelve una lista de transacciones del pedido. |
tax_price | La 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.title | El nombre del impuesto. Por ejemplo, QST o IVA. |
tax_line.price | El importe del impuesto. |
tax_line.rate | La tasa de impuestos como decimal. Devuelve 0,175 si es 17,5 %. |
tax_line.rate_percentage | La tasa de impuestos en un formato legible. Devuelve 17,5 si la tasa es 0,175. |
customer | Objeto del cliente que contiene los atributos de la salida de customer. |
billing_address | La dirección de facturación. |
billing_address.first_name | 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 la tienda. |
shop.phone | Número de teléfono de la tienda. |
subtotal_price | Suma 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. |
discounts | Una 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_status | El 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_price |
El precio del envío. Ejemplo: |
shipping_address | La dirección de envío. |
shipping_address.first_name | El 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 todas las líneas de artículo del pedido. |
line_items_including_zero_quantity | Lista 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_count | La suma de las cantidades de todos los artículos. |
fulfillment_status | El estado actual de preparación del pedido. Uno de: unfulfilled, partial, fulfilled. |
note | La 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: |
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: |
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: |
landing_site_ref |
Analiza la página de destino y extrae un parámetro de referencia. Los parámetros de referencia pueden ser: Si
{% if landing_site_ref == 'my-tracking-token' %}
Mi acción...
{% endif %}
|
cancelled | (booleano) Devuelve verdadero si el pedido se canceló. |
cancelled_at | El momento en que se canceló el pedido. |
cancel_reason | Motivo 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 |
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
| Propiedad | Descripción |
|---|---|
id | Una identificación única del pedido preliminar para uso interno. |
invoice_url | Un 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, Puedes dar formato a las fechas usando el date filter de Liquid. |
user | La última persona del personal que modificó el pedido preliminar. |
user.name | El nombre de la última persona del personal que modificó el pedido preliminar. |
user.email | La dirección de correo electrónico de la última persona del personal que modificó el pedido preliminar. |
email | La dirección de correo electrónico asociada al pedido preliminar. |
name | El único number del pedido preliminar, con el prefijo del signo de número #. |
number | El 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, Puedes dar formato a las fechas usando el date filter de Liquid. |
tags | Devuelve 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_price | La 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.price | El importe del impuesto. |
tax_line.rate | La tasa de impuestos en formato decimal. Por ejemplo, una tasa de impuestos de 17,5% devuelve 0.175. |
tax_line.rate_percentage | La tasa de impuestos en formato de porcentaje. Por ejemplo, un rate de 0.175 devuelve 17.5. |
customer | Objeto del cliente que contiene los atributos de la salida de customer. |
billing_address | La billing address del pedido preliminar. |
billing_address.first_name | El 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 en la dirección de facturación. |
shop.name | El nombre de la tienda. |
shop.phone | Número de teléfono de la tienda. |
subtotal_price | Suma 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. |
discounts | Una 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_price | El 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_shipping | Devuelve 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.price | El 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 |
Nota: A diferencia de los pedidos normales, la dirección de envío de un pedido preliminar puede estar incompleta. |
shipping_address.first_name | El 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 en la dirección de envío. |
line_items | Una lista de todas las line items del pedido preliminar. |
item_count | La suma de todas las cantidades de artículos del pedido preliminar. |
note | La 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
| Propiedad | Descripció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
| Propiedad | Descripció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, 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)
| Propiedad | Descripción |
|---|---|
bundle_component.image_url | La URL de la imagen del componente de paquete. |
bundle_component.product.title | El título del producto del componente de paquete. |
bundle_component.quantity | Cantidad 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)
`
| Propiedad | Descripción |
|---|---|
component.image_url | La URL de la imagen del componente. |
component.product.title | El título del producto del componente. |
component.quantity | Cantidad 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.
| Propiedad | Descripció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_agreement | El Delivery Agreement asociado a esta línea de artículo. |
line.grams | Peso de un solo artículo. |
line.groups | El Line item group del artículo. |
line.image | Devuelve 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_price | El precio multiplicado por la cantidad de ese artículo. |
line.original_line_price | El precio total de la cantidad de artículos incluidos en la línea, antes de aplicar los descuentos. |
line.final_line_price | El 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_price | El precio antes de impuestos por artículo, multiplicado por la cantidad comprada. |
line.price | El 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.title | El nombre actual del producto. |
line.product.vendor | El proveedor del artículo. |
line.properties | Devuelve 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.quantity | Cantidad de ese artículo. |
line.current_quantity | La 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_allocation | Devuelve 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.url | La 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.barcode | El código de barras asociado a la variante de producto. |
line.variant.compare_at_price | El compare-at price asociado a la variante de producto. |
line.variant.image | La 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.sku | El 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: |
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.
| Propiedad | Descripción |
|---|---|
line_item_group.display_title | El título del grupo de líneas de artículo. |
line_item_group.components | Lista de line item components que pertenecen al grupo. |
line_item_group.image | La imagen del grupo de líneas de artículo. |
line_item_group.product_id | El ID de producto del grupo de líneas de artículo. |
line_item_group.variant | El objeto de variante del grupo de líneas de artículo. |
line_item_group.variant_id | El ID de variante del grupo de líneas de artículo. |
Propiedades de los reembolsos
| Propiedad | Descripción |
|---|---|
amount | El monto reembolsado. |
refund_line_items | Lista 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:
| Propiedad | Descripción |
|---|---|
refund_line.line_item | El line_item que se está reembolsando. Tiene acceso a todas las line_item's properties. |
refund_line.quantity | La cantidad de la línea de artículo que se va a reembolsar. |
Propiedades de preparación de pedidos
| Propiedad | Descripción |
|---|---|
service_name | El 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_at | Una 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_items | Lista de fulfillment line items que se van a preparar. |
fulfillment.item_count | La 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_company | La empresa que realiza el seguimiento. |
fulfillment.tracking_numbers | Lista de números de seguimiento. |
fulfillment.tracking_urls | Lista 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.
| Propiedad | Descripción |
|---|---|
fulfillment_line.line_item | El line_item que se está preparando. Tiene acceso a todas las line_item's properties. |
fulfillment_line.quantity | La 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.
| Propiedad | Descripción |
|---|---|
item_count | La suma de todas las cantidades de artículos en el paquete preparado. |
prepared_package_line_items | Lista 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.
| Propiedad | Descripción |
|---|---|
line_item | El line_item asociado. Tiene acceso a todas las line_item's properties. |
quantity | La cantidad de la línea de artículo que se marcó como lista para retiro. |
Propiedades de entrega
| Propiedad | Descripción |
|---|---|
delivery_agreements | Lista de todos los Delivery Agreements del pedido. |
delivery_instructions | Informació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_time | Informació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
| Propiedad | Descripción |
|---|---|
delivery_agreement.delivery_method_type | El tipo de forma de entrega. |
delivery_agreement.delivery_method_name | El 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_groups | Lista de todos los line item groups que contienen componentes de líneas de artículo agrupados en el Delivery Agreement. |
delivery_agreement.line_items | Lista 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.
| Propiedad | Descripción |
|---|---|
discount_allocation.amount | El 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_application | La 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.
| Propiedad | Descripció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:
|
discount_application.target_type | El 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_amount | El importe total que el descuento resta al precio del pedido. |
discount_application.type | El tipo de descuento. Una de las siguientes opciones: automatic, discount_code, manual o script. |
discount_application.value | El valor del descuento. |
discount_application.value_type | El 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
| Propiedad | Descripció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_frequency | Con 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.
|
customer | El customer de la suscripción. |
line_items | Las line items del ciclo de facturación de la suscripción. |
product_names | Una lista con los nombres de los productos incluidos en el ciclo de facturación de la suscripción. |
update_payment_method_url | La 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_address | La dirección de facturación de la suscripción. |
subtotal_price | El precio subtotal de las líneas de artículo de la suscripción. |
shipping_price | El precio de envío de la suscripción. |
total_tax | El total de impuestos de la suscripción. |
total_price | El precio total de la suscripción. |
total_discounts | El total de descuentos de la suscripción. |
customer_self_serve_url | La URL de autoservicio que el cliente puede usar para administrar sus suscripciones. |
billing_attempt_expected_date | La fecha de facturación de este ciclo. |
next_billing_date | La siguiente fecha de facturación no omitida después de este ciclo. |
last_attempted_billing_date | La última fecha en que se intentó facturar este ciclo. |
days_overdue | El número de días de retraso en la facturación de este ciclo. |
payment_instrument | El 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 %}| Propiedad | Descripción |
|---|---|
url | La URL de la página de información del producto para la variante de producto de la línea de artículo. |
requires_shipping | Indica si la línea de artículo requiere envío físico. |
unit_price_measurement | La unit price measurement de la línea de artículo. |
selling_plan_allocation | La 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 %}| Propiedad | Descripción |
|---|---|
title | El 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 }}| Propiedad | Descripció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_brand | La marca de la tarjeta de crédito. |
credit_card_company | El nombre de la empresa emisora de la tarjeta de crédito. |
credit_card_last_four_digits | Los últimos 4 dígitos de la tarjeta de crédito. |
Propiedades de las notificaciones por correo electrónico
| Propiedad | Descripción |
|---|---|
shop.email_logo_url | La URL del logo especificado en la sección Customize email templates del panel de control. |
shop.email_logo_width | El ancho del logo (píxeles) especificado en la sección Customize email templates del panel de control. |
shop.email_accent_color | El 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.
| Propiedad | Descripció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. |
customer | Objeto del cliente que contiene los atributos de la salida de customer. |