API Expéditeur — Valider des OTR

Description

Valide un ou plusieurs ordres de transport au statut create : ils passent au statut Validated et le transporteur est prévenu par email et notification.

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
otrs	array<int>	Oui	Identifiants des OTR à valider

Exemple de requête

curl -X POST "https://shippinova.com/APIs/external/api_validate_otrs.php" \
  -H "X-API-KEY: votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{ "otrs": [123, 456, 789] }'

Réponse (succès)

{
  "success": true,
  "validated_otrs": [123, 456],
  "not_validated": [
    { "otr_id": 789, "reason": "wrong_status", "current_status": "Validated" }
  ],
  "mails_sent": ["dispo@transporteur.ch"],
  "mails_failed": []
}

reason	Signification
`not_found`	L'OTR n'existe pas
`not_owner`	L'OTR appartient à une autre société
`wrong_status`	L'OTR n'est plus au statut `create` (voir `current_status`)
`no_carrier`	Aucun transporteur n'est associé à l'OTR

Codes d'erreur

Code	Signification
401	Clé API absente
403	Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur
400	Liste `otrs` absente ou vide
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai `Retry-After`