Migrar plantillas de la aplicación Order Printer a Order Printer de Shopify

Si tienes plantillas personalizadas en la aplicación Order Printer obsoleta, debes migrarlas a la aplicación Order Printer de Shopify.

Para migrar tus plantillas, puedes importarlas a la aplicación Order Printer de Shopify. Sin embargo, la implementación de la nueva aplicación Order Printer de Shopify difiere un poco de la correspondiente a la aplicación Order Printer obsoleta. Esto significa que es posible que algunas de tus plantillas existentes no funcionen inicialmente y que sea necesario hacer algunos ajustes en el código de las plantillas.

Para que tus plantillas funcionen en la nueva aplicación, debes reemplazar las variables obsoletas por las nuevas. Por ejemplo, si usas la variable date, debes reemplazarla por created_at.

En esta página puedes encontrar una lista de variables que quizá debas reemplazar por otras nuevas en la aplicación Order Printer de Shopify.

Consideraciones para migrar plantillas existentes

Antes de migrar plantillas existentes a la aplicación Order Printer de Shopify, revisa las siguientes consideraciones:

• Para migrar plantillas existentes, es necesario saber usar HTML, CSS y Liquid. La atención al cliente de temas de Shopify puede ayudarte con ajustes menores dentro del alcance de la Política de diseño de Shopify.
• Revisa la referencia de variables y filtros de Liquid para Order Printer de Shopify para todas las personalizaciones de plantilla compatibles.
• Si las plantillas existentes usan CSS personalizado, debes transferir y ajustar manualmente el código en la nueva aplicación.
• Para acceder a variables de pedido en la aplicación Order Printer de Shopify, debes agregar el prefijo del pedido.
• Cuando se importan plantillas existentes, los metacampos no se importan. Es posible que tengas que migrar manualmente las plantillas que contengan metacampos.

Migrar plantillas existentes a la aplicación Order Printer de Shopify

Si tienes plantillas existentes de la aplicación Order Printer obsoleta, puedes importarlas a la aplicación Order Printer de Shopify. No puedes importar plantillas en particular, solo puedes importar todas tus plantillas al mismo tiempo.

Pasos:

1. En el panel de control de Shopify, haz clic en Configuración > Aplicaciones y canales de ventas.
2. Haz clic en Order Printer.

3. Haz clic en Abrir aplicación.

4. Haz clic en Plantillas.

5. Haz clic en Importar.

6. En el cuadro de diálogo, haz clic en Importar.

7. Revisa si en tus plantillas se usa alguna de las variables obsoletas y, luego, reemplázalas por las nuevas.

8. Obtén una vista previa de las plantillas y asegúrate de que se visualicen correctamente.

9. Opcional: Imprime documentos de prueba.

Usar variables de pedido en la aplicación Order Printer de Shopify

Las variables de pedido se usan de forma distinta en la aplicación Order Printer de Shopify. Para acceder a variables de pedido, debes agregar el prefijo order.. Por ejemplo, para acceder a la variable billing_address, debes usar order.billing_address.

Las siguientes variables de pedido usadas comúnmente son accesibles sin el prefijo order.:

• line_items
• tax_lines
• fulfillments
• transactions
• 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.

También puedes crear tus propios alias para la plantilla. Por ejemplo, puedes usar la sintaxis de Liquid {% assign fulfillments_count = order.fulfillments | size %} y luego hacer referencia a ella incluyendo {{ fulfillments_count }} en el código.

Asignación de variables

La aplicación Order Printer de Shopify usa variables distintas respecto a la aplicación Order Printer obsoleta. Si tus plantillas existentes usan alguna de las variables enumeradas en esta sección, debes reemplazar las variables antiguas por otras nuevas.

Por ejemplo, si usas la variable date, debes reemplazarla por la variable created_at.

Variables de pedido

