API Carrier — Clore une mission

Description

Marque une mission comme définitivement livrée et clôturée. Passe le statut à livre, enregistre la date effective de livraison et ajoute un événement tracé dans l'historique.

💡 Pour uploader une preuve photo avant de clore, utilisez d'abord carrier_upload_pod.php.

Corps de la requête (JSON)

Champ	Type	Obligatoire	Description
otr_id	int	Oui	ID de la mission à clore
note_livraison	string	Non	Commentaire de livraison (max 2000 caractères)
date_livraison_effective	string	Non	Date/heure réelle de livraison (ISO 8601, ex : `2026-07-29T14:30:00`). Si absent : date/heure serveur.

Exemple de requête

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

{
  "otr_id": 1060,
  "note_livraison": "Livré en mains propres au responsable",
  "date_livraison_effective": "2026-07-29T14:30:00"
}

Réponse (succès)

{
  "success": true,
  "otr_id": 1060,
  "otr_number": "OTR-20260728-000001",
  "previous_status": "en_cours",
  "new_status": "livre",
  "date_livraison_effective": "2026-07-29T14:30:00",
  "note_livraison": "Livré en mains propres au responsable",
  "notification_sent": true
}

Codes d'erreur

Code	Signification
401	Clé API absente
402	Abonnement inactif (essai terminé ou abonnement résilié)
403	Clé invalide, ou clé expéditeur utilisée sur un endpoint transporteur
400	otr_id manquant ou date invalide
404	Mission introuvable pour votre société
409	Mission déjà dans un état final (livrée, annulée, refusée)
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après `Retry-After`