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.

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

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

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:

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

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ængelig i Shipmondo Dokumentdesigner:

Dataobjekt	Adgang for ressourcer
document	alle
order_integration	alle
fulfillment	følgeseddel
order	følgeseddel, plukliste
pick_path	plukruteseddel

Properties

Oversigt over properties med data eksempler.

document

Objekt	Forklaring
document	Det aktuelle dokument

Eksempel:

"document": {
  "format": "a4"
}

order_integration

Objekt	Forklaring
order_integration	Den tilhørende integration

Eksempel:

"order_integration": {
  "id": null
}

fulfillment

Objekt	Forklaring
fulfillment	Den specifikke leverance for en ordre
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"
    }
  ]
}

order

Objekt	Forklaring
order	Den tilhørende ordre
order.shipment_template	Den aktuelt tilknyttede forsendelsesskabelon
order.assigned_to	Den medarbejder, der er tildelt ordren
order.item_lines	Ordrelinjerne for ordren. De er sorteret efter brugerens plukindstillinger
order.sender	Afsender
order.ship_to	Modtager
order.bill_to	Fakturering (kunde)
order.barcodes	Stregkoder, der bruges til at udføre forskellige handlinger

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,
  "shipping_method": "Service point",
  "payment_method": "Card payment",
  "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
    }
   ],
  "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"
  }
}

pick_path

Objekt	Forklaring
pick_path	Den tilhørende plukrute
pick_path.item_lines	Varelinjerne for alle ordrer. De er sorteret efter brugerens plukindstillinger

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
    }
  ]
}