Referens för aviseringsvariabler

Aviseringar som skickats ut från din butik återges med hjälp av Liquid. Liquid är Shopifys enkla och användarvänliga programmeringsspråk. Det är samma programmeringsspråk som våra teman från Temabutiken bygger på.

Om du vill redigera aviseringarna som skickas från din butik kan du göra grundläggande anpassningar i dina aviseringsmallar.

Om du vill ha hjälp med mer avancerade ändringar eller med att göra ändringar i anpassade aviseringsmallar, kan du kontakta communityn på våra forum eller så kan du även anlita en Shopify Expert som kan göra dina anpassningar åt dig.

Här är en lista över mallar för Liquid-aviseringar som du kan anpassa från din Shopify-administratören:

  • Övergiven utcheckningskassa
  • Kontakta kund
  • Kundkontoinbjudan
  • Välkomstmeddelande till kundkonto
  • Återställning av lösenord till kundkonto
  • Utkast till orderfaktura
  • Distributionsbegäran
  • Presentkort skapat
  • Ny order
  • Ny beställning (mobil)
  • Order annullerad
  • Orderbekräftelse
  • POS och mobila kvittenser
  • Återbetalning av order
  • Leveransbekräftelse
  • Leveransuppdatering

Alla mallar Shopify-administratören har tillgång till egenskaperna för deras motsvarande order.

Orderegenskaper

Många egenskaper för en order är tillgängliga direkt med hjälp av Liquid i mallar och i ytterligare skript.

Egenskaperna för en order finns i följande mallar:

  • Orderbekräftelse
  • Ny order
  • Ny beställning (mobil)
  • Leveransbekräftelse
  • Leveransuppdatering
  • Ytterligare skript
  • Distributionsbegäran

Obs! Till skillnad från de flesta andra Liquid-objekt, benämns inte orderobjektet med namn i e-postmallar. Till exempel, istället för att använda {{ order.shipping_method.title }} i din e-postmall för orderbekräftelse bör du använda {{ shipping_method.title }}. För SMS-meddelanden måste dock orderegenskaper som vanligt föregås av order.

Beskrivning av orderegenskaper
Egenskap Beskrivning
id

Ett systemomfattande unikt ID för ordern för internt bruk. Använd följande exempel för att skapa en länk till ordern i admin-avsnittet i din butik. I din mall Ny order kan du till exempel lägga till följande kod:

<a href="{{ shop.url }}/admin/orders/{{ id }}">Visa order</a>
email
E-posten som hör samman med ordern.
name

Vanligtvis är detta en pundsymbol som följs av order_number.

Exempel: #1004

order_name
Samma som namnet.
order_number

Butiksspecifikt nummer för ordern, utan pundprefixet #, eller ett prefix eller suffix som butiksägaren har lagt till order-ID i sina butiksinställningar.

Exempel: 1004

created_at

Det datum och den tidpunkt då kunden skapade ordern. Du kan formatera det här med hjälp av datumfiltret.

Exempel: 2009-05-30T17:43:51+02:00

tags Returnerar alla olika ordertaggar. Taggarna returneras i alfabetisk ordning. Se vår referensdokumentation för Liquid för ytterligare information.
transactions Returnerar alla transaktioner från ordern.
tax_price
De sammanlagda skatterna för alla varor i ordern.
tax_lines

Skatter uppdelade efter typ av skatt:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Namnet på skatten.

Exempel: QST eller moms

tax_line.price
Beloppet.
tax_line.rate
Priset. Den kommer att returnera 0,175 om det är 17,5%.
tax_line.rate_percentage
Skattesats i mänskligt läsbar form. Den kommer att returnera 17,5 om priset är 0,175.
customer
Kundobjekt som innehåller attribut för kunderna.
billing_address
Faktureringsadressen.
billing_address.first_name
Kundens förnamn.
billing_address.last_name
Kundens efternamn.
billing_address.company
Företagsnamn för fakturering.
billing_address.phone
Telefonnummer från faktureringsadressen.
shop.name
Namnet på din butik.
shop.phone
Telefonnumret till din butik.
subtotal_price
Summan av orderns radartikelpriser efter att eventuell radartikelrabatt eller varukorgsrabatt har dragits av. Delsumman inkluderar inte skatter (om inte skatt ingår i priserna), leveranskostnader eller dricks.
discounts
En lista över rabatter.
discounts_amount

