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