# GET /distributor-portal/shipments/{shipment_id}

Le détail d'une de vos expéditions : ses unités et ses confirmations de réception.

Source : https://docs.sealtrust.io/reference/get-distributor-portal-shipments-id/

---

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`](/reference/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

```bash
curl -i "https://api.sealtrust.io/v1/distributor-portal/shipments/318" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"
```

## Réponse d'exemple

```json
{
  "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`](/reference/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`](/reference/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`](/reference/post-distributor-portal-shipments-id-receive/),
  confirmer la réception.