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

La implementación de Liquid en Order Printer de Shopify difiere levemente de la aplicación Order Printer original. Para migrar tus plantillas, deberás copiar manualmente el código de tus plantillas existentes, pegarlas en la nueva aplicación y hacer los ajustes necesarios como se describe en esta guía. Cualquier CSS personalizado agregado a tus plantillas también deberá transferirse y ajustarse en la nueva aplicación.

Nota

Las nuevas notas de entrega, facturas y plantillas de la aplicación Order Printer de Shopify se optimizaron para usar menos papel y tinta, e incluir información adicional. Antes de migrar tus plantillas existentes de Order Printer, revisa las nuevas plantillas para determinar si se adaptan mejor a tus necesidades.

Se eliminan los atributos del pedido del espacio de nombre global

Para acceder a los atributos de pedido, anteponles order.. Por ejemplo, ahora se accede a billing_address como order.billing_address.

Para tu comodidad, varios atributos de pedido usados comúnmente aún son accesibles sin el prefijo order.:

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

Se puede acceder a estas variables como fulfillments o order.fulfillments, y así sucesivamente.

Nota

Puedes hacer tus propios alias dentro del cuerpo de las plantillas con la {% assign fulfillments_count = order.fulfillments | size %} Sintaxis Liquid, y luego hacer referencia a ella con el texto {{ fulfillments_count }} sintaxis hacia abajo de la plantilla.

Campos obsoletos

De acuerdo con el modelo de datos actualizado de Shopify, varios campos de varios objetos cambiaron de nombre o quedaron obsoletos con un reemplazo o una solución alternativa proporcionados en los párrafos siguientes. Si tus plantillas acceden a cualquiera de ellos, sustitúyelos por los campos de reemplazo o los fragmentos de código provistos.

Pedido

Diferencias de implementación:

• line_items. Las líneas de artículos reembolsadas no están incluidas en la colección line_items. Accede a ellas a través de refunds.<each>.refunded_line_items.

Campos obsoletos con reemplazos indicados:

• credit_card. Usa los detalles de pago basados en cada transacción del pedido: transactions.each.payment_details.
• current_shipping_price. Usa shipping_price en su lugar.
• date. Usa created_at en su lugar.
• gateways. Usa unique_gateways o transactions.<each>.gateway en su lugar.
• order_currency. Usa currency en su lugar.
• processed_at. Usa created_at en su lugar.
• payment_transactions. Filtra por order.transactions para ver el tipo y el estado en la sintaxis de Liquid con donde o con bucle y if dentro.
• refund_transactions. Filtra por order.transactions para ver el tipo y el estado en la sintaxis de Liquid con donde o con bucle y if dentro.
• shipping_line. Usa shipping_methods | first.
• shipping_lines. Usa shipping_methods.
• show_line_item_taxes. Haz que tax_lines.size > 0. Puedes definirlo como una variable al comienzo de la plantilla y hacer referencia varias veces: {% assign show_line_item_taxes = tax_lines.size > 0 %}.
• total_tax. Usa tax_price.
• total_paid. Usa net_payment.

LineItem

Campos obsoletos con reemplazos indicados:

• fulfillable_quantity. Usa quantity - successfully_fulfilled_quantity.
• fulfilled. Calcula la condición quantity == successfully_fulfilled_quantity.
• name. Usa title.
• product_title. Usa product.title.
• unit_discount. Calcula quantity ? total_iscount / quantity : 0.
• variant_title. Usa variant.title.
• weight. Usa grams.

Preparación de pedidos

Campos obsoletos con reemplazos indicados:

• date. Usa created_at.

Shop

Campos obsoletos con reemplazos indicados:

• owner - Usa account_owner.name.

Para los siguientes campos, refiérete a ellos como shop.address.<field_name>:

• address - Usa shop.address.address1.
• address2 - Usa shop.address.address2.
• city - Usa shop.address.city.
• country - Usa shop.address.city.
• country_code - Usa shop.address.country_code.
• province - Usa shop.address.province.
• province_code - Usa shop.address.province_code.
• zip - Usa shop.address.zip.

Dirección

Campos obsoletos con reemplazos indicados:

• latitude - Si se hizo referencia a address desde location, la latitud y la longitud están disponibles en el mismo objeto location.
• Longitude - Si se hizo referencia a address desde location, la latitud y la longitud están disponibles en el mismo objeto location.

Reembolso

Campos obsoletos con reemplazos indicados:

• date. Usa created_at.

ShippingLine

Campos obsoletos con reemplazos indicados:

• current_price. Usa price.
• price. Usa original_price.

Transacción

Campos eliminados:

• authorization
• message
• test

Variante

Campos obsoletos con reemplazos indicados:

• grams. Usa weight.

Filtros obsoletos

Campos obsoletos con reemplazos indicados:

• files_url. Usa file_url.
• payment_method, 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 Order Printer anterior mapeaba a estas categorías solo 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 por su parte.