Naslag meldingsvariabelen

Meldingen die vanuit je winkel worden verzonden, worden weergegeven met behulp van Liquid. Liquid is de eenvoudige, gebruiksvriendelijke programmeertaal van Shopify. Het is dezelfde programmeertaal waarop thema's uit de Theme Store zijn gebaseerd.

Als je de meldingen wilt bewerken die vanuit je winkel worden verzonden, kun je basisaanpassingen uitvoeren in je meldingstemplates.

Voor hulp bij geavanceerdere wijzigingen of om wijzigingen in aangepaste meldingstemplates aan te brengen, kun je op onze forums contact opnemen met de community of je huurt ook een Shopify-expert in om je aanpassingen uit te voeren.

Hier is een lijst met Liquid-meldingstemplates die je via het Shopify-beheercentrum kunt aanpassen:

  • Afgebroken checkouts
  • Contact opnemen met de klant
  • Uitnodiging voor klantaccount
  • Verwelkoming klantaccount
  • Wachtwoord van klantaccount opnieuw instellen
  • Conceptbestellingsfactuur
  • Verzoek afhandelen
  • Cadeaubon gemaakt
  • Nieuwe bestelling
  • Nieuwe bestelling (mobiel)
  • Factuur van bestelling
  • Bestelling geannuleerd
  • Bestelbevestiging
  • POS en mobiele ontvangst
  • Terugbetaling van bestelling
  • Verzendgegevens
  • Verzendingsupdate

Alle templates in het Shopify-beheercentrum hebben toegang tot de eigenschappen van hun bijbehorende bestelling.

Besteleigenschappen

Veel eigenschappen van een bestelling zijn direct beschikbaar via Liquid, in templates en in aanvullende scripts.

De eigenschappen van een bestelling zijn beschikbaar in de volgende templates:

  • Bestelbevestiging
  • Nieuwe bestelling
  • Nieuwe bestelling (mobiel)
  • Factuur van bestelling
  • Verzendgegevens
  • Verzendingsupdate
  • Aanvullende scripts
  • Verzoek afhandelen
Beschrijving van de besteleigenschappen
Eigenschappen Beschrijving
id

Een systeembrede, unieke ID van de bestelling voor intern gebruik. Gebruik het volgende voorbeeld om een link naar de bestelling te genereren in het beheergedeelte van je winkel. In het sjabloon Nieuwe bestelling kun je de volgende code toevoegen:

<a href="{{ shop.url }}/admin/orders/{{ id }}">Bestelling bekijken</a>
email
De e-mail die aan de bestelling is gekoppeld.
name

Meestal is dit een hekje gevolgd door het order_number.

Voorbeeld: #1004

order_name
Hetzelfde als de naam.
order_number

Voor de winkel uniek nummer van de bestelling, zonder het voorvoegsel #, of een voorvoegsel of achtervoegsel dat de winkeleigenaar aan de bestellings-ID heeft toegevoegd in hun winkelvoorkeuren.

Bijvoorbeeld: 1004.

created_at

De datum en tijd waarop de klant de bestelling heeft gemaakt. Je kunt dit opmaken met behulp van het datumfilter.

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

payment_terms

Betalingsvoorwaarden bepalen de datum waarop voor een bestelling moet worden betaald.

Meer informatie over het toevoegen van betalingsvoorwaarden aan facturen.

Voor meer informatie, raadpleeg je de Liquid-naslagdocumentatie voor payment_terms.

tags Retourneert een matrix van alle tags van de bestelling. De tags worden in alfabetische volgorde geretourneerd. Raadpleeg onze Liquid-naslagdocumentatie voor meer informatie.
transactions Retourneert een matrix van transacties van de bestelling.
tax_price
De gecombineerde belastingen van alle artikelen in de bestelling.
tax_lines

Belastingen ingedeeld in types:

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

De naam van de belasting.

Voorbeelden: QST of btw

