L’API externe de Gestion-Traiteur

Ce que l’intégration fait aujourd’hui

• Votre site web, votre système comptable, votre tableau de bord maison : vos outils lisent directement vos événements, vos commandes, vos factures, vos paiements et votre catalogue. Plus de double saisie, plus d’exportations manuelles.
• 70 points d’accès couvrent les événements, les propositions, commandes et factures, les paiements et dépôts, les clients et entreprises, le catalogue de produits et de matériel, les lieux et salles, les demandes de devis reçus par votre boutique et les réglages du compte.
• Vous gardez le contrôle. Chaque outil connecté reçoit sa propre clé et une liste précise de permissions : événements, commandes, paiements, clients, rapports. Il ne voit que ce que vous autorisez, et vous pouvez retirer l’accès à tout moment.
• En lecture seule, par conception. Aucun outil externe ne peut créer, modifier ou supprimer quoi que ce soit dans votre compte. Il peut toutefois demander vos rapports (facture, feuille de route BEO, production du jour, journal des encaissements…) en PDF ou en Excel, générés à la demande.
• Vos assistants IA aussi. Le serveur MCP donne à Claude, ChatGPT, Copilot ou à votre propre assistant le même accès que l’API, avec la même clé et les mêmes permissions : « Quels événements cette semaine ? », « Quel est le solde de ce client ? », « Prépare la feuille de route de samedi ». Vous collez l’identifiant et le secret de la clé dans votre assistant, et il lit votre compte sans jamais rien modifier.
• Pensée pour vos développeurs et pour les assistants de programmation : documentation complète avec des exemples réels, spécification OpenAPI, collection Postman prête à l’emploi et guide à remettre tel quel à un assistant de programmation, qui saura exactement quoi appeler sans rien inventer. Une première intégration se fait en moins d’une heure.

Ce qui circule

Ce qui ne circule pas

• Aucune écriture : un outil externe ne peut pas créer un client, un événement, une commande ou un paiement dans GT.
• Les informations sensibles ne sortent jamais : coûts d’achat, salaires, données bancaires, e-mails et téléphones personnels, contact sur place d’un événement.
• Les coordonnées professionnelles des clients et des entreprises (e-mail, téléphone de bureau, mobile, adresse) sortent seulement avec la permission « coordonnées ».
• Pas de notification en temps réel pour l’instant : votre outil interroge GT quand il en a besoin, et peut ne relire que ce qui a changé depuis sa dernière visite.

Mise en route

1. 01 Écrivez-nous avec le nom de l’outil ou de l’assistant IA à connecter et ce qu’il doit pouvoir lire.
2. 02 Nous activons l’API externe sur votre compte et créons la clé avec les permissions demandées. Vous recevez son identifiant et son secret une seule fois : transmettez-les à votre développeur par un canal sécurisé, jamais par e-mail ordinaire.
3. 03 Votre développeur se connecte à la documentation avec cette clé : elle ne montre que ce que la clé peut lire, avec des exemples prêts à copier, la spécification OpenAPI et la collection Postman.
4. 04 Pour coder avec un assistant de programmation, remettez-lui le guide fourni par la documentation : liste fermée des points d’accès et règles à suivre, rien à deviner.
5. 05 Pour un assistant IA (Claude, ChatGPT, Copilot), ajoutez l’adresse du serveur MCP de GT comme connecteur, collez l’identifiant et le secret de la clé sur la page de connexion, puis autorisez : l’assistant voit exactement ce que la clé permet.