Télécharger un document

Description

Génère un document PDF pour un de vos OTR : lettre de voiture CMR ou étiquette. Les adresses, le transporteur et les dates sont repris de l'OTR.

Clé API expéditeur dans l'en-tête X-API-KEY (ou Authorization: Bearer).

Les paramètres sont envoyés en multipart/form-data (formulaire), la clé uniquement dans l'en-tête.

Paramètres (formulaire)

Champ	Type	Obligatoire	Description
type	string	Oui	cmr, label (étiquette 100×150 mm) ou labela4 (étiquettes sur A4)
otr_id	int	Oui	Identifiant de l'OTR
goods	string (JSON)	Non	Pour la CMR : liste des marchandises (packages, description, gross_kg, volume, marks)

Exemple de requête

curl -X POST "https://shippinova.com/APIs/external/download_otr_doc.php" \
  -H "X-API-KEY: votre_cle_api" \
  -F "type=cmr" \
  -F "otr_id=123" \
  -F 'goods=[{"packages":"2","description":"Palettes de fruits","gross_kg":"500","volume":"2.5","marks":"FRUITS"}]' \
  -o cmr_123.pdf

Réponse (succès)

Le fichier PDF (Content-Type: application/pdf).

Codes d'erreur

Code	Signification
401	Clé API absente
403	Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur
400	Paramètre manquant, type inconnu, ou JSON goods invalide
403	OTR d'une autre société
404	OTR introuvable
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai Retry-After