tax_line.price
Het bedrag.
tax_line.rate
Het tarief. Als het 17,5% is, wordt 0,175 geretourneerd.
tax_line.rate_percentage
Het belastingtarief in een voor mensen leesbare vorm. Als het 0,175 is, wordt 17,5 geretourneerd.
customer
Klantobject met de attributen van de klantuitvoer.
billing_address
Het factuuradres.
billing_address.first_name
Voornaam van de klant.
billing_address.last_name
Achternaam van de klant.
billing_address.company
Bedrijfsnaam voor facturering.
billing_address.phone
Telefoonnummer voor het factuuradres.
shop.name
Naam van je winkel.
shop.phone
Telefoonnummer van je winkel.
subtotal_price
Som van de regelitemprijzen van de bestelling na aftrek van regelitemkorting of winkelwagenkorting. Het subtotaal omvat geen belastingen (tenzij belastingen zijn inbegrepen in de prijzen), verzendkosten of tips.
discounts
Een lijst met kortingen.
discounts_amount

Het bedrag van de korting dat door alle kortingen wordt toegepast.

Voorbeeld: + $ 5,00

discounts_savings

Het bedrag van de besparingen dat door alle kortingen wordt veroorzaakt.

Bijvoorbeeld: -$ 5,00

total_price

Totaal van de bestelling (subtotaal + verzendkosten - verzendkorting + belasting).

financial_status
De huidige betalingsstatus. Eén van het volgende: nil, in behandeling, geautoriseerd, betaald, ongeldig, terugbetaald.
requires_shipping
(Booleaans) Retourneert true als ten minste één artikel in de bestelling moet worden verzonden.
shipping_method.title

De naam van het verzendtarief.

Voorbeeld: Standard Shipping

shipping_method.price

De verzendprijs inclusief eventuele verzendkorting.

Voorbeeld: {{ shipping_method.price | money }}

shipping_price

De verzendkosten.

Voorbeeld: {{ shipping_price | money }}

shipping_address
Het bezorgadres.
shipping_address.first_name
Voornaam voor het bezorgadres.
shipping_address.company
Bedrijfsnaam voor het bezorgadres.
shipping_address.phone
Telefoonnummer voor het bezorgadres.
line_items
Lijst van alle orderregels in de bestelling.
item_count
Som van alle hoeveelheden van de artikelen.
fulfillment_status
De huidige fulfillmentstatus van de bestelling. Eén van de volgende: openstaand, gedeeltelijk afgehandeld, afgehandeld.
note
De aantekening die bij de bestelling is gevoegd. De aantekening kan worden verkregen van de klant en/of worden bewerkt op het scherm met bestelgegevens in de beheerdersinterface.
attributes

Alle attributen die aan de bestelling zijn gekoppeld.

Voorbeeld: {{ attributes.gift-note }}

referring_site

Bevat de URL van de verwijzer die de klant naar je winkel heeft gebracht.

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

landing_site

Bevat het pad van de bestemmingssite die de klant heeft gebruikt. Dit is de eerste pagina die de klant zag toen hij de winkel bereikte.

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

landing_site_ref

Kijkt naar de bestemmingssite en extraheert er een verwijzingsparameter uit. Verwijzingsparameters kunnen zijn: ref, source, r.

Als de landing_site /products/great-product?ref=my-tracking-token is, dan is de landing_site_ref my-tracking-token. Je kunt een bepaalde actie uitvoeren als je ref gelijk is aan een bepaalde waarde:

{% if landing_site_ref == 'my-tracking-token' %} Mijn actie... {% endif %}
cancelled
(Booleaans) Retourneert true als de bestelling is geannuleerd.
cancelled_at
De tijd waarop de bestelling is geannuleerd.
cancel_reason
De reden die is geselecteerd bij het annuleren van de bestelling. Eén van het volgende: voorraad, klant, geweigerd, fraude, anders.
has_high_risks?

Retourneert true als de bestelling een hoog risico heeft

translate="no"
unique_gateways

Retourneert een lijst met unieke betalingsproviders voor een bestelling. Als iemand bijvoorbeeld heeft betaald met een Visa-kaart, een Mastercard en contant, zou dit de geretourneerde lijst zijn: shopify_payments, cash.

