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ètreTypeDescription
brand_idintegerLa 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).
pageintegerPage, à partir de 1. Par défaut 1.
page_sizeintegerTaille de page, 1 à 200. Par défaut 25.
statusstringopen, closed ou cancelled. Omis : toutes les expéditions.

#Requête d'exemple

curl
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

JSON
{
  "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

ChampTypeDescription
units_allocatedintegerUnités actives allouées à cette expédition.
lotsarrayCodes de lot distincts parmi les unités de l'expédition.
receivedbooleanAu moins une confirmation de réception a été enregistrée pour cette expédition.

#Erreurs

CodeConditionQue faire
401Jeton absent, illisible ou expiré.Reconnectez-vous.
403Compte sans aucun accès distributeur actif, à aucune marque.Voir GET /distributor-portal/me.
400Plusieurs marques accessibles et brand_id omis.Appelez GET /distributor-portal/brands et précisez brand_id.
404brand_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.
429Plafond d'appels dépassé.Attendez le délai de Retry-After.

#Voir aussi

Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.

Proposer une correctionSignaler un problème