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:
item_line (produktbillede angivet under varer)
order_integration (uploadet logo under ordreintegration)
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:
Hvis I benytter Shopify, hentes oversættelsen i det sprog, som ordren er afgivet i.
Modtagerlandets sprog, hvis sproget er aktiveret under Oversættelser.
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"
}
}

