Referanse for varselsvariabler
Varsler som sendes ut fra butikken din gjengis med Liquid. Liquid er Shopifys enkle, brukervennlige programmeringsspråk. Det er det samme programmeringsspråket som temaene våre fra Theme Store er bygget med.
Hvis du vil redigere varslene som sendes fra butikken, kan du gjøre grunnleggende tilpasninger i varslingsmalene.
Hvis du trenger hjelp med mer avanserte endringer, eller gjøre endringer i egendefinerte varslingsmaler, kan du ta kontakt med fellesskapet på forumene våre, eller du kan leie inn en Shopify-ekspert for å gjøre tilpasningene for deg.
Her er en liste over Liquid-varslingsmaler som du kan tilpasse fra Shopify-administrator:
- Forlatt kasse
- Kontakt kunden
- Kundekontoinvitasjon
- Kundekontovelkomst
- Tilbakestilling av passord for kundekonto
- Faktura for utkastbestilling
- Oppfyllelsesforespørsel
- Gavekort opprettet
- Ny bestilling
- Ny bestilling (mobil)
- Bestillingsfaktura
- Bestilling avbrutt
- Bestillingsbekreftelse
- POS- og mobilkvittering
- Bestillingsrefusjon
- Fraktbekreftelse
- Fraktoppdatering
Alle maler i Shopify-administrator har tilgang til egenskapene i sin tilhørende bestilling.
Bestillingsegenskaper
Mange egenskaper for en bestilling er tilgjengelige direkte med Liquid, i maler og i ytterligere skript.
Egenskapene til en bestilling er tilgjengelige i følgende maler:
- Bestillingsbekreftelse
- Ny bestilling
- Ny bestilling (mobil)
- Bestillingsfaktura
- Fraktbekreftelse
- Fraktoppdatering
- Ytterligere skript
- Oppfyllelsesforespørsel
Egenskap | Beskrivelse |
---|---|
id |
En unik ID for bestillingen på systemnivå for internt bruk. Bruk følgende eksempel for å generere en kobling til bestillingen i administratordelen av butikken. I Ny bestilling-malen kan du for eksempel legge til følgende kode: <a href="{{ shop.url }}/admin/orders/{{ id }}">Vis bestilling</a> |
E-posten som er knyttet til bestillingen. | |
name |
Dette er vanligvis et nummertegn etterfulgt av Eksempel: #1004 |
order_name |
Samme som navn. |
order_number |
Butikkens unike bestillingsnummer, for eksempel 1004, uten nummer #-prefikset, eller et prefiks eller suffiks som er lagt til bestillings-ID-en av butikkeieren i butikkens innstillinger. Eksempel: 1004 |
created_at |
Datoen og klokkeslettet kunden opprettet bestillingen. Du kan formatere dette med datofilteret. Eksempel: 2009-05-30T17:43:51+02:00 |
payment_terms |
Betalingsvilkårene angir datoen betalingen for en bestilling forfaller til betaling. Finn ut hvordan du legger til betalingsvilkår på bestillingsfakturaer. For mer informasjon kan du se Liquid-referansen for payment_terms. |
tags | Returnerer en matrise med alle bestillingstaggene. Taggene returneres i alfabetisk rekkefølge. Se referansedokumentasjonen for Liquid for flere detaljer. |
transactions | Returnerer en matrise med transaksjoner fra bestillingen. |
tax_price |
Samlede avgifter for alle varene i bestillingen. |
tax_lines |
Avgifter brutt opp etter type beskatning:
|
tax_line.title |
Navnet på avgiften. Eksempler: QST eller MVA |
tax_line.price |
Beløpet. |
tax_line.rate |
Prisen. Hvis den er på 17,5 %, returneres 0,175. |
tax_line.rate_percentage |
Skattesatsen i lesbar form. Hvis prisen er 0,175, returneres 17,5. |
customer |
Kundeobjekt som inneholder egenskapene til kundens utdata. |
billing_address |
Fakturaadressen. |
billing_address.first_name |
Fornavnet til kunden. |
billing_address.last_name |
Etternavnet til kunden. |
billing_address.company |
Bedriftsnavn for fakturering. |
billing_address.phone |
Telefonnummer fra fakturaadressen. |
shop.name |
Navnet på butikken din. |
shop.phone |
Butikkens telefonnummer. |
subtotal_price |
Summen av bestillingens varelinjepriser etter at eventuelle varelinjerabatter eller handlekurvrabatter er trukket fra. Delsummen inkluderer ikke skatter (med mindre skatter er inkludert i prisene), fraktomkostninger eller tips. |
discounts |
En liste over rabatter. |
discounts_amount |
Rabattbeløpet som gjelder for alle rabatter. Eksempel: +$5,00 |
discounts_savings |
Summen av besparelser som skyldes alle rabatter. Eksempel: -$5.00 |
total_price |
Totalsum for bestillingen (delsum + fraktkostnad - fraktrabatt + avgift). |
financial_status |
Gjeldende betalingssttatus. En av: nil, pending , authorized , paid , voided , refunded . |
requires_shipping |
(boolsk) Er sann hvis det er minst én vare i bestillingen som krever levering. |
shipping_method.title |
Navnet på fraktprisen. Eksempel: Standardfrakt |
shipping_method.price |
Fraktprisen inkludert eventuell fraktrabatt. Eksempel |
shipping_price |
Fraktprisen. Eksempel |
shipping_address |
Leveringsadressen. |
shipping_address.first_name |
Fornavnet i leveringsadressen. |
shipping_address.company |
Bedriftsnavnet i leveringsadressen. |
shipping_address.phone |
Telefonnummeret i leveringsadressen. |
line_items |
Liste over alle linjevarer i bestillingen. |
item_count |
Summen over alle vareantallene. |
fulfillment_status |
Gjeldende innfrielsesstatus for bestillingen. En av: unfulfilled , partial , fulfilled . |
note |
Merknaden som er knyttet til bestillingen. Merknaden kan hentes fra kunden og/eller redigeres i bestillingsopplysning-skjermen i administrator-grensesnittet. |
attributes |
Eventuelle egenskaper som er knyttet til bestillingen. Eksempel |
referring_site |
Inneholder URL-adressen til referenten som brakte kunden til butikken din. Eksempel: |
landing_site |
Inneholder banen til landingsstedet som kunden har brukt. Dette var den første siden kunden så når vedkommende kom til butikken. Eksempel: |
landing_site_ref |
Ser på landingsstedet og trekker ut en referanseparameter fra den. Referanseparametre kan være: Hvis {% if landing_site_ref == 'my-tracking-token' %} Min handling ... {% endif %} |
cancelled |
(boolsk) Er sann hvis bestillingen har blitt kansellert. |
cancelled_at |
Tidspunktet da bestillingen ble kansellert. |
cancel_reason |
Årsaken som ble valgt ved kansellering av bestillingen. En av: inventory , customer , declined , fraud eller other . |
has_high_risks? |
Er sann hvis det er en høyrisikobestilling |
oversett=«nei»unike_gateways |
Returnerer en liste over unike betalingsleverandører på en bestilling. Hvis noen for eksempel betalte med Visa, Mastercard og kontanter, vil den returnerte listen være |
location (POS only) |
Viser den fysiske plasseringen til bestillingen. Det er flere lokalisasjonsegenskaper tilgjengelig, oppført her. Du kan konfigurere lokalisasjoner i Lokalisasjoner-området i administrator. |
order_status_url |
Returnerer koblingen til siden for bestillingsstatus for denne bestillingen. |
|
Liste over linjevarer som har blitt sluttført. |
|
Liste over varelinjer som ikke har blitt fullstendig sluttført. |
Egenskaper for bestillingsutkast
Egenskaper for bestillingsutkast er tilgjengelig på e-postmalen for bestillingsutkast-fakturaen, som varsler kundene om utestående fakturaer.
Egenskap | Beskrivelse |
---|---|
id |
En unik ID for bestillingsutkastet til intern bruk. |
invoice_url |
En kobling som kunden kan følge for å betale for fakturaen med Shopifys sikre utsjekking. |
reserve_inventory_until |
Datoen og klokkeslettet som linjevarene i utkastet er reservert frem til, for eksempel Du kan formatere datoer med Liquid-datofilteret. |
user |
Det siste personalmedlemmet som endret bestillingsutkastet. |
user.name |
Navnet på det siste personalmedlemmet som endret bestillingsutkastet. |
user.email |
E-postadressen til det siste personalmedlemmet som endret bestillingsutkastet. |
E-postadressen som er knyttet til bestillingsutkastet. | |
name |
Den unike number til bestillingsutkastet, som har et nummertegn foran # . |
number |
Det unike nummeret til bestillingsutkastet uten bestillingsprefikset eller -suffikset. |
created_at |
Datoen og klokkeslettet kunden opprettet bestillingsutkastet, for eksempel Du kan formatere datoer med Liquid-datofilteret. |
tags | Returnerer en matrise med alle bestillingstaggene. Taggene returneres i alfabetisk rekkefølge. Se referansedokumentasjonen for Liquid for flere detaljer. |
tax_price |
De kombinerte avgiftene på alle varene i bestillingsutkastet. |
tax_lines |
Skatter brutt ned etter type skatt: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %} |
tax_line.title |
Navnet på avgiften. Eksempler: QST eller MVA |
tax_line.price |
Avgiftsbeløpet. |
tax_line.rate |
Skattesatsen i desimalform. For eksempel vil en skattesats på 17,5 % returnere 0,175 . |
tax_line.rate_percentage |
Skattesatsen i prosent. For eksempel vil en prissats på 0,175 returnere 17,5 . |
customer |
Kundeobjekt som inneholder egenskapene til kundens utdata. |
billing_address |
Fakturaadressen for bestillingsutkastet. |
billing_address.first_name |
Kundens fornavn |
billing_address.last_name |
Kundens etternavn |
billing_address.company |
Firmanavnet i fakturaadressen. |
billing_address.phone |
Telefonnummeret i fakturaadressen. |
shop.name |
Navnet på butikken din. |
shop.phone |
Butikkens telefonnummer. |
subtotal_price |
Summen av bestillingsutkastets linjevare etter en hvilken som helst linjevarerabatt eller handlekurvrabatt er trukket fra. Avgifter er ikke inkludert i delsummen (med mindre avgifter er inkludert i prisene) eller fraktkostnadene. |
discounts |
En liste over rabatter. |
discounts_amount |
Beløp for rabatten som er lagt til av alle rabatter. Eksempel: +$5,00 |
discounts_savings |
Beløp for besparelsene forårsaket av alle rabatter. Eksempel: -$5.00 |
total_price |
Totalprisen for bestillingen (delsum + fraktkostnad – fraktrabatt + avgift). |
requires_shipping |
Returnerer true hvis det er minst én vare i bestillings utkastet som krever frakt. Returnerer false hvis ingen varer i bestillingsutkastet krever frakt. |
shipping_method.title |
Navnet på fraktprisen. Eksempel: Standardfrakt |
shipping_method.price |
Prisen på leveringsmetoden. Returnerer samme informasjon som shipping_price . |
shipping_price |
Fraktprisen. Du kan formatere dette beløpet med Liquid-pengefiltre. |
shipping_address |
Merk: I motsetning til i vanlige bestillinger, kan fraktadressen til et bestillingsutkast være ufullstendig. |
shipping_address.first_name |
Fornavnet i leveringsadressen. |
shipping_address.company |
Firmanavnet i leveringsadressen. |
shipping_address.phone |
Telefonnummeret i leveringsadressen. |
line_items |
En liste over alle linjevarene i bestillingsutkastet. |
item_count |
Summen av alle vareantallene i bestillingsutkastet. |
note |
Merknaden som er knyttet til bestillingen. Merknaden kan hentes fra kunden og redigeres i opplysningsskjermen til bestillingsutkastet i administrator-grensesnittet. |
location |
Den fysiske lokalisasjonen til bestillingen. Det er flere tilgjengelige lokalisasjonsegenskaper. Du kan konfigurere steder på plasseringer-siden i Shopify-administrator. |
Linjevare-egenskaper
Hver line
i listen over line_items
eller subtotal_line_items
har følgende egenskaper.
Egenskap | Beskrivelse |
---|---|
|
Liste over rabatter som er brukt på dette produktet (hver rabatt har egenskaper knyttet til tittel , kode , mengde , sparepenger og type ). |
|
(boolsk) Er sann hvis varen er en egendefinert linjevare for et bestillingsutkast. |
line.grams |
Vekten til en enkelt vare. |
line.image |
Returnerer URL-adressen til bildet som er tilknyttet denne varelinjen. Du kan også bruke img_url-filteret for å hente bestemte bildestørrelser, for eksempel {{ line.image | img_url: 'small' }}
|
line.line_price |
Prisen ganget med vareantallet. |
line.original_line_price |
Totalprisen for antall varer inkludert i varelinjen, før rabatter. |
line.final_line_price |
Totalprisen for alle varene i varelinjen, inkludert alle rabattbeløp på varelinjenivå. |
line.price |
Prisen for en enkelt vare. |
line.product.metafields |
Metafeltene på produktnivå. Bruk følgende syntaks: line.product.metafields.NAMESPACE.KEY |
line.product.title |
Produktnavnet. |
line.product.vendor |
Selgeren av varen. |
line.properties |
Returnerer en matrise med egendefinert informasjon for en vare. Varelinjeegenskaper bestemmes av kunden på produktsiden, før et produkt legges i handlekurven. |
line.quantity |
Antallet av den varen. |
line.requires_shipping |
(boolsk) Returnerer sann hvis varianten for varen har en avmerket boks på produktsiden der det står Dette er et fysisk produkt. |
line.selling_plan_allocation |
Returnerer et selling_plan_allocation -objekt, som beskriver hvordan en salgsplan som subscription påvirker varelinjen. |
line.taxable |
(boolsk) Er sann hvis varianten for varen har en avmerket boks på produktsiden der det står Belast skatt på dette produktet. |
line.title |
Navnet på produktet etterfulgt av en bindestrek etterfulgt av variantens navn. Variantnavnet inkluderes ikke når det er «Standard tittel». |
line.url |
Den relative URL-adressen til varelinjens variant. Den relative URL-adressen inkluderer ikke rot-URL-adressen til butikken (mystore.myshopify.com ). |
line.line_item.variant.barcode |
Strekkoden som er tilknyttet produktvarianten. |
line.variant.compare_at_price |
Sammenlign med-prisen knyttet til produktvarianten. |
line.variant.image |
Bildet for produktvarianten. Returnerer bare et bilde hvis det er et bestemt bilde tilordnet varianten i linjevaren. |
line.variant.metafields |
Metafeltene på variantnivå. Bruk følgende syntaks: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku |
SKU-en knyttet til produktvarianten. |
line.variant.title |
Alternativverdiene for varianten, adskilt med Eksempel: liten / rød |
line.refunded.quantity |
Antallet av en vare som skal refunderes. Du kan bruke denne egenskapen til å legge til en identifikator i refunderte varer i en bestilling. For eksempel: |
Refusjonsegenskaper
Disse ekstra egenskapene er tilgjengelige på e-postmalen for refusjoner. Denne e-postmalen brukes til å varsle kundene om at en refusjon (fullstendig eller delvis) har blitt brukt i bestillingen. Du kan bruke en hvilken som helst variabel som er tilgjengelig for e-postvarsel-malen for bestillinger i tillegg til følgende variabler:
Egenskap | Beskrivelse |
---|---|
amount |
Pengebeløpet som er refundert. |
refund_line_items |
En liste over varelinjer til refusjon som skal refunderes. |
Refunder_linje_varer-egenskaper
Hver refund_line
i listen over refund_line_items
har følgende egenskaper:
Egenskap | Beskrivelse |
---|---|
refund_line.line_item |
Linje_varen som blir refundert. Den har tilgang til alle av linje_varens-egenskaper. |
refund_line.quantity |
Antall linjevarer som skal refunderes. |
Innfrielsesegenskaper
Disse ekstra egenskapene er tilgjengelige i fraktbekreftelsen, fraktoppdateringen og e-postmaler for innfrielsesforespørsler.
Fraktbekreftelsen og fraktoppdateringen brukes til å varsle kundene om at noen eller alle varene i bestillingen har blitt sluttført eller oppdatert med ny fraktinformasjon.
E-postmalen Innfrielsesforespørsel brukes til tilpassede oppfyllelsestjenester som er definert i butikkadministrator. For å legge til en tilpasset oppfyllelsestjeneste kan du gå til Innstillinger > Frakt og bla ned til Oppfyllelse/Direktefrakting.
Egenskap | Beskrivelse |
---|---|
service_name |
Navnet på den tilpassede tjenesten som definert på Innstillinger > Frakt -siden. (Kun innfrielsesforespørsel) |
fulfillment.estimated_delivery_at |
En estimert leveringsdato basert på sporingsnummeret (hvis tilgjengelig) som tilbys av en av følgende budfirmaer: USPS, FedEx, UPS, Canada Post (kun Canada). Denne egenskapen er bare tilgjengelig når fraktpriser utregnet av budfirma er i bruk. |
fulfillment.fulfillment_line_items |
En liste over varelinjer til oppfylling som skal sluttføres. |
fulfillment.item_count |
Summen av antallet av en vare. Totalt antall varer som sluttføres. |
fulfillment.requires_shipping |
(boolsk) Er sann hvis denne innfrielsesforespørselen krever frakt. |
fulfillment.tracking_company |
Selskapet som utfører sporingen. |
fulfillment.tracking_numbers |
En liste med sporingsnumre. |
fulfillment.tracking_urls |
En liste over nettadresser for sporing |
|
En liste over varelinjer som skal oppfylles av denne bestemte egendefinerte oppfyllelsestjenesten. (Kun oppfyllelsesforespørsler) |
|
Totalt antall varer som skal innfris av denne forespørselen. (Kun innfrielsesforespørsel) |
Innfrielse_linje_vare-egenskaper
Hver fulfillment_line
i listen over fulfillment_line_items
har følgende egenskaper:
Egenskap | Beskrivelse |
---|---|
fulfillment_line.line_item |
Linje_varen som blir sluttført. Den har tilgang til alle linje_varens-egenskaper. |
fulfillment_line.quantity |
Antallet av linjevaren som sluttføres. |
Leveringsegenskaper
Egenskap | Beskrivelse |
---|---|
delivery_instructions |
Informasjon om lokal levering som skal deles med kunden. Denne informasjonen kontrolleres av Leveringsinformasjon-feltet i innstillingene for lokal levering. |
consolidated_estimated_delivery_time |
Informasjon om leveringsdatoer for bestillinger som kan deles med kunden. Denne informasjonen styres av innstillingen Behandlingstid som du har konfigurert på siden Frakt og leveranse. |
Rabattegenskaper
Det finnes to typer rabattegenskaper.
discount_applications
beskriver hvorfor og hvordan en vare ble rabattert.
discount_allocations
beskriver hvordan en bestemt rabatt påvirker en varelinje, og hvordan den reduserer prisen. Denne egenskapen brukes på varelinjenivå.
Du kan kombinere disse egenskapene for å vise rabattinformasjon på varelinje- eller bestillingsnivå.
Eksempel
Dette eksempelet sjekker om en rabatt er lagt til på varelinjen. Dersom rabatten ikke ble lagt til på bestillingsnivå (all
), vises rabattnavnet og -beløpet.
{% 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 ser kanskje slik ut:
SPRING5 (-$5.00)
Egenskaper for discount_allocation
Hver discount_allocation
i listen over discount_allocations
har følgende egenskaper:
Egenskap | Beskrivelse |
---|---|
discount_allocation.amount |
Hvor mye penger kunden sparte på en varelinje. Må legges inn i en løkke dersom du ønsker å tillate flere rabattkoder. |
discount_allocation.discount_application |
Tilleggelsen av rabatten som tilordner beløpet til varelinjen. |
Discount_application-egenskaper
Hver discount_application
i listen over discount_applications
har følgende egenskaper:
Egenskap | Beskrivelse |
---|---|
discount_application.target_selection |
Beskriver hvordan en rabatt velger varelinjene i handlekurven som skal rabatteres. En av:
|
discount_application.target_type |
Varetypen en rabatt gjelder for (line_item eller shipping_line ). |
discount_application.title |
Rabattnavnet som er synlig for kunden. Eksempler: Welcome10 eller CBBWQQAKYBYY |
discount_application.total_allocated_amount |
Totalbeløpet som prisen for en bestilling reduseres med av rabatten. |
discount_application.type |
Rabattypen. En av: automatic , discount_code , manual eller script . |
discount_application.value |
Verdien av rabatten. |
discount_application.value_type |
Verditypen til rabatten. En av: fixed_amount eller percentage . |
Egenskaper for e-postvarsel
Egenskap | Beskrivelse |
---|---|
shop.email_logo_url |
Nettadressen for logoen som er angitt i Tilpass e-postmaler-seksjonen i administratoren. |
shop.email_logo_width |
Logobredden (piksler) som er angitt i Tilpass e-postmaler-seksjonen i administratoren. |
shop.email_accent_color |
HEX-koden for aksentfargen som er angitt i Tilpass e-postmaler--seksjonen i administratoren. |