Skip to main content
Qargo

PN - Intégration Pallet Track : quoi, pourquoi et comment.

Relie Qargo et Pallet Track de bout en bout : synchronisation entrante des statuts et des documents, visibilité sortante des documents, des ETA, des statuts d'avarie et des statuts manuels, ainsi que le tri de jour ou de nuit lors du dispatch.

Table des matières
  1. Résumé
  2. Aperçu des fonctionnalités
  3. Terminologie
  4. Prérequis
  5. Mise en route
  6. Entrant : synchronisation des statuts
  7. Sortant : mises à jour de statut manuelles
  8. Entrant : synchronisation des documents
  9. Entrant : synchronisation de la signature du destinataire
  10. Sortant : visibilité des documents
  11. Sortant : visibilité des ETA
  12. Sortant : mises à jour des statuts d’avarie
  13. Dispatch : tri
  14. Dépannage

Suggestions de captures d’écran

  1. Une expédition dans Qargo affichant l’Historique des codes-barres avec les codes de statut Pallet Track et leurs horodatages (par ex. Expédié, Au hub, Livré).
  2. L’action d’intégration de statut manuel sur une expédition, avec la liste déroulante Code de statut et les champs de saisie (remarque, code-barres, dimensions, date/heure).
  3. Une expédition avec un document (POD ou photo de livraison) récupéré depuis Pallet Track.
  4. Une expédition affichant une signature du destinataire (ePOD) avec ses métadonnées : nom du destinataire, emplacement et horodatage de la signature.
  5. Une expédition avec un POD / une signature joints dans Qargo, reproduits dans le portail Pallet Track.
  6. Un arrêt de livraison d’une tournée affichant une heure d’arrivée estimée envoyée à Pallet Track.
  7. Une photo de marchandises endommagées sur une commande et l’historique des statuts de la palette affichant un code d’avarie (DAD / DDD / DAC).
  8. Le champ Tri dans le formulaire de détail de l’expédition, avec la liste déroulante DAY / NIGHT.

Résumé

  • Qu’est-ce que c’est ?

    • L’intégration Pallet Track maintient Qargo et le réseau Pallet Track synchronisés tout au long du cycle de vie de l’expédition. Les statuts et les documents sont récupérés de Pallet Track dans Qargo. Les documents, les ETA (heures d’arrivée estimées), les statuts d’avarie et les mises à jour de statut manuelles sont envoyés de Qargo à Pallet Track. Le tri de jour ou de nuit peut également être défini par expédition lors du dispatch.
  • Pourquoi l’utiliser ?

    • Sans intégration, travailler sur les deux plateformes oblige à mettre à jour les statuts et à transférer les documents à la main dans chaque système. L’automatisation du flux supprime les doubles saisies et réduit les mises à jour oubliées ou tardives. Elle facilite aussi le respect des règles du réseau (remontée des statuts dans les délais) et donne à chaque partie une vue cohérente de chaque expédition.
  • Comment ça fonctionne ?

    • Qargo interroge l’API de statuts de Pallet Track toutes les minutes et applique les mises à jour de statut et les documents entrants à l’expédition correspondante. À l’étape concernée du parcours, Qargo renvoie automatiquement les documents, les ETA et les statuts d’avarie à Pallet Track. Les utilisateurs du bureau peuvent en outre envoyer à la demande un ensemble plus large de codes de statut du réseau. Une valeur de tri est transmise à Pallet Track lors du dispatch des expéditions.

Aperçu des fonctionnalités

Vue d’ensemble de ce que prend en charge l’intégration Pallet Track.

Fonctionnalité Sens Prise en charge Remarques
Export des commandes Q → PT Oui Expéditions dispatchées vers Pallet Track
Import des commandes / implants PT → Q Oui Nécessite le code de compte Pallet Track
Mises à jour et suppressions de jobs Q → PT Oui
Génération d’étiquettes Q → PT Oui Également disponible avant le dispatch
Synchronisation des statuts PT → Q Oui Interrogation toutes les minutes ; plus de 90 codes mappés
Mises à jour des arrêts / statuts Q → PT Oui Automatiques, plus des codes manuels pour les utilisateurs du bureau
POD Les deux Oui POD papier dans Pallet Track
ePOD / signature du destinataire Les deux Oui L’entrant nécessite une configuration supplémentaire de la synchronisation des statuts et le dépôt d’enlèvement responsable
Images de livraison et d’enlèvement Les deux Oui Selon le rôle : envoyées pour le tronçon exécuté par le tenant
COP (confirmation d’enlèvement) Les deux À confirmer Voir la note du relecteur en haut de cette page
Téléversement des documents du client Q → PT Oui Via le portail client et l’API
ETA Q → PT Oui Arrêts de livraison uniquement ; automatique
ETA PT → Q À définir Actuellement non reçue du réseau
Scans de cross-docking Les deux Oui
Mises à jour des statuts d’avarie Q → PT Oui DAD / DDD / DAC, définis par l’arrêt actuel
Tri Q → PT Oui DAY ou NIGHT, appliqué lors du dispatch
Multi-dépôt — Oui Un numéro de dépôt par intégration Pallet Track
Frais via l’API Q → PT À définir Non confirmé
Système de test — Oui Disponible pour les tests avant la mise en production

