Réserver en ligne : portail, panier et paiement

Vos clients réservent une ressource sur le portail Bookings, à l'adresse https://<votre site>/bookings-ui. Chaque créneau choisi crée une Réservation de ressource et l'ajoute au panier. À la validation du panier, Dokos crée une commande client, demande le paiement si besoin, puis confirme la réservation.

Cette page décrit ce parcours et les réglages qui le modifient. Pour créer les ressources, voir Ressources réservables. Pour les créneaux proposés, voir Disponibilités.

Prérequis

• Une ressource réservable Publiée sur le site web, avec au moins un prix et une disponibilité dans chaque prix.
• Le client a un compte sur le site et est connecté. Sinon, le portail affiche « Connectez-vous pour réserver ce créneau ».
• Le client a une adresse de facturation. Sans adresse, la commande est refusée avec le message « Définir l’adresse de livraison ou l’adresse de facturation ».
• Dans les Paramètres de réservation de ressources, onglet Panier, cochez Activer le panier et choisissez la Société et la Liste de prix. Pour le paiement en ligne, cochez Activer le paiement. Pour encaisser hors ligne, cochez Aucune passerelle de paiement. Dans cette version, Bookings n'a plus besoin de l'application Webshop.
• Pour le paiement en ligne : une passerelle de paiement configurée, avec son mode de paiement.

Le parcours du client

1. Le client ouvre la ressource sur le portail, choisit un tarif (heure, demi-journée, jour…) puis une date.
2. Il clique sur un créneau. La fenêtre Gérer ma réservation s'ouvre.
3. Il clique sur Réserver ce créneau. Dokos crée la réservation au statut Dans le panier et l'ajoute au panier. Le créneau est bloqué pour les autres clients.
4. Il ouvre le panier et clique sur Valider la commande. Le panier est une page du portail (/bookings-ui/cart). Ce bouton crée toujours la commande : le portail ne propose pas de demande de devis, même si Activer le paiement n'est pas coché.
5. Dokos crée un devis puis une commande client.
6. Si le montant à payer est supérieur à zéro et qu'un mode de paiement est autorisé, Dokos redirige le client vers la page de paiement. Sinon, il le renvoie vers ses commandes sur le portail.
7. Dokos confirme la réservation selon le réglage Confirmer automatiquement les réservations sur le portail.

      
flowchart TD
    A[Clic sur un créneau] --> B[Réservation : Dans le panier]
    B -->|Panier abandonné| X[Réservation supprimée après le délai]
    B --> C[Valider la commande]
    C --> D[Devis puis commande client]
    D --> E{Montant à payer > 0 ?}
    E -->|Oui| F[Page de paiement]
    E -->|Non| G[Mes commandes]
    F --> H[Réservation : Confirmé]
    G --> H

    

Statuts d'une réservation

Quand la réservation est confirmée

Le champ Confirmer automatiquement les réservations sur le portail, dans les paramètres de réservation de ressources, a trois valeurs :

Quel que soit le réglage, une commande déjà payée en entier confirme la réservation. Une réservation payée avec des crédits est aussi confirmée à la commande.

Paniers abandonnés

Si le client ne valide pas son panier, Dokos supprime la réservation après le délai Effacer les brouillons après x minutes (15 minutes par défaut). Le délai compte depuis la dernière modification de la réservation. Le créneau redevient libre. Si des crédits avaient été réservés pour ce créneau, ils sont rendus. Avec la valeur 0, Dokos ne supprime jamais les paniers.

Le client peut aussi retirer un créneau lui-même : il clique sur le créneau puis sur Retirer de mon panier.

Réserver sans passer par le panier

Certains clients peuvent réserver sans panier ni commande. La réservation passe directement à Confirmé. Aucune commande ni facture n'est créée, et aucun crédit n'est déduit.

C'est le cas si l'une de ces conditions est remplie :

