POST
Supprimer un OTR
POST /APIs/external/delete_otr.php
Description
Supprime un ordre de transport tant qu'il n'a pas été validé (statut create), avec ses unités et ses emballages.
Clé API expéditeur dans l'en-tête X-API-KEY (ou Authorization: Bearer).
Corps de la requête (JSON)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| otr_id | int | Oui | Identifiant de l'OTR |
Exemple de requête
curl -X POST "https://shippinova.com/APIs/external/delete_otr.php" \
-H "X-API-KEY: votre_cle_api" \
-H "Content-Type: application/json" \
-d '{ "otr_id": 123 }'
Réponse (succès)
{
"success": true,
"deleted_otr": 123
}
Codes d'erreur
| Code | Signification |
|---|---|
| 401 | Clé API absente |
| 403 | Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur |
| 403 | OTR d'une autre société |
| 404 | OTR introuvable |
| 409 | OTR déjà validé (MISSION_NOT_ACTIONABLE, avec current_status) |
| 429 | Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai Retry-After |