Referentiegids voor meldingsvariabelen

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

Om de meldingen die vanuit je winkel worden verzonden te bewerken, kun je basisaanpassingen maken in je meldingstemplates. Ga naar de pagina Meldingen in je Shopify-beheercentrum voor toegang tot de volledige lijst met meldingen die je kunt aanpassen.

Voor hulp bij meer geavanceerde wijzigingen of om wijzigingen aan te brengen in aangepaste meldingstemplates, kun je contact opnemen met de community op onze forums of een Shopify-partner inhuren om de aanpassingen voor je te doen. Meer informatie over het inhuren van een Shopify-partner.

Bestellingseigenschappen

Veel eigenschappen van een bestelling zijn rechtstreeks beschikbaar via Liquid en in templates.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het bestellingsobject in meldingstemplates
EigenschapBeschrijving
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. Voeg in je template Nieuwe bestelling bijvoorbeeld de volgende code toe:

Bestelling bekijken
emailDe e-mail die aan de bestelling is gekoppeld.
name

Meestal is dit een hekje, gevolgd door de order_number.

Voorbeeld: #1004

order_nameHetzelfde als naam.
order_number

Winkeluniek nummer van de bestelling, zonder het voorvoegsel #, of een ander voor- of achtervoegsel dat door de winkeleigenaar in de winkelvoorkeuren aan de bestellings-ID is toegevoegd.

Voorbeeld: 1004

confirmation_number

Een willekeurig gegenereerde alfanumerieke identificatiecode voor de bestelling die aan de klant kan worden getoond in plaats van de sequentiële naam van de bestelling. Het is niet gegarandeerd dat deze waarde uniek is.

Voorbeeld: XPAV284CT

created_at

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

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

payment_terms

Betalingsvoorwaarden geven de datum aan waarop een bestelling betaald moet worden.

Meer informatie over het toevoegen van betalingsvoorwaarden aan bestelfacturen.

Raadpleeg voor meer informatie de Liquid-referentie voor payment_terms.

destinationDe bestemming waar de artikelen naartoe moeten worden verzonden.
tagsRetourneert een array met alle tags van de bestelling. De tags worden in alfabetische volgorde geretourneerd. Tags die dynamisch worden toegepast door apps of platformfuncties, zoals de Shopify Collective-tag, zijn mogelijk niet beschikbaar op het moment dat de e-mailmelding wordt gegenereerd. Als je artikelen van een specifieke functie wilt detecteren, controleer je in plaats daarvan voor elke orderregel de tags op productniveau. Raadpleeg de referentiedocumentatie voor Liquid voor meer informatie.
transactionsRetourneert een array van transacties van de bestelling.
tax_priceDe gecombineerde belastingen van alle artikelen in de bestelling.
tax_lines

Belastingen uitgesplitst per belastingtype:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleDe naam van de belasting. Bijvoorbeeld QST of btw.
tax_line.priceHet bedrag van de belasting.
tax_line.rateHet belastingtarief als een decimaal getal. Retourneert 0,175 als het 17,5% is.
tax_line.rate_percentageHet belastingtarief in een voor mensen leesbare vorm. Retourneert 17,5 als het tarief 0,175 is.
customerKlantobject met de attributen van de klant-output.
billing_addressHet factuuradres.
billing_address.first_nameVoornaam van de klant.
billing_address.last_nameAchternaam van de klant.
billing_address.companyBedrijfsnaam voor facturering.
billing_address.phoneTelefoonnummer van het factuuradres.
shop.nameNaam van je winkel.
shop.phoneHet telefoonnummer van je winkel.
subtotal_priceDe som van de orderregelprijzen van de bestelling nadat een orderregelkorting of winkelwagenkorting is afgetrokken. Het subtotaal is exclusief belastingen (tenzij belastingen zijn inbegrepen in de prijzen), verzendkosten of fooien.
discountsEen lijst met kortingen.
discounts_amount

Het kortingsbedrag dat door alle kortingen wordt toegepast.

Voorbeeld: +$5.00

discounts_savings

Het bedrag van de besparingen die door alle kortingen worden veroorzaakt.

Voorbeeld: -$5.00

total_price

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

financial_statusDe huidige betalingsstatus. Een van: nil, pending, authorized, paid, voided, refunded.
requires_shipping(booleaans) Retourneert 'true' als er ten minste één artikel in de bestelling is waarvoor verzending is vereist.
shipping_method.title

De naam van het verzendtarief.

In meldingen voor klanten wordt de naam van het verzendtarief vertaald naar de taal waarin de klant heeft afgerekend, als die taal anders is dan de standaardtaal van de winkel.