Rabattbeloppet som tillämpas för alla rabatter.

Exempel: +5,00 USD

discounts_savings

Belopp för besparingarna orsakade av alla rabatter.

Exempel: - 5,00 USD

total_price

Totalbelopp för ordern (delsumma + fraktkostnad - fraktrabatt + skatt).

financial_status
Den aktuella betalningsstatusen. En av: noll, väntande, godkänd, betald, ogiltigförklarad, återbetald.
requires_shipping
(boolean) Returnerar sant om det finns minst en artikel i den order som kräver frakt.
shipping_method.title

Fraktkostnadens namn.

Exempel: Standardfrakt

shipping_method.price

Fraktpriset inklusive eventuell fraktrabatt.

Exempel: {{ shipping_method.price | money }}

shipping_price

Fraktpriset.

Exempel: {{ shipping_price | money }}

shipping_address
Leveransadressen.
shipping_address.first_name
Förnamnet för leveransadressen.
shipping_address.company
Företagsnamnet för leveransadressen.
shipping_address.phone
Telefonnummer från leveransadressen.
line_items
Lista över alla Radobjekt i ordern.
item_count
Summan av alla artikelkvantiteter.
fulfillment_status
Orderns aktuella distributionsstatus. En av: ej distribuerad, delvis distribuerad, distribuerad.
note
Anteckningen som bifogas ordern. Anteckningen kan erhållas från kunden och/eller redigeras i orderinformationsfönstret i ditt admin-gränssnitt.
attributes

Alla attribut som bifogades till ordern.

Exempel: {{ attributes.gift-note }}

referring_site

Innehåller URL till hänvisaren som förde kunden till din butik.

Exempel: https://www.google.com/?s=great+products

landing_site

Innehåller sökvägen till landningsplatsen som kunden använde. Detta är den första sidan som kunden såg när han/hon nådde butiken.

Exempel: /products/great-product?ref=my-tracking-token

landing_site_ref

Tittar på landningsplatsen och extraherar en referensparameter från den. Referensparametrar kan vara: ref, source, r.

Om landing_site is /products/great-product?ref=my-tracking-token så är landing_site_ref my-tracking-token. Du kan utföra en viss åtgärd om din ref är lika med ett visst värde:

{% if landing_site_ref == 'my-tracking-token' %} Min åtgärd... {% endif %} 
cancelled
(boolean) Returnerar sant om ordern har annullerats.
cancelled_at
Tidspunkten när ordern annullerades.
cancel_reason
Anledningen som valdes vid annullering av ordern. En av: lager, kund , nekad , bedrägeri eller annat.
has_high_risks?

Returnerar sant om ordern har hög risk

translate="no"
unique_gateways

Returnerar en lista över unika betalningsleverantör för en order. Till exempel, om någon betalade med ett Visa-kort, ett MasterCard och kontanter, skulle den returnerade listan vara shopify_payments, cash.

location (POS only)

Visar orderns fysiska plats. Det finns flera tillgängliga platsegenskaper, listade här. Du kan konfigurera platser i Platser i administratören.

order_status_url

Returnerar länken till orderstatussidan för den här ordern.

fulfilled_line_items
(borttagen)
Lista över Radobjekt som har distribuerats.
unfulfilled_line_items
(borttagen)
Lista över Radartiklar som inte har distribuerats fullt ut.

Egenskaper för orderutkast

Egenskaper för orderutkast finns tillgängliga i e-postmallen för Utkast för orderfaktura som meddelar dina kunder om utestående fakturor.

OBS! Du kan inte skicka aviseringar om orderutkast via SMS.

Beskrivning av egenskaper för orderutkast
Egenskap Beskrivning
id
Ett unikt ID för orderutkastet för internt bruk.
invoice_url
En länk som kunden kan följa för att betala fakturan med hjälp av Shopifys säkra kassa.
reserve_inventory_until

Datum och tid som radartiklarna i utkastet är reserverade till, till exempel 2015-05-30T17:43:51+02:00.

Du kan formatera datum med hjälp av datumfiltret för Liquid.

