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.
En esta página
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_itemstax_linesfulfillmentstransactionsdiscountsrefundsshipping_methodscustomer
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:
attributesb2bbilling_addresscancel_reasoncancel_reason_labelcancelledcancelled_atcart_level_discount_applicationscheckout_idcheckout_payment_collection_urlcompanycompany_locationconfirmation_numbercreated_at. Momento en que se procesó el pedido. Equivale aorder.processed_atde la API GraphQL. Usa el filtrodatepara dar formato a la marca de fecha y hora; por ejemplo:{{ order.created_at | date: "%B %e, %Y" }}.customerdiscounts. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedadorder.discountsse reemplazó pororder.discount_applications.discounts_amount. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedadorder.discountsse reemplazó pororder.total_discounts.discount_applicationsdiscounts_savings. Obsoleto porque no se incluyen todos los tipos y detalles de descuento. La propiedadorder.discountsse reemplazó por-.emailfeesfinancial_statusfinancial_status_labelfulfilled_line_itemsfulfillment_abortedfulfillment_statusfulfillmentsgatewayiditem_countlanding_sitelanding_site_refline_itemsline_items_subtotal_pricelocationmetafieldsnamenet_paymentnoteorder_nameorder_numberorder_status_urlpaymentpayment_detailspo_numberrefundsrequires_shippingshipping_addressshipping_methodshipping_methodsshipping_priceshopshop_namesubtotal_pricetagstax_linestax_pricetip_line_itemstotal_discountstotal_dutiestotal_landed_cost_additional_feestotal_net_amounttotal_outstandingtotal_pricetotal_refunded_amounttotal_tiptransactionsunacceptable_risksunfulfilled_line_itemsunique_gatewaysuservoid_transactions
Shop
Consulta la siguiente lista de atributos de Shop disponibles en Shopify Order Printer:
accepts_gift_cardsaccount_ownerallows_discountscheckoutcheckout_requires_confirmation_stepcollections_countcontact_informationcurrencycustomer_accounts_enabledcustomer_accounts_optionaldescriptiondomainemailemail_accent_coloremail_logo_urlemail_logo_widthemail_marketingenabled_currenciesenabled_localesenabled_payment_typesfeaturesidlatitudelegal_noticelongitudemetafieldsmoney_formatmoney_with_currency_formatnamepassword_messagepermanent_domainphonepoliciesprivacy_policyproducts_countrefund_policysecure_urlshipping_policysubscription_policyterms_of_saleterms_of_servicetypesurl
LineItem
Consulta la siguiente lista de atributos de la línea de artículo disponibles en Shopify Order Printer:
aggregated_updateapplied_discounts. En desuso porque no están disponibles todos los tipos de descuento ni sus detalles. La propiedadline_item.discountsse reemplazó porline_item.discount_allocations.current_quantitydiscount_allocationsdiscounts. En desuso porque no están disponibles todos los tipos de descuento ni sus detalles. La propiedadline_item.discountsse reemplazó porline_item.discount_allocations.final_line_pricefinal_pricefulfillmentfulfillment_servicegift_cardgramsgroupsidimageindexitem_updatesjson_filterkeyline_level_discount_allocationsline_level_total_discountline_price. En desuso porque no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. La propiedadline_item.line_pricese reemplazó porline_item.final_line_price.messageoptions_with_valuesoriginal_line_priceoriginal_priceprice. En desuso porque no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. La propiedadline_item.pricese reemplazó porline_item.final_price.productproduct_idpropertiesquantityrefunded_quantityrequires_shippingselling_plan_allocationskusuccessfully_fulfilled_quantitytax_linestaxabletitletotal_discount. En desuso porque no incluye los descuentos provenientes de descuentos automáticos ni de códigos de descuento. La propiedadline_item.total_discountse reemplazó porline_item.line_level_total_discount.unit_priceunit_price_measurementurlurl_to_removevariantvariant_idvendor
Preparación de pedidos
Revisa la siguiente lista de atributos de preparación de pedidos disponibles en Shopify Order Printer:
created_at. Usa el filtrodatepara dar formato a la marca de fecha y hora, por ejemplo:{{ fulfillment.created_at | date: "%B %e, %Y" }}.estimated_delivery_atfulfillment_line_itemsitem_countline_itemsrequires_shippingtracking_companytracking_numbertracking_numberstracking_urltracking_urlsupdated_at
Dirección
Revisa la siguiente lista de atributos de dirección disponibles en Shopify Order Printer:
address1address2citycompanycountrycountry_codecountry_uppererrorsfirst_nameidlast_namenamephoneprovinceprovince_codestreetsummarytranslated_country_nametranslated_province_nameurlzip
Cliente
Revisa la siguiente lista de atributos de cliente disponibles en Shopify Order Printer:
accepts_marketingaccount_activation_urladdressesaddresses_countb2b?default_addressemailfirst_namehas_accountidlast_namelast_ordermetafieldsnamenew_addressordersorders_countpayment_methodsphonereset_password_urlsubscribe_urltagstax_exempttotal_spent
DiscountApplication
Revisa la siguiente lista de atributos de DiscountApplication disponibles en Shopify Order Printer:
target_selectiontarget_typetitletotal_allocated_amounttypevalue_typevalue
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_discountsy la colecciónorder.discount_applications. - Accede a los descuentos de las líneas de artículos con el valor
line_item.line_level_total_discounto la colecciónline_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_priceyline_item.final_line_priceequivalen a los valoresline_item.original_priceyline_item.final_pricemultiplicados porline_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 %}- Más información sobre discount types y working with discounts in Liquid.
DiscountAllocation
Revisa la siguiente lista de atributos de DiscountAllocation disponibles en Shopify Order Printer:
amountdiscount_application
Discount
Revisa la siguiente lista de atributos de Discount disponibles en Shopify Order Printer:
amountcodefree_shipping_discountidsavingstitletotal_amounttotal_savings
Product
Revisa la siguiente lista de atributos de Product disponibles en Shopify Order Printer:
as_jsonavailablecollectionscompare_at_pricecompare_at_price_maxcompare_at_price_mincompare_at_price_variescontentcreated_atdescriptionfeatured_imagefeatured_mediafirst_available_variantgift_card?handlehas_only_default_variantidimagesjson_filtermediametafieldsobject_typeoptionsoptions_by_nameoptions_with_valuespriceprice_maxprice_minprice_variespublished_atrequires_selling_planselected_or_first_available_selling_plan_allocationselected_or_first_available_variantselected_selling_planselected_selling_plan_allocationselected_variantselling_plan_groupstagstemplate_suffixtitletypeurlvariantsvendor
Variante
Revisa la siguiente lista de atributos de variante disponibles en Shopify Order Printer:
as_jsonavailablebarcodecompare_at_pricefeatured_imagefeatured_mediaidimageincominginventory_managementinventory_policyinventory_quantityjson_filtermetafieldsnext_incoming_dateoption1option2option3optionspriceproductrequires_selling_planrequires_shippingselected_selling_plan_allocationselling_plan_allocationsskustore_availabilitiestaxabletitleunit_priceunit_price_measurementurlweightweight_in_unitweight_unit
Reembolso
Revisa la siguiente lista de atributos de reembolso disponibles en Shopify Order Printer:
amountcreated_atidnoterefund_line_itemsrestocktransactions
Línea de envío
Revisa la siguiente lista de atributos de la línea de envío disponibles en Shopify Order Printer:
handleidoriginal_priceprice. Obsoleto porque el precio no incluía los descuentos a nivel de pedido. La propiedadshipping_line.pricese reemplazó porshipping_line.price_with_discounts.price_with_discountstax_linestitle
Línea de impuestos
Revisa la siguiente lista de atributos de la línea de impuestos disponibles en Shopify Order Printer:
priceraterate_percentagetitle
Transacción
Revisa la siguiente lista de atributos de transacción disponibles en Shopify Order Printer:
amountbuyer_pending_payment_instructionsbuyer_pending_payment_noticecreated_atgatewaygateway_display_nameidkindnamepayment_detailsreceiptshow_buyer_pending_payment_instructionsstatusstatus_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:
StringArray: usa[ ]para indexar. Por ejemplo,order.metafield.shipping.express_delivery_status[0]IntegerBooleanDate
Nota el tipo Metaobject no es compatible.
Objetos que admiten metacampos:
OrderCustomerProductVariantLocation
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
camelcasecamelizeencode_url_componentformat_codehandlehighlightpad_spacesparagraphizepluralizeurl_escapeurl_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
moneymoney_with_currencymoney_without_currencymoney_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
weightweight_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_taglink_to_add_taglink_to_remove_taglink_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_urlasset_img_urlasset_urlcdn_asset_urlcollection_img_urlfile_img_urlfile_urlglobal_asset_urlimage_urlimg_tagimg_urllink_topayment_icon_png_urlpayment_type_img_urlpayment_type_svg_tagplaceholder_svg_tagproduct_img_urlscript_tagshopify_asset_urlstylesheet_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_typelink_to_vendorsort_byurl_for_typeurl_for_vendorwithin
Para ver ejemplos de uso, consulta la documentación de Liquid de temas de Shopify sobre collection filters.