Terminologie

‼️ Action du relecteur : emplacement de la terminologie. Certains termes ci-dessous décrivent le cadre d’intégration de Qargo plutôt que Pallet Track en particulier et reviennent d’un réseau à l’autre. Ils devraient donc être déplacés vers la page générique PN - Terminologie des réseaux de palettes (puis retirés d’ici) : Synchronisation des statuts, Synchronisation des documents, Visibilité des documents, Historique des codes-barres, Historique de traçabilité des marchandises et URL présignée (ce dernier terme est sans doute trop technique pour une base de connaissances client).

Les termes qui devraient rester sur cette page Pallet Track sont : Pallet Track, Post Status API, Tri et Code de suivi / code palette (nommé par Pallet Track, même si le concept est générique). Remarque : les articles sur les réseaux ne suivent pas strictement cette règle aujourd’hui (par ex. UPN reprend des termes génériques). Confirmer la convention avant de modifier les pages publiées. [encadré rouge]

Les termes ci-dessous sont propres à l’intégration Pallet Track.

Terme Définition
Pallet Track Un réseau de palettes britannique qui relie des transporteurs régionaux pour le fret palettisé à l’échelle nationale.
Code de suivi / code palette Le code-barres ou la référence Pallet Track attribué à une expédition, utilisé pour associer les mises à jour et les documents à la bonne commande.
Historique des codes-barres L’enregistrement de toutes les mises à jour de statut d’une expédition dans Qargo, affiché dans les informations de code-barres de l’expédition.
Synchronisation des statuts Récupération automatique des mises à jour de statut des expéditions depuis Pallet Track dans Qargo.
Synchronisation des documents Import automatique des documents depuis Pallet Track dans Qargo.
Visibilité des documents Transmission automatique des documents de Qargo vers Pallet Track.
Post Status API L’interface Pallet Track utilisée par Qargo pour envoyer les mises à jour de statut.
Tri Le moment où les marchandises sont triées au hub Pallet Track : NIGHT (standard, de nuit) ou DAY (en journée).
Historique de traçabilité des marchandises L’enregistrement des événements et des incidents (comme une avarie) consignés pour une palette donnée.
URL présignée Un lien temporaire et sécurisé fourni par Pallet Track, qui donne un accès limité dans le temps à un document.

Prérequis

  • L’intégration Pallet Track doit être active sur le compte Qargo. Chaque domaine fonctionnel est activé par tenant par l’équipe Qargo.
  • Les expéditions doivent être dispatchées vers Pallet Track et porter un code de suivi Pallet Track valide pour que les statuts et les documents circulent.
  • Les types de document à synchroniser doivent être activés dans la configuration des documents du compte.
  • Pour les mises à jour de statut manuelles, la commande doit déjà avoir été exportée vers Pallet Track et l’action de statut manuel doit être configurée sur l’intégration.

Mise en route

L’intégration Pallet Track est configurée et activée par Qargo. Pour commencer, contacter l’Account Manager ou l’équipe intégrations. Les éléments suivants sont nécessaires côté client :

  • Numéro de dépôt Pallet Track : l’identifiant du dépôt dans Pallet Track. Un dépôt correspond à une intégration Pallet Track ; les opérations multi-dépôts nécessitent le numéro de chaque dépôt.
  • Code de compte Pallet Track : requis uniquement si des implants sont utilisés (commandes créées dans le portail Pallet Track dont le dépôt demandeur est le propre dépôt du client).
  • Fonctionnalités requises : confirmation des flux nécessaires : import/export des commandes, synchronisation des statuts, synchronisation des documents (quels documents, et dans un seul sens ou dans les deux), génération d’étiquettes, synchronisation des ETA, synchronisation du cross-docking, frais via l’API et implants.
  • Configuration des dépôts : si l’activité est multi-dépôt, ainsi que le rôle de chaque dépôt (enlèvement, livraison, demandeur) et les niveaux de service applicables.
  • Contacts : un contact informatique à mettre en copie des échanges avec Pallet Track, et un contact d’escalade pour les problèmes (nom et e-mail).

