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
Comment ça marche
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.
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é.
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é.
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.
Rotate secret crée immédiatement un nouveau secret ; saisissez-le aussitôt chez le transporteur, l'ancien cesse de fonctionner.
Où le trouver
- Deliveries & packing → Couriers → Status webhook
/admin/deliveries/couriers
Réglages qui le modifient
- Courier account → Webhook check and signature header
/admin/deliveries/couriers
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.