Intégration externe - Suivi de colis international (17TRACK, DHL)

cover-colis

Salut tout le monde !

L’intégration La Poste (Intégration externe - La Poste (suivi de colis)) suit les colis La Poste, Colissimo et Chronopost… mais nos colis passent aussi par UPS, DPD, GLS, Mondial Relay, ou arrivent de Chine après trois semaines de voyage. Voici donc son complément pour tout le reste, international compris. @ruegerth, tu demandais DHL et les postes autrichienne et suisse : c’est pour toi ^^

Ce que ça fait

  • Un appareil par colis, avec un statut commun à tous les transporteurs : enregistré, en transit, en livraison, à retirer, problème, livré. Et aussi la dernière étape avec le texte du transporteur, le lieu, la date, le transporteur et la date de livraison prévue.
  • Trois déclencheurs : « En cours de livraison », « Livré » et « Le colis demande votre attention » (à retirer en point relais, ou problème), chacun filtrable sur un colis précis.
  • Trois actions de scène : suivre un colis (même à partir de l’objet d’un mail), arrêter de le suivre, et lire l’état de mes colis.
  • Un widget « Mes colis », qui montre d’abord ceux qui vous attendent ; un appui ouvre l’historique et le lien de suivi.
  • Un colis livré est archivé tout seul après 7 jours (réglable).
  • En français, anglais, allemand et espagnol.

Qui passe par quoi : les numéros DHL et Deutsche Post passent par l’API officielle de DHL. Tout le reste passe par 17TRACK, qui reconnaît le transporteur à partir du numéro : UPS, FedEx, USPS, GLS, DPD, Royal Mail, les envois de Chine… et les postes nationales, dont la poste autrichienne et la poste suisse. UPS, FedEx et USPS ont bien leurs propres API, mais elles demandent un compte professionnel : 17TRACK est bien plus simple. Pour La Poste, Colissimo et Chronopost, gardez l’intégration La Poste, qui lit l’API officielle.

Le truc sympa

Colis en cours de livraison et personne à la maison → « Le colis Amazon arrive aujourd’hui »
Colis à retirer en point relais → rappel le lendemain matin avec l’adresse de la dernière étape
Tous les matins à 8 h → annonce vocale « Vous avez 2 colis en route, dont un livré aujourd’hui »

Installation

:warning: Gladys 5.1 minimum.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub

  1. Créez une clé gratuite 17TRACK sur https://api.17track.net, une clé gratuite DHL sur https://developer.dhl.com (API « Shipment Tracking - Unified »), ou les deux. Avec la seule clé DHL, seuls les colis DHL sont suivis.
  2. Collez la ou les clés dans la configuration.
  3. Utilisez l’action « Suivre un colis » avec le numéro, puis ajoutez l’appareil du colis dans l’onglet Découverte.

Petites réserves honnêtes

  • Les offres gratuites sont limitées, et l’intégration s’y tient : 240 requêtes DHL par jour au plus, et un seul enregistrement 17TRACK par colis. Côté 17TRACK, l’offre gratuite donne un nombre limité d’enregistrements de numéros (200 au départ d’après leur aide, c’est un peu flou) ; « Lire les colis maintenant » affiche ce qui reste.
  • 40 colis suivis au plus, et l’appareil d’un colis archivé reste dans Gladys : à supprimer à la main.
  • DHL ne dit pas « en livraison » ni « à retirer » : l’intégration le devine d’après le texte de l’étape, en anglais et en allemand. Une formulation inhabituelle peut rester en « En transit ».
  • Les étapes gardent le texte du transporteur, sans traduction.
  • Développée sans compte 17TRACK ni DHL. J’ai vérifié depuis chez moi que les vraies API de 17TRACK et de DHL répondent et refusent proprement une fausse clé, mais aucun vrai colis n’a encore été suivi. Les postes autrichienne et suisse passent par 17TRACK et n’ont pas été vérifiées une à une : @ruegerth, tes retours seront précieux.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à 17TRACK, à DHL ni aux transporteurs cités.

Dépôt : GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub

@guim31 Bonjour, pas pour moi, mais pour les 100 millions d’Européens qui parlent par hasard allemand :joy: :joy: :joy:

C’est logique que je l’essaie.
Cordialement

Tom