location (POS only)

Toont de fysieke locatie van de bestelling. Er zijn verschillende locatie-eigenschappen beschikbaar, die hier worden vermeld. In het gedeelte Locaties van de beheerder kun je locaties configureren.

order_status_url

Retourneert de link naar de bestelstatuspagina voor deze bestelling.

fulfilled_line_items
(verouderd)
Lijst met orderregels die zijn afgehandeld.
unfulfilled_line_items
(verouderd)
Lijst met orderregels die niet volledig zijn afgehandeld.

Conceptbestellingseigenschappen

Conceptbestellingseigenschappen zijn beschikbaar in de e-mailtemplate Conceptbestellingsfactuur, die je klanten op de hoogte stelt van openstaande facturen.

Beschrijving van de concept besteleigenschappen
Eigenschappen Beschrijving
id
Een unieke ID van de conceptbestelling voor intern gebruik.
invoice_url
Een link die de klant kan volgen om voor de factuur te betalen via de veilige checkoutpagina van Shopify.
reserve_inventory_until

De datum en tijd tot wanneer de orderregels in het concept worden gereserveerd, bijvoorbeeld 2015-05-30T17:43:51+02:00.

Je kunt datums opmaken met behulp van het Liquid-datumfilter.

user
De laatste medewerker die de conceptbestelling heeft gewijzigd.
user.name
De naam van de laatste medewerker die de conceptbestelling heeft gewijzigd.
user.email
Het e-mailadres van de laatste medewerker die de conceptbestelling heeft gewijzigd.
email
Het e-mailadres dat aan de conceptbestelling is gekoppeld.
name
Het unieke number van de conceptbestelling, voorafgegaan door een hekje #.
number
Het unieke nummer van de conceptbestelling zonder het bestellingsvoorvoegsel of -achtervoegsel.
created_at

De datum en tijd waarop de klant de conceptbestelling heeft gemaakt, bijvoorbeeld 2009-05-30T17:43:51+02:00.

Je kunt datums opmaken met behulp van het Liquid-datumfilter.

tags Retourneert een matrix van alle tags van de bestelling. De tags worden in alfabetische volgorde geretourneerd. Raadpleeg onze Liquid-naslagdocumentatie voor meer informatie.
tax_price
De gecombineerde belastingen van alle artikelen in de conceptbestelling.
tax_lines

Belastingen ingedeeld in 'types':

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

De naam van de belasting.

Voorbeelden: QST of btw

tax_line.price
Het belastingbedrag.
tax_line.rate
Het belastingtarief in decimale vorm. Een belastingtarief van 17,5% retourneert bijvoorbeeld 0,175.
tax_line.rate_percentage
Het belastingtarief in procentuele vorm. Een tarief van 0,175 retourneert bijvoorbeeld 17,5.
customer
Klantobject met de attributen van de klantuitvoer.
billing_address
Het factuuradres voor de conceptbestelling.
billing_address.first_name
De voornaam van de klant.
billing_address.last_name
De achternaam van de klant.
billing_address.company
De bedrijfsnaam in het factuuradres.
billing_address.phone
Het telefoonnummer in het factuuradres.
shop.name
De naam van je winkel.
shop.phone
Telefoonnummer van je winkel.
subtotal_price
Som van de regelitemprijzen van de conceptbestelling na aftrek van regelitemkorting of winkelwagenkorting. Het subtotaal omvat geen belastingen (tenzij belastingen zijn inbegrepen in de prijzen) of verzendkosten.
discounts
Een lijst met kortingen.
discounts_amount

Bedrag van de korting dat door alle kortingen wordt toegepast.

Voorbeeld: + $ 5,00

discounts_savings

Bedrag van de besparingen dat door alle kortingen wordt veroorzaakt.

Bijvoorbeeld: -$ 5,00

