Referencia de variables de notificación

Las notificaciones enviadas desde la tienda se renderizan conLiquid. 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 nuestros temas de latienda de temas.

Para editar las notificaciones que se envían desde la tienda, puedesrealizar personalizaciones básicasen las plantillas de notificación. Para acceder a la lista completa de notificaciones que puedes personalizar, ve a la páginaNotificacionesdel panel de control de Shopify.

Para solicitar ayuda con cambios más avanzados o para realizar cambios en plantillas de notificación personalizadas, puedes consultar a la comunidad en nuestrosforoso puedes contratar a un experto de Shopify para que haga las personalizaciones. Más información sobre cómo contratar aexpertos de Shopify.

Propiedades de pedidos

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

Descripción de las propiedades del pedido
Propiedad Descripción
id

Una identificación única global del pedido para uso interno. Usa el siguiente ejemplo para generar un enlace al pedido en la sección de panel de control de tu tienda. Por ejemplo, en tu plantilla denuevo pedidopuedes agregar el siguiente código:

Ver pedido
email
El correo electrónico asociado al pedido.
name

Normalmente, es un símbolo de numeral seguido delorder_number.

Ejemplo: #1004

order_name
Igual que el nombre.
order_number

Número único del pedido, sin el prefijo del símbolo numeral, o cualquier prefijo o sufijo que agregue el propietario de la tienda en las preferencias de su tienda.

Por ejemplo: 1004

confirmation_number

Un identificador alfanumérico generado al azar para el pedido que podría mostrarse al cliente en lugar del nombre de pedido secuencial. 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 usando el filtro de fecha.

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

payment_terms

Las condiciones de pago especifican la fecha en la que se debe efectuar el pago de un pedido.

Más información sobre cómoagregar términos de pago a las facturas de pedidos.

Para más detalles, consulta la referencia de Liquid parapayment_terms.

destination
El destino al que deben enviarse los artículos.
tags
Devuelve una matriz de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta nuestradocumentación de referencia de Liquidpara más detalles.
transactions
Muestra una serie detransaccionesdel pedido.
tax_price
洛杉矶impuestos完全de Los危象en elpedido.
tax_lines

Impuestos desglosados por tipo:

{% 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 monto.
tax_line.rate
La tasa. Devolverá 0,175 si es 17,5%.
tax_line.rate_percentage
de impuestos en La tasa形式清晰对位的角色s. Devolverá 17,5 si la tasa es 0,175.
customer
Objeto de cliente que contiene los atributos de salida delcliente.
billing_address
Ladirecció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 o propinas.
discounts
Una lista dedescuentos.
discounts_amount

El monto del descuento que aplican todos los descuentos.

Ejemplo: +$5,00

discounts_savings

Monto ahorrado en 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 actual de pago. Uno de los siguientes: nulo,pendienteautorizadopagadoanuladoreembolsado.
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.

En las notificaciones para el comprador, el nombre de la tarifa de envío se traduce al idioma en que ese comprador realizó el pago, si el idioma es diferente al predeterminado de la tienda.

Ejemplo: envío estándar
shipping_method.price

El precio de envío incluyendo cualquier descuento de envío.

Ejemplo:{{shipping_method。price | money }}

shipping_price

El precio de envío.

Ejemplo:{{ shipping_price | money }}

shipping_address
Ladirecció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 losArtículosen 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. Puede ser uno de los siguientes:no preparado,parcialopreparado.
note
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.
attributes

Cualquieratributoque 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.

Silanding_sitees/products/great-product?ref=my-tracking-token, entonces ellanding_site_refesmy-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 %}
cancelled
(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. Uno de los siguientes:inventario,cliente,rechazado,fraude, uotro.
has_high_risks?
(deprecated)

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íashopify_payments, cash.

location (POS only)

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

order_status_url

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

fulfilled_line_items
(deprecated)
Lista deArtículosque se han enviado.
unfulfilled_line_items
(deprecated)
Lista deLíneas de artículoque no se han preparado en su totalidad.
b2b吗?

Devuelve un valor verdadero si el pedido es un pedido B2B. Usa la propiedad con variables B2B para mostrar la 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, puedes agregar un encabezado a una plantilla con la siguiente información:

{% if b2b? %} 

Customer: {{ customer.name }}

Company: {{ company.name }}

Location: {{ company_location.name }} {% endif%}

company

Laempresaa la que le 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

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

company_location.name

El nombre de la sucursal de una 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

Ladirección de envíode la sucursal de la empresa en un pedido B2B.

company_location.billing_address

Ladirección de facturaciónde la sucursal de la empresa en un pedido B2B.

customer_order_url

Lanueva página de detalles del pedidode un pedido para el que un cliente solicitó una devolución utilizando lasnuevas cuentas de clientes.

Propiedades de pedido preliminar

Descripción de las propiedades del pedido preliminar
Propiedad Descripción
id
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 elfiltro de fechade Liquid.

user
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.
email
El correo electrónico asociado al pedido preliminar.
name
Elnumberúnico del pedido preliminar, precedido de un símbolo numeral#.
number
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 elfiltro de fechade Liquid.

tags
Devuelve una matriz de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta nuestradocumentación de referencia de Liquidpara más detalles.
tax_price
洛杉矶impuestos完全de Los危象en elpedido preliminar.
tax_lines

Impuestos desglosados por tipo:

{% 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 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, unatasade 0,175 devolverá17,5.
customer
Objeto de cliente que contiene los atributos de salida delcliente.
billing_address
Ladirección de facturacióndel 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.
discounts
Una lista dedescuentos.
discounts_amount

Monto del descuento aplicado en todos los descuentos.

Ejemplo: +$5,00

discounts_savings

Monto ahorrado con todos los descuentos.

Ejemplo: -$5,00

total_price
Precio total del pedido (subtotal + costo de envío - descuento de envío + impuestos).
requires_shipping
Devuelvetruesi hay al menos un artículo en el pedido preliminar que requiere envío. Devuelvefalsesi no hay artículos en el pedido preliminar que requieran 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 enshipping_price.
shipping_price

El precio de envío.

Puedes dar formato a este monto usando losfiltros de dinero de Liquid.

shipping_address

Ladirección de envío.

Nota: diferencia de los pedidos正常拉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 losartículosen el pedido preliminar.
item_count
Una suma de todas las cantidades de artículos en el pedido preliminar.
note
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.
location

La ubicación física del pedido. Hay variaspropiedades de ubicacióndisponibles.

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

b2b吗?

Devuelve un valor verdadero si el pedido es un pedido B2B. Usa la propiedad con variables B2B para mostrar la 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, puedes agregar un encabezado a una plantilla con la siguiente información:

{% if b2b? %} 

Customer: {{ customer.name }}

Company: {{ company.name }}

Location: {{ company_location.name }} {% endif %}

company

Laempresaa la que le 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

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

company_location.name

El nombre de la sucursal de una 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

Ladirección de envíode la sucursal de la empresa en un pedido B2B.

company_location.billing_address

Ladirección de facturaciónde la sucursal de la empresa en un pedido B2B.

Propiedades de los cronogramas de pago

Descripción de las propiedades de los cronogramas de pago
Propiedad Descripción
payment_schedule.amount_due

El monto por abonar correspondiente a un cronograma de pago.

Para formatear montos con monedas, usa elfiltro de dinerode Liquid.

payment_schedule.due_at

La fecha de vencimiento del cronograma de pago.

Puede dar formato a fechas usando elfiltro de fechade Liquid.

payment_schedule.due_in_days

El número de días hasta la fecha de vencimiento si el cronograma de pago aún está pendiente (sin pagar).

payment_schedule.due_later?

Devuelve el valor true si el cronograma de pago no se completó y vence en el futuro.

payment_schedule.number_of_days_overdue?

El número de días desde la fecha de vencimiento si el cronograma de pago ya venció.

payment_schedule.overdue?

Devuelve el valor true si no se completó el cronograma de pago y su fecha de vencimiento ya pasó.

Propiedades del estado de pago

Descripción de las 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.

Obtén más información sobre lospagos 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 devuelve verdadero y la forma de pago admite instrucciones de pago,buyer_pending_payment_instructionsproporciona información que el comprador puede usar para completar su compra offline.

Obtén más información sobre elobjeto de transacciónde Liquid.

propiedades de la línea de artículo

Cadalineen la lista deline_itemsosubtotal_line_itemstiene las siguientes propiedades.

Descripción de las propiedades de la línea de artículo
Propiedad Descripción
line.applied_discounts
(POS and draft orders only)
Lista de descuentos aplicados a este artículo (cada descuento tiene las propiedadestítulo,código,monto,ahorroytipo).
line.custom
(Draft orders only)
(booleano) Devuelve verdadero si el artículo es una línea de artículo personalizada 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 artículo. También puedes usar elfiltro img_urlpara 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.original_line_price
El precio combinado 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 en la línea de artículo, incluidos todos los montos de descuento de línea.
line.price
El precio de un artículo.
line.product.metafields

Los metacampos de nivel de producto. Usa la siguiente sintaxis:

línea.producto.metacampos.ESPACIO DE NOMBRES.CLAVE

line.product.title
El nombre actual del producto.
line.product.vendor
El proveedor del artículo.
line.properties
Devuelve una variedad de informaciones personalizadas de un artículo. El cliente especifica laspropiedades de línea de artículoen la página de 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 casillaEste es un producto físicoen la página del producto.
line.selling_plan_allocation
Muestra un objetoselling_plan_allocation, que describe cómo un plan de venta, p. ej. unasuscripción, afecta la línea de artículo.
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 en el momento de la venta, seguido de un guión y el nombre de la variante en el momento de la venta. El nombre de la variante no está incluido cuando es un "Nombre predeterminado".

En las notificaciones para el comprador, el nombre del producto y el nombre de la variante se traducen al idioma en que ese comprador realizó el pago, si el idioma es diferente al 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 tu tienda (mitienda.myshopify.com).
line.variant.barcode
Código de barras asociado a la variante del producto.
line.variant.compare_at_price
Elprecio de comparaciónasociado a la variante de 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.variant.metafields

Los metacampos de nivel de variante. Usa la siguiente sintaxis:

línea.variante.metacampos.ESPACIO DE NOMBRES.CLAVE

line.variant.sku
El SKU asociado a la variante del producto.
line.variant.title

Los nombres actuales de los valores de las opciones de la variante, acompañados por/caracteres.

Ejemplo: pequeño/rojo

line.refunded.quantity
(within refund notifications)

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

For example:{% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}

Propiedades de reembolsos

Descripción de las propiedades de los reembolsos
Propiedad Descripción
amount
El monto de dinero reembolsado.
refund_line_items
Una lista delíneas de artículo de reembolsoque deben reembolsarse.

Refund_line_item properties

Cadarefund_lineen la listarefund_line_itemstiene las siguientes propiedades:

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

Propiedades de la preparación de pedidos

Descripción de las propiedades de la preparación y envío de pedidos
Propiedad Descripción
service_name
El nombre del servicio personalizado tal como se define en la páginaConfiguración>Envío y entrega.(Solo con solicitud 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 una de las siguientes empresas de transporte: USPS, FedEx, UPS, Canada Post (solo en Canadá). Esta propiedad solo está disponible cuando se utilizan lastarifas calculadas por la empresa de transporte.
fulfillment.fulfillment_line_items
Una lista delíneas de artículo de preparación de pedidosque se deben preparar.
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 seguimiento.
items_to_fulfill
(deprecated)
Una lista delíneas de artículoque debe preparar este servicio de logística personalizado en particular.(Solo con solicitud de preparación de pedidos)
items_to_fulfill_count
(deprecated)
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

Cadafulfillment_lineen la listafulfillment_line_itemstiene las siguientes propiedades.

Descripción de las propiedades de la línea de artículo de preparación de pedidos
Propiedad Descripción
fulfillment_line.line_item
El line_item a ser preparado. Tiene acceso a todas laspropiedades del line_item.
fulfillment_line.quantity
La cantidad del artículo que se preparará.

Propiedades de entrega

Descripción de las propiedades de entrega
Propiedad Descripción
delivery_instructions
Información de entrega local para compartir con el cliente. Esta información está controlada por el campoInformación de entregaen laconfiguración de entrega local.
consolidated_estimated_delivery_time
Información sobre fechas de entrega de pedidos para compartir con el cliente. Esta información se controla mediante la configuración deTiempo de procesamientoestablecida en la páginaEnvío y entrega.

Propiedades de descuento

Existen dos tipos de propiedades de descuento.

discount_applicationsdescribe por qué y cómo se hizo un descuento a un artículo.

discount_allocationsdescribe cómo un descuento en particular afecta una línea de artículo y cómo rebaja el precio. Debes usar esta propiedad a nivel de línea de artículo.

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

Ejemplo

Este ejemplo comprueba si se ha aplicado un descuento a la línea de artículo. Si el descuento no se aplicó a nivel de pedido (all), se mostrará el nombre y el monto del descuento.

{%ifline.discount_allocations%}{%fordiscount_allocationinline.discount_allocations%}{%ifdiscount_allocation.discount_application.target_selection!='all'%}{{discount_allocation.discount_application.title|upcase}}(-{{discount_allocation.amount|money}}){%endif%}{%endfor%}{%endif%}

El resultado podría verse así:

SPRING5 (-$5.00)

Propiedades de discount_allocation

Cadadiscount_allocationen la listadiscount_allocationstiene las siguientes propiedades.

Descripción de las propiedades discount_allocation
Propiedad Descripción
discount_allocation.amount
El monto de dinero que ahorró el cliente en una línea de artículo. Debe ingresarse en un bucle si quieres permitir que se apliquen varios códigos de descuento.
discount_allocation.discount_application
La propiedaddiscount_applicationque asigna el monto a la línea de artículo.

Propiedades discount_application

Cadadiscount_applicationen la listadiscount_applicationstiene las siguientes propiedades.

Descripción de las propiedades discount_application
Propiedad Descripción
discount_application.target_selection

Describe cómo un descuento selecciona líneas de artículo en el carrito para aplicar descuentos. Uno de los siguientes:

  • all: El descuento se aplica a todas las líneas de artículo.
  • entitled: El descuento se aplica a un subconjunto determinado de líneas de artículo, a menudo definidos por una condición.
  • explicit: El descuento se aplica a una línea de artículo o línea de envío seleccionada específicamente.
discount_application.target_type
El tipo de artículo al que se aplica un descuento (line_itemoshipping_line).
discount_application.title

El nombre del descuento que ve el cliente.

Ejemplos: Welcome10 o CBBWQQAKYBYY

discount_application.total_allocated_amount
El monto total en el que se rebaja el precio de un pedido con el descuento.
discount_application.type
El tipo de descuento. Uno de los siguientes:automatic,discount_code,manualoscript.
discount_application.value
埃尔瓦尔or del descuento.
discount_application.value_type
El tipo de valor del descuento. Uno de los siguientes:fixed_amountopercentage.

Propiedades de notificación por correo electrónico

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

¿Estás listo/a para comenzar a vender con Shopify?

Prueba gratis