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.
Op deze pagina
- Bestellingseigenschappen
- Conceptbestellingseigenschappen
- Betalingsschema-eigenschappen
- Betalingsstatuseigenschappen
- Bundelcomponenteigenschappen
- Componenteigenschappen
- Regelartikeleigenschappen
- Regelartikelgroepeigenschappen
- Terugbetalingseigenschappen
- Fulfilmenteigenschappen
- Eigenschappen van voorbereid pakket
- Bezorgingseigenschappen
- Kortingseigenschappen
- Abonnementseigenschappen
- E-mailmeldingseigenschappen
- Winkeltegoedeigenschappen
Bestellingseigenschappen
Veel eigenschappen van een bestelling zijn rechtstreeks beschikbaar via Liquid en in templates.
| Eigenschap | 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. Voeg in je template Nieuwe bestelling bijvoorbeeld de volgende code toe: Bestelling bekijken
|
email | De e-mail die aan de bestelling is gekoppeld. |
name |
Meestal is dit een hekje, gevolgd door de Voorbeeld: #1004 |
order_name | Hetzelfde 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. |
destination | De bestemming waar de artikelen naartoe moeten worden verzonden. |
tags | Retourneert 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. |
transactions | Retourneert een array van transacties van de bestelling. |
tax_price | De 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.title | De naam van de belasting. Bijvoorbeeld QST of btw. |
tax_line.price | Het bedrag van de belasting. |
tax_line.rate | Het belastingtarief als een decimaal getal. Retourneert 0,175 als het 17,5% is. |
tax_line.rate_percentage | Het belastingtarief in een voor mensen leesbare vorm. Retourneert 17,5 als het tarief 0,175 is. |
customer | Klantobject met de attributen van de klant-output. |
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 van het factuuradres. |
shop.name | Naam van je winkel. |
shop.phone | Het telefoonnummer van je winkel. |
subtotal_price | De 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. |
discounts | Een 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_status | De 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_price |
De verzendprijs. Voorbeeld: |
shipping_address | Het bezorgadres. |
shipping_address.first_name | De voornaam voor het bezorgadres. |
shipping_address.company | Bedrijfsnaam voor het bezorgadres. |
shipping_address.phone | Telefoonnummer van het bezorgadres. |
line_items | Lijst van alle orderregels in de bestelling. |
line_items_including_zero_quantity | Lijst 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_count | Een som van de aantallen van alle artikelen. |
fulfillment_status | De huidige fulfilmentstatus van de bestelling. Een van: unfulfilled, partial, fulfilled. |
note | De 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: |
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: |
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: |
landing_site_ref |
Controleert de landingspagina en haalt er een verwijzingsparameter uit. Verwijzingsparameters kunnen zijn: Als de
{% if landing_site_ref == 'my-tracking-token' %}
Mijn actie...
{% endif %}
|
cancelled | (booleaans) Retourneert 'true' als de bestelling is geannuleerd. |
cancelled_at | Het tijdstip waarop de bestelling is geannuleerd. |
cancel_reason | De 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 |
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
| Eigenschap | Beschrijving |
|---|---|
id | Een unieke ID van de conceptbestelling voor intern gebruik. |
invoice_url | Een 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 Je kunt datums opmaken met 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 | De unieke number van de conceptbestelling, voorafgegaan door een hekje #. |
number | Het unieke nummer van de conceptbestelling zonder het bestelvoorvoegsel of -achtervoegsel. |
created_at |
De datum en tijd waarop de klant de conceptbestelling heeft aangemaakt, bijvoorbeeld Je kunt datums opmaken met het Liquid-datumfilter. |
tags | Retourneert een array van alle tags van de bestelling. De tags worden in alfabetische volgorde geretourneerd. Raadpleeg de Liquid-referentiedocumentatie voor meer informatie. |
tax_price | De 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.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 percentagevorm. Een tarief van 0,175 retourneert bijvoorbeeld 17,5. |
customer | Klantobject met de attributen van de klant-output. |
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 | Het telefoonnummer van je winkel. |
subtotal_price | De 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. |
discounts | Een 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_price | De totaalprijs van de bestelling (subtotaal + verzendkosten - verzendkorting + belasting). |
amount_due_now | Het vereiste bedrag op de factuur van de conceptbestelling. |
requires_shipping | Retourneert 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.price | De 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_name | De voornaam voor het bezorgadres. |
shipping_address.company | De bedrijfsnaam in het bezorgadres. |
shipping_address.phone | Het telefoonnummer in het bezorgadres. |
line_items | Een lijst van alle orderregels in de conceptbestelling. |
item_count | Een som van alle artikelaantallen in de conceptbestelling. |
note | De 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
| Eigenschap | Beschrijving |
|---|---|
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
| Eigenschap | Beschrijving |
|---|---|
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 Meer informatie over het Liquid-transactieobject. |
Bundelonderdeeleigenschappen
Elke bundle_component in de lijst line_item.bundle_components heeft de volgende eigenschappen. (Alleen conceptbestellingen)
| Eigenschap | Beschrijving |
|---|---|
bundle_component.image_url | De afbeeldings-URL van het bundelonderdeel. |
bundle_component.product.title | De producttitel van het bundelonderdeel. |
bundle_component.quantity | Aantal voor het bundelonderdeel. |
bundle_component.variant.title | De huidige namen van de optiewaarden van de bundelonderdeelvariant, verbonden door Voorbeeld: small / red |
Componenteigenschappen
Elke component in de lijst line_item.components heeft de volgende eigenschappen. (Alleen bij verlaten checkouts)
`
| Eigenschap | Beschrijving |
|---|---|
component.image_url | De afbeeldings-URL van het component. |
component.product.title | De producttitel van het component. |
component.quantity | Aantal voor het component. |
component.variant.title | De huidige namen van de optiewaarden van de componentvariant, verbonden door Voorbeeld: small / red |
Orderregeleigenschappen
Elke line in de lijst met line_items of subtotal_line_items heeft de volgende eigenschappen.
| Eigenschap | Beschrijving |
|---|---|
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_agreement | De Delivery Agreement die aan deze orderregel is gekoppeld. |
line.grams | Gewicht van een enkel artikel. |
line.groups | Orderregelgroep van het artikel. |
line.image | Retourneert 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_price | De prijs vermenigvuldigd met het aantal voor dat artikel. |
line.original_line_price | De gecombineerde prijs van het aantal artikelen in de orderregel, voordat kortingen werden toegepast. |
line.final_line_price | De gecombineerde prijs van alle artikelen in de orderregel, inclusief alle kortingsbedragen op orderregelniveau. |
line.pre_tax_price | De prijs vóór belasting voor de orderregels, vermenigvuldigd met het aantal van de gekochte orderregel. |
line.price | De prijs voor een enkel artikel. |
line.product.metafields | Eventuele metavelden op productniveau. Gebruik de volgende syntaxis: line.product.metafields.NAMESPACE.KEY |
line.product.title | De huidige naam van het product. |
line.product.vendor | De verkoper van het artikel. |
line.properties | Retourneert 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.quantity | Aantal voor dat artikel. |
line.current_quantity | Het 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_allocation | Retourneert 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.url | De relatieve URL van de productvariant van de orderregel. De relatieve URL bevat niet de root-URL van je winkel (mystore.myshopify.com). |
line.variant.barcode | De barcode van de productvariant. |
line.variant.compare_at_price | De vergelijkingsprijs van de productvariant. |
line.variant.image | De 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.sku | De SKU van de productvariant. |
line.variant.title | De huidige namen van de optiewaarden van de variant, verbonden door 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: |
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.
| Eigenschap | Beschrijving |
|---|---|
line_item_group.display_title | De titel van de orderregelgroep. |
line_item_group.components | Lijst met orderregelcomponenten die bij de groep horen. |
line_item_group.image | De afbeelding van de orderregelgroep. |
line_item_group.product_id | De product-ID van de orderregelgroep. |
line_item_group.variant | Het variantobject van de orderregelgroep. |
line_item_group.variant_id | De variant-id van de orderregelgroep. |
Eigenschappen van terugbetalingen
| Eigenschap | Beschrijving |
|---|---|
amount | Het terugbetaalde bedrag. |
refund_line_items | Een lijst met terugbetalingsorderregels. |
Eigenschappen van terugbetalingsorderregel
Elke refund_line in de lijst refund_line_items heeft de volgende eigenschappen:
| Eigenschap | Beschrijving |
|---|---|
refund_line.line_item | De line_item die wordt terugbetaald. Deze heeft toegang tot alle eigenschappen van de orderregel. |
refund_line.quantity | Het terug te betalen aantal van de orderregel. |
Fulfilment-eigenschappen
| Eigenschap | Beschrijving |
|---|---|
service_name | De naam van de aangepaste service zoals gedefinieerd op de pagina Instellingen > Verzending en bezorging. (Alleen fulfilmentaanvraag) |
fulfillment.estimated_delivery_at | Een 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_items | Een lijst met fulfilmentorderregels die afgehandeld moeten worden. |
fulfillment.item_count | De 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_company | Het bedrijf dat de tracking uitvoert. |
fulfillment.tracking_numbers | Een lijst met trackingnummers. |
fulfillment.tracking_urls | Een 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.
| Eigenschap | Beschrijving |
|---|---|
fulfillment_line.line_item | De line_item die wordt afgehandeld. Deze heeft toegang tot alle eigenschappen van de orderregel. |
fulfillment_line.quantity | Het aantal van de orderregel dat wordt afgehandeld. |
Eigenschappen van voorbereid pakket
Een voorbereid pakket bevat de artikelen die zijn gemarkeerd als 'klaar voor afhalen'.
| Eigenschap | Beschrijving |
|---|---|
item_count | De som van de aantallen van alle artikelen in het voorbereide pakket. |
prepared_package_line_items | Een 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.
| Eigenschap | Beschrijving |
|---|---|
line_item | De bijbehorende line_item. Deze heeft toegang tot alle eigenschappen van de orderregel. |
quantity | Het aantal van de orderregel dat is gemarkeerd als 'klaar voor afhalen'. |
Bezorgingseigenschappen
| Eigenschap | Beschrijving |
|---|---|
delivery_agreements | Lijst met alle bezorgingsovereenkomsten voor de bestelling. |
delivery_instructions | Informatie 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_time | Informatie 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
| Eigenschap | Beschrijving |
|---|---|
delivery_agreement.delivery_method_type | Het type bezorgmethode. |
delivery_agreement.delivery_method_name | Het 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_groups | Lijst van alle orderregelgroepen met gebundelde orderregelcomponenten in de bezorgingsovereenkomst. |
delivery_agreement.line_items | Lijst 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.
| Eigenschap | Beschrijving |
|---|---|
discount_allocation.amount | Het bedrag dat de klant op een orderregel bespaart. Moet in een lus worden ingevoerd als je meerdere kortingscodes wilt toestaan. |
discount_allocation.discount_application | De 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.
| Eigenschap | Beschrijving |
|---|---|
discount_application.target_selection |
Beschrijft hoe een korting orderregels in de winkelwagen selecteert waarop korting wordt toegepast. Een van de volgende:
|
discount_application.target_type | Het 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_amount | Het totale bedrag waarmee de prijs van een bestelling wordt verlaagd door de korting. |
discount_application.type | Het type korting. Een van de volgende: automatic, discount_code, manual of script. |
discount_application.value | De waarde van de korting. |
discount_application.value_type | Het 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
| Eigenschap | Beschrijving |
|---|---|
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_frequency | Hoe 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.
|
customer | De klant van het abonnement. |
line_items | De orderregels in de factureringscyclus van het abonnement. |
product_names | Een lijst met de namen van de producten in de factureringscyclus van het abonnement. |
update_payment_method_url | De 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_address | Het factuuradres van het abonnement. |
subtotal_price | De subtotaalprijs van de abonnementsorderregels. |
shipping_price | De verzendkosten van het abonnement. |
total_tax | De totale belasting van het abonnement. |
total_price | De totale prijs van het abonnement. |
total_discounts | De totale kortingen van het abonnement. |
customer_self_serve_url | De selfservice-URL die de klant kan gebruiken om hun abonnementen te beheren. |
billing_attempt_expected_date | De factuurdatum voor deze factureringscyclus. |
next_billing_date | De volgende niet-overgeslagen factuurdatum na deze factureringscyclus. |
last_attempted_billing_date | De laatst geprobeerde factuurdatum voor de factureringscyclus. |
days_overdue | Het aantal dagen dat de facturering voor deze factureringscyclus achterstallig is. |
payment_instrument | Het 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 %}| Eigenschap | Beschrijving |
|---|---|
url | De URL naar de productgegevenspagina voor de productvariant van de orderregel. |
requires_shipping | Of de orderregel fysieke verzending vereist. |
unit_price_measurement | De eenheidsprijsmeting van de orderregel. |
selling_plan_allocation | De 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 %}| Eigenschap | Beschrijving |
|---|---|
title | De 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 }}| Eigenschap | Beschrijving |
|---|---|
payment_type |
Het type betaalmethode dat door het betaalinstrument wordt vertegenwoordigd. Gebruik betalingsfilters om een afbeeldings-URL of SVG weer te geven. |
credit_card_brand | Het merk van de creditcard. |
credit_card_company | De naam van de creditcardmaatschappij. |
credit_card_last_four_digits | De laatste 4 cijfers van de creditcard. |
Eigenschappen van e-mailnotificaties
| Eigenschap | Beschrijving |
|---|---|
shop.email_logo_url | De URL voor het logo dat is opgegeven in de sectie E-mailtemplates aanpassen van het beheerpaneel. |
shop.email_logo_width | De logobreedte (in pixels) die is opgegeven in de sectie E-mailtemplates aanpassen van het beheerpaneel. |
shop.email_accent_color | De 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.
| Eigenschap | Beschrijving |
|---|---|
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. |
customer | Klantobject met de attributen van de klant-output. |