Kodeverktøy for utskrevne kvitteringer for Shopify POS

Du kan tilpasse utskrevne kvitteringer ved hjelp av koderedigeringsprogrammet i Shopify-administrator. Filene som utgjør kvitteringene inneholder Liquid, Shopifys malspråk. Med koderedigeringsprogrammet kan du lage mer avanserte tilpasninger ved hjelp av HTML, CSS og Liquid enn med det visuelle redigeringsprogrammet.

Du kan endre kvitteringsmalen og seksjonsmalene som brukes på de utskrevne kvitteringene dine. Kvitteringer-malfilene er de typene kvitteringer du kan skrive ut i butikken. Seksjoner er deler av kvitteringene, som for eksempel topp- eller bunnteksten. Seksjoner kan gjenbrukes på flere kvitteringer.

Ting du bør vurdere før du bruker kodeverktøyet for kvitteringer

Før du bruker kodeverktøyet for kvitteringer, bør du vurdere følgende:

Tilgangsbegrensninger

• Du kan bare bruke kodeverktøyet fra Shopify-administratorpanelet på en stasjonær datamaskin.
• Kode-editoren er ikke tilgjengelig for noen POS-plasseringer i Italia.

Hvor endringer gjelder

• Kodeendringer du gjør, gjelder kun for den valgte lokalisasjonen.
• Tilpasninger i koderedigeringsprogrammet gjelder bare for POS Pro-steder. Hvis du bruker koderedigeringsprogrammet og har steder uten POS Pro, kan du bruke det visuelle redigeringsprogrammet til å tilpasse topp- og bunnteksten for disse stedene.
• Du kan tilpasse trykte kvitteringer som har en mal i koderedigeringsprogrammet, som salgskvitteringer, byttelapper, gavekortkvitteringer og kvitteringer for returer og bytter.

Kodespråk

• Filene som utgjør kvitteringene inneholder Liquid, Shopifys malspråk. Finn ut mer om bruk av Liquid.
• For å redigere malene i koderedigeringsprogrammet for kvitteringer, må du være kjent med HTML, CSS og Liquid. Shopify Temastøtte kan hjelpe med mindre justeringer innenfor rammen av Shopifys retningslinjer for design.

Begrensninger for tilpasning

• Du kan ikke forhåndsvise kvitteringer i ulike skriverstørrelser fra kode-editoren. For å forhåndsvise etter skriverstørrelse kan du bruke det visuelle redigeringsverktøyet.
• Produktbeskrivelser er ikke tilgjengelige som en variabel i kvitteringsmaler, og kan ikke legges til på utskrevne kvitteringer.

Malvedlikehold

• Hvis du tilpasser en kvittering med kvitteringens kode-editor, kan den eksisterende malen mangle nye egenskaper, for eksempel selling_plan_name. For å legge til de nyeste tilgjengelige egenskapene i malen din, må du tilbakestille kvitteringsmalen til standard. Når du tilbakestiller kvitteringsmaler til standard, fjernes alle tilpasninger du har gjort i dem. Noter ned den tilpassede koden før du tilbakestiller. Etter at du har tilbakestilt malen, må du legge til tilpasningene på nytt manuelt.

Få tilgang til koderedigeringsprogrammet

Du kan redigere malene ved hjelp av koderedigeringsprogrammet. Du må først bytte til å bruke koderedigeringsprogrammet fra det standard visuelle redigeringsprogrammet, og du kan når som helst bytte tilbake til det visuelle redigeringsprogrammet.

Trinnene for å bytte mellom redigeringsprogrammene er litt forskjellige avhengig av om alle POS-plasseringene dine er kvalifisert for koderedigeringsprogrammet, eller om bare noen av POS-plasseringene dine er kvalifiserte, for eksempel hvis noen av POS-plasseringene dine ikke bruker POS Pro eller er basert i Italia eller Frankrike.

Trinn:

Bruk egendefinerte filer i kvitteringsmalen

Du kan bruke filer, som bildeelementer, som du laster opp til Shopify-administratorpanelet, for å tilpasse trykte kvitteringer.

