GET
Détail d'un OTR
GET /APIs/external/get_otr.php
Description
Renvoie le détail complet d'un ordre de transport de votre société : adresses, dates, références, unités et emballages.
Clé API expéditeur dans l'en-tête X-API-KEY (ou Authorization: Bearer).
Paramètres (query string)
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| id | int | Oui* | Identifiant numérique de l'OTR |
| otr_number | string | Oui* | Numéro de l'OTR (ex. OTR-20260122-093000-A1B2C3) |
* Un seul des deux paramètres est nécessaire.
Exemple de requête
curl -X GET "https://shippinova.com/APIs/external/get_otr.php?id=123" \ -H "X-API-KEY: votre_cle_api"
Réponse (succès)
{
"success": true,
"otr_id": 123,
"otr_number": "OTR-20260122-093000-A1B2C3",
"status": "create",
"carrier_id": 2,
"client_id": 5,
"pickup_name": "Entrepôt Lausanne",
"pickup_street": "Rue du Port 12",
"pickup_zip": "1003",
"pickup_city": "Lausanne",
"pickup_country": "CH",
"pickup_phone": "+41 21 000 00 00",
"delivery_name": "Client final",
"delivery_street": "Avenue de la Gare 5",
"delivery_zip": "1201",
"delivery_city": "Genève",
"delivery_country": "CH",
"delivery_phone": null,
"pickup_date": "2026-01-22",
"delivery_date": "2026-01-23",
"reference1": "REF-OTR-001",
"reference2": null,
"temperature_zone": "chilled",
"delivery_time": "08:00 - 12:00 / 13:30 - 17:00",
"delivery_slot": "day",
"default_instructions": "Appeler avant la livraison",
"instructions": null,
"notes": null,
"units": [
{ "type_unit": "palette", "quantity": 2, "description": "Palettes EUR", "weight": 500, "height": null, "width": null, "length": null, "volume_cm3": null }
],
"packaging": [
{ "packaging_id": 1, "quantity": 3, "date_creation": "2026-01-21 10:00:00" }
]
}
delivery_slot vaut toujours day, morning, afternoon ou fixed.
Codes d'erreur
| Code | Signification |
|---|---|
| 401 | Clé API absente |
| 403 | Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur |
| 404 | OTR introuvable, ou n'appartenant pas à votre société |
| 429 | Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai Retry-After |