Skip to main content
Qargo

Documents : référence des variables de la feuille de chargement

Référence complète de toutes les variables disponibles dans les modèles de document Feuille de chargement. Les noms des variables correspondent exactement à ceux affichés dans le sélecteur de variables {{}} de l'éditeur de modèles (Configuration > Modèles > Documents).

Table des matières
  1. Comment lire cette référence
  2. Expédition
  3. Groupe de tournées
  4. Utilisateur
  5. Tenant
  6. Premier client
  7. Récapitulatif des marchandises
  8. Ressources
  9. Expéditions [Loop]
  10. Champs de capacité dans les expéditions
  11. Étapes d’enlèvement / de livraison [Loop]

Comment lire cette référence

Les variables de cet article sont de deux types :

  • Valeur unique : disponibles directement sur la tournée. Elles s’insèrent n’importe où dans le modèle à l’aide du sélecteur #{{}} et renvoient une seule valeur. Exemples : Shipment Name, Tenant > Legal Name, Trip group > Display Name.
  • Boucle : elles contiennent plusieurs éléments (un par chauffeur, par arrêt, par expédition, etc.). Dans le panneau du schéma de données, à droite de l’éditeur, elles sont signalées par un badge Loop. Dans cet article, elles sont signalées par [Loop].

Pour utiliser les variables de boucle, les ajouter dans une section de tableau configurée pour boucler sur cette source de données.

Lors de la configuration d’une section de tableau dans l’éditeur de modèles, choisir la boucle sur laquelle elle doit se répéter (par exemple, Pickup stages). Le tableau génère alors automatiquement une ligne par élément.

Les variables insérées dans les cellules de ces lignes portent sur un seul élément de la boucle. Dans un tableau Pickup stages, Consignment > Consignment Reference Number renvoie ainsi la référence de chaque arrêt, une par ligne.


Expédition

Disponibles directement sur chaque feuille de chargement, sans boucle.

Variable Description
Shipment Name Nom de référence interne de la tournée (par ex. « Trip-0001 »)
Shipment Display Name Nom affiché de la tournée, visible par les utilisateurs
Creation Timestamp Date et heure de création de la tournée
Estimated Start Timestamp Date et heure de début estimées
Planned Start Timestamp Date et heure de début planifiées
License Plates Toutes les plaques d’immatriculation des véhicules, réunies en une seule chaîne
Order Names Toutes les références des commandes associées, réunies

Groupe de tournées

Variables du groupe de tournées lié à cette tournée.

Variable Description
Trip group > Display Name Nom affiché du groupe de tournées, visible par les utilisateurs
Trip group > Name Nom interne du groupe de tournées
Trip group > Reference Number Numéro de référence du groupe de tournées

Utilisateur

Variable Description
User > Email Adresse e-mail de l’utilisateur qui a généré le document

Tenant

Coordonnées de l’entreprise telles que configurées dans Qargo.

Variable Description
Tenant > Legal Name Raison sociale
Tenant > Vat Number Numéro de TVA
Tenant > Iban IBAN
Tenant > Bic BIC
Tenant > Billing location > Name Nom de l’emplacement
Tenant > Billing location > Display Name Nom affiché de l’emplacement
Tenant > Billing location > Address Adresse (courte)
Tenant > Billing location > Address Long Adresse complète, sur une ligne
Tenant > Billing location > Address Long Multiline Adresse complète, sur plusieurs lignes
Tenant > Billing location > Address Second Line Deuxième ligne d’adresse
Tenant > Billing location > City Ville
Tenant > Billing location > Postal Code Code postal
Tenant > Billing location > Country Nom du pays
Tenant > Billing location > Country Code Code pays ISO
Tenant > Billing location > Location Short Emplacement, format court
Tenant > Billing location > Location Long Emplacement, format complet
Tenant > Billing location > Location Long Multiline Emplacement complet, sur plusieurs lignes
Tenant > Billing location > Location Long With Full Country Emplacement complet avec le nom du pays
Tenant > Billing location > Contact Name Nom de la personne de contact
Tenant > Billing location > Contact Email E-mail de contact
Tenant > Billing location > Contact Phone Téléphone de contact

Premier client

Détails du client principal de la tournée. Utile lorsqu’une tournée a un seul client principal et qu’aucune boucle n’est nécessaire.

Variable Description
First customer > Name Nom du client
First customer > Legal Name Raison sociale
First customer > Code Code client
First customer > Vat Number Numéro de TVA
First customer > Currency Devise
First customer > Accounting Customer Code Code dans le système de comptabilité
First customer > Company Registration Number Numéro d’immatriculation de l’entreprise
First customer > Factoring Code Code d’affacturage
First customer > Note Note libre sur le client
First customer > Billing location > … Champs d’adresse complets, même structure que Tenant > Billing location

Récapitulatif des marchandises

Données agrégées des marchandises de toutes les expéditions de la tournée.