user
Den personal som senast ändrade orderutkastet.
user.name
Namnet på den personal som senast ändrade orderutkastet.
user.email
E-postadress för den personal som senast ändrade orderutkastet.
email
E-postadressen som är kopplad till orderutkastet.
name
Den unika number för orderutkastet som föregås av ett nummertecken #.
number
Det unika numret på orderutkastet utan orderns prefix eller suffix.
created_at

Det datum och den tidpunkt då kunden skapade orderutkastet, till exempel 2009-05-30T17:43:51+02:00.

Du kan formatera datum med hjälp av datumfiltret för Liquid.

tags Returnerar alla olika ordertaggar. Taggarna returneras i alfabetisk ordning. Se vår referensdokumentation för Liquid för ytterligare information.
tax_price
De sammanlagda skatterna för alla varor i orderutkastet.
tax_lines

Skatter uppdelade efter typ av skatt:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Namnet på skatten.

Exempel: QST eller moms

tax_line.price
Skattebeloppet.
tax_line.rate
Skattesats i decimalform. Till exempel kommer en skattesats på 17,5% att returnera 0.175.
tax_line.rate_percentage
Skattesatsen i procentform. Till exempel kommer en sats på 0,175 att returnera 17.5.
customer
Kundobjekt som innehåller attribut för kunderna.
billing_address
Faktureringsadressen för orderutkastet.
billing_address.first_name
Kundens förnamn.
billing_address.last_name
Kundens efternamn.
billing_address.company
Företagsnamnet i faktureringsadressen.
billing_address.phone
Telefonnumret i faktureringsadressen.
shop.name
Namnet på din butik.
shop.phone
Telefonnumret till din butik.
subtotal_price
Summan av orderns radartikelpriser efter eventuell rabatt på radartikel eller varukorgsrabatt har dragits av. Delsumman inkluderar inte skatter (om inte skatt ingår i priserna) eller fraktkostnader.
discounts
En lista över rabatter.
discounts_amount

Rabattbelopp som tillämpas för alla rabatter.

Exempel: +5,00 USD

discounts_savings

Belopp för besparingarna orsakade av alla rabatter.

Exempel: - 5,00 USD

total_price
Det totala priset för ordern (delsumma + fraktkostnad - rabattrabatt + skatt).
requires_shipping
Returnerar true if det finns minst en artikel i orderutkastet som kräver frakt. Returnerar false om inga varor i orderutkastet kräver frakt.
shipping_method.title

Fraktkostnadens namn.

Exempel: Standardfrakt

shipping_method.price
Priset för fraktmetoden. Returnerar samma information som shipping_price.
shipping_price

Fraktpriset.

Du kan formatera det här beloppet med hjälp av pengafilter för Liquid.

shipping_address

Leveransadressen.

OBS! Till skillnad från i vanliga beställningar kan ett orderutkasts leveransadress vara ofullständig.

shipping_address.first_name
Förnamnet för leveransadressen.
shipping_address.company
Företagsnamnet i leveransadressen.
shipping_address.phone
Telefonnumret i leveransadressen.
line_items
En lista över alla radobjekt i orderutkastet.
item_count
Summan av alla artikelkvantiteter i orderutkastet.
note
Anteckningen om bifogas orderutkastet. Anteckningen kan erhållas från kunden och även redigerats i orderinformationsfönstret i ditt admin-gränssnitt.
location

Orderns fysiskt plats. Det finns flera platsegenskaper tillgängliga.

Du kan konfigurera platser på sidan Platser i din Shopify-admin.

Postegenskaper

Varje line i listan över line_items eller subtotal_line_items har följande egenskaper.