Entrant : synchronisation des statuts

Qargo interroge l’API de statuts de Pallet Track toutes les minutes et importe les nouvelles mises à jour de statut des expéditions actives. Chaque mise à jour est associée à la commande et à l’unité de manutention grâce au code de suivi de la palette. Les mises à jour apparaissent automatiquement dans l’Historique des codes-barres de l’expédition, sans aucune action manuelle.

  • Plus de 90 codes de statut distincts sont pris en charge, chacun mappé au statut Qargo approprié.
  • Environ 70 codes administratifs ou informatifs (par ex. demandes de documents ou d’avoirs) n’ont pas d’équivalent dans Qargo et sont enregistrés comme Autre. Ils sont conservés à des fins d’audit mais ne modifient pas le statut principal de l’expédition.

Mappages courants :

Code Pallet Track Statut Qargo Signification
DSO Expédié Marchandises expédiées depuis le dépôt d’origine
DSI Au hub Marchandises reçues au hub Pallet Track
DSV Livré Marchandises livrées avec succès
DUE Non livrable La livraison n’a pas pu être effectuée
Other Autre Codes administratifs / informatifs (sans équivalent dans Qargo)

Sortant : mises à jour de statut manuelles

Une action d’intégration configurable permet aux utilisateurs du bureau d’envoyer à la demande des codes de statut Pallet Track supplémentaires pour une expédition, au-delà des statuts envoyés automatiquement par le processus standard. Cette action couvre le large éventail de statuts du cycle de vie (échecs d’enlèvement, exceptions de livraison, modifications, nouveaux avis de passage, etc.) que le réseau impose aux dépôts de déclarer. Beaucoup de ces statuts proviennent du bureau plutôt que de la cabine.

Pour envoyer une mise à jour de statut manuelle :

  1. Ouvrir l’expédition à mettre à jour.
  2. Déclencher l’action de statut Pallet Track.
  3. Sélectionner le code de statut requis dans la liste déroulante.
  4. Remplir les champs facultatifs pertinents : une remarque, la palette concernée (code-barres), les dimensions de la palette (poids, longueur, hauteur, largeur) ainsi que la date et l’heure (l’heure actuelle est utilisée si aucune n’est indiquée).
  5. Envoyer la mise à jour à Pallet Track.

Entrant : synchronisation des documents

Les documents téléversés dans Pallet Track sont automatiquement détectés, importés dans Qargo et joints à l’expédition correspondante. Les fichiers sont récupérés à l’aide des URL présignées renvoyées par l’API de statuts, puis traités par la synchronisation des documents standard de Qargo.
Types de document entrants pris en charge : POD, photos de livraison, photos d’enlèvement.

Entrant : synchronisation de la signature du destinataire

Lorsque le réseau Pallet Track effectue une livraison et que le destinataire signe, la signature du destinataire est synchronisée dans Qargo sous forme de document ePOD avec ses métadonnées. Elle est enregistrée directement sur l’expédition comme preuve de livraison :

  • La signature du destinataire (document ePOD)
  • Le nom du destinataire
  • L’emplacement de la signature
  • L’horodatage de la signature

Sortant : visibilité des documents

Lorsque des documents sont ajoutés à une expédition dans Qargo, ils sont automatiquement envoyés à Pallet Track et liés à l’enregistrement de l’expédition correspondante. Pour les signatures du destinataire, le téléversement inclut également le nom du signataire et l’horodatage de la capture.

Type de document Qargo Affichage dans Pallet Track
Preuve de livraison (POD) POD papier
Signature du destinataire POD électronique (ePOD)
Photo de livraison Photographie de livraison
Photo d’enlèvement Photographie d’enlèvement

La transmission dépend du rôle : les documents sont envoyés uniquement pour le tronçon exécuté par le tenant.

  • Les POD, les signatures du destinataire et les photos de livraison sont envoyés lorsque le tenant effectue la livraison.
  • Les photos d’enlèvement sont envoyées lorsque le tenant effectue l’enlèvement.

Sortant : visibilité des ETA

