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ètreTypeObligatoireDescription
idintOui*Identifiant numérique de l'OTR
otr_numberstringOui*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

CodeSignification
401Clé API absente
403Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur
404OTR introuvable, ou n'appartenant pas à votre société
429Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai Retry-After