Beskrivning av egenskaper för radobjekt
Egenskap Beskrivning
line.applied_discounts
(Endast POS och orderutkast)
Lista över rabatter som tillämpas på denna artikel (varje rabatt har egenskaperna titel, kod, kvantitet, besparingar och typ).
line.custom
(Endast orderutkast)
(boolean) Returnerar sant om artikeln är en anpassad radartikel för ett orderutkast.
line.grams
Vikt för en enskild vara.
line.image
Returnerar URL för den bild som är associerad med den här radartikeln. Du kan även använda filtret img_url för att få specifika bildstorlekar, till exempel {{ line.image | img_url: 'small' }}
line.line_price
Priset multiplicerat med kvantiteten för den artikeln.
line.original_line_price
Det sammanlagda priset för antalet artiklar som ingår i raden, innan rabatter tillämpades.
line.final_line_price
Det sammanlagda priset för alla artiklar i radartikeln, inklusive alla rabattbelopp på radnivå.
line.price
Priset för en enskild vara.
line.product.title
Produktens namn.
line.product.vendor
Leverantören för artikeln.
line.properties
Returnerar anpassad information för en artikel. Egenskaper för radartiklar anges av kunden på produktsidan innan de lägger till en produkt i varukorgen.
line.quantity
Kvantitet för den artikeln.
line.requires_shipping
(boolean) Returnerar sant om varianten för artikeln har kryssrutan Detta är en fysisk produkt markerad på produktsidan.
line.selling_plan_allocation
Returnerar ett selling_plan_allocation-objekt, som beskriver hur en försäljningsplan såsom en prenumeration påverkar radartikeln.
line.taxable
(boolean) Returnerar sant om varianten för artikeln har kryssrutan "debitera skatt för den här produkten" markerad på produktsidan.
line.title
Namnet på produkten följt av ett bindestreck följt namnet på varianten. Variantens namn ingår inte när det är "Standardtitel".
line.url
Den relativa URL:en för radartikelns variant. Den relativa URL:en innehåller inte din butiks rot-URL (mystore.myshopify.com).
line.variant.barcode
Streckkoden associerad med produktvarianten.
line.variant.compare_at_price
Jämförpriset som är associerat med produktvarianten.
line.variant.image
Bild för produktvarianten. Returnerar bara en bild om det finns en specifik bild tilldelad till varianten i radartikeln.
line.variant.sku
SKU:n som är associerad med produktvarianten.
line.variant.title

Variantens alternativvärden, sammanfogade med /-tecken.

Exempel: small / röd

Egenskaper för återbetalning

Dessa ytterligare egenskaper finns tillgängliga i e-postmallen för Återbetalning. Den här e-postmallen används för att meddela dina kunder att en återbetalning (fullständig eller delvis) har tillämpats på deras order. Du kan använda alla variabler som finns tillgängliga för Orderaviseringsmallen, utöver följande variabler:

Beskrivning av återbetalningsegenskaper
Egenskap Beskrivning
amount
Beloppet som återbetalas.
refund_line_items
En lista över radartiklarna för återbetalning som ska återbetalas.

Egenskaper för Refund_line_item

Varje refund_line i listan över refund_line_items har följande egenskaper:

Beskrivning av återbetalningsegenskaper för radartiklar
Egenskap Beskrivning
refund_line.line_item
Den line_item som har återbetalats. Detta har tillgång till alla egenskaper för line_items.
refund_line.quantity
Kvantiteten på radartikeln som ska återbetalas.

Egenskaper för distribution

Dessa ytterligare egenskaper finns i Leveransbekräftelsen, Leveransuppdateringen och e-postmallar för Distributionsförfrågan.

Leveransbekräftelsen och Leveransdateringen används för att meddela dina kunder att vissa eller alla varor i deras order har distribuerats eller uppdaterats med ny leveransinformation.

E-postmallen för Distributionsförfrågan används för en anpassad distributionstjänst som definieras i din butiksadministratör. För att lägga till en anpassad distributionstjänst går du till Inställningar > leverans och bläddrar ner till Distribution/Dropshipping.

Beskrivning av egenskaper för distribution
Egenskap Beskrivning
service_name
Namnet på den anpassade tjänsten som den definieras i Inställningar > Leverans sidan. (Endast distributionsförfrågan)
fulfillment.estimated_delivery_at
Ett beräknat leveransdatum baserat på spårningsnumret (om tillgängligt) som tillhandahålls av en av följande transportörer: USPS, FedEx, UPS, Canada Post (endast Kanada). Den här egenskapen är endast tillgänglig när priser beräknade av bud används.
fulfillment.fulfillment_line_items
En lista över distributionsradartiklar som ska distribueras.
fulfillment.item_count
Summan av alla artikelkvantiteter. Det totala antalet artiklar som ska distribueras.
fulfillment.requires_shipping
(boolean) Returnerar sant om denna distributionsförfrågan kräver frakt.
fulfillment.tracking_company
Företaget som spårar.
fulfillment.tracking_numbers
En lista med spårningsnummer.
fulfillment.tracking_urls
En lista med spårningsadresser.
items_to_fulfill
(borttagen)
En lista över radartiklar som ska distribueras av den här särskilda anpassade distributionstjänsten. (Endast distributionsförfrågan)
items_to_fulfill_count
(borttagen)
Det totala antalet artiklar som denna förfrågan ska distribuera. (Endast distributionsförfrågan)

