Kodredigerare för utskrivna kvitton för Shopify kassasystem

Du kan anpassa dina utskrivna kvitton med hjälp av kodredigeraren i din Shopify-admin. Filerna som dina kvitton består av innehåller Liquid, Shopifys mallspråk. Med kodredigeraren kan du skapa mer avancerade anpassningar med HTML, CSS och Liquid än med den visuella redigeraren.

Du kan ändra kvittomallen och avsnittsmallarna som används på dina utskrivna kvitton. Mallfilerna för Kvitton är de typer av kvitton som du kan skriva ut i din butik. Avsnitt är delar av kvittona, till exempel sidhuvudet eller sidfoten. Avsnitt kan återanvändas av flera kvitton.

Att tänka på när du använder kodredigeraren för kvitton

Innan du använder kodredigeraren för kvitton bör du granska följande punkter:

Åtkomstbegränsningar

• Du kan endast använda kodredigeraren från din Shopify admin på en dator.
• Kodredigeraren är inte tillgänglig för några kassasystemsplatser i Italien.

Var ändringar tillämpas

• Kodändringar som du gör gäller endast för den valda platsen.
• Anpassningar i kodredigeraren gäller endast för POS Pro-platser. Om du använder kodredigeraren och har platser utan POS Pro kan du använda den visuella redigeraren för att anpassa sidhuvudet och sidfoten för dessa platser.
• Du kan anpassa utskrivna kvitton som har en mall i kodredigeraren, till exempel försäljningskvitton, gåvokvitton, presentkortskvitton samt kvitton för returer och byten.

Kodspråk

• Filerna som dina kvitton består av innehåller Liquid, Shopifys mallspråk. Mer information om att använda Liquid.
• För att redigera mallarna i kvittokodredigeraren måste du vara bekant med HTML, CSS och Liquid. Shopifys temasupport kan hjälpa till med mindre justeringar inom ramen för Shopifys designpolicy.

Begränsningar för anpassning

• Du kan inte förhandsgranska kvitton i olika skrivarstorlekar från kodredigeraren. Använd den visuella redigeraren om du vill förhandsgranska efter skrivarstorlek.
• Produktbeskrivningar är inte tillgängliga som en variabel i kvittomallar och kan inte läggas till på utskrivna kvitton.

Mallunderhåll

• Om du anpassar ett kvitto med kodredigeraren för kvitton kan din befintliga mall sakna nya egenskaper, till exempel selling_plan_name. För att lägga till de senast tillgängliga egenskaperna i din mall måste du återställa din kvittomall till standard. Om du återställer kvittomallar till standard tas alla anpassningar du har gjort bort. Anteckna din anpassade kod innan du återställer. När du har återställt mallen måste du tillämpa dina anpassningar manuellt igen.

Komma åt kodredigeraren

Du kan redigera dina mallar med kodredigeraren. Du måste först byta till att använda kodredigeraren från den visuella standardredigeraren, och du kan när som helst byta tillbaka till den visuella redigeraren.

Stegen för att byta mellan redigerarna skiljer sig något åt beroende på om alla dina kassasystemsplatser är kvalificerade för kodsredigeraren, eller om endast vissa av dina kassasystemsplatser är kvalificerade, till exempel om några av dina kassasystemsplatser inte använder POS Pro eller är baserade i Italien eller Frankrike.

Steg:

Använda anpassade filer i kvittomallen

Du kan använda filer, till exempel bildresurser, som du laddar upp till din Shopify admin för att anpassa dina utskrivna kvitton.

En fil måste laddas upp till din Shopify-admin innan den kan användas i ett utskrivet kvitto. Mer information om filuppladdningar.

Steg:

1. Gå till Innehåll > Filer i din Shopify-admin.

2. Bredvid filen som du vill inkludera i koden för ditt utskrivna kvitto klickar du på för att kopiera länken.

3. Gå till kodredigeraren.

4. Inkludera resurslänken i din mall.

Återställa kvittomallen till standard

Du kan återställa en kvittomall till standardversionen med hjälp av kodredigeraren.

Steg:

Liquid-variabler tillgängliga i kodredigeraren för kvitton

Du kan använda Liquid för att anpassa din mall för utskrivna kvitton och kvittotyper.

Följande dataobjekt är tillgängliga för kodredigeraren för kvitton:

Kvittoobjekt

shop

location

order

return

gift_card

Orderobjekt

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

Fraktgruppsobjekt

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

Innehåller allt i postobjektet plus följande egenskaper:

return_reason

return_reason_note

Liquid-filter tillgängliga i kvittokodsredigeraren

Du kan använda Liquid-filter för att justera information i dina kvittomallar. Du kan till exempel ändra valutaformatering eller skiftläget för en specifik text, såsom en momskod.

För att tillämpa ett filter lägger du till ett vertikalstreck | och sedan filtret i Liquid-kodblocket mellan dubbla klammerparenteser {{ }}. Filter kan endast tillämpas på Liquid-kodblock.

I följande exempel justerar filtret momskoden från gemener till versaler.

{{ tax_line.title | upcase }}

I exempelkodblocket är product objektet, title dess egenskap och upcase det tillämpade filtret. Filtret upcase ändrar värdet för tax_line.title till versaler. Om till exempel tax_line.title har värdet Hst ändrar filtret upcase värdet till HST.

Se avsnittet Filter i Liquid-referensen för Shopify-teman för information om hur du använder Liquid-filter.

Följande filter är tillgängliga i kodredigeraren för kvitton:

t

money

escape

barcode

qrcode

Exempel på kodanpassning av mall för utskrivna kvitton

Du kan använda Liquid för att lägga till villkorliga meddelanden. Denna funktionalitet liknar att spara till en enskild plats med den visuella redigeraren. Om din verksamhet till exempel startade med en enda plats och du nu har flera nya platser vill du kanske markera din ursprungliga butik på dina utskrivna kvitton.

Du kan lägga till ett anpassat meddelande i mallen header.liquid i mappen Avsnitt i kodredigeraren och använda Liquid för att visa meddelandet endast för din flaggskeppsplats.

Följande kod kontrollerar namnet på platsen, i det här fallet din ursprungliga plats som heter ”Home”, och visar meddelandet ”Välkommen till vår ursprungliga butik, öppnad 1972.” om platsen matchar namnet. Kvitton som skrivs ut från dina andra platser visar meddelandet ”Välkommen till vår butik.” istället.

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

Förhandsgranska kodändringar i kodredigeraren

Du kan förhandsgranska ändringarna av dina utskrivna kvitton i kodredigeraren för kassasystem i Shopify-admin.

Beroende på vilken Liquid-fil som är vald markerar förhandsgranskningsfönstret den design eller det avsnitt av kvittot som påverkas av filen. Som standard visar förhandsgranskningsfönstret innehållet för din senaste POS-order. Du kan välja en specifik order att använda som kvittoinnehåll i förhandsgranskningsfönstret för alla Liquid-filer utom filen gift-card.liquid, som endast visar de olika platserna som valbara förhandsgranskningsalternativ.

Steg: