> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# El objeto order y las variables más comunes

> Las variables Liquid que usan las plantillas para el pedido, el cliente, las direcciones, la tienda, el envío, los pagos, los reembolsos y los preparados.

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](https://foliant-help.iforiti.com/es/template-editor/liquid-money-and-currency.md).

## 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

```liquid theme={null}
<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](https://foliant-help.iforiti.com/es/tax-and-legal.md).

## Artículos relacionados

* [Artículos de línea en las plantillas](https://foliant-help.iforiti.com/es/template-editor/liquid-line-items.md)
* [Importes y moneda en las plantillas](https://foliant-help.iforiti.com/es/template-editor/liquid-money-and-currency.md)
* [Filtros de Liquid](https://foliant-help.iforiti.com/es/template-editor/liquid-filters.md)
* [Editar el código de una plantilla](https://foliant-help.iforiti.com/es/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.