Erreurs

Chaque endpoint de cette API renvoie des erreurs décrites ci-dessous. Pour certaines erreurs, il existe un error_type qui rajoute plus de détails sur la raison du refus.

Codes erreurs

Erreur HTTP Status Description
unauthorized 401 Unauthorized Clé API manquante / inconnue
missing_parameters 400 Bad Request Il manque des paramètres
fail_to_confirm_delivery 400 Bad Request La commande de livraison a échoué
delivery_has_expired 400 Bad request La confirmation de commande survient après le timeout (15 min)
lift_information_field_is_wrong 400 Bad request Les informations sur l’ascenseur sont erronées
no_contracts_match_the_given_constraints 400 Bad Request La livraison n’est pas disponible en raison de skills manquants ou en trop
no_delivery_options 404 not found Aucune disponibilité de livraison
missing_delivery 404 not found Numéro de commande inconnue
max_capacity_reached_for_this_slot 409 Conflict Capacité max atteinte

Erreurs /options

Erreur HTTP Status Type d’erreur Description
no_delivery_options 404 not found invalid_pickup_store Le code magasin utilisé pour le point de retrait n’est pas connu.
no_delivery_options 404 not found invalid_shipping_store Le code magasin utilisé pour le point de livraison n’est pas connu.
capacities can't be applied to city location 400 Bad Request invalid_capacity Une capacité ne peut pas être appliquée à un code postal.
max_capacity must be a positive integer 400 Bad Request invalid_capacity Une capacité maximale doit être obligatoirement un entier positif.
no_delivery_options 404 not found no_candidate_contracts Aucun contrat n’a été configuré pour votre compte. Veuillez contacter votre référent commercial au sein de Colisweb.
no_delivery_options 404 not found matching_contracts_not_eligible_to_ecommerce Votre contrat n’autorise pas les commandes depuis cette API. Veuillez contacter votre référent commercial au sein de Colisweb.
no_delivery_options 404 not found no_candidate_contracts_covering_postal_codes Votre contrat n’autorise pas les commandes sur les codes postaux renseignés.
no_delivery_options 404 not found total_weight_too_heavy Le poids total de la commande excède ce qui est autorisé par le contrat.
no_delivery_options 404 not found packets_dimensions_oversize Un ou plusieurs colis dépassent la limite de taille du contrat.
no_delivery_options 404 not found empty_response_from_packing L’association des colis ne rentre pas dans la ou les catégories du contrat.
no_delivery_options 404 not found generated_calendar_is_empty Le calendrier de disponibilités est vide.
missing_parameters 400 Bad Request invalid_routes L’entité route est invalide.
length, width, height and weight must be positive integers 400 Bad Request invalid_dimensions La longueur, la largeur, la hauteur et le poids doivent être des entiers positifs.
invalid_owner 400 Bad Request invalid_owner Le donneur d’ordre renseigné n’existe pas.
A single packet cannot be heavier than {packet_weight_limit} kg 400 Bad Request too_heavy_single_packet Un colis dépasse la limite de poids par colis autorisée par le contrat.
no_contracts_match_the_given_constraints 400 Bad Request no_contracts_match_the_given_constraints Votre contrat n’autorise pas les required_skills renseignés.
The Geo service does not know the postal code {postal_code_str} 404 not found impossible_to_geocode_the_postal_codes Impossible de géocoder le ou les codes postaux suivants.
Impossible to get the distance from ({lat/lng}) 500 impossible_to_get_the_distance Impossible de calculer la distance routière entre les deux points.
no price was found for the calendar 404 not found no_prices_found Aucun prix n’a été pu être calculé.
invalid_route_calendar 400 Bad Request invalid_route_calendar Le calendrier renseigné dans l’objet route est invalide.
internal_server_error 500 internal_server_error Erreur interne.

Erreurs /book

Erreur HTTP Status Type d’erreur Description
no_delivery_options 404 not found invalid_pickup_store Le code magasin utilisé pour le point de retrait n’est pas connu.
no_delivery_options 404 not found invalid_shipping_store Le code magasin utilisé pour le point de livraison n’est pas connu.
no_delivery_options 404 not found no_candidate_contracts Aucun contrat n’a été configuré pour votre compte. Veuillez contacter votre référent commercial au sein de Colisweb.
no_delivery_options 404 not found matching_contracts_not_eligible_to_ecommerce Votre contrat n’autorise pas les commandes depuis cette API. Veuillez contacter votre référent commercial au sein de Colisweb.
no_delivery_options 404 not found no_candidate_contracts_covering_postal_codes Votre contrat n’autorise pas les commandes sur les codes postaux renseignés.
no_delivery_options 404 not found total_weight_too_heavy Le poids total de la commande excède ce qui est autorisé par le contrat.
no_delivery_options 404 not found packets_dimensions_oversize Un ou plusieurs colis dépassent la limite de taille du contrat.
no_delivery_options 404 not found empty_response_from_packing L’association des colis ne rentre pas dans la ou les catégories du contrat.
no_delivery_options 404 not found no_contracts_matching_the_slot Le contrat ou la configuration du donneur d’ordre ne permet de commander une livraison sur cette date ou horaire.
missing_parameters 400 Bad Request invalid_routes L’entité route est invalide.
length, width, height and weight must be positive integers 400 Bad Request invalid_dimensions La longueur, la largeur, la hauteur et le poids doivent être des entiers positifs.
invalid_owner 400 Bad Request invalid_owner Le donneur d’ordre renseigné n’existe pas.
A single packet cannot be heavier than {packet_weight_limit} kg 400 Bad Request too_heavy_single_packet Un colis dépasse la limite de poids par colis autorisée par le contrat.
lift_information_field_is_wrong 400 Bad Request invalid_lift_value La valeur renseignée du champ lift_information n’est pas correcte.
no_contracts_match_the_given_constraints 400 Bad Request no_contracts_match_the_given_constraints Votre contrat n’autorise pas les required_skills renseignés.
max_capacity_reached_for_this_slot 409 Conflict max_capacity_reached_for_this_slot Plus de disponibilités pour le créneau demandé.
The Geo service does not know the postal code {postal_code_str} 404 not found impossible_to_geocode_the_postal_codes Impossible de géocoder le ou les codes postaux suivants.
Impossible to get the distance from ({lat/lng}) 500 impossible_to_get_the_distance Impossible de calculer la distance routière entre les deux points.
no price was found for the slot 500 no_prices_found Impossible de calculer un prix de vente.
internal_server_error 500 internal_server_error Erreur interne.