Aller au contenu
Essai gratuit de 14 jours, sans carte9 langues176 types d'activité · 50 applications
FR· USD
Essayer une démo en directEssai gratuit

Webhooks de statut des transporteurs : comment ça marche

Un transporteur peut envoyer chaque changement de statut d'un colis à votre espace de travail dès qu'il se produit, sans attendre la synchronisation toutes les demi-heures. Chaque envoi est vérifié avec un secret, appliqué une seule fois, et ne fait jamais reculer un colis.

Leçon 8 sur 12 · Comment ça marche

  • environ 3 min
  • Deliveries & packing → Couriers → Status webhook

Comment ça marche

  1. Sur Deliveries → Couriers, ouvrez Status webhook sous un transporteur API et choisissez Create webhook secret. Copiez l'adresse du webhook (et le secret) dans le panneau marchand du transporteur.

  2. Chaque envoi doit prouver qu'il vient du transporteur : une signature faite avec le secret, le secret dans un en-tête ou une adresse secrète, selon le transporteur. Tout le reste est refusé.

  3. Le colis est retrouvé par son numéro de suivi ou d'envoi ; le bon de livraison passe alors à en cours de livraison, livré ou retourné, et l'argent encaissé est enregistré.

  4. Le même envoi reçu deux fois n'est appliqué qu'une fois. Un ancien rapport arrivé en retard, ou un retour en arrière, est seulement ajouté à l'historique du colis.

  5. Rotate secret crée immédiatement un nouveau secret ; saisissez-le aussitôt chez le transporteur, l'ancien cesse de fonctionner.

Où le trouver

Réglages qui le modifient

Liste de contrôle

Avant de continuer, vérifiez que vous savez :

  • Ouvrir Deliveries & packing → Couriers → Status webhook
  • Sur Deliveries → Couriers, ouvrez Status webhook sous un transporteur API et choisissez Create webhook secret.
  • Chaque envoi doit prouver qu'il vient du transporteur : une signature faite avec le secret, le secret dans…
  • Le colis est retrouvé par son numéro de suivi ou d'envoi ; le bon de livraison passe alors à en cours de…
  • Le même envoi reçu deux fois n'est appliqué qu'une fois.

Astuces et erreurs fréquentes

  • L'encadré indique quand le dernier envoi est arrivé et ce qu'il a fait, par exemple aucun colis avec ce numéro.
  • La synchronisation toutes les demi-heures continue de tourner : un envoi manqué est donc rattrapé plus tard.
  • Gardez le secret privé : avec la vérification par adresse secrète, l'adresse elle-même est le secret.