Dépannage
Les contrôles à effectuer avant d’escalader, univers par univers.
Dans cette page
1. Premiers réflexes
- Identifier l’univers. Le problème est-il visible dans la Boutique, dans le Manager, dans le Widget, ou dans les trois ? Un symptôme présent partout vient du paramétrage ; un symptôme isolé vient de l’application concernée.
- Vérifier la maintenance. Un bandeau orange dans l’administration de la Boutique et un badge dans le planning du Manager signalent un mode maintenance actif.
- Rafraîchir réellement. Navigation privée pour le Widget, bouton Actualiser ou tirer-pour-rafraîchir dans le Manager, Vider le cache après un changement de règle.
- Reproduire une seule fois, précisément. Notez produit, date, créneau, tarif et quantité exacts : c’est ce qui permettra de trancher.
2. Boutique — disponibilité, prix et notifications
| Symptôme | Contrôles prioritaires |
|---|---|
| Aucun créneau | Produit publié ; disponibilité du module de réservation ; quota de base ; règles datées ; ressources associées au tarif ; marge de blocage autour du créneau. |
| Capacité trop faible | Nombre de personnes du tarif ; option par personne ; quotas des ressources ; chevauchements de règles ; matériel déduit par une catégorie. |
| Prix incorrect | Coût de base ; ordre et plages des règles de tarif ; opération appliquée ; quantité ; mode groupe ; extras ; coupon et TVA. |
| Séjour impossible | Une seule journée fermée sur la période invalide tout le séjour ; horaires d’arrivée et de départ ; heures de blocage check-in / check-out. |
| Taxe de séjour absente ou fausse | Pourcentage renseigné sur le produit ; nombre d’adultes déclaré ; nombre de nuits facturables. |
| Coupon refusé | Code, expiration, limite d’usage, catégorie globale autorisée et produit concerné. |
| Email absent | Activation sur le produit ou le mode ; adresse client ; service Brevo actif ; état d’envoi sur la fiche rendez-vous. |
| SMS absent | Activation ; numéro client exploitable ; clé Brevo validée ; crédits disponibles ; limite mensuelle d’OTP par utilisateur. |
| Facture ou devis non généré | Service Hiboutik actif ; token de l’application Documents PDF ; intitulés exacts des trois modèles. |
| Paiement incohérent | Type du moyen, paiements fractionnés, reste à payer, retour de passerelle et notes de commande. |
3. Manager — accès et exploitation
| Symptôme | Contrôles prioritaires |
|---|---|
| « Code ou identifiants invalides » | Orthographe de l’e-mail ; rôle du compte dans la Boutique ; code encore valide (10 minutes) ; nombre d’essais et d’envois. |
| Aucun code reçu | Adresse ou numéro du profil ; crédits SMS restants ; délai de renvoi de 60 secondes ; dossier indésirable de la messagerie. |
| Onglet Caisse ou Cadeaux absent | Rôle du compte : seuls Manager et Administrateur disposent de ces permissions. Le changement s’applique à la reconnexion. |
| Écran de maintenance au lancement | Mode maintenance Manager ou Global actif dans les options générales. |
| Planning vide alors que des réservations existent | Filtres actifs sur les activités, les statuts ou les points de contrôle ; date affichée ; bouton Actualiser. |
| Point de contrôle qui ne se valide pas | Étape précédente non franchie ; échec réseau — actualisez la liste avant de rebasculer l’interrupteur. |
| Règle de disponibilité invisible | Seules les règles de type période d’heures sont remontées dans le Manager ; les autres se gèrent dans la Boutique. |
| Changement de règle sans effet | Bouton Vider le cache de Menu → Créneaux, puis contrôle en navigation privée. |
| TPE injoignable | Terminal allumé et sur le même réseau ; adresse IP et port déclarés toujours valides. |
| Verrouillage impossible | Message « Le réglage du verrouillage n’a pas pu être enregistré » : réseau indisponible au moment de l’enregistrement. |
| Manager figé sur une ancienne version | Fermez complètement l’application installée et relancez-la pour laisser la mise à jour s’appliquer. |
4. Widget — affichage et intégration
| Symptôme | Contrôles prioritaires |
|---|---|
| Rien ne s’affiche | Page en HTTPS ; balise <script src="…/loader.js"> présente dans le code source publié ; navigateur compatible ; console du navigateur (F12). |
| Widget vide, aucun produit | Clé api_key complète et correspondant au bon environnement ; product_cat qui n’exclut pas tout ; produits publiés. |
| Message d’indisponibilité | Mode maintenance ciblant le Widget. Le Widget revient seul dès la maintenance levée. |
| Catalogue incomplet en multi-sites | Format de api_key : virgules entre les entrées, barres verticales dans l’entrée, aucune espace parasite autour d’une clé. |
| Calendrier lent à s’afficher | Mode calendar_navigation="full" qui interroge douze mois : essayez month. |
| Mise en page cassée sur mobile | Attribut responsive ; largeur du conteneur hôte ; bloc HTML de la page placé dans une iframe trop courte. |
| Couleurs non appliquées | data-theme orthographié exactement comme dans la liste des thèmes ; surcharges CSS ciblant bien la balise et non une classe interne. |
| Titres d’étapes inchangés | Les titres viennent de la fiche produit, onglet Widget — pas du code du site. Un widget_step1 sur la balise l’emporte pour l’étape 1. |
| Réservation abandonnée qui bloque des places | Délai d’expiration des commandes dans Réglages → Hivebook → Autres. |
| Version servie incertaine | Dans la console du navigateur : HivebookWidget.version. |
| Comportement différent après mise à jour | Canal du loader : /latest/ peut basculer de version majeure. Préférez /v3/, ou figez une version exacte. |
5. Informations à transmettre au support
Un signalement exploitable. Numéro de rendez-vous et de commande, date et heure, produit, tarif, quantité, résultat attendu, résultat observé, univers concerné, version du Manager ou du Widget, et capture d’écran sans secret. Ne transmettez jamais de clé API privée, de token ni de mot de passe.
- Ce qui a changé récemment : règle de disponibilité, quota, tarif, mise à jour.
- Si le problème est reproductible, et dans quelles conditions exactes.
- S’il affecte un seul produit, un seul compte, un seul appareil, ou tout le monde.
- Les messages d’erreur recopiés mot pour mot, y compris ceux de la console du navigateur.