total_price
De totale prijs van de bestelling (subtotaal + verzendkosten - verzendkorting + belasting).
requires_shipping
Retourneert true als ten minste één artikel in de conceptbestelling moet worden verzonden. Retourneert false als geen artikelen in de conceptbestelling hoeven te worden verzonden.
shipping_method.title

De naam van het verzendtarief.

Voorbeeld: Standard Shipping

shipping_method.price
De prijs van de verzendmethode. Retourneert dezelfde informatie als shipping_price.
shipping_price

De verzendkosten.

Je kunt dit bedrag opmaken met Liquid-geldfilters.

shipping_address

Het bezorgadres.

Opmerking: In tegenstelling tot bij gewone bestellingen kan het bezorgadres van een conceptbestelling onvolledig zijn.

shipping_address.first_name
Voornaam voor het bezorgadres.
shipping_address.company
De bedrijfsnaam in het bezorgadres.
shipping_address.phone
Het telefoonnummer in het bezorgadres.
line_items
Een lijst met alle orderregels in de conceptbestelling.
item_count
Een som van alle artikelhoeveelheden in de conceptbestelling.
note
De aantekening die bij de conceptbestelling is gevoegd. De aantekening kan worden verkregen van de klant en ook worden bewerkt op het scherm met conceptbestellingsgegevens in het Shopify-beheercentrum.
location

De fysieke locatie van de bestelling. Er zijn verschillende locatie-eigenschappen beschikbaar.

Op de pagina Locaties van het Shopify-beheercentrum kun je locaties configureren.

Eigenschappen orderregel

Elke line in de lijst met line_items of subtotal_line_items heeft de volgende eigenschappen.

Beschrijving van de eigenschappen van orderregels
Eigenschappen Beschrijving
line.applied_discounts
(alleen POS- en conceptbestellingen)
Lijst met kortingen die op dit artikel worden toegepast (elke korting heeft de eigenschappen titel, code, bedrag, besparingen en type).
line.custom
(alleen conceptbestellingen)
(Booleaans) Retourneert true als het artikel een aangepast orderregel voor een conceptbestelling is.
line.grams
Gewicht van één artikel.
line.image
Retourneert de URL van de afbeelding die aan dit regelitem is gekoppeld. Je kunt ook het img_url-filter gebruiken om specifieke afbeeldingsformaten te krijgen, bijvoorbeeld {{ line.image | img_url: 'small' }}
line.line_price
De prijs vermenigvuldigd met de hoeveelheid voor dat artikel.
line.original_line_price
De gecombineerde prijs van het aantal artikelen dat is opgenomen in de regel, voordat kortingen zijn toegepast.
line.final_line_price
De gecombineerde prijs van alle artikelen in de orderregel, inclusief alle kortingsbedragen op regelniveau.
line.price
De prijs voor één artikel.
line.product.metafields

De metavelden op productniveau. Gebruik de volgende syntax:

line.product.metavelds.NAMESPACE.KEY

line.product.title
De naam van het product.
line.product.vendor
De leverancier voor het artikel.
line.properties
Retourneert een matrix met aangepaste gegevens voor een artikel. Regelitemeigenschappen worden op de productpagina opgegeven door de klant, voordat hij een product aan de winkelwagen toevoegt.
line.quantity
Hoeveelheid voor dat artikel.
line.requires_shipping
(Booleaans) Retourneert true als voor de variant van het artikel het selectievakje Dit is een fysiek product is aangevinkt op de productpagina.
line.selling_plan_allocation
Retourneert een selling_plan_allocation-object, waarin wordt beschreven hoe een verkoopplan zoals een abonnement gevolgen heeft voor de orderregel.
line.taxable
(Booleaans) Retourneert true als voor de variant van het artikel het selectievakje 'Hef btw op dit product' is aangevinkt op de productpagina.
line.title
De naam van het product gevolgd door een streepje gevolgd door de naam van de variant. De variantnaam wordt niet opgenomen wanneer deze 'Standaardtitel' is.
line.url
De relatieve URL van de variant van de orderregel. De relatieve URL bevat geen hoofd-URL van je winkel (mystore.myshopify.com).
line.line_item.variant.barcode
De barcode die aan de productvariant is gekoppeld.
line.variant.compare_at_price
De prijsvergelijking die aan de productvariant is gekoppeld.
line.variant.image
De afbeelding voor de productvariant. Retourneert alleen een afbeelding als er een specifieke afbeelding is toegewezen aan de variant in de orderregel.
line.variant.metafields

