POSTMéthode POST/distributor-portal/shipments/{shipment_id}/receive

Vous confirmez avoir reçu une expédition. L'appel enregistre un événement de réception avec la date et votre identité ; scanner des cartons ou des unités est facultatif, une confirmation sans aucun scan est tout aussi valable.

Vous pouvez confirmer une même expédition en plusieurs fois (une partie reçue aujourd'hui, le reste demain) : chaque appel ajoute sa propre confirmation, aucune n'en remplace une autre. Un code déjà enregistré par une confirmation antérieure de la MÊME expédition est ignoré silencieusement s'il est scanné à nouveau : rescanner le même carton deux fois, par erreur ou par un appel rejoué, ne le compte jamais deux fois. Une expédition accepte au plus 500 appels de confirmation au total ; au-delà, l'appel est refusé plutôt que de laisser la table grossir sans limite.

#Autorisation

Session d'un compte contact distributeur. Voir GET /distributor-portal/me. Même règle d'isolation que la lecture : l'expédition d'un autre distributeur répond 404.

#Plafond d'appels

30 appels par minute, partagé avec le reste du portail distributeur. C'est le seul appel du portail qui écrit.

#Paramètres de chemin

#Corps de la requête

curl -i -X POST "https://api.sealtrust.io/v1/distributor-portal/shipments/318/receive" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000" \
  -H "Content-Type: application/json" \
  -d '{"scanned_identifiers": ["DSP000000123", "DSP000000124"], "note": "Carton légèrement abîmé"}'

{
  "reception_id": 7,
  "shipment_id": 318,
  "received_at": "2026-10-05T08:30:00Z",
  "received_by": "Camille Exemple",
  "scanned_count": 2
}