{"id":12326,"date":"2025-08-15T00:39:04","date_gmt":"2025-08-14T22:39:04","guid":{"rendered":"https:\/\/help.mapal-os.com\/?p=12326"},"modified":"2026-10-08T05:03:01","modified_gmt":"2026-10-08T03:03:01","slug":"racuparer-les-donnaes-de-shifts-de-caisse-via-api","status":"publish","type":"post","link":"https:\/\/help.mapal-os.com\/fr\/analytics-fr\/cashrec-4\/racuparer-les-donnaes-de-shifts-de-caisse-via-api\/","title":{"rendered":"R\u00e9cup\u00e9rer les donn\u00e9es de shifts de caisse 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 Cashrec<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">L\u2019API Cashrec est un service RESTful qui permet de r\u00e9cup\u00e9rer les donn\u00e9es de feuilles de caisse pour des sites et des p\u00e9riodes sp\u00e9cifiques.<\/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>Obtenez des informations d\u00e9taill\u00e9es sur la caisse et les ventes au niveau du shift.<\/li>\n\n\n\n<li>B\u00e9n\u00e9ficiez d\u2019une int\u00e9gration de serveur \u00e0 serveur s\u00e9curis\u00e9e et chiffr\u00e9e (HTTPS + JWT).<\/li>\n\n\n\n<li>Traitez des volumes \u00e9lev\u00e9s de requ\u00eates en temps r\u00e9el.<\/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>Champs de la r\u00e9ponse en cas de succ\u00e8s :<\/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\">Obtenir les informations de feuille de caisse<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Domaine de base (OpenAPI) :<\/strong> <code>https:\/\/cashrec.api.pro.mapal-os.com<\/code>.<\/li>\n\n\n\n<li><strong>Chemin du point de terminaison :<\/strong> <code>\/api\/v1\/cashSheet<\/code>.<\/li>\n\n\n\n<li><strong>M\u00e9thode :<\/strong> GET.<\/li>\n\n\n\n<li><strong>Description :<\/strong> r\u00e9cup\u00e8re les informations d\u00e9taill\u00e9es de feuille de caisse pour une p\u00e9riode et une liste de sites donn\u00e9es.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Param\u00e8tres de requ\u00eate<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>startDate<\/code> (format : <code>yyyy-MM-ddTHH:mm:ss<\/code>).<\/li>\n\n\n\n<li><code>endDate<\/code> (format : <code>yyyy-MM-ddTHH:mm:ss<\/code>).<\/li>\n\n\n\n<li><code>centersList<\/code> (liste d\u2019identifiants de sites s\u00e9par\u00e9s par des virgules).<\/li>\n\n\n\n<li><strong>R\u00e9ponse :<\/strong> <code>200 OK<\/code> avec les enregistrements de feuilles de caisse pour la p\u00e9riode et les sites demand\u00e9s.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Remarque :<\/strong> les noms des param\u00e8tres peuvent \u00eatre sensibles \u00e0 la casse. Utilisez les noms exacts indiqu\u00e9s dans votre sp\u00e9cification OpenAPI s\u2019ils diff\u00e8rent (par exemple, <code>StartDate<\/code> au lieu de <code>startDate<\/code>). Pour le sch\u00e9ma complet des requ\u00eates et des r\u00e9ponses ainsi que la documentation interactive, consultez la sp\u00e9cification OpenAPI : <a href=\"https:\/\/cashrec.api.pro.mapal-os.com\/swagger\/index.html\">https:\/\/cashrec.api.pro.mapal-os.com\/swagger\/index.html<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Erreurs de l\u2019API<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>400 Bad Request :<\/strong> param\u00e8tres manquants ou non valides. Exemple de message, code 100 : \u00ab Invalid parameters. You must provide valid StartDate, EndDate and CenterLists. \u00bb<\/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 introuvable. Exemple de message, code 0 : \u00ab Tenant configuration not found. \u00bb<\/li>\n\n\n\n<li><strong>500 Internal Server Error :<\/strong> erreur inattendue du serveur.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Remarque :<\/strong> toutes les requ\u00eates doivent utiliser HTTPS. Les jetons expirent (voir <code>expires_in<\/code>) et doivent \u00eatre renouvel\u00e9s \u00e0 leur expiration. Si un jeton est compromis, le fournisseur de l\u2019API peut le r\u00e9voquer.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>En tant que d\u00e9veloppeur int\u00e9grant votre syst\u00e8me avec Mapal OS, vous pouvez r\u00e9cup\u00e9rer de mani\u00e8re s\u00e9curis\u00e9e les donn\u00e9es de ventes et de caisse au niveau du shift afin de pouvoir rapprocher les op\u00e9rations de caisse avec les enregistrements Mapal en temps r\u00e9el. L'API Cashrec 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":[132553,132552],"tags":[],"class_list":["post-12326","post","type-post","status-publish","format-standard","hentry","category-commencer-2","category-cashrec-4"],"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\/12326","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=12326"}],"version-history":[{"count":1,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12326\/revisions"}],"predecessor-version":[{"id":26025,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/posts\/12326\/revisions\/26025"}],"wp:attachment":[{"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/media?parent=12326"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/categories?post=12326"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.mapal-os.com\/fr\/wp-json\/wp\/v2\/tags?post=12326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}