De metavelden op variantniveau. Gebruik de volgende syntax:

line.variant.metafields.NAMESPACE.KEY

line.variant.sku
De SKU die aan de productvariant is gekoppeld.
line.variant.title

De optiewaarden van de variant, samen met / tekens.

Voorbeeld: klein/rood

Terugbetalingseigenschappen

Deze aanvullende eigenschappen zijn beschikbaar in de e-mailtemplate Terugbetalingen. Deze e-mailtemplate wordt gebruikt om je klanten te informeren dat er een terugbetaling (volledig of gedeeltelijk) is toegepast op hun bestelling. Naast de volgende variabelen kun je elke variabele gebruiken die beschikbaar is voor de meldingstemplate Bestellingsmail:

Beschrijving van de eigenschappen van terugbetalingen
Eigenschappen Beschrijving
amount
Het terugbetaalde geldbedrag.
refund_line_items
Een lijst met orderregels terugbetaling die moeten worden terugbetaald.

Refund_line_item-eigenschappen

Elke refund_line in de lijst met refund_line_items heeft de volgende eigenschappen:

Beschrijving van de eigenschappen van het regelitem terugbetaling
Eigenschappen Beschrijving
refund_line.line_item
Het line_item dat wordt terugbetaald. Dit heeft toegang tot alle eigenschappen van line_item.
refund_line.quantity
De hoeveelheid van de orderregel dat moet worden terugbetaald.

Afhandelingseigenschappen

Deze aanvullende eigenschappen zijn beschikbaar in de e-mailtemplates Verzendingsbevestiging, Verzendingsupdate en Afhandelingsverzoek.

De Verzendingsbevestiging en Verzendingsupdate worden gebruikt om je klanten op de hoogte te stellen dat sommige of alle artikelen in hun bestelling zijn afgehandeld of met nieuwe verzendgegevens zijn bijgewerkt.

Het e-mailsjabloon Fulfillmentverzoek wordt gebruikt voor een aangepaste fulfillmentservice die in de winkelbeheerder is gedefinieerd. Ga naar de Instellingen > Verzenden en scrol omlaag naar Afhandeling/Dropshipping als je een aangepaste fulfillmentservice wilt toevoegen.

Beschrijving van afhandelingseigenschappen
Eigenschappen Beschrijving
service_name
De naam van de aangepaste service zoals gedefinieerd op de pagina Instellingen > Verzenden . (alleen Fulfillmentverzoek)
fulfillment.estimated_delivery_at
Een geschatte leverdatum op basis van het trackingnummer (indien beschikbaar) van een van de volgende vervoerders: USPS, FedEx, UPS, Canada Post (alleen Canada). Deze eigenschap is alleen beschikbaar wanneer door vervoerder berekende tarieven worden gebruikt.
fulfillment.fulfillment_line_items
Een lijst met orderregels fulfillment die moeten worden afgehandeld.
fulfillment.item_count
Som van alle hoeveelheden van de artikelen. Het totaalaantal artikelen dat wordt afgehandeld.
fulfillment.requires_shipping
(Booleaans) Retourneert true als voor deze afhandelingsaanvraag verzending nodig is.
fulfillment.tracking_company
Het bedrijf dat de tracering uitvoert.
fulfillment.tracking_numbers
Een lijst met trackingnummers.
fulfillment.tracking_urls
Een lijst met tracking-URL's.
items_to_fulfill
(verouderd)
Een lijst met orderregels die moeten worden afgehandeld door deze specifieke aangepaste fulfillmentservice. (alleen Fulfillmentverzoek)
items_to_fulfill_count
(verouderd)
Het totaalaantal artikelen dat moet worden afgehandeld door deze aanvraag. (alleen Afhandelingsverzoek)