• l'utilisateur a le rôle choisi dans Rôle autorisé à ignorer le panier d'achat ;
• le client a un contrat de réservation actif qui inclut cette ressource.

Utilisez cette option pour vos membres abonnés : leur abonnement couvre déjà l'usage de la ressource.

Proposer des réservations gratuites

Il n'existe pas de case « ressource gratuite ». Selon le besoin, utilisez l'une de ces méthodes.

Sur le portail /bookings-ui, un prix à 0 € s'affiche comme un montant, par exemple « 0,00 € », et non « Gratuit ». Le portail affiche « Gratuit » seulement quand le tarif n'a pas de montant formaté. La fiche article du site web, elle, affiche « Gratuit » pour un prix à 0 €.

Pour un prix à 0 €, le client doit toujours valider le panier.

Payer avec des crédits

Si le client a des crédits valables pour cette ressource et ce tarif, la fenêtre Gérer ma réservation affiche Réserver en utilisant des crédits. Dokos réserve les crédits dès l'ajout au panier. Dans le devis, la ligne passe à 0 €. Voir Crédits de réservation.

Réserver une période longue

Pour un tarif au jour, à la semaine ou au mois, le portail affiche un calendrier. Le client clique sur une date de début, puis sur une date de fin, et clique sur Ajouter ce créneau à mon panier. Dokos calcule la quantité selon la durée.

• Au mois, la réservation couvre des mois civils entiers.
• À la semaine, si Semaines calendaires fixes est coché dans l'onglet Unités de mesure des paramètres, un clic sélectionne une semaine entière. Dokos recale la réservation sur des semaines civiles. Elle va du premier jour ouvert au dernier, par exemple du lundi 8h au vendredi 18h. Le premier jour de la semaine suit le réglage Premier jour de la semaine des paramètres système.
• Sans cette case, un tarif à la semaine accepte une plage de dates libre.

Badges requis

Si une ressource exige des badges, Dokos vérifie ceux du client. S'il lui en manque, le portail masque les disponibilités et indique les badges à obtenir. Une réservation sans les badges est refusée.

Annuler une réservation sur le portail

Si Autoriser l'annulation des réservations de ressources sur le portail est coché, le client clique sur un créneau confirmé puis sur Annuler ma réservation.

• L'annulation est refusée moins de Délai d'annulation avant le début (24 heures par défaut).
• Si Rembourser les crédits en cas d'annulation est coché, les crédits déduits sont rendus.
• La commande et la facture ne sont pas modifiées. Traitez le remboursement éventuel à la main.

Réserver pour plusieurs clients

Un utilisateur peut être utilisateur du portail de plusieurs clients, par exemple un agent d'accueil. Il choisit le client actif sur le portail. Dokos vérifie qu'il est déclaré comme utilisateur du portail de ce client avant d'accepter le choix. Pour une intégration, le client actif se transmet par l'en-tête HTTP X-Webshop-Customer, le paramètre webshop_customer ou un cookie du même nom.

Exemple

Sophie, de Maison Verte SARL (exemple fictif sur la démo Mappemonde), veut la salle Marco Polo mardi de 9h à 12h.

1. Sur /bookings-ui, elle ouvre la salle Marco Polo, choisit le tarif Heure et la date du mardi.
2. Elle clique sur le créneau de 9h, puis sur Réserver ce créneau. Elle recommence pour 10h et 11h. Les trois réservations sont Dans le panier.
3. Elle ouvre le panier : 3 heures. Elle clique sur Valider la commande.
4. Le montant est supérieur à zéro et le paiement par carte est autorisé : elle paie sur la page de la passerelle.
5. Le site est réglé sur Sur commande : ses trois réservations passent à Confirmé à la création de la commande.

Si Sophie avait fermé son navigateur à l'étape 3, ses trois créneaux auraient été libérés 15 minutes plus tard.

Problèmes fréquents

Voir aussi

• Paramètres de réservation de ressources
• Crédits de réservation
• Gestion multi-lieux
• Passerelles de paiement