Méthode GET/distributor-portal
Le détail d'une de vos expéditions : ses unités et ses confirmations de réception.
Sur cette page
Vous relisez une de vos expéditions par son id : ses unités (numéro de
série, lot) et l'historique de ses confirmations de réception.
⛔ Isolation. Une expédition d'un autre distributeur — de la même marque ou d'une autre — répond exactement 404, la même réponse qu'une expédition qui n'existe pas. Cet appel ne confirme jamais qu'une expédition d'un autre distributeur existe.
#Autorisation
Session d'un compte contact distributeur. Voir
GET /distributor-portal/me.
#Plafond d'appels
30 appels par minute, partagé avec le reste du portail distributeur.
#Paramètres de chemin et de requête
| Paramètre | Type | Description |
|---|---|---|
shipment_id | integer | Identifiant de l'expédition, chemin. |
page, page_size | integer | Pagination des unités, 1 à 200 par page, 50 par défaut. |
#Requête d'exemple
curl -i "https://api.sealtrust.io/v1/distributor-portal/shipments/318" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"#Réponse d'exemple
{
"id": 318,
"order_ref": "SO-2026-0318",
"status": "closed",
"ship_date": "2026-10-01",
"units_allocated": 2,
"received": true,
"receptions": [
{
"id": 7,
"received_at": "2026-10-05T08:30:00Z",
"received_by": "Camille Exemple",
"scanned_count": 2,
"note": null
}
],
"units": [
{
"product_id": 9001,
"serial": "DSP000000123",
"product_name": "Eau de parfum 50 ml",
"lot": "LOT-2026-09-A",
"allocated_at": "2026-09-28T09:12:00Z"
}
],
"units_total": 2,
"page": 1,
"page_size": 50
}#Ce que l'on ne trouve jamais ici
Aucune donnée personnelle de consommateur, aucune information sur un autre distributeur, aucune note interne de la marque. Les unités sont lues par identifiant produit, numéro de série et lot — jamais par qui les a scannées ni où elles se trouvent ensuite.
#Erreurs
| Code | Condition | Que faire |
|---|---|---|
| 401 | Jeton absent, illisible ou expiré. | Reconnectez-vous. |
| 403 | Compte sans accès distributeur actif. | Voir GET /distributor-portal/me. |
| 404 | Expédition inconnue, ou d'un autre distributeur (le vôtre ou un autre de la même marque, ou d'une autre marque). | Vérifiez l'id dans la liste GET /distributor-portal/shipments. |
| 429 | Plafond d'appels dépassé. | Attendez le délai de Retry-After. |
#Voir aussi
POST /distributor-portal/shipments/{shipment_id}/receive, confirmer la réception.
Cette page vous a-t-elle été utile ?
Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.