POST

Mettre à jour le statut d'une mission

POST /APIs/external/carrier_update_mission_status.php
Starter

Description

Change le statut d'une mission assignée à votre société. Utile pour synchroniser votre TMS avec Shippinova en temps réel.

Corps de la requête (JSON)

ChampTypeObligatoireDescription
otr_idintOuiID de la mission
statusstringOuiNouveau statut. Valeurs : en_cours, livre, livree, delivered, incident, refuse, refusee, annule, annulee

💡 Les alias livree, delivered, refusee, annulee sont normalisés automatiquement.

Exemple de requête

POST /APIs/external/carrier_update_mission_status.php
X-API-KEY: votre_cle_transporteur
Content-Type: application/json

{
  "otr_id": 1060,
  "status": "en_cours"
}

Réponse (succès)

{
  "success": true,
  "otr_id": 1060,
  "otr_number": "OTR-20260728-000001",
  "previous_status": "assigne",
  "new_status": "en_cours"
}

Codes d'erreur

CodeSignification
401Clé API absente
402Abonnement inactif (essai terminé ou abonnement résilié)
403Clé invalide, ou clé expéditeur utilisée sur un endpoint transporteur
400Champ manquant ou statut invalide
404Mission introuvable pour votre société
429Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après Retry-After