Aller au contenu principal

Mettre à jour une réservation

PUT 
/api/booking/update

Met à jour une réservation existante sur place : la réservation conserve son id et son historique, et les modifications des champs principaux (dates, lieux, voiture ou catégorie, distance, ids de transport, agence, accords et prix) sont auditées sous forme de commentaires sur la réservation. Il s'agit d'une opération de modification, pas d'une annulation suivie d'une nouvelle réservation.

Les dates, heures, lieux de prise en charge/restitution, le modèle ou la catégorie de voiture, les services additionnels, les ids de transport (numéros de vol) et les champs liés au prix sont mis à jour directement et le prix est recalculé (la même tolérance de 1 % qu'à la création s'applique lorsque Price est envoyé). Avec la disponibilité par modèle, les dates demandées sont revalidées, en conservant le véhicule attribué tant qu'il reste disponible ; avec la disponibilité par catégorie, le quota de la catégorie n'est revérifié que lorsque la catégorie change — les changements de dates seuls sont appliqués sans nouveau contrôle de disponibilité.

Statut de la réservation :

  • Les réservations annulées sont automatiquement réactivées. Si la réservation a un véhicule attribué (ou si la disponibilité est par modèle), sa disponibilité est validée et la requête échoue avec BookingStatusNotAllowUpdate lorsqu'aucun véhicule n'est disponible ; les réservations par catégorie sans véhicule attribué sont réactivées sans contrôle de disponibilité. La réactivation a lieu avant la validation de version, donc une requête ensuite rejetée pour version peut quand même avoir réactivé la réservation.
  • Les réservations livrées et clôturées ne peuvent pas être mises à jour : la requête échoue avec BookingStatusNotAllowUpdate et un commentaire d'avertissement est ajouté à la réservation.

Versionnage : lorsque la version enregistrée et la Version entrante sont toutes deux numériques, une valeur entrante inférieure ou égale à celle enregistrée échoue avec BookingVersionError et une valeur supérieure est appliquée ; lorsque l'une des deux valeurs est absente ou non numérique, aucun contrôle de version n'est effectué et la mise à jour est appliquée.

Données client : seuls Customer.Name et Customer.EmailAddress sont mis à jour, et uniquement lorsque le client a été créé par le même utilisateur d'API effectuant la requête ; sinon, les modifications du client sont ignorées. Les autres champs du client (téléphone, âge, documents, etc.) ne sont jamais modifiés par ce point de terminaison.

Les services additionnels sont synchronisés avec la requête : les additionnels optionnels omis de Additionals sont supprimés de la réservation, tandis que les obligatoires et ceux ajoutés par le système (p. ex. frais hors horaires) sont réappliqués automatiquement même s'ils sont omis.

Lorsque FullResponse vaut true et que la réservation a été tarifée par tranches de couverture VDR, ses lignes de location facturées à la journée peuvent porter AppliedCoverageBrackets. Chacune de ces lignes déclare une seule plage avec la totalité de son Price. Plusieurs lignes du même payeur peuvent déclarer la même plage, et le total de cette plage est leur somme. Le détail est omis sur toutes les lignes lorsque les lignes enregistrées ne peuvent pas être rattachées à leurs plages, par exemple après une prolongation payée par un autre payeur. La réponse simplifiée ne le porte jamais.

Request​

Responses​

Met à jour une réservation existante ou Met à jour une réservation existante