Variable Description
Good summary > Goods Weight Total Poids total
Good summary > Goods Weight Unit Unité de poids (par ex. kg)
Good summary > Goods Volume Total Volume total
Good summary > Goods Volume Unit Unité de volume
Good summary > Goods Loading Meters Total Total des mètres de chargement
Good summary > Goods Loading Meters Unit Unité des mètres de chargement
Good summary > Goods Pallet Spaces Total Total des places palettes
Good summary > Goods Quantity Total Quantité totale
Good summary > Goods Ordered Weight Total Poids total commandé
Good summary > Goods Ordered Volume Total Volume total commandé
Good summary > Goods Ordered Quantity Total Quantité totale commandée
Good summary > Goods Ordered Loading Meters Total Total des mètres de chargement commandés
Good summary > Goods Descriptions Toutes les descriptions des marchandises, réunies
Good summary > Goods Products Tous les noms de produits, réunis
Good summary > Goods Summaries Texte complet du récapitulatif des marchandises
Good summary > Goods Packaging Types d’emballage
Good summary > Goods Dimensions Dimensions des marchandises
Good summary > Goods Adr Summary Texte du récapitulatif ADR
Good summary > Goods Adr Numbers Numéros UN ADR
Good summary > Goods Adr Points Total Total des points ADR
Good summary > Goods Good Trace Total Valeur totale de traçage des marchandises
Good summary > Per Product [Loop] Détail par type de produit
Good summary > Per Parent Product [Loop] Détail par produit parent

Ressources

Véhicules et personnel affectés à la tournée. Chaque sous-type est une boucle : les ajouter dans une section de tableau configurée pour boucler sur ce type de ressource.

Chauffeurs : Resources > Drivers

Variable Description
Name Nom complet
First Name Prénom
Last Name Nom
Code Code chauffeur
Phone Number Numéro de téléphone
Pincode Code PIN du chauffeur
Pincode Url PIN sous forme d’URL (pour QR code / code-barres)
Is Primary Chauffeur principal (true/false)
Resource Type Identifiant du type de ressource
Company Détails de l’entreprise sous-traitante

Tracteurs : Resources > Tractors

Variable Description
Name Nom du véhicule
Code Code du véhicule
License Plate Plaque d’immatriculation
Model Modèle
Fuel Type Type de carburant
Is Primary Tracteur principal (true/false)
Company Détails de l’entreprise sous-traitante

Remorques : Resources > Trailers

Variable Description
Name Nom de la remorque
Code Code de la remorque
License Plate Plaque d’immatriculation
Model Modèle
Ilu Code Code ILU
Fuel Type Type de carburant
Exterior Length Longueur extérieure
Exterior Width Largeur extérieure
Exterior Height Hauteur extérieure
Distance Uom Unité de mesure de distance
Is Primary Remorque principale (true/false)

Autres boucles de ressources

Boucle Contenu
Resources > Subcontractors Entreprises sous-traitantes
Resources > Chassis Châssis
Resources > Containers Conteneurs
Resources > Ferries Ferries
Resources > Handling Ressources de manutention
Resources > Rigids Porteurs
Resources > Trains Trains
Resources > Vans Fourgons
Resources > Vehicles Tous les véhicules réunis
Resources > All Resource Allocations Toutes les affectations, tous types de ressources confondus

Expéditions [Loop]

Pour les feuilles de chargement couvrant plusieurs expéditions. Chaque élément de la boucle contient :

Variable Description
Shipment Name Nom de l’expédition
Shipment Display Name Nom affiché de l’expédition
Estimated Start Timestamp Heure de début estimée
Transport Group Détails du groupe de tournées (mêmes champs que dans la section Groupe de tournées ci-dessus)
Resources Boucles de ressources propres à cette expédition
Pickup Stages [Loop] Détail de l’enlèvement par arrêt pour cette expédition

Champs de capacité dans les expéditions

Variable Description
Capacity > Weight Total Poids total
Capacity > Volume Total Volume total
Capacity > Loading Meters Total Total des mètres de chargement
Capacity > Pallet Spaces Total Total des places palettes
Capacity > Quantity Total Quantité totale
Capacity > Adr Points Total Total des points ADR
Capacity > Capacity Weight Limite de capacité en poids
Capacity > Capacity Loading Meters Limite de capacité en mètres de chargement
Capacity > Capacity Pallet Spaces Limite de capacité en places palettes

Étapes d’enlèvement / de livraison [Loop]

Disponibles comme boucles de premier niveau (Pickup stages, Delivery stages, Consignment delivery stages) et dans chaque expédition (Shipments > Pickup Stages). Chaque étape représente un arrêt et son expédition.

Variable Description
Consignment > Consignment Reference Number Référence de l’expédition
Consignment > Customer Reference Number Référence propre du client
Consignment > Cmr Reference Number Numéro de référence CMR
Consignment > Container Number N° du conteneur
Consignment > Container Type Type de conteneur
Consignment > Buyer Détails de l’acheteur (mêmes champs d’adresse que First customer)
Consignment > Customer Détails du client (même structure)
Consignment > Delivery Stop Détails de l’emplacement de l’arrêt de livraison
Consignment > Container Yard Détails du dépôt de conteneurs
Consignment > Custom Fields Champs personnalisés de l’expédition

Pour en savoir plus sur les modèles, lire l’article suivant :
📎 Modèles de documents : quoi, pourquoi et comment