Migrar do app Order Printer para Shopify Order Printer

Se você tem modelos personalizados no antigo app Order Printer, precisará migrá-los para o novo Shopify Order Printer.

Para migrar modelos, é possível importar os modelos existentes para o app. No entanto, o Shopify Order Printer tem uma implementação um pouco diferente daquela do app herdado. Isso significa que alguns dos modelos existentes podem não funcionar no início, e talvez seja necessário fazer alguns ajustes no código.

Para que os modelos funcionem no novo app, é necessário substituir as variáveis antigas pelas novas. Por exemplo, se você usa a variável date, precisa substituí-la por created_at.

Nesta página, você encontra uma lista de variáveis que talvez precise substituir por novas no app Shopify Order Printer.

Nesta página

Considerações sobre a migração de modelos existentes

Antes de migrar os modelos existentes para o app Shopify Order Printer, analise as seguintes considerações:

Para migrar modelos existentes, você precisa conhecer HTML, CSS e Liquid. O Atendimento para Temas da Shopify pode ajudar em pequenos ajustes no escopo da Política de design da Shopify.
Consulte a referência de filtros e variáveis do Liquid para o Shopify Order Printer e veja todas as personalizações de modelo com suporte.
Se os modelos existentes usam CSS personalizado, é necessário transferir e ajustar o código manualmente no novo app.
Para acessar variáveis de pedido no app Shopify Order Printer, você precisa adicionar o prefixo relacionado.
Durante a importação de modelos existentes, os metacampos não são importados. Por isso, pode ser necessário migrar manualmente os modelos que contêm metacampos.

Migrar os modelos existentes para o app Shopify Order Printer

Se você tiver modelos do app Order Printer legado, eles poderão ser importados para o app Shopify Order Printer. Vale destacar que não é possível importar modelos específicos, só todos os modelos ao mesmo tempo.

Etapas:

No admin da Shopify, clique em Configurações > Apps e canais de vendas.
Clique em Order Printer.
Clique em Abrir app.
Clique em Modelos.
Clique em Importar.
Na caixa de diálogo, clique em Importar.
Confira se os modelos usam variáveis herdadas e faça a substituição pelas novas.
Pré-visualize os modelos e verifique se eles são exibidos corretamente.
Opcional: imprima os documentos de teste.

Usar variáveis de pedido no app Shopify Order Printer

As variáveis de pedido são usadas de modo diferente no app Shopify Order Printer. Para acessá-las, é preciso adicionar o prefixo order.. Por exemplo, para acessar a variável billing_address, use order.billing_address.

Estas variáveis de pedido usadas comumente podem ser acessadas sem o prefixo order.:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Por exemplo, se você quiser acessar a variável de itens de linha, poderá usar line_items ou order.line_items.

Também é possível criar seu alias para o modelo. Por exemplo, use a sintaxe do Liquid {% assign fulfillments_count = order.fulfillments | size %} e, em seguida, faça referência com {{ fulfillments_count }} em seu código.

Mapeamento de variáveis

O app Shopify Order Printer usa variáveis distintas do antigo Order Printer. Se os modelos existentes usarem alguma das variáveis listadas nesta seção, será necessário substituir as antigas pelas novas.

Por exemplo, se você usa a variável date, precisa substituí-la por created_at.

Variáveis do pedido

