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.