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 tu tienda, puedesrealizar personalizaciones básicasa tus plantillas de notificación.
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 deexpertos de Shopify.
A continuación hay una lista de plantillas de notificaciones de Liquid que puedes personalizar desde el panel de control de Shopify:
- Pedido abandonado
- Contacto del cliente
- Invitación a la cuenta de cliente
- Bienvenida a la cuenta de cliente
- Renovación de contraseña de la cuenta de cliente
- Borrador de factura de pedido
- Solicitud de envío
- Se ha creado una tarjeta de regalo
- Pedido nuevo
- Nuevo pedido (móvil)
- Factura del pedido
- Pedido cancelado
- Confirmación del pedido
- Recibo de TPV y móvil
- Reembolso de pedido
- Confirmación de envío
- Actualización de envío
Todas las plantillas en el panel de control de Shopify tienen acceso a las propiedades de sus pedidos correspondientes.
Propiedades de pedidos
Varias propiedades de un pedido están disponibles directamente usando Liquid, en plantillas y en scripts adicionales.
Las propiedades de un pedido están disponibles en las siguientes plantillas:
- Confirmación del pedido
- Pedido nuevo
- Nuevo pedido (móvil)
- Factura del pedido
- Confirmación de envío
- Actualización de envío
- Scripts adicionales
- Solicitud de envío
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 |
El correo electrónico asociado al pedido. | |
name |
Normalmente, es un símbolo de numeral seguido del 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 |
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. |
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 |
Los impuestos totales de todos los artículos en el pedido. |
tax_lines |
Impuestos desglosados por tipo:
|
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 |
La tasa de impuestos en forma legible para personas. 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,pendiente autorizado pagado anulado reembolsado . |
requires_shipping |
(booleano) Devuelve verdadero si hay al menos un artículo en el pedido que requiere envío. |
shipping_method.title |
El nombre de la tarifa de envío. Ejemplo: envío estándar |
shipping_method.price |
El precio de envío incluyendo cualquier descuento de envío. Ejemplo: |
shipping_price |
El precio de envío. Ejemplo: |
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 ,parcial opreparado . |
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: |
referring_site |
Contiene la URL del referente que llevó al cliente a tu tienda. Ejemplo: |
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: |
landing_site_ref |
Revisa el sitio de llegada y extrae un parámetro de referencia. Los parámetros de referencia pueden ser: Si {% 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ía |
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:
|
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 pedido preliminar
Las propiedades de pedido preliminar están disponibles en la plantilla de correo electrónico deFactura de pedido preliminar, con el que se notifica a tus clientes sobre facturas pendientes.
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, Puede dar formato a fechas usando elfiltro de fechade Liquid. |
用户 |
El último empleado que modificó el pedido preliminar. |
用户.name |
El nombre del último empleado que modificó el pedido preliminar. |
用户.email |
El correo electrónico del último empleado que modificó el pedido preliminar. |
El correo electrónico asociado al pedido preliminar. | |
name |
Elnumber 整合del pedido preliminar precedido de联合国simbolo 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, 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 |
Los impuestos totales de todos los artículos en el pedido 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, unatasa de 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数量de la senior en la direccion 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 |
Devuelvetrue si hay al menos un artículo en el pedido preliminar que requiere envío. Devuelvefalse si 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 |
Nota: a diferencia de pedidos normales, la dirección de envío de un pedido preliminar puede estar incompleta. |
shipping_address.first_name |
El primer nombre para la dirección de envío. |
shipping_address.company |
El nombre de la empresa en la dirección de envío. |
shipping_address.phone |
El número de teléfono de la dirección de envío. |
line_items |
Una lista de todos 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:
|
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 la línea de artículo
Cadaline
en la里deline_items
osubtotal_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 propiedadestítulo ,código ,monto ,ahorro ytipo ). |
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 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 seguido de un guión seguido del nombre de la variante. El nombre de la variante no está incluido cuando es “Título Predeterminado”. |
line.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.line_item.variant.barcode |
Código de barras asociado a la variante del producto. |
line.variant.compare_at_price |
Elprecio de comparaciónasociado a la variante del 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 la variante del producto. |
line.variant.title |
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: |
Propiedades de reembolsos
Estas propiedades adicionales están disponibles en la plantilla de correo electrónico deReembolsos. Esta plantilla de correo electrónico se utiliza para notificar a tus clientes que se ha aplicado un reembolso (completo o parcial) a su pedido. Puedes usar cualquier variable disponible para la plantilla de notificación deCorreo electrónico de pedido, además de las siguientes variables:
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_line
en la里refund_line_items
tiene las siguientes propiedades:
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 proceso de envío
Estas propiedades adicionales están disponibles en las plantillas de correo electrónico deConfirmación de envío,Actualización de envíoySolicitud de proceso de envío.
LaConfirmación de envíoy laActualización de envíose utilizan para notificar a tus clientes que algunos o todos los artículos en su pedido se han enviado satisfactoriamente o se han actualizado con nueva información de envío.
La plantilla de correo electrónico desolicitud de preparación de pedidosse utiliza para cualquier servicio de logística personalizado definido en el panel de control de tu tienda. Para agregar un servicio de logística personalizado, ve aConfiguración>Envíoy desplázate hacia abajo hastaPreparación de pedidos/dropshipping.
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_line
en la里fulfillment_line_items
tiene las siguientes propiedades.
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
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_applications
describe por qué y cómo se hizo un descuento a un artículo.
discount_allocations
describe 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
), y el monto del descuento se mostrara el数量。
El resultado podría verse así:
Propiedades de discount_allocation
Cadadiscount_allocation
en la里discount_allocations
tiene las siguientes propiedades.
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_application
en la里discount_applications
tiene las siguientes propiedades.
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:
|
discount_application.target_type |
El tipo de artículo al que se aplica un descuento (line_item oshipping_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 ,manual oscript . |
discount_application.value |
El valor del descuento. |
discount_application.value_type |
El tipo de valor del descuento. Uno de los siguientes:fixed_amount opercentage . |
Propiedades de notificación por 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. |