Le Souk
Point of Sale API
API REST complète pour la gestion de votre restaurant : commandes, factures, caisse, stock, réservations, cuisine et plus encore.
$ Base URL
https://api.lesoukcg.com/api/v1
Authentification
Login
/auth/login
Connexion par email et mot de passe. Retourne un token Sanctum.
Login par PIN
/auth/login-pin
Connexion rapide par code PIN pour les utilisateurs enregistrés.
Headers requis :
Authorization: Bearer {token}
—
Accept: application/json
Modules de l'API
Commandes
/orders
Gestion des commandes, changement de statut, annulation et service.
Factures
/invoices
Facturation, paiement et annulation de paiements.
Caisse
/cash-registers
Ouverture, fermeture de caisse, sessions et transactions.
Menu
/menu/categories, /menu/items
Catégories et articles du menu, gestion de la disponibilité.
Tables & Zones
/tables, /zones
Gestion des zones, tables, occupation et réservation.
Réservations
/reservations
Création, confirmation et annulation de réservations.
Cuisine
/kitchen/orders
File d'attente cuisine, démarrage préparation et signaler prêt.
Stock
/stock-items, /stock-movements
Articles en stock, mouvements et alertes de réapprovisionnement.
Clients
/clients
Gestion des clients, activation/désactivation.
Fournisseurs
/suppliers, /purchase-orders
Fournisseurs, bons de commande et réception de marchandise.
Utilisateurs
/users
Gestion des utilisateurs, rôles et permissions.
Paramètres
/settings
Configuration générale du système et du restaurant.
Réponse standard
Succès
{
"success": true,
"data": { ... },
"message": "Opération réussie"
}Erreur
{
"success": false,
"message": "Erreur de validation",
"errors": { ... }
}