Referencia de variables y filtros de Liquid para Order Printer de Shopify

Puedes usar Liquid para crear tus propias plantillas personalizadas con la aplicación Order Printer de Shopify. Con Liquid, puedes crear plantillas de texto y renderizarlas según los datos únicos de cada pedido.

Las referencias de Liquid que aparecen en esta página son una extensión de la versión de código abierto de Liquid y están concebidas para usarse en la aplicación Order Printer de Shopify. Para renderizar la información basada en los atributos order y shop, puedes usar la lista de objetos, etiquetas y filtros de esta referencia para personalizar las plantillas. También puedes usar los documentos de la API Admin GraphQL para obtener información sobre los campos de objeto.

En esta página

Usar variables y atributos

En las plantillas de Order Printer de Shopify, los objetos de datos principales son order y shop. Puedes usar order.variable_name para acceder a los atributos de pedido.

Los siguientes atributos de pedido usados comúnmente son accesibles sin el prefijo order.:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Por ejemplo, si deseas acceder a la variable de línea de artículo, puedes usar line_items o order.line_items.

Variables de Liquid disponibles en Order Printer de Shopify

Las siguientes clases están disponibles. Los atributos se muestran por orden alfabético.

Pedido

Los siguientes atributos de pedido están disponibles en Order Printer de Shopify:

