Referencia de variables y filtros de Liquid para Shopify Order Printer

Puedes usar Liquid para crear plantillas personalizadas con la app Shopify Order Printer. Con Liquid, puedes crear plantillas de texto y generarlas según los datos únicos de cada pedido.

Las referencias de Liquid que se listan en esta página son una extensión de la versión de código abierto de Liquid y están pensadas para usarse en la app Shopify Order Printer. Para mostrar información basada en los atributos de order y shop, puedes usar la lista de objetos, etiquetas y filtros de esta referencia para personalizar las plantillas. También puedes usar la documentación de Admin GraphQL API para conocer detalles sobre los campos de los objetos.

Usar variables y atributos

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

Los siguientes atributos de pedido de uso común son accesibles sin el prefijo order.:

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • discounts
  • refunds
  • shipping_methods
  • customer

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

Variables de Liquid disponibles en Shopify Order Printer

Están disponibles las siguientes clases. Los atributos se muestran en orden alfabético.

Pedido

En Shopify Order Printer están disponibles los siguientes atributos de pedido:

  • 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. Momento en que se procesó el pedido. Equivale a order.processed_at de la API GraphQL. Usa el filtro date para dar formato a la marca de fecha y hora; por ejemplo: {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedad order.discounts se reemplazó por order.discount_applications.
  • discounts_amount. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedad order.discounts se reemplazó por order.total_discounts.
  • discount_applications
  • discounts_savings. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedad order.discounts se reemplazó 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

Consulta la siguiente lista de atributos de Shop disponibles en Shopify Order Printer:

  • 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

Consulta la siguiente lista de atributos de la línea de artículo disponibles en Shopify Order Printer:

  • aggregated_update
  • applied_discounts. En desuso porque no están disponibles todos los tipos de descuento ni sus detalles. La propiedad line_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 descuento ni sus detalles. La propiedad line_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 no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. 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 no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. 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 no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. 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 disponibles en Shopify Order Printer:

  • created_at. Usa el filtro date para dar formato a la marca de fecha y hora, por ejemplo: {{ 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 disponibles en Shopify Order Printer:

  • 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 disponibles en Shopify Order Printer:

  • 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 Shopify Order Printer:

  • target_selection
  • target_type
  • title
  • total_allocated_amount
  • type
  • value_type
  • value

Imprimir descuentos

Los descuentos se pueden aplicar a todo el pedido o a líneas de artículos específicas:

  • Descuentos a nivel de pedido: se aplican a todo el pedido. Puedes mostrarlos por separado en la parte inferior cuando imprimas la factura del pedido.
  • Descuentos a nivel de línea de artículo: se aplican a artículos individuales. Puedes incluir estos descuentos cuando imprimas los detalles de cada artículo en la sección de líneas de artículos.

Accede a la información de los descuentos con las siguientes variables:

  • Accede a todos los descuentos aplicados al pedido o a cualquiera de sus líneas de artículos con el valor order.total_discounts y la colección order.discount_applications.
  • Accede a los descuentos de las líneas de artículos 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 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 relacionados a nivel de línea de artículo con el valor line_item.final_price.
  • Los valores line_item.original_line_price y line_item.final_line_price equivalen a los valores line_item.original_price y line_item.final_price multiplicados por line_item.quantity.
  • Accede a los descuentos a nivel de pedido con la colección order.cart_level_discount_applications.

Ejemplo de bloque de código para imprimir descuentos a nivel de 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 %}

Ejemplo de bloque de código para imprimir descuentos a nivel de 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 %}

DiscountAllocation

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

  • amount
  • discount_application

Discount

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

  • amount
  • code
  • free_shipping_discount
  • id
  • savings
  • title
  • total_amount
  • total_savings

Product

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

  • 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 variante disponibles en Shopify Order Printer:

  • 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 reembolso disponibles en Shopify Order Printer:

  • amount
  • created_at
  • id
  • note
  • refund_line_items
  • restock
  • transactions

Línea de envío

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

  • handle
  • id
  • original_price
  • price. Obsoleto porque el precio no incluía los descuentos a nivel de pedido. La propiedad shipping_line.price se reemplazó por shipping_line.price_with_discounts.
  • price_with_discounts
  • tax_lines
  • title

Línea de impuestos

Revisa la siguiente lista de atributos de la línea de impuestos disponibles en Shopify Order Printer:

  • price
  • rate
  • rate_percentage
  • title

Transacción

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

  • 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 metafield asociado a un objeto padre. Para saber cómo acceder a un metacampo en un objeto específico, consulta Access metafields.

Los metacampos admiten varios tipos de datos, que determinan el tipo de información que se almacena en el metacampo. Para acceder a ellos, la ruta de acceso a los metacampos consta de dos niveles:

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

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

Convención de nombres: <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 el tipo Metaobject no es compatible.

Objetos que admiten metacampos:

  • Order
  • Customer
  • Product
  • Variant
  • Location

Filtros de Liquid disponibles en Shopify Order Printer

Uso

Para aplicar filtros a una salida, agrega el filtro y cualquier parámetro del filtro dentro de las llaves {{ }}, precedidos por un carácter de barra vertical |. En el siguiente ejemplo, product es el objeto, title es su propiedad y upcase es el filtro que se aplica:

{{ product.title | upcase }}

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

Consulta la Filters section de la referencia de Liquid de Shopify Themes para obtener detalles sobre cómo usar los filtros de Liquid.

Filtros para aplicar a objetos Address

  • format_address

Para ver ejemplos de uso, consulta la documentación de Liquid de Shopify Themes para format_address.

Filtros para aplicar a cualquier texto/cadena

  • camelcase
  • camelize
  • encode_url_component
  • format_code
  • handle
  • highlight
  • pad_spaces
  • paragraphize
  • pluralize
  • url_escape
  • url_param_escape

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

Filtros para aplicar a importes monetarios

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer 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 a los importes. Puedes change the currency formatting. Define los valores de Email with currency y Email without currency en el panel de control de Shopify para cambiar el formato de los filtros de dinero en Shopify Order Printer.

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

Filtros para convertir objetos a JSON

  • json

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

Filtros para aplicar a valores de peso

  • weight
  • weight_with_unit

Para ver ejemplos de uso, consulta la documentación de Liquid de temas de Shopify sobre weight with unit.

Filtros para aplicar a etiquetas

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

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

Filtros para aplicar a URLs

  • 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 ver ejemplos de uso de los filtros multimedia compatibles, consulta la documentación de Liquid para los temas de Shopify sobre los filtros multimedia.

Filtros para aplicar a colecciones

  • link_to_type
  • link_to_vendor
  • sort_by
  • url_for_type
  • url_for_vendor
  • within

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