Migrera mallar från Order Printer-appen till Shopify Order Printer

Den här sidan skrevs ut den Jul 27, 2024. Besök https://help.shopify.com/sv/manual/orders/printing-orders/shopify-order-printer/migration för den aktuella versionen.

Om du har några anpassade mallar i den föråldrade Order Printer-appen så måste du migrera dina mallar till Shopify Order Printer-appen.

För att migrera dina mallar kan du importera befintliga mallar till Shopify Order Printer-appen. Den nya Shopify Order Printer-appen har dock en lite annan implementering än den föråldrade Order Printer-appen. Det innebär att vissa av dina befintliga mallar kanske till en början inte fungerar och du kan behöva göra vissa justeringar av mallens kod.

Du måste ersätta de föråldrade variablerna med de nya variablerna för att få mallarna att fungera i den nya appen. Om du till exempel använder variabeln date så måste du ersätta den med created_at-variabeln.

På den här sidan kan du hitta en lista över variabler som du kan behöva ersätta med nya variabler i Shopify Order Printer-appen.

På den här sidan

Överväganden för att migrera dina befintliga mallar

Granska följande överväganden innan du migrerar dina befintliga mallar till Shopify Order Printer-appen:

Migrera befintliga mallar till Shopify Order Printer-appen

Om du har befintliga mallar från den äldre Order Printer-appen kan du importera dem till Shopify Order Printer-appen . Du kan inte importera specifika mallar, du kan bara importera alla dina mallar samtidigt.

Steg:

  1. Klicka på Inställningar > Appar och försäljningskanaler från din Shopify-admin.
  2. Klicka på Order Printer.

  3. Klicka på Öppna app.

  4. Klicka på Mallar.

  5. Klicka på Importera.

  6. Klicka på Importera i dialogrutan.

  7. Kontrollera om dina mallar använder någon av de äldre variablerna och ersätt dem sedan med de nya variablerna.

  8. Förhandsgranska mallarna och se till att de visas på ett korrekt sätt.

  9. Valfritt: Skriv ut testdokument.

Använda ordervariabler i Shopify Order Printer-appen

Ordervariabler används på ett annat sätt i Shopify Order Printer-appen. Du måste lägga till prefixet order. för att komma åt ordervariabler. Du måste till exempel använda variabelnorder.billing_address för att komma åt billing_address.

Följande vanliga ordervariabler är tillgängliga utan prefixet order.:

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

Om du till exempel vill komma åt postvariablen så kan du använda line_items eller order.line_items.

Du kan även skapa egna alias för mallen. Du kan till exempel använda Liquid-syntaxen {% assign fulfillments_count = order.fulfillments | size %} och sedan referera till den genom att använda {{ fulfillments_count }} i koden.

Variabelmappning

Shopify Order Printer-appen använder andra variabler än den föråldrade Order Printer-appen. Om dina befintliga mallar använder någon av variablerna som listas i det här avsnittet så måste du ersätta de gamla variablerna med nya.

Om du till exempel använder variabeln date måste du ersätta den med variabeln created_at.

Ordervariabler

Ordervariabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
line_items
  • Återbetalade poster ingår inte i variabeln line_items. Granska följande uppgifter:
    • Du kan få tillgång till återbetalade poster med hjälp av variabeln refunds.<each>.refund_line_items. variabel. Granska följande exempel.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Du kan lägga till de återbetalade posterna i produktserien line_items om du vill. Granska följande exempel.
      {% 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 %}
    • Kontrollera att du inkluderar filtret | uniq för att undvika duplicering av de återbetalade posterna.
  • Dricksposter ingår inte i variabeln line_items . Granska följande uppgifter:
    • Du kan komma åt dricksposter med hjälp av variabeln tip_line_items.
    • Du kan lägga till tip_line_items i produktserien line_items om du vill. Granska följande exempel.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Du kan använda följande exempelkod att efterlikna den föråldrade produktserien Order Printer line_items .
    {% 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 Använd betalningsuppgifter baserat på varje transaktion från ordern med variabeln transactions.<each>.payment_details .
current_shipping_price shipping_price
Datum Använd variabeln created_at. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
gateways unique_gateways eller transactions.<each>.gateway
order_currency valuta
processed_at Använd variabeln created_at. Den innehar värdet på order.processed_at från GraphQL API, och det innebär den faktiska tiden som ordern behandlas vid, snarare än den tidpunkt då ordern importeras till Shopify. Den är den samma som order.processed_at från den äldre Order Printer-appen. Du kan använda filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filtrera med order.transactions för statusen kind i Liquid-syntaxen med where, eller med looping och ett inbäddat if. Granska följande exempel.

{% 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" %} Transaktions-ID: {{ transaction.id }} Sort: {{ transaction.kind }} Belopp: {{ 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 Filtrera med order.transactions för statusen kind i Liquid-syntaxen med where, eller med looping och ett inbäddat if, som i följande exempel.
{% 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. Du kan definiera den som en variabel i början av mallen och referera till den flera gånger, som i följande exempel.
{% 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

LineItem-variabler

LineItem-variabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
fulfillable_quantity quantity - successfully_fulfilled_quantity
distribuerad kvantitet == successfully_fulfilled_quantity
namn Titel
product_title product.title
unit_discount kvantitet ? line_level_total_discount/kvantitet: 0
variant_title variant.title
vikt gram

Distributionsvariabler

distributionsvariabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
Datum created_at

Butiksvariabler

Shop-variabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
ägare account_owner.name
adress shop.address.address1
adress2 shop.address.address2
stad shop.address.city
land shop.address.country
country_code shop.address.country_code
provins shop.address.province
province_code shop.address.province_code
postnummer shop.address.zip

Adressvariabler

Adressvariabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
latitud Om variabeln address refererades till från attributet location så finns latitud och longitud tillgängliga för själva objektet location.
longitud Om variabeln address refererades till från attributet location så finns latitud och longitud tillgängliga för själva objektet location.

Återbetalningsvariabler

Återbetalningsvariabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
Datum Använd variabeln created_at. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-variabler

ShippingLine-variabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
current_price pris
pris original_price

Transaktionsvariabler

Följande transaktionsvariabler togs bort och kan inte bytas ut i Shopify Order Printer-appen:

  • authorization
  • message
  • test

Variantvariabler

variantvariabel
Variabel i den föråldrade Order Printer-appen Variabel i den nya Shopify Order Printer-appen
gram vikt

Metafältvariabler

Om du vill komma åt ett metafält måste du ange metafältets Namnrymd. Du behöver inte lägga till .value i variabeln. Mer information om definitioner för metafält.

Till exempel: istället för variabeln product.metafields.manufacturerid.value använder du variabeln product.metafields.custom.manufacturerid.

Se sidan Anpassade data i din Shopify-admin om du vill identifiera namnrymd-värden för varje metafält. Metafältdefinitioner grupperas efter objekt som de hänvisar till, till exempel produkter, produktvarianter eller ordrar.

Filtrera mappning

Filtrera mappning
Filtrera namn i den föråldrade Order Printer-appen Filtrera namn i den nya Shopify Order Printer-appen
files_url file_url
payment_method och payment_methods Använd fältet transaction.gateway_display_name för ordertransaktioner. Betalningsmetoder kategoriseras inte längre i specifika typer, som till exempel {credit card, debit card, bank transfer}. Den föråldrade Order Printer-appen mappade endast en liten delmängd av för närvarande fungerande betalnings-gateways till dessa kategorier. Betalnings-gateways hanterar de typer av betalningsmetoder som används av kunderna på deras sida.

Är du redo att börja sälja med Shopify?

Prova gratis