API Carrier — Accepter / Refuser une mission

Description

Accepte ou refuse une mission qui vient d'être assignée à votre société (statut assigne). Disponible uniquement sur le plan Pro ou supérieur.

Corps de la requête (JSON)

Champ	Type	Obligatoire	Description
otr_id	int	Oui	ID de la mission à traiter
decision	string	Oui	`accept` ou `refuse`

⚠️ La mission doit être dans le statut assigne. Toute autre décision retourne une erreur 409.

Exemple de requête

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

{
  "otr_id": 1060,
  "decision": "accept"
}

Réponse (succès)

{
  "success": true,
  "otr_id": 1060,
  "otr_number": "OTR-20260728-000001",
  "decision": "accept",
  "new_status": "accepte"
}

Codes d'erreur

Code	Signification
401	Clé API absente
402	Abonnement inactif (essai terminé ou abonnement résilié)
403	Clé invalide, clé expéditeur, ou formule Starter (`Plan upgrade required` : Pro requis)
400	otr_id ou decision manquant / invalide
404	Mission introuvable pour votre société
409	Mission pas dans le statut `assigne`
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après `Retry-After`