Egenskaper för Fulfillment_line_item

Varje fulfillment_line i listan över fulfillment_line_items har följande egenskaper.

Beskrivning av egenskaper för distribution av radartiklar
Egenskap Beskrivning
fulfillment_line.line_item
Line_item distribueras. Detta har tillgång till alla egenskaper för line_item.
fulfillment_line.quantity
Kvantiteten av den radartikel som distribueras.

Leveransegenskaper

Beskrivning av leveransegenskaper
Egenskap Beskrivning
delivery_instructions
Lokal leveransinformation att dela med kunden. Den här informationen styrs av fältet Leveransinformation i dina lokala leveransinställningar.

Rabattegenskaper

Det finns två typer av rabattegenskaper.

discount_applications beskriv varför och hur en artikel rabatterades.

discount_allocations beskriv hur en viss rabatt påverkar en radartikel och hur den sänker priset. Du bör använda den här egenskapen på radartikelnivå.

Du kan kombinera dessa egenskaper för att visa rabattinformation på radartikel- eller ordernivå.

Exempel

Det här exemplet kontrollerar om en rabatt har tillämpats på radartikeln. Rabattnamnet och beloppet visas om rabatten inte tillämpades på ordernivån (all).

{% if line.discount_allocations %}
    {% for discount_allocation in line.discount_allocations %}
        {% if discount_allocation.discount_application.target_selection != 'all' %}
            {{ discount_allocation.discount_application.title | upcase }}
            (-{{ discount_allocation.amount | money }})
        {% endif %}
    {% endfor %}
{% endif %}

Resultatet kan se ut så här:

SPRING5 (-$5.00)

Discount_allocation-egenskaper

Varje discount_allocation i listan över discount_allocations har följande egenskaper.

Beskrivning av egenskaper för discount_allocation
Egenskap Beskrivning
discount_allocation.amount
Beloppet som kunden sparar på en radartikel. Måste anges i en loop om du vill tillåta flera rabattkoder.
discount_allocation.discount_application
Rabattapplikationen som fördelar beloppet på radartikeln.

Egenskaper för discount_application

Varje discount_application i listan över discount_applications har följande egenskaper.

Beskrivning av egenskaper för discount_application
Egenskap Beskrivning
discount_application.target_selection

Beskriver hur en rabatt väljer radartiklar i varukorgen som ska rabatteras. En av:

  • alla: Rabatten gäller för alla radartiklar.
  • berättigad: Rabatten gäller för en viss delmängd av radartiklar, som ofta definieras av ett villkor.
  • specifik: Rabatten gäller för en specifikt vald radartikel eller leveransrad.
discount_application.target_type
Den typ av artikel som en rabatt gäller för (line_item eller shipping_line).
discount_application.title

Namnet på rabatten som kunden ser.

Exempel: Welcome10 eller CBBWQQAKYBYY

discount_application.total_allocated_amount
Det totala beloppet som priset för en order minskas med av rabatten.
discount_application.type
Rabattyp. En av: automatisk, discount_code, manuell eller skript.
discount_application.value
Rabattens värde.
discount_application.value_type
Rabattens värdetyp. En av: fixed_amount eller procentandel.

Egenskaper för e-postavisering

Beskrivning av egenskaper för e-postavisering
Egenskap Beskrivning
shop.email_logo_url
Webbadressen för logotypen som anges i avsnittet Anpassa e-postmallar på administratörskontot.
shop.email_logo_width
Logotypbredden (pixlar) som anges i avsnittet Anpassa e-postmallar på administratörskontot.
shop.email_accent_color
HEX-koden för den accentfärg som anges i avsnittet Anpassa e-postmallar på administratörskontot.

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

Prova gratis