El objeto order y las variables más comunes

Cada documento se genera a partir de un pedido (o, en las plantillas agrupadas, de los pedidos seleccionados). En Liquid, los campos del pedido están disponibles directamente, como {{ name }}, y también dentro de order, como {{ order.name }}. Las dos formas funcionan igual. Las variables siguen las de Order Printer de Shopify, así que la mayoría de las plantillas de Order Printer funcionan en Foliant tal cual. La pestaña Variables Liquid del editor de código las muestra todas, con búsqueda. Este artículo trata las que más vas a usar. Los importes están en céntimos; consulta Importes y moneda en las plantillas.

El pedido

Variable	Qué imprime
`{{ order_name }}` o `{{ name }}`	El nombre del pedido, con # (`#1042`)
`{{ order_number }}`	El número de pedido (`1042`)
`{{ id }}`	El ID del pedido
`{{ po_number }}`	El número de orden de compra
`{{ date }}` o `{{ created_at }}`	Cuándo se hizo el pedido. Dale formato con el filtro `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Otras fechas del pedido
`{{ completed_at }}`	Cuándo se completó un pedido preliminar
`{{ financial_status }}`	El estado del pago, como `paid`, `pending` o `partially_refunded`
`{{ fulfillment_status }}`	El estado de preparación, como `unfulfilled` o `fulfilled`
`{{ note }}`	La nota del pedido
`{{ tags }}`	Las etiquetas del pedido (una lista: recórrela con `{% for tag in tags %}`)
`{{ email }}`	El correo electrónico del pedido
`{{ customer_locale }}`	El idioma en el que compró el cliente
`{{ order_status_url }}`	El enlace a la página de estado del pedido (pedidos online)
`{{ total_items }}` o `{{ item_count }}`	Cuántos artículos hay
`{{ total_weight }}`	El peso total; `{{ total_weight_in_grams \| weight_with_unit }}` añade la unidad
`{{ order_currency }}` o `{{ currency }}`	El código de moneda del pedido
`{% if pickup_in_store? %}…{% endif %}`	Si el pedido se recoge en tienda
`{{ location.name }}`	La ubicación del POS (pedidos de POS), con `address1`, `city`, `zip`, `country`, `phone`…

Totales

Imprime los totales con un filtro de importe, por ejemplo {{ total_price | money }}.

Variable	Qué es
`subtotal_price`	El subtotal
`shipping_price`	El envío
`total_discounts`	Todos los descuentos
`order_level_discounts`	Los descuentos de todo el pedido (no incluidos en los precios de las líneas)
`total_tax`	Los impuestos
`total_line_items_tax`, `total_shipping_tax`	Los impuestos de los artículos y del envío
`total_duties`	Los aranceles
`total_price`	El total del pedido
`total_paid`	Lo que se pagó
`total_refunds`	Lo que se reembolsó
`total_gift_cards`	Lo pagado con tarjetas de regalo

También están disponibles current_subtotal_price, current_total_discounts, current_total_tax y current_total_price.

Cliente y direcciones

Variable	Qué imprime
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	El nombre del cliente
`{{ customer.email }}`, `{{ customer.phone }}`	Los datos de contacto
`{{ customer.note }}`	La nota del cliente
`{{ customer.tags }}`	Las etiquetas del cliente
`{{ customer.total_spent \| money }}`	Lo que ha gastado el cliente
`{% if customer.tax_exempt %}`	Si el cliente está exento de impuestos
`{{ shipping_address \| format_address }}`	La dirección de envío, con saltos de línea
`{{ billing_address \| format_address }}`	La dirección de facturación

Cada dirección (shipping_address, billing_address y customer.default_address) tiene name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone y city_province_zip. {% if shipping_address.member_of_eu %} comprueba si el país está en la UE.

Tu tienda

Variable	Qué imprime
`{{ shop.name }}` o `{{ shop_name }}`	El nombre de tu tienda
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Los datos de contacto
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Tu dirección, tal como está configurada en Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Tu logotipo y tu color de acento de Configuración › Marca
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Tu número de IVA y tu EORI de Configuración › Impuestos y legal
`{{ seller.legal_lines \| join: ' · ' }}`	Tus datos legales, uno por línea, en el idioma del documento

Envío, pagos y preparados

Variable	Qué imprime
`{{ shipping_method.title }}`	El método de envío
`{% for shipping_line in shipping_lines %}`	Cada línea de envío: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Cómo se pagó el pedido
`{% for transaction in transactions %}`	Cada transacción: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Cada impuesto: `title`, `rate`, `price`
`{% for discount in discounts %}`	Cada descuento: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Cada preparado: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	El preparado más reciente
`{% for refund in refunds %}`	Cada reembolso: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	El reembolso más reciente (notas de crédito)
`{{ payment_terms.due_in_days }}`	Las condiciones de pago (B2B y pedidos preliminares), con `payment_schedules` y `current_payment_schedule.due_at`

Ejemplo

<h1>{{ 'titles.invoice' | t }} {{ order_name }}</h1>
<p>{{ created_at | date: '%d %B %Y' }}</p>
<p>{{ shipping_address | format_address }}</p>
<p>{{ 'total' | t }}: {{ total_price | money }}</p>
{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}

Conviene saber

Un valor vacío no imprime nada. Usa {% if … != blank %} para omitir una etiqueta cuando no hay valor.
Las plantillas para todos los pedidos seleccionados usan orders (recórrelos con {% for order in orders %}), batch y pick_list en lugar de un solo pedido. Consulta la sección Plantillas agrupadas de la pestaña Variables Liquid.
Para las facturas con IVA, consulta la sección IVA de la referencia: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} y {% include 'legal_notes' %}. Consulta Impuestos y legal.

Bienvenida

Primeros pasos

Impresión

Plantillas

Editor de plantillas

Diseños

Envío de PDF

Plantillas de correo electrónico

Cuentas de cliente

Exportaciones

Facturas y numeración

Impuestos y aspectos legales

Integraciones

Facturación y planes

Configuración

Solución de problemas

Legal