Referencia de variables de notificación
Las notificaciones enviadas desde la tienda se renderizan con Liquid. Liquid es un lenguaje de programación simple y fácil de usar de Shopify. Es el mismo lenguaje de programación en el que se basan nuestros temas de la tienda de temas.
Para editar las notificaciones que se envían desde la tienda, puedes realizar personalizaciones básicas en las plantillas de notificación. Para acceder a la lista completa de notificaciones que puedes personalizar, ve a la página Notificaciones del 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 nuestros foros o también puedes contratar a un Shopify Partner para que haga las personalizaciones. Obtén más información sobre cómo contratar a un Shopify Partner.
En esta página
- Propiedades de pedido
- Propiedades de pedido preliminar
- Propiedades de los cronogramas de pago
- Propiedades del estado de pago
- Propiedades de línea de artículo
- Propiedades de reembolsos
- Propiedades de la preparación de pedidos
- Propiedades de paquetes preparados
- Propiedades de entrega
- Propiedades de descuento
- Propiedades de la suscripción
- Propiedades de notificación por correo electrónico
Propiedades de pedido
Varias propiedades de un pedido están disponibles directamente usando Liquid, en plantillas y en scripts adicionales.
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 de nuevo pedido puedes agregar el siguiente código: <a href="{{ shop.url }}/admin/orders/{{ id }}">Ver pedido</a> |
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 |
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ómo agregar términos de pago a las facturas de pedidos. Para más detalles, consulta la referencia de Liquid para payment_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 nuestra documentación de referencia de Liquid para más detalles. |
transactions | Muestra una serie de transacciones del 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 del cliente. |
billing_address | La dirección de facturación. |
billing_address.first_name | Primer nombre del cliente. |
billing_address.last_name | Apellido del cliente. |
billing_address.company | Nombre de la empresa para la facturación. |
billing_address.phone | Número de teléfono de la dirección de facturación. |
shop.name | Nombre de tu tienda. |
shop.phone | El número de teléfono de tu tienda. |
subtotal_price | Suma de los precios de los artículos individuales del pedido después de aplicar cualquier descuento en un artículo o en el carrito. El subtotal no incluye impuestos (a menos que los impuestos estén incluidos en los precios) ni costos de envío o propinas. |
discounts | Una lista de descuentos. |
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. 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_price |
El precio de envío. Ejemplo: |
shipping_address | La dirección de envío. |
shipping_address.first_name | El primer nombre para la dirección de envío. |
shipping_address.company | Nombre de la empresa para la dirección de envío. |
shipping_address.phone | Número de teléfono de la dirección de envío. |
line_items | Lista de todos los Artículos en el pedido. |
item_count | Una suma de todas las cantidades de los artículos. |
fulfillment_status | El estado actual de la preparación del pedido. Puede ser uno de los siguientes: no preparado , parcial o preparado . |
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 |
Cualquier atributo que 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 , u otro . |
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 ubicación disponibles, disponibles aquí. Puedes configurar sucursales en el área sucursales del panel de control. |
order_status_url |
Devuelve el enlace a la página de estado de este pedido. |
fulfilled_line_items(deprecated) | Lista de Artículos que se han enviado. |
unfulfilled_line_items(deprecated) | Lista de Líneas de artículo que 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 |
La empresa a 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 |
La sucursal de 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 |
La dirección de envío de la sucursal de la empresa en un pedido B2B. |
company_location.billing_address |
La dirección de facturación de la sucursal de la empresa en un pedido B2B. |
customer_order_url |
La nueva página de detalles del pedido de un pedido para el que un cliente solicitó una devolución utilizando las nuevas cuentas de clientes. |
Propiedades de 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, Puede dar formato a fechas usando el filtro de fecha de 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. |
El correo electrónico asociado al pedido preliminar. | |
name | El number ú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, Puede dar formato a fechas usando el filtro de fecha de Liquid. |
tags | Devuelve una matriz de todas las etiquetas del pedido. Las etiquetas se devuelven en orden alfabético. Consulta nuestra documentación de referencia de Liquid para más detalles. |
tax_price | Los impuestos totales de todos los artículos en el pedido preliminar. |
tax_lines |
Impuestos desglosados por 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, una tasa de 0,175 devolverá 17,5 . |
customer | Objeto de cliente que contiene los atributos de salida del cliente. |
billing_address | La dirección de facturación del pedido preliminar. |
billing_address.first_name | El primer nombre del cliente. |
billing_address.last_name | El apellido del cliente. |
billing_address.company | El nombre de la empresa en la dirección de facturación. |
billing_address.phone | El número de teléfono de la dirección de facturación. |
shop.name | El nombre de tu tienda. |
shop.phone | El número de teléfono de tu tienda. |
subtotal_price | Suma de los precios de los artículos individuales del pedido después de aplicar cualquier descuento en un artículo o en el carrito. El subtotal no incluye impuestos (a menos que los impuestos estén incluidos en los precios) ni costos de envío. |
discounts | Una lista de descuentos. |
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). |
amount_due_now | El monto requerido en 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 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 en shipping_price . |
shipping_price |
El precio de envío. Puedes dar formato a este monto usando los filtros de dinero de Liquid. |
shipping_address |
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 primer nombre para la dirección de envío. |
shipping_address.company | El nombre de la empresa en la dirección de envío. |
shipping_address.phone | El número de teléfono de la dirección de envío. |
line_items | Una lista de todos los artículos en el pedido preliminar. |
item_count | Una suma de todas las cantidades de artículos en el pedido preliminar. |
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 varias propiedades de ubicación disponibles. Puedes configurar áreas enSucursales de 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 | La empresa a 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 | La sucursal de 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 | La dirección de envío de la sucursal de la empresa en un pedido B2B. |
company_location.billing_address | La dirección de facturación de la sucursal de la empresa en un pedido B2B. |
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 el filtro de dinero de Liquid. |
payment_schedule.due_at |
La fecha de vencimiento del cronograma de pago. Puede dar formato a fechas usando el filtro de fecha de 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
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 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 devuelve verdadero y la forma de pago admite instrucciones de pago, Obtén más información sobre el objeto de transacción de Liquid. |
Propiedades de línea de artículo
Cada line
en la lista de 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 título , código , monto , ahorro y tipo ). |
line.bundle_components(Draft orders only) | Lista de líneas de artículo que son componentes del paquete 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.custom(Draft orders only) | (booleano) Devuelve verdadero si el artículo es una línea de artículo personalizada para un pedido preliminar. |
line.delivery_agreement | El acuerdo de entrega asociado a esta línea de artículo. |
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 el filtro img_url para obtener tamaños de imagen específicos, por ejemplo {{ line.image | img_url: 'small' }}
|
line.line_price | El precio multiplicado por la cantidad de artículos. |
line.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 las propiedades de línea de artículo en la página de producto, antes de agregarlo al carrito. |
line.quantity | La cantidad de dicho artículo. |
line.current_quantity | La cantidad actual del artículo después de las eliminaciones. |
line.requires_shipping | (booleano) Devuelve verdadero si la variante del artículo tiene marcada la casilla Este es un producto físico en la página del producto. |
line.selling_plan_allocation | Muestra un objeto selling_plan_allocation , que describe cómo un plan de venta, p. ej. una suscripció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 | El precio de comparación asociado 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 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
Propiedad | Descripción |
---|---|
amount | El monto de dinero reembolsado. |
refund_line_items | Una lista de líneas de artículo de reembolso que deben reembolsarse. |
Propiedades de refund_line_item
Cada refund_line
en la lista 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 las propiedades de line_item. |
refund_line.quantity | La cantidad del artículo que se reembolsará. |
Propiedades de la 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 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 las tarifas calculadas por la empresa de transporte. |
fulfillment.fulfillment_line_items | Una lista de líneas de artículo de preparación de pedidos que 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 de líneas de artículo que 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) |
Propiedades de fulfillment_line_item
Cada fulfillment_line
en la lista fulfillment_line_items
tiene las siguientes propiedades.
Propiedad | Descripción |
---|---|
fulfillment_line.line_item | El line_item a ser preparado. Tiene acceso a todas las propiedades del line_item. |
fulfillment_line.quantity | La cantidad del artículo que se preparará. |
Propiedades de paquetes preparados
Un paquete preparado incluye los artículos marcados como listos para retiro.
Propiedad | Descripción |
---|---|
item_count | La suma de todos los artículos en el paquete preparado. |
prepared_package_line_items | La lista de líneas de artículos de paquetes preparados. |
Propiedades de Prepared_package_line_item
Cada prepared_package_line_item
en la lista prepared_package_line_items
tiene las siguientes propiedades.
Propiedad | Descripción |
---|---|
line_item | Los datos asociados de line_item. Tiene acceso a todas las propiedades de line_item. |
quantity | La cantidad líneas de artículos que se han marcado como listos para retiro. |
Propiedades de entrega
Propiedad | Descripción |
---|---|
delivery_agreements | Lista de todos los acuerdos de entrega del pedido. |
delivery_instructions | Información de entrega local para compartir con el cliente. Esta información está controlada por el campo Información de entrega en la configuración de entrega local. |
consolidated_estimated_delivery_time | Información sobre las fechas de entrega de los pedidos para compartir con el cliente. Esta información está controlada por la configuración de Tiempo de procesamiento que configuraste en tu página de Envío y entrega. Cuando el pedido tiene varias formas de entrega, se muestra una lista de formas y fechas de entrega. |
has_multiple_delivery_methods | (booleano) Muestra verdadero si el pedido tiene varias formas de entrega. |
Propiedades del acuerdo de entrega
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 formaliza el pago, cuando el idioma es diferente del predeterminado de la tienda. |
delivery_agreement.line_items | Lista de todas las líneas de artículo asociadas a este acuerdo de 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
), se mostrará el nombre y el monto del descuento.
El resultado podría verse así:
Propiedades de discount_allocation
Cada discount_allocation
en la lista 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 propiedad discount_application que asigna el monto a la línea de artículo. |
Propiedades de discount_application
Cada discount_application
en la lista 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 o shipping_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 o script . |
discount_application.value | El valor del descuento. |
discount_application.value_type | El tipo de valor del descuento. Uno de los siguientes: fixed_amount o percentage . |
Propiedades de la suscripción
Los detalles de un contrato de suscripción, del ciclo de facturación en curso y de sus líneas de artículo, forma de entrega y forma de pago están disponibles para todas las plantillas de correo electrónico de suscripción.
Para editar las plantillas de notificación de suscripción, instala la aplicación Shopify Subscriptions y luego busca la plantilla en Configuración > Notificaciones 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 a su ciclo de facturación, usa el objeto subscription_contract_billing_cycle
.
Ejemplo
Resultado:
Propiedades
Propiedad | Descripción |
---|---|
status |
El estado del contrato. Uno de los siguientes: activo , pausado , cancelado , fallido , vencido u obsoleto .
|
delivery_method |
La forma de entrega de la suscripción. Si la suscripción es para un servicio o producto digital, nuloes lo que se muestra. |
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 que creó la suscripción. Si la suscripción no se creó a partir de un pedido de Shopify, se muestra nulo .
|
customer | El cliente de la suscripción. |
line_items | Las líneas de artículo en el ciclo de facturación de la suscripción. |
product_names | Una lista de 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 modificar la forma de pago de este contrato. |
shipping_address |
La dirección de envío de la suscripción. Si la suscripción es para un servicio o producto digital, se muestra nulo .
|
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 impuesto total de la suscripción. |
total_price | El precio total de la suscripción. |
total_discounts | Los descuentos totales de la suscripción. |
customer_self_serve_url | La URL de autoservicio que el cliente puede usar para gestionar sus suscripciones. |
billing_attempt_expected_date | La fecha de facturación de este ciclo. |
next_billing_date | La próxima fecha de facturación no omitida después de este ciclo de facturación. |
last_attempted_billing_date | La última fecha en que se intentó llevar a cabo la facturación en este ciclo. |
days_overdue | El número de días que la facturación lleva vencida en este ciclo. |
payment_instrument | El instrumento de pago asociado con el contrato de suscripción. Este instrumento de pago se utiliza para facturar al cliente. |
Propiedades de la línea 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
Propiedad | Descripción |
---|---|
url | La URL que dirige a la página de detalles del producto correspondiente a la variante de producto de la línea de artículo. |
requires_shipping | Si la línea de artículo requiere envío físico. |
unit_price_measurement | La medida del precio unitario de la línea de artículo. |
selling_plan_allocation | La asignación del plan de ventas 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 que se está utilizando 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
Propiedad | Descripción |
---|---|
title | El título de la opción de envío asociada con la forma de entrega. |
type |
El tipo de forma de entrega. Uno de los siguientes: envío , local o retiro .
|
Propiedades del instrumento de pago del contrato de suscripción
Detalles sobre el instrumento de pago del contrato de suscripción. Este instrumento de pago se utiliza 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
Propiedad | Descripción |
---|---|
payment_type |
El tipo de forma de pago representado por el instrumento de pago. Usa filtros de pago para generar una URL o un SVG de imagen. |
credit_card_brand | La marca de la tarjeta de crédito. |
credit_card_company | El nombre de la empresa de la tarjeta de crédito. |
credit_card_last_four_digits | Los últimos cuatro dígitos de la tarjeta de crédito. |
Propiedades de notificación por correo electrónico
Propiedad | Descripción |
---|---|
shop.email_logo_url | El url del logo especificado en la sección Personalizar plantillas de correo electrónico del panel de control. |
shop.email_logo_width | El ancho del logo (píxeles) especificado en la sección Personalizar plantillas de correo electrónico del panel de control. |
shop.email_accent_color | El código HEX del tono de color especificado en la sección Personalizar plantillas de correo electrónico del panel de control. |