Créez votre propre site web et votre application sur votre POS : la Shop API de Bill&Go

La plupart des POS gardent pour eux ce qu’ils savent. Le menu, les prix, les ventes du jour et les commandes restent derrière les écrans du POS, et quand votre site web, votre comptable ou un partenaire de livraison en a besoin, quelqu’un les retape. Les prix divergent, un plat épuisé reste sur le site, et les chiffres du tableur ont un jour de retard.

La Shop API de Bill&Go fait l’inverse : une porte que vos propres systèmes peuvent utiliser pour lire votre POS et lui envoyer des commandes, avec une clé que vous créez et pouvez couper en une seconde. Toute la référence est publique sur ce site : vous, ou le développeur qui crée votre site, pouvez lire exactement ce qu’elle fait avant de vous inscrire.

Votre propre site web, qui prend des commandes

Créez le site que votre boutique mérite, à vos couleurs, à votre propre adresse, avec les outils que vous ou votre développeur préférez. La Shop API lui donne tout ce que votre POS sait :

• Le menu, en direct. Les catégories, les plats avec leurs noms anglais et khmers, les prix, les photos, les options avec le nombre que l’on peut choisir, et ce qui est épuisé en ce moment. Changez un prix au comptoir et le site l’affiche.
• Vos succursales. Chaque magasin avec son adresse, sa position sur la carte, son téléphone, ses horaires et ses frais de livraison, pour une page « Nous trouver » ou pour laisser le client choisir où commander.
• Les commandes droit en cuisine. Le site passe la commande et la marque comme payée ; elle arrive au POS et s’imprime en cuisine comme les autres, avec son propre numéro d’appel, et le POS prend le relais.
• Le suivi des commandes. Le site peut suivre chaque commande, confirmée, en préparation puis prête, pour dire au client où elle en est.

Votre propre application mobile

Il en va de même pour une application mobile au nom de votre boutique sur l’App Store et Google Play : vos clients parcourent votre menu, commandent et paient dans votre application, et la commande arrive à votre POS. Fidélité, offres et notifications sont à vous d’imaginer, car l’application est la vôtre.

Bon à savoir. Une application ou une page web ne contient jamais la clé elle-même : n’importe qui pourrait l’en extraire. Votre application parle à un petit serveur à vous, et c’est ce serveur qui garde la clé et parle à Bill&Go. Votre développeur connaît ce principe ; la référence montre quoi envoyer.

Et tout ce qui entoure la boutique

• Les ventes pour votre comptable. Les ventes du jour par magasin, prêtes chaque matin pour un logiciel de comptabilité ou un Google Sheet, sans export à la main.
• Un partenaire de livraison toujours à jour. Le menu vient du POS : le prix que vous changez au comptoir est celui que le partenaire affiche.
• Le stock là où vous en avez besoin. Les quantités de chaque magasin, pour un bon de commande fournisseur ou un site qui masque ce qui est épuisé.
• Votre propre tableau de bord. Les commandes au fil de leurs changements, page par page, pour tenir à jour un autre système ou un rapport.

Sûre par conception

Une clé est créée par le propriétaire dans la console, sous Paramètres → Clés API, et chacune dit exactement ce qu’elle peut faire :

• Lecture seule, ou aussi passer des commandes. Une clé pour votre comptable ne fait que lire ; celle de votre site ou de votre application peut passer des commandes.
• Une succursale, ou toutes. Une clé peut être attachée à un seul magasin, et elle ne voit alors jamais les autres.
• Coupée en une seconde. Révoquez une clé et elle cesse aussitôt de fonctionner ; rien d’autre ne change. La console indique quand chaque clé a servi pour la dernière fois.
• Uniquement pour la Shop API. Une clé fonctionne sur la Shop API et nulle part ailleurs : elle ne peut jamais se connecter à la console ni changer vos paramètres.

Vos données restent les vôtres : l’API vous les donne, en JSON simple, quand vous le voulez.

Pour commencer

1. Vérifiez que la boutique est sur Starter ou plus : la Shop API fait partie des connexions des forfaits payants. Chaque nouvelle boutique a un mois de Pro pour l’essayer.
2. Dans la console, ouvrez Paramètres → Clés API et ajoutez une clé : nommez-la (« Site web »), choisissez ce qu’elle peut faire et pour quels magasins.
3. Copiez la clé. Elle n’est affichée qu’une fois, en entier ; gardez-la sur votre serveur, jamais dans une page web ou une application.
4. Envoyez votre clé API avec chaque requête à `https://api.billandgo.app/v1` ; la référence montre comment, prêt à copier. Commencez par `GET /stores` et `GET /menu`.

La référence de la Shop API liste chaque adresse, ce qu’elle répond et chaque erreur, avec des exemples à copier.

Astuce. Demandez à chaque POS que vous envisagez de vous montrer sa référence d’API avant d’acheter. Si elle n’est pas écrite, vos données ne sont accessibles que dans la mesure où le fournisseur le veut bien.