attributes
b2b
billing_address
cancel_reason
cancel_reason_label
cancelled
cancelled_at
cart_level_discount_applications
checkout_id
checkout_payment_collection_url
company
company_location
confirmation_number
created_at. El momento en que se ha procesado el pedido. Esto es igual a order.processed_at de la API GraphQL. Usa el filtro date para dar formato a la marca de tiempo, por ejemplo con {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. En desuso porque no se capturan todos los tipos de descuentos ni toda la información sobre ellos. La propiedad order.discounts se ha reemplazado por order.discount_applications.
discounts_amount. En desuso porque no se capturan todos los tipos de descuentos ni toda la información sobre ellos. La propiedad order.discounts se ha reemplazado por order.total_discounts.
discount_applications
discounts_savings. En desuso porque no se capturan todos los tipos de descuentos ni toda la información sobre ellos. La propiedad order.discounts se ha reemplazado por -.
email
fees
financial_status
financial_status_label
fulfilled_line_items
fulfillment_aborted
fulfillment_status
fulfillments
gateway
id
item_count
landing_site
landing_site_ref
line_items
line_items_subtotal_price
location
metafields
name
net_payment
note
order_name
order_number
order_status_url
payment
payment_details
po_number
refunds
requires_shipping
shipping_address
shipping_method
shipping_methods
shipping_price
shop
shop_name
subtotal_price
tags
tax_lines
tax_price
tip_line_items
total_discounts
total_duties
total_landed_cost_additional_fees
total_net_amount
total_outstanding
total_price
total_refunded_amount
total_tip
transactions
unacceptable_risks
unfulfilled_line_items
unique_gateways
user
void_transactions

Shop

Revisa la siguiente lista de atributos de Shop que están disponibles en Order Printer de Shopify:

accepts_gift_cards
account_owner
allows_discounts
checkout
checkout_requires_confirmation_step
collections_count
contact_information
currency
customer_accounts_enabled
customer_accounts_optional
description
domain
email
email_accent_color
email_logo_url
email_logo_width
email_marketing
enabled_currencies
enabled_locales
enabled_payment_types
features
id
latitude
legal_notice
longitude
metafields
money_format
money_with_currency_format
name
password_message
permanent_domain
phone
policies
privacy_policy
products_count
refund_policy
secure_url
shipping_policy
subscription_policy
terms_of_sale
terms_of_service
types
url

LineItem

Revisa la siguiente lista de línea de artículo que están disponibles en Order Printer de Shopify:

aggregated_update
applied_discounts. En desuso porque no están disponibles todos los tipos de descuentos ni toda la información sobre ellos. La propiedadline_item.discounts se reemplazó por line_item.discount_allocations.
current_quantity
discount_allocations
discounts. En desuso porque no están disponibles todos los tipos de descuentos ni toda la información sobre ellos. La propiedadline_item.discounts se reemplazó por line_item.discount_allocations.
final_line_price
final_price
fulfillment
fulfillment_service
gift_card
grams
groups
id
image
index
item_updates
json_filter
key
line_level_discount_allocations
line_level_total_discount
line_price. En desuso porque los descuentos procedentes de descuentos automáticos y códigos de descuento no están incluidos. La propiedad line_item.line_price se reemplazó por line_item.final_line_price.
message
options_with_values
original_line_price
original_price
price. En desuso porque los descuentos procedentes de descuentos automáticos y códigos de descuento no están incluidos. La propiedad line_item.price se reemplazó por line_item.final_price.
product
product_id
properties
quantity
refunded_quantity
requires_shipping
selling_plan_allocation
sku
successfully_fulfilled_quantity
tax_lines
taxable
title
total_discount. En desuso porque los descuentos procedentes de descuentos automáticos y códigos de descuento no están incluidos. La propiedad line_item.total_discount se reemplazó por line_item.line_level_total_discount.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Preparación de pedidos

Revisa la siguiente lista de atributos de preparación de pedidos que están disponibles en Order Printer de Shopify:

created_at. Usa el filtro date para dar formato a la marca de tiempo, por ejemplo con {{ fulfillment.created_at | date: "%B %e, %Y" }}.
estimated_delivery_at
fulfillment_line_items
item_count
line_items
requires_shipping
tracking_company
tracking_number
tracking_numbers
tracking_url
tracking_urls
updated_at

Dirección

Revisa la siguiente lista de atributos de dirección que están disponibles en Order Printer de Shopify:

address1
address2
city
company
country
country_code
country_upper
errors
first_name
id
last_name
name
phone
province
province_code
street
summary
translated_country_name
translated_province_name
url
zip

Cliente

Revisa la siguiente lista de atributos de Cliente que están disponibles en Order Printer de Shopify:

accepts_marketing
account_activation_url
addresses
addresses_count
b2b?
default_address
email
first_name
has_account
id
last_name
last_order
metafields
name
new_address
orders
orders_count
payment_methods
phone
reset_password_url
subscribe_url
tags
tax_exempt
total_spent

DiscountApplication

Revisa la siguiente lista de atributos de DiscountApplication disponibles en Order Printer de Shopify:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Imprimir descuentos

Los descuentos pueden aplicarse a todo el pedido o a líneas de artículo específicas:

Descuentos a nivel del pedido: se aplican a todo el pedido. Puedes mostrar estos descuentos por separado en la parte inferior al imprimir la factura de tu pedido.
Descuentos a nivel de la línea de artículo: se aplican a artículos individuales. Puedes mencionar estos descuentos al imprimir detalles de artículos individuales en la sección de línea de artículo.

Puedes acceder a la información de descuentos usando las siguientes variables:

Accede a todos los descuentos aplicados al pedido o a cualquiera de sus líneas de artículo con el valor order.total_discounts y la colección order.discount_applications.
Accede a los descuentos de línea de artículo con el valor line_item.line_level_total_discount o la colección line_item.line_level_discount_allocations.
- Accede al precio de la línea de artículo tal y como estaba antes de aplicar cualquier descuento con el valor line_item.original_price.
- Accede al precio resultante de la línea de artículo después de aplicar todos los descuentos de nivel de línea de artículo relacionados con el valorline_item.final_price.
- Los valoresline_item.original_line_price y line_item.final_line_price son iguales a los valoresline_item.original_price y line_item.final_price multiplicados por line_item.quantity.
Accede a descuentos a nivel de pedido con la colecciónorder.cart_level_discount_applications.

Ejemplo de bloque de código para imprimir descuentos de nivel de la línea de artículo:

{% for line_item in order.line_items %}
  <tr>
    <td>{{ line_item.quantity }}</td>
    <td>{{ line_item.title }}
    {% if line_item.line_level_discount_allocations.size > 0 %}
      <span class="subduedText">
        {% for discount_allocation in line_item.line_level_discount_allocations %}
        <br>{{ discount_allocation.discount_application.title }} (-{{ discount_allocation.amount | money }})
        {% endfor %}
      </span>
    {% endif %}
    </td>
    <td style="text-align: right;">
      {% if line_item.original_price != line_item.final_price %}
        <span class="subduedText"><s>{{ line_item.original_price | money }}</s></span>
      {% endif %}
      {{ line_item.final_price | money }}
    </td>
  </tr>
{% endfor %}

Bloque de código de ejemplo para imprimir descuentos a nivel del pedido:

{% for discount_application in order.cart_level_discount_applications %}
<tr>
  <td colspan="2" style="text-align: right;">{% if discount_application.title %}<span class="subduedText">{{ discount_application.title }}</span>{% endif %}</td>
  <td style="text-align: right;">-{{ discount_application.total_allocated_amount | money }}</td>
</tr>
{% endfor %}

Obtén más información sobre tipos de descuentos y cómo trabajar con descuentos en Liquid.

DiscountAllocation

Revisa la siguiente lista de atributos de DiscountAllocation disponibles en Order Printer de Shopify:

amount
discount_application

Descuento

Revisa la siguiente lista de atributos de Descuento que están disponibles en Order Printer de Shopify:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Producto

Revisa la siguiente lista de atributos de Descuento que están disponibles en Order Printer de Shopify:

as_json
available
collections
compare_at_price
compare_at_price_max
compare_at_price_min
compare_at_price_varies
content
created_at
description
featured_image
featured_media
first_available_variant
gift_card?
handle
has_only_default_variant
id
images
json_filter
media
metafields
object_type
options
options_by_name
options_with_values
price
price_max
price_min
price_varies
published_at
requires_selling_plan
selected_or_first_available_selling_plan_allocation
selected_or_first_available_variant
selected_selling_plan
selected_selling_plan_allocation
selected_variant
selling_plan_groups
tags
template_suffix
title
type
url
variants
vendor

Variante

Revisa la siguiente lista de atributos de Descuento que están disponibles en Order Printer de Shopify:

as_json
available
barcode
compare_at_price
featured_image
featured_media
id
image
incoming
inventory_management
inventory_policy
inventory_quantity
json_filter
metafields
next_incoming_date
option1
option2
option3
options
price
product
requires_selling_plan
requires_shipping
selected_selling_plan_allocation
selling_plan_allocations
sku
store_availabilities
taxable
title
unit_price
unit_price_measurement
url
weight
weight_in_unit
weight_unit

Reembolso

Revisa la siguiente lista de atributos de Descuento que están disponibles en Order Printer de Shopify:

amount
created_at
id
note
refund_line_items
restock
transactions

ShippingLine

Revisa la siguiente lista de línea de atributos de la línea de envío que están disponibles en Order Printer de Shopify:

handle
id
original_price
price. Se dejó de usar porque el precio no incluía los descuentos a nivel del pedido. La propiedad shipping_line.price se ha remplazado por shipping_line.price_with_discounts.
price_with_discounts
tax_lines
title

TaxLine

Revisa la siguiente lista de atributos de línea de impuesto que están disponibles en Order Printer de Shopify:

price
rate
rate_percentage
title

Transacción

Revisa la siguiente lista de atributos de transacción que están disponibles en Order Printer de Shopify:

amount
buyer_pending_payment_instructions
buyer_pending_payment_notice
created_at
gateway
gateway_display_name
id
kind
name
payment_details
receipt
show_buyer_pending_payment_instructions
status
status_label

Metacampo

Un metacampo adjunto a un objeto principal. Para obtener información sobre cómo acceder a un metacampo en un objeto específico, consulta Acceder a metacampos.

Los metacampos admiten varios tipos de datos, que determinan el tipo de información almacenada en el metacampo. Para acceder a metacampos, la ruta de acceso para metacampos consiste en dos capas:

espacio de nombre: una agrupación de metacampos para prevenir conflictos,
clave: el nombre del metacampo.

Teniendo esto, puedes acceder al objeto de metacampo con la siguiente sintaxis: {{ resource.metafields.namespace.key }}.

Nomenclatura: <object>.metafields.<namespace>.<key>. Por ejemplo, order.metafields.shipping.express_delivery_status.

Tipos:

String
Array - usa [] para indexar. Por ejemplo, order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Nota: No se admite el tipo Metaobject.

Objetos compatibles con metacampos:

Order
Customer
Product
Variant
Location

Filtros de Liquid disponibles en Order Printer de Shopify

Uso

Para aplicar filtros a una salida, agrega el filtro y cualquier parámetro de filtro dentro de los delimitadores de llave {{ }}, precedidos por un carácter filtro |. En el siguiente ejemplo, el producto es el objeto, el título es su propiedad y el texto en mayúscula es el filtro que se está aplicando:

{{ product.title | upcase }}

Si product.title tiene el valor Health potion , HEALTH POTION será la salida desde el filtro upcase.

Consulta la sección Filtros de la referencia de Liquid de Temas de Shopify para ver detalles sobre cómo usar filtros de Liquid.

Filtros que se aplicarán en objetos Dirección

format_address

Para ver ejemplos de uso, consulta format_address en la documentación de Liquid sobre temas de Shopify.

Filtros que se aplicarán en cualquier texto o cadena

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Para ejemplos de uso, consulta la documentación de Liquid de Temas de Shopify para ver filtros de cadena.

Filtros que se aplicarán a números que significan dinero

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Order Printer de Shopify usa las opciones de formato de moneda de las notificaciones por correo electrónico configuradas en el panel de control de Shopify para dar formato al dinero. Puedes cambiar el formato de la moneda. Define los valores Email with currency y Email without currency en el panel de control de Shopify para cambiar el formato de los filtros de dinero en Order Printer de Shopify.

Para ver ejemplos de uso, consulta filtros de dinero en la documentación de Liquid sobre temas de Shopify.

Filtros que se aplicarán para convertir objetos a json

json

Para ver ejemplos de uso, consulta filtro json en la documentación de Liquid sobre temas de Shopify.

Filtros a aplicar en las cifras de peso-significado

weight
weight_with_unit

Para ejemplos de uso, consulta la documentación de Liquid de Temas de Shopify para el peso con unidad.

Filtros que se aplican a las etiquetas

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Para ver ejemplos de uso, consulta filtros de etiquetas en la documentación de Liquid sobre temas de Shopify.

Filtros que se aplicarán en URL

article_img_url
asset_img_url
asset_url
cdn_asset_url
collection_img_url
file_img_url
file_url
global_asset_url
image_url
img_tag
img_url
link_to
payment_icon_png_url
payment_type_img_url
payment_type_svg_tag
placeholder_svg_tag
product_img_url
script_tag
shopify_asset_url
stylesheet_tag

Para ejemplos de uso, consulta la documentación de Liquid de Temas de Shopify para filtros de elementos multimedia y html.

Filtros que se aplicarán a las colecciones

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Para ver ejemplos de uso, consulta filtros de colección en la documentación de Liquid sobre temas de Shopify.