{"id":12436,"date":"2025-08-14T23:57:34","date_gmt":"2025-08-14T21:57:34","guid":{"rendered":"https:\/\/help.mapal-os.com\/?p=12436"},"modified":"2026-10-08T05:05:08","modified_gmt":"2026-10-08T03:05:08","slug":"soumettre-des-ventes-en-temps-rael-via-api","status":"publish","type":"post","link":"https:\/\/help.mapal-os.com\/fr\/analytics-fr\/ventes\/soumettre-des-ventes-en-temps-rael-via-api\/","title":{"rendered":"Soumettre des ventes en temps r\u00e9el via API"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><strong>Point de d\u00e9part :<\/strong> votre int\u00e9gration de serveur \u00e0 serveur (client API).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">L\u2019API de ventes en temps r\u00e9el<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">L\u2019API de ventes en temps r\u00e9el est un service RESTful qui permet de soumettre des donn\u00e9es de ventes en direct de mani\u00e8re s\u00e9curis\u00e9e.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Principaux avantages :<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mise \u00e0 jour imm\u00e9diate des chiffres de ventes.<\/li>\n\n\n\n<li>Connexion de serveur \u00e0 serveur s\u00e9curis\u00e9e (HTTPS + JWT).<\/li>\n\n\n\n<li>Filtrage flexible par site et par jour d\u2019activit\u00e9.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">G\u00e9n\u00e9rer un jeton JWT<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Envoyez une requ\u00eate POST \u00e0 : <code>https:\/\/login.mapal-os.com\/connect\/token<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Param\u00e8tres :<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>grant_type=password<\/code><\/li>\n\n\n\n<li><code>username=<\/code><\/li>\n\n\n\n<li><code>password=<\/code><\/li>\n\n\n\n<li><code>client_id=wf_wap_tp<\/code><\/li>\n\n\n\n<li><code>client_secret=<\/code> (contactez le Support client pour l\u2019obtenir).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>La r\u00e9ponse en cas de succ\u00e8s contient :<\/strong> <code>access_token<\/code>, <code>expires_in<\/code>, <code>token_type<\/code>, <code>refresh_token<\/code>, <code>scope<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Inclure le jeton dans les requ\u00eates<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ajoutez l\u2019en-t\u00eate : <code>Authorization: Bearer {access_token}<\/code>.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Soumettre des ventes en temps r\u00e9el<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Domaine de base :<\/strong> <code>https:\/\/api.workforce.mapal-os.com\/sales<\/code>.<\/li>\n\n\n\n<li><strong>Chemin du point de terminaison :<\/strong> <code>\/api\/v1\/business-unit\/{unitId}\/real-time-sales<\/code>.<\/li>\n\n\n\n<li><strong>M\u00e9thode :<\/strong> GET (si votre sp\u00e9cification OpenAPI indique une autre m\u00e9thode, suivez la sp\u00e9cification).<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Param\u00e8tres et champs de la charge utile<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>unitId<\/code> (route, entier).<\/li>\n\n\n\n<li><code>businessDay<\/code> (cha\u00eene, <code>yyyy-MM-dd<\/code>).<\/li>\n\n\n\n<li><code>realTimeSales<\/code> (tableau d\u2019objets) :\n<ul class=\"wp-block-list\">\n<li><code>currencyId<\/code> (cha\u00eene).<\/li>\n\n\n\n<li><code>salesTypeId<\/code> (cha\u00eene).<\/li>\n\n\n\n<li><code>timeSlotStart<\/code> (cha\u00eene, date-heure).<\/li>\n\n\n\n<li><code>netSales<\/code> (d\u00e9cimal).<\/li>\n\n\n\n<li><code>grossSales<\/code> (d\u00e9cimal).<\/li>\n\n\n\n<li><code>numChecks<\/code> (entier).<\/li>\n\n\n\n<li><code>numGuests<\/code> (entier).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">V\u00e9rifier les ventes soumises<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Acc\u00e9dez \u00e0 <strong>Analytics > Ventes<\/strong> dans Mapal OS.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Remarque :<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Toutes les requ\u00eates doivent utiliser HTTPS.<\/li>\n\n\n\n<li>Les jetons expirent (<code>expires_in<\/code>) et doivent \u00eatre g\u00e9n\u00e9r\u00e9s \u00e0 nouveau.<\/li>\n\n\n\n<li>Les jetons peuvent \u00eatre r\u00e9voqu\u00e9s s\u2019ils sont compromis.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Gestion des erreurs<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>400 Bad Request :<\/strong> identifiant de site non valide, incoh\u00e9rence du jour d\u2019activit\u00e9, incoh\u00e9rence de la devise ou du type de vente, cr\u00e9neaux horaires non valides.<\/li>\n\n\n\n<li><strong>401 Unauthorized :<\/strong> jeton non valide ou manquant.<\/li>\n\n\n\n<li><strong>404 Not Found :<\/strong> tenant ou configuration du tenant introuvable.<\/li>\n\n\n\n<li><strong>500 Internal Server Error :<\/strong> erreur inattendue du serveur.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>En tant que d\u00e9veloppeur int\u00e9grant votre syst\u00e8me avec Mapal OS, vous pouvez soumettre des ventes en temps r\u00e9el via API afin que les chiffres soient instantan\u00e9ment disponibles pour les rapports et les pr\u00e9visions. L'API de ventes en temps r\u00e9el est RESTful et s\u00e9curis\u00e9e avec HTTPS et JWT.<\/p>\n","protected":false},"author":251210541,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[132059],"tags":[],"class_list":["post-12436","post","type-post","status-publish","format-standard","hentry","category-ventes"],"acf":{"article_type":"default","post_id":"","post_url_text":"","post_url":"","info_box":{"title":"","info":""},"post_video":"","import_category":"","overview_item":null,"troubleshoot_case":null},"_links":{"self":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12436","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/users\/251210541"}],"replies":[{"embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/comments?post=12436"}],"version-history":[{"count":1,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12436\/revisions"}],"predecessor-version":[{"id":26026,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12436\/revisions\/26026"}],"wp:attachment":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/media?parent=12436"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/categories?post=12436"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/tags?post=12436"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}