Voorbeeld: Standaardverzending
shipping_method.price

De verzendprijs inclusief eventuele verzendkorting.

Voorbeeld: {{ shipping_method.price | money }}

shipping_price

De verzendprijs.

Voorbeeld: {{ shipping_price | money }}

shipping_addressHet bezorgadres.
shipping_address.first_nameDe voornaam voor het bezorgadres.
shipping_address.companyBedrijfsnaam voor het bezorgadres.
shipping_address.phoneTelefoonnummer van het bezorgadres.
line_itemsLijst van alle orderregels in de bestelling.
line_items_including_zero_quantityLijst van alle orderregels in de bestelling, inclusief die met een aantal van nul. Orderregels hebben een aantal van nul als ze volledig zijn terugbetaald.
line_item_groups(Orders and POS only)Lijst van alle orderregelgroepen die orderregelcomponenten in de bestelling bevatten.
item_countEen som van de aantallen van alle artikelen.
fulfillment_statusDe huidige fulfilmentstatus van de bestelling. Een van: unfulfilled, partial, fulfilled.
noteDe notitie die aan de bestelling is toegevoegd. De notitie kan van de klant worden verkregen en/of worden bewerkt in het scherm met bestelgegevens in je beheer.
attributes

Eventuele attributen die aan de bestelling zijn gekoppeld.

Voorbeeld: {{ attributes.gift-note }}

metafields

Eventuele metavelden van de bestelling. Gebruik de volgende syntaxis:

metafields.NAMESPACE.KEY

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 landingspagina die de klant heeft gebruikt. Dit is de eerste pagina die de klant zag toen die je winkel bezocht.

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

landing_site_ref

Controleert de landingspagina en haalt 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_atHet tijdstip waarop de bestelling is geannuleerd.
cancel_reasonDe reden die is geselecteerd bij het annuleren van de bestelling. Een van: inventory, customer, declined, fraud of other.
has_high_risks?(deprecated)

Retourneert 'true' als de bestelling een hoog risico heeft

unique_gateways

Retourneert een lijst met unieke betalingsproviders voor een bestelling. Als iemand bijvoorbeeld heeft betaald met Visa, Mastercard en contant geld, dan is de geretourneerde lijst shopify_payments, cash.

location(POS only)

Geeft de fysieke locatie van de bestelling weer. Er zijn verschillende locatiekenmerken beschikbaar die hier worden vermeld. Je kunt locaties configureren in het gedeelte Locaties van het beheer.

order_status_url

Retourneert de link naar de bestelstatuspagina voor deze bestelling.

fulfilled_line_items(deprecated)Lijst met orderregels die zijn afgehandeld.
unfulfilled_line_items(deprecated)Lijst met orderregels die nog niet volledig zijn afgehandeld.
b2b?

Retourneert 'true' als de bestelling een B2B-bestelling is. Gebruik het kenmerk met B2B-variabelen om relevante informatie, zoals de bedrijfsnaam, bedrijfslocatie en het adres, in e-mails weer te geven. Bij B2B-bestellingen kun je bijvoorbeeld een koptekst aan een template toevoegen met de volgende informatie:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Het bedrijf waaraan je verkoopt bij een B2B-bestelling.

company.name

De naam van het bedrijf bij een B2B-bestelling.

company.id

De ID van het bedrijf bij een B2B-bestelling.

company_location

De locatie van het bedrijf bij een B2B-bestelling. Een bedrijf dat bij je koopt, kan meer dan één locatie hebben.

company_location.name

De naam van de bedrijfslocatie bij een B2B-bestelling.

company_location.id

Het ID-nummer van de bedrijfslocatie bij een B2B-bestelling.

company_location.shipping_address

Het bezorgadres van de bedrijfslocatie bij een B2B-bestelling.

company_location.billing_address

Het factuuradres van de bedrijfslocatie bij een B2B-bestelling.

customer_order_url

De nieuwe bestelstatuspagina van een bestelling waarvoor een klant een retour heeft aangevraagd via klantaccounts.

Kenmerken van conceptbestelling

Beschrijvingen van Liquid-kenmerken die je kunt gebruiken met het conceptbestelling-object in meldingstemplates
EigenschapBeschrijving
idEen unieke ID van de conceptbestelling voor intern gebruik.
invoice_urlEen link die de klant kan gebruiken om de factuur te betalen via de beveiligde checkout van Shopify.
reserve_inventory_until

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

Je kunt datums opmaken met het Liquid-datumfilter.