Fulfillment_line_item-eigenschappen

Elke fulfillment_line in de lijst met fulfillment_line_items heeft de volgende eigenschappen:

Beschrijving van de eigenschappen van het afhandelingsregelitem
Eigenschappen Beschrijving
fulfillment_line.line_item
Het line_item dat wordt vervuld. Dit heeft toegang tot alle eigenschappen van line_item.
fulfillment_line.quantity
De hoeveelheid van de orderregel dat wordt afgehandeld.

Eigenschappen bezorging

Beschrijving van eigenschappen bezorging
Eigenschappen Beschrijving
delivery_instructions
Gegevens over de lokale bezorging om met de klant te delen. Deze gegevens worden beheerd door het veld Bezorginformatie in de Instellingen van de lokale bezorging.

Kortingseigenschappen

Er zijn twee soorten kortingseigenschappen.

discount_applications beschrijven waarom en hoe een korting op een artikel is toegepast.

discount_allocations Beschrijf hoe een bepaalde korting van invloed is op een orderregel en hoe dit de prijs verlaagt. Gebruik deze eigenschap op het orderregelniveau.

Je kunt deze eigenschappen combineren om kortingsgegevens weer te geven op het orderregel- of bestelniveau.

Voorbeeld

In dit voorbeeld wordt gecontroleerd of er een korting is toegepast op de orderregel. Als de korting niet op het bestelniveau (all) is toegepast, worden de naam en het bedrag van de korting weergegeven.

{% 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 %}

Het resultaat kan er als volgt uitzien:

SPRING5 (-$5.00)

Eigenschappen voor discount_allocation

Elke discount_allocation in de lijst met discount_allocations heeft de volgende eigenschappen:

Beschrijving van eigenschappen voor discount_allocation
Eigenschappen Beschrijving
discount_allocation.amount
Het geldbedrag dat de klant heeft bespaard op een orderregel. Moet in een lus worden ingevoerd als je meerdere kortingscodes wilt toestaan.
discount_allocation.discount_application
De kortingstoepassing die het bedrag op de orderregel toewijst.

Eigenschappen voor discount_allocation

Elke discount_application in de lijst met discount_applications heeft de volgende eigenschappen:

Beschrijving van eigenschappen discount_application
Eigenschappen Beschrijving
discount_application.target_selection

Beschrijft hoe een korting orderregels in de winkelwagen selecteert om te worden afgeprijsd. Een van de volgende:

  • all: De korting is van toepassing op alle orderregels.
  • entitled: De korting is van toepassing op een bepaald aantal orderregels, vaak gedefinieerd door een voorwaarde.
  • explicit: De korting is van toepassing op een specifiek geselecteerde orderregel of verzendregel.
discount_application.target_type
Het type artikel waarop een korting van toepassing is ( line_item of shipping_line).
discount_application.title

De klantgerichte naam van de korting.

Voorbeelden: Welcome10 of CBBWQQAKYBYY

discount_application.total_allocated_amount
Het totale bedrag dat de prijs van een bestelling vermindert met de korting.
discount_application.type
Het type korting. Een van: automatic , discount_code, manual of script .
discount_application.value
De waarde van de korting.
discount_application.value_type
Het type waarde van de korting. Een van: fixed_amount of percentage .

E-mailmeldingseigenschappen

Beschrijving van de eigenschappen van een e-mailmelding
Eigenschappen Beschrijving
shop.email_logo_url
De URL voor het logo dat is opgegeven in het gedeelte E-mailtemplates aanpassen van de beheerder.
shop.email_logo_width
De logobreedte (pixels) die is opgegeven in het gedeelte E-mailtemplates aanpassen van de beheerder.
shop.email_accent_color
De HEX-code voor de accentkleur die is opgegeven in het gedeelte E-mailtemplates aanpassen van de beheerder.

Klaar om te beginnen met verkopen met Shopify?

Probeer het gratis