Spring videre til hovedindholdet

Introduktion til Liquid i Shipmondo

Sådan bruger I Liquid, custom tags, filtre og dataobjekter i Shipmondo.

Shipmondos designmotor er baseret på teknologierne HTML og Liquid. Det er disse sprog, der bruges i f.eks. Shipmondo Dokumentdesigner.

I denne guide finder I link til Liquid-dokumentationen samt en oversigt over Shipmondos custom tags, filtre og de tilgængelige dataobjekter og properties.

Hvad er Liquid?

Liquid er et fleksibelt templating-sprog udviklet af Shopify, som bruges til at strukturere og generere dynamisk indhold samt få adgang til dataobjekter i Shipmondo.

Med en syntaks baseret på tags, filtre og variabler gør Liquid det muligt at bygge logik direkte ind i HTML.

I Shipmondo understøtter vi alle funktioner, tags og filtre, der er beskrevet i Liquids dokumentation: https://shopify.github.io/liquid/.

Custom Liquid tags

Vi har udviklet en række Shipmondo-specifikke tags.

1. image

Hvis I vil tilføje et billede, kan I bruge image-tagget.

Følgende ressourcer er tilgængelige:

Valgfrie parametre:

Parameter

Forklaring

height

Angiver højden på billedet

width

Angiver bredden på billedet

Eksempel (uden valgfrie parametre):

{% image item_line %}

Eksempel (med valgfrie parametre):

{% image order_integration, height: 35, width: 200 %}

2. barcode

Hvis I ønsker at genere en stregkode, kan I bruge barcode-tagget.

Det kan f.eks. anvendes, hvis I ønsker at tilføje en stregkode til at finde eller afslutte en ordre, når stregkoden scannes.

Valgfrie parametre:

Parameter

Forklaring

height

Angiver højden på stregkoden

xdim

Angiver den horisontale tykkelse (stregernes bredde)

margin

Angiver margenen omkring stregkoden

background

Angiver baggrundsfarven

Eksempel (med valgfrie parametre):

{% barcode "270000000123", height: 35, xdim: 1.6, margin: 1, background "white" %}

3. qr_code

Hvis I ønsker at genere en QR-kode, kan I bruge qr_code-tagget.

Det kan f.eks. anvendes, hvis I ønsker at lave en genvej til jeres hjemmeside eller returportal.

Valgfrie parametre:

Parameter

Forklaring

xdim

Angiver den horisontale diameter

margin

Angiver margenen omkring QR-koden

background

Angiver baggrundsfarven

Eksempel (med valgfrie parametre):

{% qr_code "270000000123", xdim: 2.5, margin: 1, background "white" %}

Custom Liquid filtre

Vi har også udviklet en række Shipmondo-specifikke filtre, som I kan benytte:

1. translation

Med vores oversættelsesværktøj kan I ved hjælp af translation-tagget hente den korrekte oversættelse af en nøgle.

Oversættelsen hentes ud fra følgende:

  1. Hvis I benytter Shopify, hentes oversættelsen i det sprog, som ordren er afgivet i.

  2. Modtagerlandets sprog, hvis sproget er aktiveret under Oversættelser.

  3. Det primære sprog, der er valgt og aktiveret under Oversættelser.

Eksempel:

{{ "order_no" | translate }}

2. format_currency

Hvis I ønsker at angive en specifik valutakode i forlængelse af beløbet. Bemærk, at beløb ikke omregnes.

Eksempel:

{{ item_line.unit_price | format_currency: "DKK" }}

Resultat (eksempel):

200,00 DKK

Dataobjekter og properties

Dataobjekter og adgang

Følgende dataobjekter er tilgængelige i dokumenter og beskeder:

Dataobjekt

Adgang for ressourcer

document

følgeseddel, plukliste, ordre

order_integration

følgeseddel, plukliste, og ordre relaterede personlige beskeder

fulfillment

følgeseddel og visse ordre relaterede personlige beskeder

order

følgeseddel, plukliste og ordre relaterede personlige beskeder

pick_path

plukruteseddel

invoice

faktura- og kreditnota personlige beskeder

Properties

Oversigt over properties med data eksempler.

1. document

Objekt

Forklaring

document

Det aktuelle dokument

source

Eksempel:

"document": {
"format": "a4",
"source": null
}

2. order_integration

Objekt

Forklaring

order_integration

Den tilhørende integration

Eksempel:

"order_integration": {
"id": null
}

3. fulfillment

Objekt

Forklaring

fulfillment

Den specifikke leverance for en ordre

fulfillment.code

Leverance koden

fulfillment.box_number

Kasse nummer

fulfillment.item_count

Antallet af varer

fulfillment.shipment

Den oprettede forsendelse for leverancen

fulfillment.item_lines

Varelinjerne for den oprettede leverance. De er sorteret efter brugerens plukindstillinger

Eksempel:

"fulfillment": {
"code": "1001-1",
"box_number": 1,
"shipment": {
"product_name": "Service point",
"carrier_name": "PostNord",
"carrier_code": "pdk"
},
"item_lines": [
{
"item_line_id": null,
"sku": "TS001-WH",
"name": "T-Shirt",
"quantity": 1,
"shipped_quantity": 1,
"bin": "AB-001",
"unit_price": 200,
"vat_percentage": 25,
"weight": 500,
"unfulfilled_quantity": 1,
"custom_product_data": [
"Large",
"Box fit"
],
"variant_code": "White",
"barcode": null,
"currency_code": "DKK"
}
]
}

4. order

Objekt

Forklaring

order

Den tilhørende ordre

order.id

Ordrens ID

order.number

Ordrens nummer i webshop systemet

order.shipment_template

Den aktuelt tilknyttede forsendelsesskabelon

order.assigned_to

Den medarbejder, der er tildelt ordren

order.item_count

Antallet af varer

order.unfulfilled_item_count

Antallet af varer som ikke er sendt

order.item_lines

Ordrelinjerne for ordren. De er sorteret efter brugerens plukindstillinger

order.shipping_lines

Forsendelseslinjer

order.discount_lines

Rabatlinjerne for ordren

order.gift_card_lines

Gavekort linjer

order.payment_fee_lines

Gebyr linjer

order.duty_lines

Told linjer

order.sender

Afsender

order.ship_to

Modtager

order.bill_to

Fakturering (kunde)

order.barcodes

Stregkoder, der bruges til at udføre forskellige handlinger

order.is_returning_customer

Angiver, om kunden var tilbagevendende, da ordren blev lagt (true/false)

order.shipping_method

Navnet for ordrens leveringsmetode, som webshoppen sender den

order.shipping_method_code

Koden for ordrens leveringsmetode, som webshoppen sender den

order.payment_method

Navnet for ordrens betalingsmetode, som webshoppen sender den

order.payment_method_code

Koden for ordrens betalingsmetode, som webshoppen sender den

order.reference

Reference

order.customer_reference

Kunde reference

order.note

Note

order.ordered_at

Købstidspunkt

order.tags

Tags fra webshop systemet

Eksempel:

"order": {
"id": null,
"number": "1001",
"ordered_date": "2025-11-11T11:12:54.000+01:00",
"tags": [],
"note": "This is a note",
"customer_reference": "Please deliver between 9am-5pm",
"item_count": 5,
"is_returning_customer": true,
"shipping_method": "Service point",
"payment_method": "Card payment",
"shipping_method_code": "service_point",
"payment_method_code": "card",
"shipment_template": {
"product_name": "MyPack Home",
"carrier_name": "PostNord (DK)",
"carrier_code": "pdk"
},
"assigned_to": {
"name": "John Doe"
},
"item_lines": [
{
"id": null,
"sku": "TS001-WH",
"name": "T-Shirt",
"quantity": 1,
"shipped_quantity": 0,
"bin": "AB-001",
"image_url": "http://example.com/image",
"unit_price": "200.0",
"vat_percentage": "25.0",
"weight": 500,
"unfulfilled_quantity": 1,
"custom_product_data": [
"Large",
"Box fit"
],
"variant_code": "White",
"barcode": null,
"currency_code": "DKK",
"item_line_id": null
}
],
"discount_lines": [
{
"name": "SUMMER10",
"quantity": 1,
"unit_price": -20.0,
"vat_percentage": 25.0,
"currency_code": "DKK"
}
],
"sender": {
"name": "My Company ApS",
"address1": "Strandvejen 6B",
"address2": null,
"zipcode": "5240",
"city": "Odense NØ",
"email": "info@minvirksomhed.dk",
"mobile": "70400407",
"country": {
"code": "DK",
"name": "Denmark"
}
},
"ship_to": {
"name": "My Company ApS",
"attention": "Lene Hansen",
"address1": "Skibhusvej 52",
"address2": null,
"zipcode": "5000",
"city": "Odense C",
"email": "lene@email.dk",
"mobile": "12345678",
"country": {
"code": "DK",
"name": "Denmark"
}
},
"bill_to": {
"name": "My Company ApS",
"attention": "Lene Hansen",
"address1": "Skibhusvej 52",
"address2": null,
"zipcode": "5000",
"city": "Odense C",
"email": "lene@email.dk",
"mobile": "12345678",
"country": {
"code": "DK",
"name": "Denmark"
}
},
"barcodes": {
"complete_pick": "27100000000000",
"find_order": "27170000000000"
}
}

Nye og tilbagevendende kunder

Med order.is_returning_customer kan I vise forskelligt indhold, alt efter om kunden handler for første gang eller er vendt tilbage. I kan f.eks. byde nye kunder velkommen eller takke faste kunder.

Eksempel:

{% if order.is_returning_customer %}Velkommen tilbage!{% else %}Tak for din første ordre!{% endif %}

Bemærk:

  • Værdien viser, om kunden var tilbagevendende, da ordren blev lagt. Hvis I genudskriver en følgeseddel for kundens første ordre, vises den stadig som en ny kunde.

  • Ordrer uden en tilknyttet kunde tæller altid som ikke-tilbagevendende.

  • Variablen findes ikke på plukruteseddel (pick_path), fordi den ikke indeholder ordreoplysninger.

  • I forhåndsvisningen i dokumentdesigneren vises altid varianten for tilbagevendende kunder.

Rabatter

Med order.discount_lines kan I vise de rabatter, kunden har fået, fx på følgesedlen. Hver rabatlinje har navn, antal, beløb ekskl. moms, momssats og valuta.

Bemærk:

  • Navnet er det, webshoppen sender med ordren, fx rabatkoden "SUMMER10". Har linjen intet navn, vises "Rabat" eller "Discount" afhængigt af sproget.

  • Rabatlinjer kommer ikke automatisk på eksisterende skabeloner. I skal selv tilføje dem.

  • I forhåndsvisningen i dokumentdesigneren har eksempeldataene en rabatlinje, så I kan teste jeres skabelon.

5. pick_path

Objekt

Forklaring

pick_path

Den tilhørende plukrute

pick_path.item_lines

Varelinjerne for alle ordrer. De er sorteret efter brugerens plukindstillinger

pick_path.created_by_user_name

Navnet på personen der oprettede plukruten

Eksempel:

"pick_path": {
"id": null,
"created_by_user_name": "",
"item_lines": [
{
"sku": "TS001-WH",
"name": "T-Shirt",
"quantity": 1,
"shipped_quantity": 0,
"bin": "AB-001",
"image_url": "http://example.com/image",
"unit_price": "0.0",
"vat_percentage": "25.0",
"weight": 500,
"unfulfilled_quantity": 1,
"custom_product_data": [
"Large",
"Box fit"
],
"variant_code": "White",
"barcode": null,
"order_number": "1001",
"box_number": 1
}
]
}

6. invoice

Objekt

Forklaring

invoice

Den tilhørende faktura eller kreditnota

invoice.id

ID'et på fakturaen eller kreditnotaen

invoice.number

Faktura nummeret

invoice.invoiced_date

Faktura tidspunkt

invoice.bill_to

Faktureringsadresse

invoice.sender

Afsender

invoice.payment_method

Navnet for betalingsmetoden, som webshoppen sender den

invoice.payment_method_code

Koden for betalingsmetoden, som webshoppen sender den

Eksempel:

"invoice": {
"bill_to": {
"address1": "Skibhusvej 52",
"address2": null,
"attention": "Lene Hansen",
"city": "Odense C",
"country": {
"code": "DK",
"name": "Denmark"
},
"email": "lene@email.dk",
"mobile": "12345678",
"name": "My Company ApS",
"zipcode": "5000"
},
"invoiced_date": "2025-11-11T11:12:54.000+01:00",
"item_lines": [
{
"barcode": "1234567890123",
"bin": "AB-001",
"currency_code": "DKK",
"custom_product_data": ["Large", "Box fit"],
"image_url": "http://example.com/image",
"item_line_id": -1,
"name": "T-Shirt",
"quantity": 1,
"shipped_quantity": 0,
"sku": "TS001-WH",
"unfulfilled_quantity": 1,
"unit_price": "200.0",
"variant_code": "White",
"vat_percentage": "25.0",
"weight": 500
}
],
"number": "8001",
"payment_method": "Card payment",
"payment_method_code": "card",
"sender": {
"address1": "Strandvejen 6B",
"address2": null,
"city": "Odense NØ",
"country": {
"code": "DK",
"name": "Denmark"
},
"email": "info@minvirksomhed.dk",
"mobile": "70400407",
"name": "My Company ApS",
"zipcode": "5240"
}
}
Besvarede dette dit spørgsmål?