Lorsque l’heure de début estimée d’un arrêt de livraison change dans Qargo (progression du chauffeur, retards, optimisation des tournées), l’ETA mise à jour est automatiquement envoyée à Pallet Track. Le hub peut ainsi planifier le personnel, l’équipement et le tri. Les données envoyées comprennent l’ETA de l’arrêt de livraison, la référence de l’expédition, la référence du job Pallet Track, le code du dépôt et l’ordre de passage de l’arrêt.

Sortant : mises à jour des statuts d’avarie

Lorsqu’une photo de marchandises endommagées est téléversée sur une commande, Qargo vérifie quelles palettes ont un incident enregistré dans leur historique de traçabilité des marchandises. Qargo envoie alors une mise à jour de statut d’avarie à Pallet Track pour ces palettes uniquement. Le code indique à quel moment du parcours l’avarie est signalée et dépend de l’arrêt actuel :

  • DAD (endommagé à l’arrivée au dépôt) : l’arrêt actuel est un début de transfert de marchandises au dépôt (arrivée des marchandises).
  • DDD (endommagé au départ du dépôt) : l’arrêt actuel est une fin de transfert de marchandises au dépôt (départ des marchandises).
  • DAC (endommagé à l’arrivée chez le destinataire) : l’arrêt actuel est l’arrêt de livraison.

Dispatch : tri

Le tri détermine le moment où les marchandises sont triées au hub Pallet Track. Une valeur de Tri (NIGHT : standard, de nuit ; DAY : pendant les heures de jour du hub) est définie par expédition et transmise à Pallet Track lors du dispatch.
Pour définir le tri d’une expédition :

  1. Accéder à la commande et ouvrir l’expédition affectée à Pallet Track.
  2. Configurer le champ Tri (dans la section des champs supplémentaires) sur NIGHT ou DAY.
  3. Enregistrer l’expédition. La valeur est appliquée lors du dispatch.

Une valeur par défaut peut également être définie via l’importation de commande, en mappant le champ source au champ Qargo pallet_track__sortation et en configurant une valeur par défaut (NIGHT ou DAY) pour les expéditions sans valeur explicite. Cette valeur peut être remplacée pour chaque expédition avant le dispatch.


Dépannage

Problème Solution
Les mises à jour de statut n’apparaissent pas dans Qargo Vérifier que l’intégration est active et que l’expédition est dispatchée vers Pallet Track avec un code de suivi correspondant. Compter jusqu’à une minute pour l’affichage des nouveaux statuts.
Un statut s’affiche comme Autre Comportement attendu pour environ 70 codes administratifs sans équivalent dans Qargo ; l’historique complet figure dans la chronologie des codes-barres.
L’action de statut manuel n’est pas visible Vérifier que l’action de statut manuel est configurée sur l’intégration et que l’utilisateur est un utilisateur du bureau.
Statut manuel rejeté Vérifier que la commande a été exportée vers Pallet Track et que le code-barres saisi correspond à une palette de l’expédition ; certains codes nécessitent des détails supplémentaires avant l’envoi.
Les documents de Pallet Track n’apparaissent pas dans Qargo Vérifier que la synchronisation des documents est active et que le type est POD, photo de livraison ou photo d’enlèvement (l’ePOD nécessite une configuration supplémentaire ; la COP n’est pas prise en charge).
Signature du destinataire / métadonnées manquantes Vérifier que la synchronisation des documents et la synchronisation des statuts sont actives, que la configuration supplémentaire des métadonnées de signature est en place et que le dépôt est le dépôt d’enlèvement responsable.
Les documents de Qargo n’apparaissent pas dans Pallet Track Vérifier que la visibilité des documents est activée, qu’un code de suivi valide est présent et que le document a été ajouté à la bonne étape (livraison ou enlèvement).
ETA non envoyée à Pallet Track Vérifier que l’arrêt est un arrêt de livraison, que le dépôt est la partie qui livre et que l’expédition est dispatchée vers Pallet Track (les ETA d’enlèvement ne sont pas prises en charge).
Aucun statut d’avarie envoyé après le téléversement d’une photo Vérifier que les palettes concernées ont bien un incident dans leur historique de traçabilité des marchandises : seules ces palettes reçoivent une mise à jour.
Code d’avarie inattendu (DAD/DDD/DAC) Le code dépend de l’arrêt actuel ; vérifier quel arrêt était en cours lors du téléversement de la photo.
Le champ Tri n’est pas visible Vérifier que l’intégration est configurée et que l’expédition est affectée à Pallet Track ; ce champ est propre à Pallet Track.
Erreurs de tri lors du dispatch La valeur doit être NIGHT ou DAY (sans distinction de casse) ; les valeurs non valides sont rejetées par Pallet Track.