Méthode GET/distributor-portal /shipments
Lister vos propres expéditions : statut, unités, lots. Session de compte contact distributeur.
Sur cette page
Vous listez vos propres commandes B2B (vos expéditions), jamais celles d'un autre distributeur de la même marque ni d'une autre marque. Chaque entrée porte le nombre d'unités allouées, les lots expédiés et si une confirmation de réception existe déjà.
#Autorisation
Session d'un compte contact distributeur. Voir
GET /distributor-portal/me pour le
détail des règles de session et des refus 401/403.
#Plafond d'appels
30 appels par minute, partagé avec le reste du portail distributeur.
#Paramètres de requête
| Paramètre | Type | Description |
|---|---|---|
brand_id | integer | La marque dont lire les expéditions. Obligatoire si vous êtes un contact actif chez plusieurs marques ; optionnel sinon (la seule marque accessible est utilisée). |
page | integer | Page, à partir de 1. Par défaut 1. |
page_size | integer | Taille de page, 1 à 200. Par défaut 25. |
status | string | open, closed ou cancelled. Omis : toutes les expéditions. |
#Requête d'exemple
curl -i "https://api.sealtrust.io/v1/distributor-portal/shipments?page=1&page_size=25" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"#Réponse d'exemple
{
"items": [
{
"id": 318,
"order_ref": "SO-2026-0318",
"status": "closed",
"ship_date": "2026-10-01",
"units_allocated": 240,
"lots": ["LOT-2026-09-A", "LOT-2026-09-B"],
"received": false,
"created_at": "2026-09-28T09:12:00Z"
}
],
"total": 1,
"page": 1,
"page_size": 25,
"total_pages": 1
}#Les champs de la réponse
| Champ | Type | Description |
|---|---|---|
units_allocated | integer | Unités actives allouées à cette expédition. |
lots | array | Codes de lot distincts parmi les unités de l'expédition. |
received | boolean | Au moins une confirmation de réception a été enregistrée pour cette expédition. |
#Erreurs
| Code | Condition | Que faire |
|---|---|---|
| 401 | Jeton absent, illisible ou expiré. | Reconnectez-vous. |
| 403 | Compte sans aucun accès distributeur actif, à aucune marque. | Voir GET /distributor-portal/me. |
| 400 | Plusieurs marques accessibles et brand_id omis. | Appelez GET /distributor-portal/brands et précisez brand_id. |
| 404 | brand_id donné, mais sans contact actif pour cette marque (y compris une marque qui n'existe pas). Même réponse dans les deux cas. | Vérifiez l'identifiant. |
| 429 | Plafond d'appels dépassé. | Attendez le délai de Retry-After. |
#Voir aussi
GET /distributor-portal/brands, la liste de vos marques pour construire un sélecteur.GET /distributor-portal/shipments/{shipment_id}, le détail d'une expédition : ses unités, ses confirmations de réception.POST /distributor-portal/shipments/{shipment_id}/receive, confirmer la réception d'une expédition.
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.