En fil må lastes opp til Shopify-administrator før den kan brukes i en utskrevet kvittering. Finn ut mer om filopplastinger.

Trinn:

1. Gå til Innhold > Filer i Shopify-administrator.

2. Ved siden av filen du vil inkludere i koden for den trykte kvitteringen, klikker du på for å kopiere koblingen.

3. Gå til koderedigeringsprogrammet.

4. Inkluder elementkoblingen i malen.

Tilbakestill kvitteringsmalen til standard

Du kan tilbakestille en kvitteringsmal til standardversjonen ved hjelp av koderedigeringsprogrammet.

Trinn:

Liquid-variabler tilgjengelig i koderedigeringsprogrammet for kvitteringer

Du kan bruke Liquid til å tilpasse malen for utskrevne kvitteringer og kvitteringstyper.

Følgende dataobjekter er tilgjengelige for koderedigeringsprogrammet for kvitteringer:

Kvitteringsobjekter

shop

location

order

return

gift_card

Bestillingsobjekt

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Returobjekt

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

Fraktgruppeobjekt

destination

products

Postobjekt

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Returpostobjekt

Inkluderer alt i postobjektet pluss følgende egenskaper:

return_reason

return_reason_note

Liquid-filtre tilgjengelig i kodeditor for kvitteringer

Du kan bruke Liquid-filtre til å justere informasjon i kvitteringsmalene. For eksempel kan du endre formateringen av valuta eller bruken av store og små bokstaver i spesifikk tekst, som en avgiftskode.

For å bruke et filter legger du til et vertikalstrek-tegn | og deretter filteret i Liquid-kodeblokken mellom doble krøllparenteser {{ }}. Filtre kan bare brukes på Liquid-kodeblokker.

I følgende eksempel justerer filteret avgiftskoden fra små til store bokstaver.

{{ tax_line.title | upcase }}

I kodeblokkeksempelet er product objektet, title er egenskapen og upcase er filteret som brukes. Filteret upcase endrer verdien for tax_line.title til store bokstaver. Hvis for eksempel tax_line.title har verdien Hst, endrer upcase-filteret verdien til HST.

Se Filtre-seksjonen fra Shopify Themes Liquid-referansen for mer informasjon om hvordan du bruker Liquid-filtre.

Følgende filtre er tilgjengelige i kodebehandleren for kvitteringer:

t

money

escape

barcode

qrcode

Eksempel på kodetilpasning av mal for utskrevne kvitteringer

Du kan bruke Liquid til å legge til betingede meldinger. Denne funksjonaliteten ligner på å lagre til ett enkelt sted med det visuelle redigeringsprogrammet. Hvis for eksempel bedriften din startet med ett enkelt sted og nå har flere nye steder, kan det være at du vil fremheve den opprinnelige butikken på de utskrevne kvitteringene.

Du kan legge til en egendefinert melding i header.liquid-malen i Sections-mappen i kodebehandleren, og bruke Liquid til å vise meldingen bare for flaggskipplasseringen.

Følgende kode sjekker navnet på plasseringen, i dette tilfellet den opprinnelige plasseringen kalt «Home», og viser meldingen «Velkommen til den opprinnelige butikken vår, åpnet i 1972.» hvis plasseringen samsvarer med navnet. Kvitteringer som skrives ut fra de andre plasseringene dine, viser i stedet meldingen «Velkommen til butikken vår.».

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Forhåndsvis kodeendringene i kodebehandleren

Du kan forhåndsvise endringene i de utskrevne kvitteringene i POS-koderedigeringsprogrammet i Shopify-administrator.

Avhengig av hvilken Liquid-fil som er valgt, fremhever forhåndsvisningsvinduet designet eller delen av kvitteringen som påvirkes av filen. Som standard viser forhåndsvisningsvinduet innholdet for den nyeste POS-bestillingen din. Du kan velge en bestemt bestilling som skal brukes som kvitteringsinnhold i forhåndsvisningsvinduet for alle Liquid-filer, unntatt gift-card.liquid-filen, som bare viser de ulike plasseringene som valgbare forhåndsvisningsalternativer.

Trinn: