Skip to main content
Qargo

Dokumente – Variablenreferenz für Ladungsblätter

Eine vollständige Übersicht aller Variablen, die in Dokumentvorlagen für Ladungsblätter verfügbar sind. Die Variablennamen entsprechen genau den Namen in der Variablenauswahl {{}} im Vorlageneditor (Konfiguration > Vorlagen > Dokumente).

Inhaltsverzeichnis
  1. Aufbau dieser Referenz
  2. Versand
  3. Fahrtgruppe
  4. Nutzer
  5. Mandant
  6. Erster Kunde
  7. Warenübersicht
  8. Ressourcen
  9. Versände [Loop]
  10. Kapazitätsfelder innerhalb von Versänden
  11. Etappen für Abholung und Lieferung [Loop]

Aufbau dieser Referenz

Die Variablen in diesem Artikel gibt es in zwei Arten:

  • Einzelwert: direkt auf der Fahrt verfügbar. Sie lassen sich über die Auswahl #{{}} an beliebiger Stelle in der Vorlage einfügen und geben einen einzelnen Wert aus. Beispiele: Shipment Name, Tenant > Legal Name, Trip group > Display Name.
  • Schleife: enthält mehrere Elemente (eines pro Fahrer, pro Stopp, pro Versand usw.). Im Datenschema-Bereich rechts im Editor sind diese Variablen mit dem Kennzeichen Loop markiert. In diesem Artikel sind sie mit [Loop] gekennzeichnet.

Schleifenvariablen werden in einen Tabellenabschnitt eingefügt, der so eingestellt ist, dass er über diese Datenquelle iteriert.

Beim Konfigurieren eines Tabellenabschnitts im Vorlageneditor wird ausgewählt, über welche Schleife er sich wiederholen soll (z. B. Pickup stages). Die Tabelle erzeugt dann automatisch eine Zeile pro Element.

Die Variablen in diesen Zeilenzellen beziehen sich jeweils auf ein einzelnes Element der Schleife. In einer Tabelle für Pickup stages gibt Consignment > Consignment Reference Number also die Referenz für jeden einzelnen Stopp aus, eine pro Zeile.


Versand

Direkt auf jedem Ladungsblatt verfügbar, ohne Schleife.

Variable Beschreibung
Shipment Name Interner Referenzname der Fahrt (z. B. „Trip-0001“)
Shipment Display Name Für Nutzer sichtbarer Anzeigename der Fahrt
Creation Timestamp Datum und Uhrzeit der Erstellung der Fahrt
Estimated Start Timestamp Voraussichtliches Startdatum und -uhrzeit
Planned Start Timestamp Geplantes Startdatum und -uhrzeit
License Plates Alle Fahrzeugkennzeichen, in einer Zeichenfolge zusammengefasst
Order Names Alle zugehörigen Auftragsreferenzen, zusammengefasst

Fahrtgruppe

Variablen der Fahrtgruppe, die mit dieser Fahrt verknüpft ist.

Variable Beschreibung
Trip group > Display Name Für Nutzer sichtbarer Anzeigename der Fahrtgruppe
Trip group > Name Interner Name der Fahrtgruppe
Trip group > Reference Number Referenznummer der Fahrtgruppe

Nutzer

Variable Beschreibung
User > Email E-Mail-Adresse des Nutzers, der das Dokument erzeugt hat

Mandant

Die Unternehmensdaten, wie sie in Qargo konfiguriert sind.

Variable Beschreibung
Tenant > Legal Name Rechtlicher Unternehmensname
Tenant > Vat Number MwSt.-Nummer
Tenant > Iban IBAN
Tenant > Bic BIC
Tenant > Billing location > Name Name des Standorts
Tenant > Billing location > Display Name Anzeigename des Standorts
Tenant > Billing location > Address Straßenadresse (kurz)
Tenant > Billing location > Address Long Vollständige Adresse, einzeilig
Tenant > Billing location > Address Long Multiline Vollständige Adresse, mehrzeilig
Tenant > Billing location > Address Second Line Zweite Adresszeile
Tenant > Billing location > City Ort
Tenant > Billing location > Postal Code Postleitzahl
Tenant > Billing location > Country Name des Landes
Tenant > Billing location > Country Code ISO-Ländercode
Tenant > Billing location > Location Short Kurze Standortangabe
Tenant > Billing location > Location Long Vollständige Standortangabe
Tenant > Billing location > Location Long Multiline Vollständige Standortangabe, mehrzeilig
Tenant > Billing location > Location Long With Full Country Vollständige Standortangabe mit Name des Landes
Tenant > Billing location > Contact Name Name der Kontaktperson
Tenant > Billing location > Contact Email E-Mail-Adresse des Kontakts
Tenant > Billing location > Contact Phone Telefonnummer des Kontakts

Erster Kunde

Details des Hauptkunden der Fahrt. Nützlich, wenn eine Fahrt einen Hauptkunden hat und keine Schleife benötigt wird.

Variable Beschreibung
First customer > Name Name des Kunden
First customer > Legal Name Rechtlicher Name
First customer > Code Kundencode
First customer > Vat Number MwSt.-Nummer
First customer > Currency Währung
First customer > Accounting Customer Code Code im Buchhaltungssystem
First customer > Company Registration Number Handelsregisternummer
First customer > Factoring Code Code für die Rechnungsstellung
First customer > Note Freitextnotiz zum Kunden
First customer > Billing location > … Vollständige Adressfelder, gleicher Aufbau wie Tenant > Billing location

Warenübersicht

Zusammengefasste Warendaten über alle Versände der Fahrt.

