Dépannage

Les bugs les plus fréquents, classés par fréquence, avec la vraie solution. Si le vôtre n'est pas listé, écrivez à [email protected] avec une capture — on l'ajoutera.

1. Les produits n'apparaissent pas

Cause : les produits n'ont pas encore le tag snaptare, ou la tablette n'a pas reçu le dernier delta.

Solution :

1. Dans l'admin Shopify, vérifiez que les produits portent le tag snaptare (Modification groupée → Tag → « snaptare »).
2. Sur la tablette, tapez l'icône rafraîchir à côté de la barre de recherche. Cela tire un nouveau delta depuis Shopify.
3. Si toujours vide, vérifiez Paramètres → Catalogue → Dernière sync. Si l'horodatage date de plusieurs minutes et n'avance plus, il peut y avoir un problème de livraison de webhook — fermez puis rouvrez l'app pour forcer une re-sync complète.

2. La sync semble bloquée

Cause : typiquement un problème backend transitoire ou un service worker à mettre à jour.

Solution :

1. Vérifiez l'icône wifi en haut. Si elle est barrée, vous êtes hors-ligne — la sync reprend au retour du wifi.
2. Forcer le rafraîchissement : Paramètres → Catalogue → Forcer la re-sync. Vide le cache local et tire tout à nouveau.
3. Si ça ne bouge toujours pas, fermez complètement l'app et rouvrez. Le service worker vérifie les mises à jour au démarrage.

3. La balance ne s'appaire pas

Balance USB non détectée :

• Vérifiez que le câble est bien enfoncé et que l'adaptateur de la tablette transmet les données (certains câbles Lightning-vers-USB-A bon marché sont « charge seulement » — utilisez l'adaptateur officiel Apple ou un tiers connu).
• Débranchez, attendez 5 secondes, rebranchez. Certaines balances ont besoin d'une ré-énumération.
• Sur iPad, l'invite de permission WebHID n'apparaît qu'après un tap sur Appairer. Si vous l'avez ratée, retapez Appairer.

Balance Bluetooth absente du sélecteur :

• Web Bluetooth ne marche pas sur Safari iPad. Utilisez Chrome Android ou une tablette Windows avec Edge. (Voir balances §5.)
• Vérifiez que la balance est en mode appairage (souvent un appui long sur son bouton power). Le sélecteur ne voit que les balances qui broadcastent à ce moment-là.

4. La balance lit des valeurs fausses

Cause : typiquement une mauvaise unité ou une calibration ancienne.

Solution :

1. Vérifiez que l'écran de la balance affiche la même unité que Snaptare attend (grammes). Beaucoup de balances basculent entre oz et g — vérifiez le bouton d'unité.
2. Posez un poids connu (1 L d'eau = 1000 g) et vérifiez la lecture.
3. Si la lecture est constamment décalée d'une valeur fixe, la balance peut nécessiter une recalibration selon son manuel.
4. Si la lecture est décalée d'un pourcentage (ex. 5 % en haut), la balance a peut-être dérivé sérieusement — remplacez ou faites recertifier.

5. Le vocal ne m'entend pas

Problème de permission :

• Tapez l'orbe mic. Si rien ne se passe, le navigateur n'a pas la permission micro.
• iPad : Réglages (iOS) → Safari → Microphone → Autoriser. Puis dans Snaptare : Paramètres → Vocal → Activé.
• Android : tapez l'icône cadenas dans la barre URL Chrome → Paramètres du site → Microphone → Autoriser.

Problème de reconnaissance :

• Vérifiez que Paramètres → Langue correspond à ce que vous parlez. Le recognizer est biaisé sur l'une ou l'autre.
• Maintenez l'orbe jusqu'à ce qu'elle brille visuellement avant de parler. « Carottes » prononcé instantanément peut couper le « C ».
• Restez à 50 cm de la tablette. Les micros intégrés ne sont pas magiques.

6. La TVA est incorrecte sur le ticket

Cause : la variante produit source dans Shopify a une mauvaise configuration de taxe.

Solution :

1. Dans l'admin Shopify, trouvez le produit source → variante → vérifiez le réglage Facturer la taxe sur ce produit.
2. Si votre juridiction a des catégories de taxe (ex. « Alimentaire vs. Autre »), vérifiez la catégorie de la variante dans Paramètres Shopify → Taxes.
3. Snaptare lit depuis la variante — si Shopify dit pas de taxe, le ticket dit pas de taxe. Corrigez dans Shopify et la prochaine vente reprend la correction.

7. La file hors-ligne ne se synchronise pas

Cause : le wifi est joignable mais le backend ne l'est pas, ou la file a un élément corrompu.

Solution :

1. Vérifiez Paramètres → Sync → File. Doit afficher « 0 en attente » quand synchronisé.
2. Si bloqué sur le même élément, tapez Réessayer maintenant.
3. Si un élément échoue toujours, tapez dessus pour voir l'erreur. Cause la plus fréquente : la variante source a été supprimée dans Shopify entre la création du panier et la tentative de sync. Snaptare le détecte et marque la ligne ; corrigez en éditant le panier sur la tablette.
4. Si la file est vraiment bloquée, écrivez à [email protected] — on peut la vider côté serveur sans perdre vos ventes.

8. L'autorisation caméra a été refusée

Si vous avez accidentellement refusé la caméra à la première tare IA :

• iPad : Réglages (iOS) → Safari → Caméra → Autoriser. Re-tapez « Photo » dans Snaptare.
• Android : icône cadenas dans la barre URL Chrome → Paramètres du site → Caméra → Autoriser.

La tare manuelle et les préréglages marchent sans la caméra. La tare IA est juste indisponible jusqu'à autorisation.

9. L'app démarre sur un écran blanc

Rare. Typiquement une mise à jour de service worker mal passée.

1. Forcez la fermeture de l'app (fermer tous les onglets / quitter la PWA).
2. Rouvrez. Le service worker vérifie les mises à jour au démarrage — la plupart des problèmes se résolvent seuls.
3. Si toujours blanc, effacez les données du site : iPad Réglages → Safari → Avancé → Données de site web, cherchez « snaptare », supprimez. Rouvrez. Note : ça efface aussi les brouillons locaux.
4. Écrivez-nous si ça persiste — joignez le modèle de tablette et la version OS.