Réservation depuis votre site web¶

Votre site peut proposer les mêmes choix que le portail client Rolaf (matière, taille du conteneur, adresse, date) et envoyer le visiteur au portail avec sa réservation déjà remplie. Le client n'a plus qu'à s'identifier et à confirmer.

Démo en ligne

demo-recybac.ubi2.ca montre le parcours complet sur le domaine de démonstration : catalogue, choix, puis portail de démo prérempli. Aucune commande réelle n'est créée. Le code de la page (un seul fichier HTML) sert de point de départ.

Comment ça marche¶

sequenceDiagram
    participant V as Visiteur
    participant S as Votre site
    participant A as API Rolaf
    participant P as Portail client
    S->>A: GET /website/catalog
    A-->>S: matières, tailles, prix de base
    V->>S: choisit matière, taille, adresse, date
    V->>S: clique « Réserver »
    S->>A: POST /website/draft
    A-->>S: url du portail (valide 7 jours)
    S->>P: redirige le visiteur vers l'url
    P->>V: réservation préremplie, identification, confirmation

Votre site lit le catalogue : les matières acceptées, les tailles de conteneur possibles pour chacune et leur prix de base.
Le visiteur fait ses choix sur votre site, avec votre présentation.
Au clic sur « Réserver », votre site envoie ces choix à Rolaf, qui les garde dans un brouillon de réservation et renvoie l'adresse du portail qui le reprend.
Le visiteur arrive sur le portail avec ses choix déjà en place. Le portail s'arrête à la première information manquante :
- l'adresse ou la plage horaire de livraison, si votre site ne les a pas demandées ;
- ses coordonnées (nom, téléphone, courriel), si elles manquent ;
- le résumé de la commande, quand tout est rempli.
Identification : si le courriel ou le téléphone correspond à un client existant, le portail lui propose de se connecter avec un code reçu par courriel ou par texto (aucun mot de passe). Sinon, il crée son compte en confirmant.
Confirmation : le portail applique vos règles habituelles (création de compte, signature des documents, carte de paiement), calcule le prix exact (transport selon l'adresse, surcharge carburant, taxes) et crée la commande.

Rien n'est réservé tant que le client n'a pas confirmé sur le portail

Le brouillon ne crée ni client ni commande. Il expire après 7 jours, ou dès que la commande est créée.

Activer l'intégration¶

Dans Rolaf : Paramètres → Portail client → Réservation depuis votre site web. Ajoutez l'adresse de chaque site autorisé (par exemple https://www.example.com), puis Enregistrer.

Sans aucun site dans la liste, l'intégration est désactivée : l'API répond 403 website_booking_disabled.
Indiquez chaque variante réellement utilisée : https://example.com et https://www.example.com sont deux sites différents pour le navigateur.
Le chemin ne compte pas : https://www.example.com/reserver est enregistré comme https://www.example.com.

Donnez ensuite à votre programmeur web :

l'adresse de l'API : https://api.rolaf.ca ;
votre identifiant de domaine (par exemple exemple), envoyé dans l'en-tête Domain de chaque appel ;
le lien vers cette page.

Les matières, tailles et prix affichés viennent de vos tarifs dans Rolaf (Paramètres → Tarifs de facturation). Un tarif archivé ou marqué « Cachée du portail client » n'apparaît pas sur votre site non plus.

Ce que votre site doit faire¶

Étape	Appel	Obligatoire
Afficher les matières et les tailles	`GET /website/catalog`	oui
Envoyer les choix du visiteur	`POST /website/draft`	oui
Afficher la couverture et le prix d'une adresse	`POST /website/quote`	non, recommandé
Rediriger vers le portail	`window.location = url`	oui

Le détail des champs, des erreurs et un exemple complet sont dans la référence de l'API.

Bonnes pratiques¶

Prix : le prix du catalogue est un prix de base (location et jours inclus), sans le transport (qui dépend de la zone de l'adresse), la surcharge carburant ni les taxes. Présentez-le comme « à partir de ». Dès que le visiteur a saisi son adresse, appelez /website/quote : il indique si l'adresse est desservie, dans quelle zone, et détaille le prix jusqu'au total taxes comprises.
Notes : chaque couple matière/taille peut porter des consignes (« ¾ max », « béton et roches seulement »…). Affichez-les : elles s'imposent au client.
Adresse : une adresse en texte suffit, Rolaf la géolocalise. Affichez l'adresse reconnue renvoyée par /website/quote. Si l'adresse est hors zone, ne proposez pas « Réserver » : le portail refuserait la commande.
Cache : le catalogue change rarement. Gardez-le quelques minutes en cache plutôt que de l'appeler à chaque page vue (l'API limite le nombre d'appels par adresse IP).