Point de départ : votre intégration de serveur à serveur (client API).
L’API de ventes en temps réel
L’API de ventes en temps réel est un service RESTful qui permet de soumettre des données de ventes en direct de manière sécurisée.
Principaux avantages :
- Mise à jour immédiate des chiffres de ventes.
- Connexion de serveur à serveur sécurisée (HTTPS + JWT).
- Filtrage flexible par site et par jour d’activité.
Générer un jeton JWT
Envoyez une requête POST à : https://login.mapal-os.com/connect/token
Paramètres :
grant_type=passwordusername=password=client_id=wf_wap_tpclient_secret=(contactez le Support client pour l’obtenir).
La réponse en cas de succès contient : access_token, expires_in, token_type, refresh_token, scope.
Inclure le jeton dans les requêtes
- Ajoutez l’en-tête :
Authorization: Bearer {access_token}.
Soumettre des ventes en temps réel
- Domaine de base :
https://api.workforce.mapal-os.com/sales. - Chemin du point de terminaison :
/api/v1/business-unit/{unitId}/real-time-sales. - Méthode : GET (si votre spécification OpenAPI indique une autre méthode, suivez la spécification).
Paramètres et champs de la charge utile
unitId(route, entier).businessDay(chaîne,yyyy-MM-dd).realTimeSales(tableau d’objets) :currencyId(chaîne).salesTypeId(chaîne).timeSlotStart(chaîne, date-heure).netSales(décimal).grossSales(décimal).numChecks(entier).numGuests(entier).
Vérifier les ventes soumises
- Accédez à Analytics > Ventes dans Mapal OS.
Remarque :
- Toutes les requêtes doivent utiliser HTTPS.
- Les jetons expirent (
expires_in) et doivent être générés à nouveau. - Les jetons peuvent être révoqués s’ils sont compromis.
Gestion des erreurs
- 400 Bad Request : identifiant de site non valide, incohérence du jour d’activité, incohérence de la devise ou du type de vente, créneaux horaires non valides.
- 401 Unauthorized : jeton non valide ou manquant.
- 404 Not Found : tenant ou configuration du tenant introuvable.
- 500 Internal Server Error : erreur inattendue du serveur.
