Codes d'erreur

Chaque erreur a le même format. Le code est stable, le message est en français ou en anglais selon Accept-Language. Donnez le request_id au support.

{
  "error": {
    "code": "parcel_too_big",
    "message": "Le colis dépasse les limites de ce véhicule.",
    "request_id": "req_8b43927a…",
    "param": "parcel.size",
    "doc_url": "https://kolis.delivery/developers/errors#parcel_too_big"
  }
}

• unauthorized401Clé API absente ou invalide.
• key_revoked401Cette clé API a été révoquée.
• key_expired401Cette clé API a expiré.
• api_disabled503L'API Kolis n'est pas encore ouverte.
• account_suspended403Le compte marchand est suspendu ou inactif.
• live_not_enabled403Le mode live n'est pas encore activé pour ce compte. Utilisez une clé de test.
• ip_not_allowed403Adresse IP non autorisée pour cette clé.
• insufficient_scope403Cette clé n'a pas la portée nécessaire.
• tracking_disabled403Le suivi n'est pas activé pour ce compte.
• tracking_expired410Ce lien de suivi a expiré.
• rate_limited429Trop de requêtes. Réessayez après le délai indiqué.
• daily_quota_exceeded429Quota quotidien de requêtes atteint.
• quota_exceeded429Quota mensuel de livraisons atteint.
• too_many_open_deliveries429Trop de livraisons en cours en même temps.
• invalid_json400Le corps de la requête n'est pas un JSON valide.
• invalid_input400Paramètre manquant ou invalide.
• invalid_vehicle400Véhicule inconnu.
• invalid_parcel_size400Taille de colis inconnue.
• invalid_parcel_weight400Poids de colis inconnu.
• invalid_recipient_phone400Téléphone du destinataire invalide (format E.164, ex. +237...).
• invalid_cursor400Curseur de pagination invalide.
• idempotency_key_required400L'en-tête Idempotency-Key est obligatoire pour créer une livraison.
• invalid_idempotency_key400Idempotency-Key invalide (128 caractères au maximum).
• idempotency_key_reused422Cette Idempotency-Key a déjà servi avec un autre corps de requête.
• insufficient_balance402Solde prépayé insuffisant.
• not_found404Ressource introuvable.
• quote_not_found404Devis introuvable.
• quote_expired409Le devis a expiré. Demandez-en un nouveau.
• quote_used409Ce devis a déjà servi.
• duplicate_external_ref409Cette référence externe existe déjà.
• cannot_cancel_after_pickup409Annulation impossible : le colis a été récupéré.
• bad_status409Action impossible dans l'état actuel de la livraison.
• not_covered422Adresse hors des zones desservies.
• too_far422Distance supérieure au maximum autorisé.
• parcel_too_big422Le colis dépasse les limites de ce véhicule. Choisissez un véhicule plus grand.
• internal_error500Erreur interne. Réessayez ; communiquez le request_id au support.