Variáveis do pedido
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`line_items`	Os itens de linha reembolsados não são incluídos na variável `line_items`. Analise as seguintes informações: Acesse itens de linha reembolsados com a variável `refunds.<each>.refund_line_items` . Analise o exemplo a seguir. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` É possível unir os itens de linha reembolsados com a coleção `line_items`, se você quiser. Analise o exemplo a seguir. `{% 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 %}` Inclua o filtro `\| uniq` para evitar duplicação dos itens de linha reembolsados. Os itens de linha de gorjeta não são incluídos na variável `line_items`. Analise as seguintes informações: É possível acessá-los com a variável `tip_line_items`. Você tem a opção de unir `tip_line_items` à coleção `line_items`, se quiser. Analise o exemplo a seguir. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Para imitar a coleção `line_items` herdada do Order Printer, use o código de exemplo a seguir. {% 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`	Use as informações de pagamento com base em cada transação do pedido com a variável `transactions.<each>.payment_details`.
`current_shipping_price`	`shipping_price`
`date`	Use a variável `created_at`. Use o filtro `date` para formatar a marcação de data e hora, por exemplo, com `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` ou `transactions.<each>.gateway`
`order_currency`	`Moeda`
`processed_at`	Use a variável `created_at`, que contém o valor de `order.processed_at` da API GraphQL. Isso significa o tempo real em que o pedido é processado, em vez do momento em que o pedido é importado para a Shopify. É o mesmo que `order.processed_at` herdado do app Order Printer. Use o filtro `date` para formatar a marcação de data e hora, por exemplo, com `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Filtre `order.transactions` para o status `kind` na sintaxe Liquid com where ou com loop e `if` dentro. Analise os exemplos a seguir. `{% 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" %} Transaction ID: {{ transaction.id }} Kind: {{ transaction.kind }} Amount: {{ 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`	Filtre `order.transactions` para o status `kind` na sintaxe Liquid com where ou com loop e `if` dentro, como no exemplo a seguir. `{% 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`. É possível defini-la como uma variável no início do modelo e fazer referência várias vezes, como no seguinte exemplo: `{% 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`

Variáveis LineItem

Variável LineItem
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`processado`	`quantity == successfully_fulfilled_quantity`
`Nome`	`title`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount/quantidade: 0`
`variant_title`	`variant.title`
`weight`	`gramas`

Variáveis de processamento

Variável de processamento de pedidos
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`date`	`created_at`

Variáveis da loja

Variável do Shop
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`proprietário`	`account_owner.name`
`endereço`	`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`
`zip`	`shop.address.zip`

Variáveis de endereço

Variável de endereço
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`latitude`	Se houver referência à variável `address` no atributo `location`, agora a latitude e a longitude estarão disponíveis diretamente no próprio objeto `location`.
`longitude`	Se houver referência à variável `address` no atributo `location`, agora a latitude e a longitude estarão disponíveis diretamente no próprio objeto `location`.

Variáveis do reembolso

Variável de reembolso
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`date`	Use a variável `created_at`. Use o filtro `date` para formatar a marcação de data e hora, por exemplo, com `{{ order.created_at \| date: "%B %e, %Y" }}`.

Variáveis ShippingLine

Variável ShippingLine
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`current_price`	`price`
`price`	`original_price`

Variáveis de transação

Estas variáveis de transação foram removidas e não podem ser substituídas no app Shopify Order Printer:

authorization
message
test

Variáveis de variante

Variável de variante
Variável no antigo app Order Printer	Variável no novo app Shopify Order Printer
`gramas`	`weight`

Variáveis de metacampo

Para acessar um metacampo, você precisa especificar o Namespace, e não é necessário adicionar .value à variável. Saiba mais sobre definições de metacampos.

Por exemplo, em vez da variável product.metafields.manufacturerid.value, use a variável product.metafields.custom.manufacturerid.

Para identificar os valores de Namespace em cada metacampo, consulte a página Dados personalizados no admin da Shopify. As definições de metacampos são agrupadas pelos objetos aos quais se referem, como produtos, variantes ou pedidos.

Mapeamento de filtro

Mapeamento de filtro
Filtrar nome no app herdado Order Printer	Filtrar nome no novo app Shopify Order Printer
`files_url`	`file_url`
`payment_method` e `payment_methods`	Use o campo transaction.gateway_display_name em transações de pedido. As formas de pagamento não são mais categorizadas em tipos específicos, como {cartão de crédito, cartão de débito, transferência bancária}. O Order Printer antigo mapeou apenas um pequeno subconjunto de gateways de pagamento em funcionamento para essas categorias. Os provedores de gateway de pagamento gerenciam os tipos de formas de pagamento usadas pelos clientes.