Variable de pedido

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
line_items	Las líneas de artículo que se reembolsaron no están incluidas en la variable line_items. Revisa la siguiente información: Puedes acceder a las líneas de artículos que se reembolsaron utilizando la variable refunds.<each>.refund_line_items. Revisa el siguiente ejemplo. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} Puedes unir a las líneas de artículo que se reembolsaron a la colección line_items si quieres. Revisa el siguiente ejemplo. {% assign refunded_line_items = order.refunds | map: "refund_line_items" | map: "line_item" %} {% assign line_items_with_refunded = order.line_items | concat: refunded_line_items | uniq %} Te recomendamos que te asegures de incluir el filtro | uniq para evitar que se dupliquen las líneas de artículo que se reembolsaron. Las líneas de artículos de propina no se incluyen en la variable line_items. Revisa la siguiente información: Puedes acceder a las líneas de artículos de propina usando la variable tip_line_items. Puedes unir tip_line_items a la colección line_items si quieres. Revisa el siguiente ejemplo. {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} Para imitar la colección obsoleta line_items de Order Printer, puedes usar el siguiente código de ejemplo. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} {% assign all_line_items = order.line_items | concat: refunded_line_items | concat: order.tip_line_items | uniq %} {% for line_item in all_line_items %} ... {% endfor %}
credit_card	Usa la variable transactions.<each>.payment_details para obtener detalles de pago basados en cada transacción del pedido.
current_shipping_price	shipping_price
date	Usa la variable created_at. Usa el filtro date para dar formato a la marca de tiempo, por ejemplo con {{ order.created_at | date: "%B %e, %Y" }}.
pasarelas	unique_gateways o transactions.<each>.gateway
order_currency	Moneda
processed_at	Usa la variable created_at. Contiene el valor de order.processed_at de la API GraphQL y significa el momento real en que se procesa el pedido, en lugar del momento en que se importa el pedido a Shopify. Es igual que order.processed_at de la aplicación Order Printer discontinuada. Puedes usar el filtro date para dar formato a la marca de tiempo, por ejemplo con {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions	Filtra mediante order.transactions para el estado kind en la sintaxis de Liquid con where o con un bucle e if dentro. Revisa los siguientes ejemplos. {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Identificación de la transacción: {{ transaction.id }} Tipo: {{ transaction.kind }} Cantidad: {{ transaction.amount | money }} {% endif %} {% endfor %} {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% assign payment_transactions = sale_transactions | concat: capture_transactions %}
refund_transactions	Filtra mediante order.transactions para el estado kind en la sintaxis de Liquid con where o con un bucle e if dentro, como se muestra en el siguiente ejemplo. {% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_line	shipping_methods | first
shipping_lines	shipping_methods
show_line_item_taxes	tax_lines.size > 0. Puedes definirla como una variable al principio de la plantilla y hacer referencia a ella varias veces, como con el siguiente ejemplo. {% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_tax	tax_price
total_paid	net_payment

Variables de LineItem

Variable de LineItem

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
fulfillable_quantity	quantity - successfully_fulfilled_quantity
preparado	quantity == successfully_fulfilled_quantity
Nombre	título
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
weight	Gramos

Variables de proceso de envío

variable de preparación de pedidos

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
date	created_at

Variables de la tienda

Variable de la tienda

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
titular	account_owner.name
dirección	shop.address.address1
address2	shop.address.address2
city	shop.address.city
país	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
Código postal	shop.address.zip

Variables de dirección

Variable de la dirección

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
latitude	Si se hizo referencia a la variable address desde el atributo location, la latitud y la longitud estarán disponibles en el objeto location.
longitude	Si se hizo referencia a la variable address desde el atributo location, la latitud y la longitud estarán disponibles en el objeto location.

Variables de reembolso

Variable de reembolso

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
date	Usa la variable created_at. Usa el filtro date para dar formato a la marca de tiempo, por ejemplo con {{ order.created_at | date: "%B %e, %Y" }}.

Variables de ShippingLine

Variable de ShippingLine

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
current_price	price
price	original_price

Variables de transacción

Se eliminaron las siguientes variables de transacción y no se pueden reemplazar en la aplicación Order Printer de Shopify:

• authorization
• message
• test

Variables de variante

variable de variante

Variable en la aplicación Order Printer obsoleta	Variable en la nueva aplicación Order Printer de Shopify
Gramos	weight

Variables de metacampos

Para acceder a un metacampo, debes especificar el espacio de nombres del metacampo y no necesitas agregar .value a la variable. Más información sobre definiciones de metacampos.

Por ejemplo, en lugar de la variable product.metafields.manufacturerid.value, usa product.metafields.custom.manufacturerid.

Para identificar los valores del espacio de nombres de cada metacampo, consulta la página Datos personalizados de tu panel de control de Shopify. Las definiciones de metacampos se agrupan por los objetos a los que se refieren, como productos, variantes o pedidos.

Asignación de filtro

Asignación de filtro

Filtrar nombre en la aplicación Order Printer discontinuada	Filtrar nombre en la nueva aplicación Shopify Order Printer
files_url	file_url
payment_method y payment_methods	Usa el campo transaction.gateway_display_name en las transacciones de pedidos. Las formas de pago ya no se categorizan en tipos específicos, como {credit card, debit card, bank transfer}. La aplicación Order Printer obsoleta solo asignó a estas categorías un pequeño subconjunto de pasarelas de pago que funcionan actualmente. Los proveedores de pasarelas de pago gestionan los tipos de formas de pago que usan los clientes de su lado.