Overstappen van de Order Printer-app naar Shopify Order Printer

De Liquid-implementatie in Shopify Order Printer verschilt iets van de oorspronkelijke Order Printer. Als je je templates wil migreren, kopieer je de code van je bestaande templates handmatig naar de nieuwe app en breng je de noodzakelijke wijzigingen volgens deze gids aan. Aangepaste CSS die aan je templates wordt toegevoegd, moeten ook worden overgebracht en aangepast in de nieuwe app.

Opmerking

De templates, facturen en pakbonnen van de nieuwe Shopify Order Printer-app zijn zo gemaakt dat ze minder papier en inkt gebruiken en extra informatie bevatten. Voordat je je bestaande Order Printer-templates migreert, controleer je eerst of de nieuwe templates beter bij jouw behoeften passen.

Bestellingskenmerken worden verwijderd uit de algemene naamruimte

Als je bestellingskenmerken wil gebruiken, zet je er order. voor. Zo gebruik je billing_address voortaan in deze vorm: order.billing_address.

Voor het gemak zijn enkele veelgebruikte bestellingskenmerken nog steeds te gebruiken zonder het voorvoegsel order.:

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

Deze variabelen zijn als fulfillments én als order.fulfillments, enzovoort te gebruiken.

Opmerking

Je kunt zelf aliassen maken in de template met de Liquid-syntaxis {% assign fulfillments_count = order.fulfillments | size %} en ernaar verwijzen met de syntaxis {{ fulfillments_count }} in de tekst van de template.

Velden die gaan vervallen

In overeenstemming met het bijgewerkte Shopify-gegevensmodel zijn meerdere velden op verschillende objecten anders genoemd of vervallen, met een vervanging of een tijdelijke oplossing in de onderstaande alinea's. Als je templates deze velden gebruiken, vervang ze dan door de opgegeven vervangende velden of codefragmenten.

Bestelling

Verschillen in implementatie:

• line_items. Terugbetaalde orderregels zijn niet opgenomen in de line_items-collectie. Je kunt de terugbetaalde orderregels gebruiken via refunds.<each>.refunded_line_items.

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• credit_card. Gebruik betalingsgegevens op basis van elke transactie uit de bestelling: transactions.each.payment_details.
• current_shipping_price. Gebruik in plaats daarvan shipping_price.
• date. Gebruik in plaats daarvan created_at.
• gateways. Gebruik in plaats daarvan unique_gateways of transactions.<each>.gateway .
• order_currency. Gebruik in plaats daarvan currency.
• processed_at. Gebruik in plaats daarvan created_at.
• payment_transactions. Filter order.transactions voor soort en status in de Liquid-syntaxis met where of met lussen en een if erin.
• refund_transactions. Filter order.transactions voor soort en status in de Liquid-syntaxis met where of met lussen en een if erin.
• shipping_line. Gebruik shipping_methods | first.
• shipping_lines. Gebruik shipping_methods.
• show_line_item_taxes. Gebruik tax_lines.size > 0. Je kunt deze aan het begin van de template definiëren als een variabele en meerdere keren verwijzen: {% assign show_line_item_taxes = tax_lines.size > 0 %}.
• total_tax. Gebruik tax_price.
• total_paid. Gebruik net_payment.

LineItem

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• fulfillable_quantity. Gebruik quantity - successfully_fulfilled_quantity.
• fulfilled. Bereken quantity == successfully_fulfilled_quantity.
• name. Gebruik title.
• product_title. Gebruik product.title.
• unit_discount. Bereken de voorwaarde quantity ? total_iscount / quantity : 0.
• variant_title. Gebruik variant.title.
• weight. Gebruik grams.

Afhandeling

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• date. Gebruik created_at.

Shop

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• owner - Gebruik account_owner.name.

Verwijs de volgende velden als shop.address.<field_name>:

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

Adres

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• latitude - als address is verwezen vanuit location, zijn breedtegraad en lengtegraad beschikbaar op het location-object zelf.
• Longitude - als address is verwezen vanuit location, zijn breedtegraad en lengtegraad beschikbaar op het location-object zelf.

Terugbetaling

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• date. Gebruik created_at.

ShippingLine

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• current_price. Gebruik price.
• price. Gebruik original_price.

Transactie

Verwijderde velden:

• authorization
• message
• test

Variant

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• grams. Gebruik weight.

Vervallen filters

Vervallen velden waarvoor vervangingen beschikbaar zijn gesteld:

• files_url. Gebruik file_url.
• payment_method, payment_methods. Gebruik het veld transaction.gateway_display_name voor bestellingstransacties. Betaalmethoden worden niet meer ingedeeld in specifieke typen, zoals {credit card, debit card, bank transfer}. De oudere Order Printer wees slechts een kleine subset van momenteel werkende betalingsgateways toe voor deze categorieën. Betalingsgatewayproviders houden de soorten betaalmethoden die klanten gebruiken in eigen beheer.