{"id":12604,"date":"2025-09-24T03:29:28","date_gmt":"2025-09-24T01:29:28","guid":{"rendered":"https:\/\/help.mapal-os.com\/?p=12604"},"modified":"2026-02-19T22:50:55","modified_gmt":"2026-02-19T21:50:55","slug":"api-des-ventes-workforce","status":"publish","type":"post","link":"https:\/\/help.mapal-os.com\/fr\/analytics-fr\/ventes\/api-des-ventes-workforce\/","title":{"rendered":"API des ventes Workforce"},"content":{"rendered":"\n<p>L'API Ventes est un service RESTful pour une int\u00e9gration s\u00e9curis\u00e9e de serveur \u00e0 serveur. Elle vous permet de :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>R\u00e9cup\u00e9rer des donn\u00e9es :<\/strong> Obtenir les ventes nettes et brutes filtr\u00e9es par unit\u00e9 et plage de dates.<\/li>\n\n\n\n<li><strong>Soumettre des donn\u00e9es :<\/strong> Importer des ventes d\u00e9taill\u00e9es, horaires et totales.<\/li>\n\n\n\n<li><strong>Int\u00e9gration s\u00e9curis\u00e9e :<\/strong> Toutes les communications sont chiffr\u00e9es via SSL\/TLS et authentifi\u00e9es avec des jetons JWT.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">D\u00e9marrage rapide<\/h2>\n\n\n\n<p>Voici le flux de travail typique en cinq \u00e9tapes :<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>1. G\u00e9n\u00e9rer un jeton JWT<\/strong><\/summary>\n<p>cur l -X POST&nbsp;<a href=\"https:\/\/login.mapal-os.com\/connect\/token\">https:\/\/login.mapal-os.com\/connect\/token<\/a>&nbsp; \\<br>-H \"Content-Type: application\/x-www-form-urlencoded\"  \\<br>-d \"grant_type=password&amp;username=&lt;your_username&gt;&amp;password=&lt;your_password&gt;&amp;client_id=wf_wap_tp&amp;client_secret=&lt;shared_client_secret&gt; \"                <\/p>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>2. D\u00e9marrer une session d'importation<\/strong><\/summary>\n<p>cur l -X POST&nbsp;<a href=\"https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import\">https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import<\/a>&nbsp;\\<br>-H \"Content-Type: application\/json\"  \\<br>-H \"Authorization: Bearer &lt;token&gt;\"  \\<br>-d '{ \"unitId\": 9, \"businessDay\": \"2025-02-06\" }'<\/p>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>3. Importer les donn\u00e9es de ventes (exemple : ventes totales)<\/strong><\/summary>\n<p>cur l -X POST&nbsp;<a href=\"https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import\/1\/total-sales\">https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import\/1\/total-sales<\/a>&nbsp;\\<br>-H \"Content-Type: application\/json\"  \\<br>-H \"Authorization: Bearer &lt;token&gt;\"  \\<br>-d '{ \"TotalSales\": [ { \"CurrencyId\": \"EUR\", \"NetSales\": 250, \"GrossSales\": 270, \"NumChecks\": 2, \"NumGuests\": 3, \"SalesTypeId\": \"TAKE\", \"SalesType\": \"Takeaway\" } ] }'<\/p>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>4. Terminer la session d'importation<\/strong><\/summary>\n<p>cur l -X POST&nbsp;<a href=\"https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import\/1\/finish\">https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/import\/1\/finish<\/a>&nbsp; \\  <br>-H \"Authorization: Bearer &lt;token&gt; \"    <\/p>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>5. R\u00e9cup\u00e9rer les donn\u00e9es de ventes<\/strong><\/summary>\n<p>cur l -X GET \"<a href=\"https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/business-unit\/9\/net-sales?start=2025-02-06&amp;end=2025-02-06\">https:\/\/api.workforce.mapal-os.com\/sales\/api\/v1\/business-unit\/9\/net-sales?start=2025-02-06&amp;end=2025-02-06<\/a>\" \\<br>-H \"Authorization: Bearer &lt;token&gt; \"    <\/p>\n<\/details>\n\n\n\n<h2 class=\"wp-block-heading\">Authentification<\/h2>\n\n\n\n<p>L'API utilise JWT (JSON Web Token) pour l'authentification.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Demandez un jeton avec vos identifiants client.\n<ul class=\"wp-block-list\">\n<li><strong>URL:&nbsp;<\/strong><a href=\"https:\/\/login.mapal-os.com\/connect\/token\">https:\/\/login.mapal-os.com\/connect\/token<\/a><\/li>\n\n\n\n<li><strong>grant_type: <\/strong>password.  <\/li>\n\n\n\n<li><strong>client_id: <\/strong>wf_wap_tp.  <\/li>\n\n\n\n<li><strong>client_secret: <\/strong>provided by Mapal OS<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Utilisez le jeton dans chaque requ\u00eate :<\/strong> <\/li>\n\n\n\n<li><strong>Authorization: <\/strong>Bearer {access_token} <\/li>\n\n\n\n<li><strong>Expiration du jeton : <\/strong>Les jetons expirent (par d\u00e9faut : 3600 secondes). Rafra\u00eechissez ou r\u00e9g\u00e9n\u00e9rez si n\u00e9cessaire.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Flux d'importation<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Authentification :<\/strong> g\u00e9n\u00e9rer un jeton JWT. <\/li>\n\n\n\n<li><strong>D\u00e9marrer une session d'importation :<\/strong> cr\u00e9e une session pour un jour ouvr\u00e9 sp\u00e9cifique.\n<ul class=\"wp-block-list\">\n<li>Les donn\u00e9es de ventes pr\u00e9c\u00e9dentes pour ce jour seront remplac\u00e9es.<\/li>\n\n\n\n<li>Les sessions doivent \u00eatre remplies s\u00e9quentiellement (pas de lacunes dans les jours ouvr\u00e9s).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Soumettre les donn\u00e9es de ventes :<\/strong> envoyez les donn\u00e9es vers un ou plusieurs points de terminaison :\n<ul class=\"wp-block-list\">\n<li>Ventes d\u00e9taill\u00e9es<\/li>\n\n\n\n<li>Ventes totales<\/li>\n\n\n\n<li>Ventes par demi-heure<\/li>\n\n\n\n<li>Mix produit<\/li>\n\n\n\n<li>Inventaire<\/li>\n\n\n\n<li>Ventes TVA<\/li>\n\n\n\n<li>\u2026et plus encore (voir la liste des points de terminaison).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Terminer la session d'importation :<\/strong> finaliser l'importation. <\/li>\n\n\n\n<li><strong>Visualiser les donn\u00e9es import\u00e9es :<\/strong> dans Analytics &gt; Ventes dans Mapal OS.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">R\u00e9f\u00e9rence des points de terminaison<\/h2>\n\n\n\n<p>Tous les points de terminaison sont sous :&nbsp;<a href=\"https:\/\/api.workforce.mapal-os.com\/sales\">https:\/\/api.workforce.mapal-os.com\/sales<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">R\u00e9cup\u00e9ration des ventes<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Ventes nettes : <\/strong>GET \/api \/v1\/business-unit\/{unitId}\/net-sales?start=yyyy-MM-dd&amp;end=yyyy-MM-dd  <\/li>\n\n\n\n<li><strong>Ventes brutes : <\/strong>GET \/api \/v1\/business-unit\/{unitId}\/gross-sales?start=yyyy-MM-dd&amp;end=yyyy-MM-dd<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Flux d'importation<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>D\u00e9marrer une session d'importation :<\/strong> POST \/api \/v1\/import <\/li>\n\n\n\n<li><strong>Terminer une session d'importation : <\/strong>POST \/api \/v1\/import\/{importId}\/finish  <\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Points de terminaison d'importation<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>POST \/api\/v1\/import\/{importId}\/detailed-sales<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/total-sales<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/half-hourly-sales<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/total-half-hourly-sales<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/product-mix<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/special-tickets<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/payment-method-sales<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/average-ticket-duration<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/inventory<\/li>\n\n\n\n<li>POST \/api\/v1\/import\/{importId}\/vat-sales<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Gestion des erreurs<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>400 Bad Request :<\/strong> v\u00e9rifiez les param\u00e8tres ou le corps JSON.<\/li>\n\n\n\n<li><strong>401 Unauthorized :<\/strong> rafra\u00eechissez ou r\u00e9g\u00e9n\u00e9rez le jeton.<\/li>\n\n\n\n<li><strong>404 Not Found :<\/strong> unitId invalide ou configuration du tenant incorrecte.<\/li>\n\n\n\n<li><strong>500 Internal Server Error :<\/strong> r\u00e9essayez ou contactez le support.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>En tant que d\u00e9veloppeur int\u00e9grant Mapal OS, vous pouvez utiliser l'API Ventes Workforce pour g\u00e9rer, importer et r\u00e9cup\u00e9rer efficacement les donn\u00e9es de ventes. Ce guide pr\u00e9sente comment s'authentifier, commencer \u00e0 importer et r\u00e9cup\u00e9rer les ventes, avec un flux de d\u00e9marrage rapide et une r\u00e9f\u00e9rence compl\u00e8te des points de terminaiso<\/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":[131355,131459],"class_list":["post-12604","post","type-post","status-publish","format-standard","hentry","category-ventes","tag-apis","tag-sales"],"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\/12604","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=12604"}],"version-history":[{"count":0,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12604\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/media?parent=12604"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/categories?post=12604"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/tags?post=12604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}