Variable Beschreibung
Good summary > Goods Weight Total Gesamtgewicht
Good summary > Goods Weight Unit Gewichtseinheit (z. B. kg)
Good summary > Goods Volume Total Gesamtvolumen
Good summary > Goods Volume Unit Volumeneinheit
Good summary > Goods Loading Meters Total Lademeter gesamt
Good summary > Goods Loading Meters Unit Einheit der Lademeter
Good summary > Goods Pallet Spaces Total Palettenstellplätze gesamt
Good summary > Goods Quantity Total Gesamtmenge
Good summary > Goods Ordered Weight Total Bestelltes Gewicht gesamt
Good summary > Goods Ordered Volume Total Bestelltes Volumen gesamt
Good summary > Goods Ordered Quantity Total Bestellte Menge gesamt
Good summary > Goods Ordered Loading Meters Total Bestellte Lademeter gesamt
Good summary > Goods Descriptions Alle Warenbeschreibungen, zusammengefasst
Good summary > Goods Products Alle Produktnamen, zusammengefasst
Good summary > Goods Summaries Vollständiger Text der Warenübersicht
Good summary > Goods Packaging Verpackungsarten
Good summary > Goods Dimensions Abmessungen der Waren
Good summary > Goods Adr Summary ADR-Übersichtstext
Good summary > Goods Adr Numbers ADR-UN-Nummern
Good summary > Goods Adr Points Total ADR-Punkte gesamt
Good summary > Goods Good Trace Total Good-Trace-Wert gesamt
Good summary > Per Product [Loop] Aufschlüsselung pro Produkttyp
Good summary > Per Parent Product [Loop] Aufschlüsselung pro übergeordnetem Produkt

Ressourcen

Fahrzeuge und Personal, die der Fahrt zugewiesen sind. Jeder Untertyp ist eine Loop-Schleife. Diese Variablen werden in einen Tabellenabschnitt eingefügt, der für eine Schleife über diesen Ressourcentyp konfiguriert ist.

Fahrer – Resources > Drivers

Variable Beschreibung
Name Vollständiger Name
First Name Vorname
Last Name Nachname
Code Fahrercode
Phone Number Telefonnummer
Pincode PIN-Code des Fahrers
Pincode Url URL-basierte PIN (für QR-Code oder Barcode)
Is Primary Hauptfahrer (true/false)
Resource Type Kennung des Ressourcentyps
Company Unternehmensdaten des Subunternehmers

Traktoren – Resources > Tractors

Variable Beschreibung
Name Name des Fahrzeugs
Code Fahrzeugcode
License Plate Kennzeichen
Model Modell
Fuel Type Kraftstoffart
Is Primary Haupttraktor (true/false)
Company Unternehmensdaten des Subunternehmers

Trailer – Resources > Trailers

Variable Beschreibung
Name Name des Trailers
Code Trailercode
License Plate Kennzeichen
Model Modell
Ilu Code ILU-Code
Fuel Type Kraftstoffart
Exterior Length Außenlänge
Exterior Width Außenbreite
Exterior Height Außenhöhe
Distance Uom Maßeinheit der Entfernung
Is Primary Haupttrailer (true/false)

Weitere Ressourcen-Schleifen

Schleife Inhalt
Resources > Subcontractors Subunternehmer
Resources > Chassis Chassis
Resources > Containers Container
Resources > Ferries Fähren
Resources > Handling Umschlagressourcen
Resources > Rigids Solofahrzeuge
Resources > Trains Züge
Resources > Vans Vans
Resources > Vehicles Alle Fahrzeuge zusammen
Resources > All Resource Allocations Alle Zuweisungen über alle Ressourcentypen

Versände [Loop]

Für Ladungsblätter, die mehrere Versände umfassen. Jedes Element der Schleife enthält:

Variable Beschreibung
Shipment Name Name des Versands
Shipment Display Name Anzeigename des Versands
Estimated Start Timestamp Voraussichtliche Startzeit
Transport Group Details der Fahrtgruppe (gleiche Felder wie im Abschnitt Fahrtgruppe oben)
Resources Ressourcen-Schleifen für diesen Versand
Pickup Stages [Loop] Abholungsdetails pro Stopp für diesen Versand

Kapazitätsfelder innerhalb von Versänden

Variable Beschreibung
Capacity > Weight Total Gesamtgewicht
Capacity > Volume Total Gesamtvolumen
Capacity > Loading Meters Total Lademeter gesamt
Capacity > Pallet Spaces Total Palettenstellplätze gesamt
Capacity > Quantity Total Gesamtmenge
Capacity > Adr Points Total ADR-Punkte gesamt
Capacity > Capacity Weight Kapazitätsgrenze für das Gewicht
Capacity > Capacity Loading Meters Kapazitätsgrenze für Lademeter
Capacity > Capacity Pallet Spaces Kapazitätsgrenze für Palettenstellplätze

Etappen für Abholung und Lieferung [Loop]

Verfügbar als Schleifen auf oberster Ebene (Pickup stages, Delivery stages, Consignment delivery stages) und innerhalb jedes Versands (Shipments > Pickup Stages). Jede Etappe steht für einen Stopp und die zugehörige Sendung.

Variable Beschreibung
Consignment > Consignment Reference Number Referenz der Sendung
Consignment > Customer Reference Number Eigene Referenz des Kunden
Consignment > Cmr Reference Number CMR-Referenznummer
Consignment > Container Number Container-Nr.
Consignment > Container Type Containertyp
Consignment > Buyer Details des Käufers (gleiche Adressfelder wie First customer)
Consignment > Customer Details des Kunden (gleicher Aufbau)
Consignment > Delivery Stop Standortdetails des Lieferstopps
Consignment > Container Yard Details des Containerdepots
Consignment > Custom Fields Benutzerdefinierte Felder der Sendung

Weitere Informationen zu Vorlagen im folgenden Artikel:
📎 Dokumentvorlagen – was, warum und wie