userDe laatste medewerker die de conceptbestelling heeft gewijzigd.
user.nameDe naam van de laatste medewerker die de conceptbestelling heeft gewijzigd.
user.emailHet e-mailadres van de laatste medewerker die de conceptbestelling heeft gewijzigd.
emailHet e-mailadres dat aan de conceptbestelling is gekoppeld.
nameDe unieke number van de conceptbestelling, voorafgegaan door een hekje #.
numberHet unieke nummer van de conceptbestelling zonder het bestelvoorvoegsel of -achtervoegsel.
created_at

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

Je kunt datums opmaken met het Liquid-datumfilter.

tagsRetourneert een array van alle tags van de bestelling. De tags worden in alfabetische volgorde geretourneerd. Raadpleeg de Liquid-referentiedocumentatie voor meer informatie.
tax_priceDe gecombineerde belastingen van alle artikelen in de conceptbestelling.
tax_lines

Belastingen uitgesplitst naar belastingtype:

{% 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.priceHet belastingbedrag.
tax_line.rateHet belastingtarief in decimale vorm. Een belastingtarief van 17,5% retourneert bijvoorbeeld 0,175.
tax_line.rate_percentageHet belastingtarief in percentagevorm. Een tarief van 0,175 retourneert bijvoorbeeld 17,5.
customerKlantobject met de attributen van de klant-output.
billing_addressHet factuuradres voor de conceptbestelling.
billing_address.first_nameDe voornaam van de klant.
billing_address.last_nameDe achternaam van de klant.
billing_address.companyDe bedrijfsnaam in het factuuradres.
billing_address.phoneHet telefoonnummer in het factuuradres.
shop.nameDe naam van je winkel.
shop.phoneHet telefoonnummer van je winkel.
subtotal_priceDe som van de prijzen van de orderregels van de conceptbestelling, nadat eventuele orderregel- of winkelwagenkortingen zijn afgetrokken. Het subtotaal is exclusief belastingen (tenzij belastingen zijn inbegrepen in de prijzen) en verzendkosten.
discountsEen lijst met kortingen.
discounts_amount

Het totale kortingsbedrag dat is toegepast.

Voorbeeld: +$5.00

discounts_savings

Het totale bedrag aan besparingen door alle kortingen.

Voorbeeld: -$5.00

total_priceDe totaalprijs van de bestelling (subtotaal + verzendkosten - verzendkorting + belasting).
amount_due_now

Het vereiste bedrag op de factuur van de conceptbestelling.

requires_shippingRetourneert true als er ten minste één artikel in de conceptbestelling is waarvoor verzending is vereist. Retourneert false als er geen artikelen in de conceptbestelling zijn waarvoor verzending is vereist.
shipping_method.title

De naam van het verzendtarief.

Voorbeeld: Standaardverzending

shipping_method.priceDe prijs van de verzendmethode. Retourneert dezelfde informatie als shipping_price.
shipping_price

De verzendprijs.

Je kunt dit bedrag opmaken met Liquid-geldbedragfilters.

shipping_address

Het bezorgadres.

Let op: In tegenstelling tot bij gewone bestellingen, is het bezorgadres van een conceptbestelling mogelijk onvolledig.

shipping_address.first_nameDe voornaam voor het bezorgadres.
shipping_address.companyDe bedrijfsnaam in het bezorgadres.
shipping_address.phoneHet telefoonnummer in het bezorgadres.
line_itemsEen lijst van alle orderregels in de conceptbestelling.
item_countEen som van alle artikelaantallen in de conceptbestelling.
noteDe notitie die aan de conceptbestelling is toegevoegd. De notitie kan van de klant worden verkregen en ook worden bewerkt in het gegevensscherm van de conceptbestelling in je Shopify-beheercentrum.
metafields

Alle metavelden van de conceptbestelling. Gebruik de volgende syntaxis:

metafields.NAMESPACE.KEY

location

De fysieke locatie van de bestelling. Er zijn verschillende locatiekenmerken beschikbaar.

Je kunt locaties configureren op de pagina Locaties van je Shopify-beheercentrum.

b2b?

Retourneert 'true' als de bestelling een B2B-bestelling is. Gebruik het kenmerk met B2B-variabelen om relevante informatie, zoals de bedrijfsnaam, bedrijfslocatie en het adres, in e-mails weer te geven. Bij B2B-bestellingen kun je bijvoorbeeld een koptekst aan een template toevoegen met de volgende informatie:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Het bedrijf waaraan je verkoopt bij een B2B-bestelling.

company.name

De naam van het bedrijf bij een B2B-bestelling.

company.id

De ID van het bedrijf bij een B2B-bestelling.

company_location

De locatie van het bedrijf bij een B2B-bestelling. Een bedrijf dat bij je koopt, kan meer dan één locatie hebben.

company_location.name

De naam van de bedrijfslocatie bij een B2B-bestelling.

company_location.id

Het ID-nummer van de bedrijfslocatie bij een B2B-bestelling.

company_location.shipping_address

Het bezorgadres van de bedrijfslocatie bij een B2B-bestelling.

company_location.billing_address

Het factuuradres van de bedrijfslocatie bij een B2B-bestelling.

payment_methods

Een lijst met opgeslagen betaalmethoden die beschikbaar zijn om het totaalbedrag van de conceptbestelling te verwerken.

payment_method.payment_instrument

Het betaalinstrument, met gegevens over de opgeslagen betaalmethode.

payment_method.payment_instrument.payment_type

Het type opgeslagen betaalmethode. Bijvoorbeeld ‘credit_card, apple_pay’

payment_method.payment_instrument.credit_card_brand

Het merk van de kaart, wanneer `payment_type` 'credit_card' is

payment_method.payment_instrument.credit_card_company

De kaartmaatschappij, wanneer `payment_type` 'credit_card' is

payment_method.payment_instrument.credit_card_company

De laatste 4 cijfers van de kaart, wanneer `payment_type` 'credit_card' is

Betalingsschema-eigenschappen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het betalingsschema-object in meldingstemplates
EigenschapBeschrijving
payment_schedule.amount_due

Het te betalen bedrag voor een betalingsschema.

Je kunt bedragen met valuta's opmaken met het Liquid-money-filter.

payment_schedule.due_at

De vervaldatum voor het betalingsschema.

Je kunt datums opmaken met het Liquid-datumfilter.

payment_schedule.due_in_days

Het aantal dagen tot de vervaldatum als het betalingsschema nog openstaat (onbetaald).

payment_schedule.due_later?

Retourneert 'true' als een betalingsschema nog niet is betaald en de vervaldatum in de toekomst ligt.

payment_schedule.number_of_days_overdue?

Het aantal dagen na de vervaldatum wanneer een betalingsschema achterstallig is.

payment_schedule.overdue?

Retourneert 'true' als een betalingsschema nog niet is betaald en de vervaldatum is verstreken.

Betalingsstatuseigenschappen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het betalingsstatusobject in meldingstemplates
EigenschapBeschrijving
has_pending_payment

(booleaans) Retourneert 'true' als de bestelling een transactie heeft met een betaling die in behandeling is.

Meer informatie over betalingen in behandeling.

buyer_action_required

(booleaans) Retourneert 'true' als een bestelling een transactie heeft met een betaling die in behandeling is en er een actie van de koper is vereist om de betaling te deblokkeren. Wanneer deze waarde 'true' retourneert en de betaalmethode betalingsinstructies ondersteunt, geeft de buyer_pending_payment_instructions gegevens die de klant kan gebruiken om hun aankoop offline te voltooien.

Meer informatie over het Liquid-transactieobject.

Bundelonderdeeleigenschappen

Elke bundle_component in de lijst line_item.bundle_components heeft de volgende eigenschappen. (Alleen conceptbestellingen)

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het bundelonderdeelobject in meldingstemplates
EigenschapBeschrijving
bundle_component.image_urlDe afbeeldings-URL van het bundelonderdeel.
bundle_component.product.titleDe producttitel van het bundelonderdeel.
bundle_component.quantityAantal voor het bundelonderdeel.
bundle_component.variant.title

De huidige namen van de optiewaarden van de bundelonderdeelvariant, verbonden door /-tekens.

Voorbeeld: small / red

Componenteigenschappen

Elke component in de lijst line_item.components heeft de volgende eigenschappen. (Alleen bij verlaten checkouts) `

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het componentobject in meldingstemplates
EigenschapBeschrijving
component.image_urlDe afbeeldings-URL van het component.
component.product.titleDe producttitel van het component.
component.quantityAantal voor het component.
component.variant.title

De huidige namen van de optiewaarden van de componentvariant, verbonden door /-tekens.

Voorbeeld: small / red

Orderregeleigenschappen

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

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het orderregelobject in meldingstemplates
EigenschapBeschrijving
line.applied_discounts(POS and draft orders only)Lijst met kortingen die op dit artikel zijn toegepast (elke korting heeft de eigenschappen title, code, amount, savings en type).
line.bundle_components(Draft orders only)Lijst met orderregels die bundelonderdelen van dit artikel zijn. Retourneert alleen een lijst als deze orderregel een bundelproduct is.
line.bundle_parent?(Draft orders only)(booleaans) Retourneert 'true' als de orderregel een bundelproduct is.
line.components(Abandoned checkout only)Lijst met orderregels die componenten van dit artikel zijn.
line.parent?(Abandoned checkout only)(booleaans) Retourneert 'true' als de orderregel componenten heeft.
line.custom(Draft orders only)(booleaans) Retourneert 'true' als het artikel een aangepaste orderregel voor een conceptbestelling is.
line.delivery_agreementDe Delivery Agreement die aan deze orderregel is gekoppeld.
line.gramsGewicht van een enkel artikel.
line.groupsOrderregelgroep van het artikel.
line.imageRetourneert de URL van de afbeelding die aan deze orderregel is gekoppeld. Je kunt ook het img_url-filter gebruiken om specifieke afbeeldingsformaten te verkrijgen, bijvoorbeeld {{ line.image | img_url: 'small' }}
line.line_priceDe prijs vermenigvuldigd met het aantal voor dat artikel.
line.original_line_priceDe gecombineerde prijs van het aantal artikelen in de orderregel, voordat kortingen werden toegepast.
line.final_line_priceDe gecombineerde prijs van alle artikelen in de orderregel, inclusief alle kortingsbedragen op orderregelniveau.
line.pre_tax_priceDe prijs vóór belasting voor de orderregels, vermenigvuldigd met het aantal van de gekochte orderregel.
line.priceDe prijs voor een enkel artikel.
line.product.metafields

Eventuele metavelden op productniveau. Gebruik de volgende syntaxis:

line.product.metafields.NAMESPACE.KEY

line.product.titleDe huidige naam van het product.
line.product.vendorDe verkoper van het artikel.
line.propertiesRetourneert een array met aangepaste informatie voor een artikel. Orderregeleigenschappen worden door de klant opgegeven op de productpagina voordat een product aan de winkelwagen wordt toegevoegd.
line.quantityAantal voor dat artikel.
line.current_quantityHet huidige aantal van het artikel na verwijderingen.
line.requires_shipping(booleaans) Retourneert 'true' als voor de variant van het artikel de instelling Fysiek product is geactiveerd op de productpagina.
line.selling_plan_allocationRetourneert een selling_plan_allocation-object dat beschrijft hoe een verkoopplan, zoals een abonnement, de orderregel beïnvloedt.
line.taxable(booleaans) Retourneert 'true' als voor de variant van het artikel het selectievakje ‘Belasting heffen op dit product’ is aangevinkt op de productpagina.
line.title

De naam van het product op het moment van verkoop, gevolgd door een streepje en de naam van de variant op het moment van verkoop. De variantnaam wordt niet weergegeven als dit een ‘Standaardtitel’ is.

In meldingen voor klanten worden de productnaam en variantnaam vertaald naar de taal waarin de klant heeft afgerekend, wanneer de taal verschilt van de standaardtaal van de winkel.
line.urlDe relatieve URL van de productvariant van de orderregel. De relatieve URL bevat niet de root-URL van je winkel (mystore.myshopify.com).
line.variant.barcodeDe barcode van de productvariant.
line.variant.compare_at_priceDe vergelijkingsprijs van de productvariant.
line.variant.imageDe afbeelding van de productvariant. Er wordt alleen een afbeelding geretourneerd als er een specifieke afbeelding is toegewezen aan de variant in de orderregel.
line.variant.metafields

Alle metavelden op variantniveau. Gebruik de volgende syntaxis:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuDe SKU van de productvariant.
line.variant.title

De huidige namen van de optiewaarden van de variant, verbonden door /-tekens.

Voorbeeld: small / red

line.refunded.quantity(within refund notifications)

Het aantal van een terug te betalen artikel. Je kunt deze eigenschap gebruiken om een ID toe te voegen aan terugbetaalde artikelen in een bestelling.

Bijvoorbeeld: {% if line.refunded_quantity > 0 %}ID voor terugbetaalde regel{% endif %}

Shopify Collective-artikelen detecteren in meldingstemplates

De Shopify Collective-tag wordt op een bestelling toegepast nadat de e-mail voor de bestelbevestiging is verzonden. Daarom is {% if tags contains 'Shopify Collective' %} nooit true in een template voor een bestelbevestiging. Controleer in plaats daarvan voor elke orderregel de tags op productniveau om Shopify Collective-artikelen te detecteren:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Eigenschappen van orderregelgroep

Elke line_item_group in de lijst line_item_groups heeft de volgende eigenschappen.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het orderregelgroepobject in notificatietemplates
EigenschapBeschrijving
line_item_group.display_titleDe titel van de orderregelgroep.
line_item_group.componentsLijst met orderregelcomponenten die bij de groep horen.
line_item_group.imageDe afbeelding van de orderregelgroep.
line_item_group.product_idDe product-ID van de orderregelgroep.
line_item_group.variantHet variantobject van de orderregelgroep.
line_item_group.variant_idDe variant-id van de orderregelgroep.

Eigenschappen van terugbetalingen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het terugbetalingsobject in notificatietemplates
EigenschapBeschrijving
amountHet terugbetaalde bedrag.
refund_line_itemsEen lijst met terugbetalingsorderregels.

Eigenschappen van terugbetalingsorderregel

Elke refund_line in de lijst refund_line_items heeft de volgende eigenschappen:

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor de terugbetalingsorderregel in notificatietemplates
EigenschapBeschrijving
refund_line.line_itemDe line_item die wordt terugbetaald. Deze heeft toegang tot alle eigenschappen van de orderregel.
refund_line.quantityHet terug te betalen aantal van de orderregel.

Fulfilment-eigenschappen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het fulfilmentobject in notificatietemplates
EigenschapBeschrijving
service_nameDe naam van de aangepaste service zoals gedefinieerd op de pagina Instellingen > Verzending en bezorging. (Alleen fulfilmentaanvraag)
fulfillment.estimated_delivery_atEen geschatte leverdatum op basis van het trackingnummer (indien beschikbaar), verstrekt door een van de volgende vervoerders: USPS, FedEx, UPS, Canada Post (alleen Canada). Deze eigenschap is alleen beschikbaar wanneer door de vervoerder berekende tarieven worden gebruikt.
fulfillment.fulfillment_line_itemsEen lijst met fulfilmentorderregels die afgehandeld moeten worden.
fulfillment.item_countDe som van de aantallen van alle artikelen. Het totale aantal artikelen dat wordt afgehandeld.
fulfillment.requires_shipping(booleaans) Retourneert 'true' als voor dit fulfilmentsverzoek verzending is vereist.
fulfillment.tracking_companyHet bedrijf dat de tracking uitvoert.
fulfillment.tracking_numbersEen lijst met trackingnummers.
fulfillment.tracking_urlsEen lijst met tracking-URL's.
items_to_fulfill(deprecated)Een lijst met orderregels die door deze specifieke aangepaste fulfilmentservice moeten worden afgehandeld. (Alleen bij fulfilmentsverzoek)
items_to_fulfill_count(deprecated)Het totale aantal artikelen dat met deze aanvraag moet worden afgehandeld. (Alleen bij fulfilmentsverzoek)

Eigenschappen van fulfilmentorderregel

Elke fulfillment_line in de lijst fulfillment_line_items heeft de volgende eigenschappen.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor de fulfilmentorderregel in notificatietemplates
EigenschapBeschrijving
fulfillment_line.line_itemDe line_item die wordt afgehandeld. Deze heeft toegang tot alle eigenschappen van de orderregel.
fulfillment_line.quantityHet aantal van de orderregel dat wordt afgehandeld.

Eigenschappen van voorbereid pakket

Een voorbereid pakket bevat de artikelen die zijn gemarkeerd als 'klaar voor afhalen'.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor een voorbereid pakket in notificatietemplates
EigenschapBeschrijving
item_countDe som van de aantallen van alle artikelen in het voorbereide pakket.
prepared_package_line_itemsEen lijst met orderregels van het voorbereide pakket.

Eigenschappen van voorbereidpakketorderregel

Elke prepared_package_line_item in de lijst prepared_package_line_items heeft de volgende eigenschappen.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor de orderregel van een voorbereid pakket in notificatietemplates
EigenschapBeschrijving
line_itemDe bijbehorende line_item. Deze heeft toegang tot alle eigenschappen van de orderregel.
quantityHet aantal van de orderregel dat is gemarkeerd als 'klaar voor afhalen'.

Bezorgingseigenschappen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het bezorgingsobject in notificatietemplates
EigenschapBeschrijving
delivery_agreementsLijst met alle bezorgingsovereenkomsten voor de bestelling.
delivery_instructionsInformatie over lokale bezorging om te delen met de klant. Deze informatie wordt beheerd via het veld Bezorginformatie in je instellingen voor lokale bezorging.
consolidated_estimated_delivery_timeInformatie over leverdatums van de bestelling om te delen met de klant. Deze informatie wordt beheerd via de instelling Verwerkingstijd die je instelt op de pagina Verzending en bezorging. Wanneer de bestelling meerdere bezorgmethoden heeft, wordt een lijst met bezorgmethoden en datums weergegeven.
has_multiple_delivery_methods(booleaans) Retourneert 'true' als de bestelling meerdere bezorgmethoden heeft.

Eigenschappen van bezorgingsovereenkomst

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het bezorgingsovereenkomstobject in notificatietemplates
EigenschapBeschrijving
delivery_agreement.delivery_method_typeHet type bezorgmethode.
delivery_agreement.delivery_method_nameHet type bezorgmethode, vertaald naar de taal waarin de koper heeft afgerekend, wanneer die taal verschilt van de standaardtaal van de winkel.
delivery_agreement.line_item_groupsLijst van alle orderregelgroepen met gebundelde orderregelcomponenten in de bezorgingsovereenkomst.
delivery_agreement.line_itemsLijst van alle orderregels die bij deze bezorgingsovereenkomst horen.

Kortingseigenschappen

Er zijn twee soorten kortingseigenschappen.

discount_applications beschrijven waarom en hoe een artikel korting heeft gekregen.

discount_allocations beschrijven hoe een bepaalde korting een orderregel beïnvloedt en hoe deze de prijs verlaagt. Je moet deze eigenschap op orderregelniveau gebruiken.

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

Voorbeeld

In dit voorbeeld wordt gecontroleerd of er een korting is toegepast op de orderregel. Als de korting niet op bestelniveau is toegepast (all), worden de kortingsnaam en het bedrag 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 ongeveer zo uitzien:

SPRING5 (-$5.00)

Eigenschappen van discount_allocation

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

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object discount_allocation in notificatietemplates
EigenschapBeschrijving
discount_allocation.amountHet bedrag dat de klant op een orderregel bespaart. Moet in een lus worden ingevoerd als je meerdere kortingscodes wilt toestaan.
discount_allocation.discount_applicationDe kortingstoepassing die het bedrag toewijst aan de orderregel.

Eigenschappen van discount_application

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

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object discount_application in notificatietemplates
EigenschapBeschrijving
discount_application.target_selection

Beschrijft hoe een korting orderregels in de winkelwagen selecteert waarop korting wordt toegepast. Een van de volgende:

  • all: de korting is van toepassing op alle orderregels.
  • entitled: de korting is van toepassing op een bepaalde subset van orderregels, vaak gedefinieerd door een voorwaarde.
  • explicit: de korting is van toepassing op een specifiek geselecteerde orderregel of verzendregel.
discount_application.target_typeHet type artikel waarop een korting van toepassing is (line_item of shipping_line).
discount_application.title

De naam van de korting die voor de klant zichtbaar is.

Voorbeelden: Welkom10 of CBBWQQAKYBYY

discount_application.total_allocated_amountHet totale bedrag waarmee de prijs van een bestelling wordt verlaagd door de korting.
discount_application.typeHet type korting. Een van de volgende: automatic, discount_code, manual of script.
discount_application.valueDe waarde van de korting.
discount_application.value_typeHet waardetype van de korting. Een van de volgende: fixed_amount of percentage.

Abonnementseigenschappen

Gegevens van een abonnementscontract, de huidige factureringscyclus en de bijbehorende orderregels, bezorgmethode en betaalmethode zijn beschikbaar voor alle e-mailtemplates voor abonnementen.

Installeer de Shopify Subscriptions-app om notificatietemplates voor abonnementen te bewerken en zoek de template vervolgens onder Instellingen > Meldingen in de sectie Abonnementen.

Eigenschappen van de factureringscyclus van een abonnementscontract

Gebruik het object subscription_contract_billing_cycle om toegang te krijgen tot de eigenschappen van het abonnementscontract en de bijbehorende factureringscyclus.

Voorbeeld

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Resultaat:

This contract is currently paused.

Eigenschappen

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object subscription_contract_billing_cycle in notificatietemplates
EigenschapBeschrijving
status De status van het contract.

Een van de volgende: active, paused, cancelled, failed, expired, stale,
delivery_method De bezorgmethode van het abonnement.

Als het abonnement voor een dienst of digitaal product is, wordt nil geretourneerd.
billing_frequencyHoe vaak het abonnement wordt gefactureerd.
delivery_frequency Hoe vaak het abonnement wordt bezorgd.
origin_order De oorspronkelijke bestelling waarmee het abonnement is aangemaakt.

Als het abonnement niet is aangemaakt vanuit een Shopify-bestelling, wordt nil geretourneerd.
customerDe klant van het abonnement.
line_items De orderregels in de factureringscyclus van het abonnement.
product_namesEen lijst met de namen van de producten in de factureringscyclus van het abonnement.
update_payment_method_urlDe URL die de klant kan gebruiken om de betaalmethode voor dit contract te updaten.
shipping_address Het bezorgadres van het abonnement.

Als het abonnement voor een dienst of digitaal product is, wordt nil geretourneerd.
billing_addressHet factuuradres van het abonnement.
subtotal_priceDe subtotaalprijs van de abonnementsorderregels.
shipping_priceDe verzendkosten van het abonnement.
total_taxDe totale belasting van het abonnement.
total_priceDe totale prijs van het abonnement.
total_discountsDe totale kortingen van het abonnement.
customer_self_serve_urlDe selfservice-URL die de klant kan gebruiken om hun abonnementen te beheren.
billing_attempt_expected_dateDe factuurdatum voor deze factureringscyclus.
next_billing_dateDe volgende niet-overgeslagen factuurdatum na deze factureringscyclus.
last_attempted_billing_dateDe laatst geprobeerde factuurdatum voor de factureringscyclus.
days_overdueHet aantal dagen dat de facturering voor deze factureringscyclus achterstallig is.
payment_instrumentHet betaalmiddel dat is gekoppeld aan het abonnementscontract. Dit betaalmiddel wordt gebruikt om kosten bij de klant in rekening te brengen.

Eigenschappen van abonnementscontractorderregels

De eigenschappen voor elke orderregel in de factureringscyclus. Je hebt toegang tot de eigenschappen van de contractorderregel via de bovenliggende eigenschap subscription_contract_billing_cycle.line_items.

Voorbeeld

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor abonnementscontractorderregels in notificatietemplates
EigenschapBeschrijving
urlDe URL naar de productgegevenspagina voor de productvariant van de orderregel.
requires_shippingOf de orderregel fysieke verzending vereist.
unit_price_measurementDe eenheidsprijsmeting van de orderregel.
selling_plan_allocationDe toewijzing van het verkoopplan van de orderregel.

Eigenschappen van de bezorgmethode van een abonnementscontract

De eigenschappen voor de bezorgmethode die in deze factureringscyclus wordt gebruikt. De eigenschappen van de bezorgmethode zijn toegankelijk via de bovenliggende eigenschap subscription_contract_billing_cycle.delivery_method.

Voorbeeld

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor de bezorgmethode van het abonnementscontract in notificatietemplates.
EigenschapBeschrijving
titleDe titel van de verzendoptie die is gekoppeld aan de bezorgmethode.
type Het type bezorgmethode.

Een van shipping, local of pick-up.

Eigenschappen van het betaalinstrument van een abonnementscontract

Gegevens over het betaalinstrument voor het abonnementscontract. Dit betaalinstrument wordt gebruikt om de klant te factureren. De eigenschappen van het betaalinstrument zijn toegankelijk via de bovenliggende eigenschap subscription_contract_billing_cycle.payment_instrument.

Voorbeeld

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}
Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor het betaalinstrument van het abonnementscontract in notificatietemplates.
EigenschapBeschrijving
payment_type Het type betaalmethode dat door het betaalinstrument wordt vertegenwoordigd.

Gebruik betalingsfilters om een afbeeldings-URL of SVG weer te geven.
credit_card_brandHet merk van de creditcard.
credit_card_companyDe naam van de creditcardmaatschappij.
credit_card_last_four_digitsDe laatste 4 cijfers van de creditcard.

Eigenschappen van e-mailnotificaties

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor e-mailnotificaties in notificatietemplates.
EigenschapBeschrijving
shop.email_logo_urlDe URL voor het logo dat is opgegeven in de sectie E-mailtemplates aanpassen van het beheerpaneel.
shop.email_logo_widthDe logobreedte (in pixels) die is opgegeven in de sectie E-mailtemplates aanpassen van het beheerpaneel.
shop.email_accent_colorDe HEX-code voor de accentkleur die is opgegeven in de sectie E-mailtemplates aanpassen van het beheerpaneel.

Eigenschappen van winkeltegoed

De eigenschappen met gegevens over de uitgifte van een winkeltegoed.

Beschrijvingen van Liquid-eigenschappen die je kunt gebruiken met het object voor uitgegeven winkeltegoed in notificatietemplates.
EigenschapBeschrijving
issued_store_credit.amount

Het bedrag aan winkeltegoed dat is uitgegeven.

Je kunt dit bedrag opmaken met Liquid-geldbedragfilters.

issued_store_credit.expires_at

De datum en tijd waarop het uitgegeven winkeltegoed vervalt.

Je kunt dit bedrag opmaken met Liquid-datumfilters.

issued_store_credit.balance_after_transaction

Het saldo van het account met winkeltegoed nadat het tegoed is uitgegeven.

Je kunt dit bedrag opmaken met Liquid-geldbedragfilters.

customerKlantobject met de attributen van de klant-output.