Comment voir quel utilisateur a créé une expédition via l'API

Objectif : découvrez comment retrouver l'utilisateur de votre compte Sendcloud qui a créé une expédition donnée, et comment vous en servir pour identifier l'origine d'une erreur ou mesurer la productivité de vos préparateurs de commandes.

Si vous gérez une équipe d'employés qui préparent, emballent et annoncent des expéditions dans Sendcloud, vous pouvez désormais récupérer l'ID de l'utilisateur qui a créé chaque expédition. Cela est particulièrement utile pour les marchands ayant plusieurs préparateurs de commandes qui souhaitent :

• Retrouver l'origine d'une erreur d'expédition en identifiant le préparateur qui a créé l'expédition. Si une expédition a été mal emballée ou que la mauvaise étiquette a été utilisée, vous pouvez savoir qui l'a créée.
• Mesurer la productivité des préparateurs de commandes. Vous pouvez voir combien d'expéditions chaque préparateur a créées et construire vos propres rapports à partir de ces données.

Retrouver qui a créé une expédition

Vous pouvez récupérer cette information via l' Events API, qui renvoie une liste d'événements pour votre organisation. Chaque événement inclut le user_id de l'utilisateur ayant effectué l'action, l'expédition concernée, l'operation (create, update ou delete) et le moment où cela s'est produit.

Une expédition peut comporter plusieurs événements au fil du temps, par exemple un pour sa création et un autre pour une mise à jour ultérieure. Pour savoir qui l'a créée, filtrez sur operation=create.

Pour la liste complète des paramètres et des champs de réponse, consultez la référence de l'Events API.

Retrouver qui a créé une expédition en particulier

Utilisez cette méthode pour retrouver l'utilisateur à l'origine d'une expédition mal emballée ou associée à la mauvaise étiquette.

1. Appelez l'endpoint Récupérer des expéditions et transmettez le numéro de suivi de l'expédition comme paramètre tracking_number.
   Par exemple, en transmettant le numéro de suivi 3SYZXG2094203, vous obtenez une expédition avec l'ID 6b67970c-d288-4966-859d-c2b653ad7922.
2. Appelez l'endpoint Récupérer une liste d'événements. Définissez le paramètre resource_id sur l'ID d'expédition obtenu à l'étape 1 et définissez operation sur create.

3. La réponse inclut le user_id de l'utilisateur qui a créé l'expédition :

   {
     "data": [
       {
         "user_id": 97965,
         "actor_id": null,
         "organization_id": 97965,
         "resource_type": "shipment",
         "operation": "create",
         "resource_id": "6b67970c-d288-4966-859d-c2b653ad7922",
         "timestamp": "2026-07-14T08:50:14.477458Z"
       }
     ]
   }

4. Dans votre panneau Sendcloud, allez dans Paramètres > Utilisateurs et rôles > Utilisateurs actifs pour associer le user_id à l'adresse e-mail correspondante.

Mesurer la productivité des préparateurs de commandes

Utilisez cette méthode si vous souhaitez créer votre propre tableau de bord pour suivre le nombre d'expéditions créées par chaque préparateur de commandes.

1. Appelez l'endpoint Récupérer une liste d'événements avec operation défini sur create pour voir qui a créé chaque expédition.
2. Dans votre panneau Sendcloud, allez dans Paramètres > Utilisateurs et rôles > Utilisateurs actifs pour associer ces ID utilisateur à vos préparateurs de commandes.
3. Utilisez ces données pour créer vos propres tableaux de bord et suivre les indicateurs dont vous avez besoin.

Articles connexes

→ Documentation API Sendcloud et Guide de démarrage rapide
→ Que sont les webhooks et comment les configurer dans Sendcloud ?