{"id":13452,"date":"2025-08-15T00:39:04","date_gmt":"2025-08-14T22:39:04","guid":{"rendered":"https:\/\/help.mapal-os.com\/?p=13452"},"modified":"2026-01-27T15:43:32","modified_gmt":"2026-01-27T14:43:32","slug":"obtener-datos-de-turnos-de-caja-mediante-api","status":"publish","type":"post","link":"https:\/\/help.mapal-os.com\/es\/analytics-es\/cashrec-2\/obtener-datos-de-turnos-de-caja-mediante-api\/","title":{"rendered":"Obtener datos de turnos de caja mediante API"},"content":{"rendered":"\n\n<p><strong>Empieza desde:<\/strong> Tu interface de servidor a servidor (cliente de API).<\/p>\n\n\n\n\n\n\n<h2 class=\"wp-block-heading\">La <strong>API de Cashrec<\/strong><\/h2>\n\n\n\n\n\n\n<p>La <strong>API de Cashrec<\/strong> es un servicio RESTful para obtener <strong>datos de hojas de caja<\/strong> de centros de negocio espec\u00edficos y rangos de fechas concretos.<\/p>\n\n\n\n\n\n\n<p><strong>Ventajas clave:<\/strong><\/p>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Obt\u00e9n informaci\u00f3n detallada de efectivo y ventas por turno.<\/li>\n\n\n\n\n\n\n<li>Interfaces de servidor a servidor seguras y cifradas (HTTPS + JWT).<\/li>\n\n\n\n\n\n\n<li>Admite solicitudes en tiempo real y de gran volumen.<\/li>\n<\/ul>\n\n\n\n\n\n\n<h2 class=\"wp-block-heading\">Generar un token JWT<\/h2>\n\n\n\n\n\n\n<p><strong>REALIZA una solicitud POST a: <\/strong><a class=\"\" href=\"https:\/\/login.mapal-os.com\/connect\/token\">https:\/\/login.mapal-os.com\/connect\/token<\/a><\/p>\n\n\n\n\n\n\n<p><strong>Par\u00e1metros:<\/strong><\/p>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>grant_type=password<\/li>\n\n\n\n\n\n\n<li>username=<your_username><\/your_username><\/li>\n\n\n\n\n\n\n<li>password=<your_password><\/your_password><\/li>\n\n\n\n\n\n\n<li>client_id=wf_wap_tp<\/li>\n\n\n\n\n\n\n<li>client_secret=<shared_client_secret> (contacta con el servicio de atenci\u00f3n al Cliente para obtenerlo)<br>Campos de respuesta correctos: access_token, expires_in, token_type, refresh_token, scope.<\/shared_client_secret><\/li>\n<\/ul>\n\n\n\n\n\n\n<h2 class=\"wp-block-heading\">Incluye el token en las solicitudes<\/h2>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>A\u00f1ade el encabezado:<\/strong> Authorization: Bearer {access_token}<\/li>\n<\/ul>\n\n\n\n\n\n\n<h2 class=\"wp-block-heading\">Obtener informaci\u00f3n de hoja de caja<\/h2>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>Dominio base (OpenAPI):<\/strong> <a class=\"\" href=\"https:\/\/cashrec.api.pro.mapal-os.com\">https:\/\/cashrec.api.pro.mapal-os.com<\/a><\/li>\n\n\n\n\n\n\n<li><strong>Ruta del endpoint: <\/strong>\/api\/v1\/cashSheet<\/li>\n\n\n\n\n\n\n<li><strong>M\u00e9todo:<\/strong> GET<\/li>\n\n\n\n\n\n\n<li><strong>Descripci\u00f3n: <\/strong>Recupera informaci\u00f3n detallada de la hoja de caja para un periodo y una lista de centros de negocio especificados.<\/li>\n<\/ul>\n\n\n\n\n\n\n<h2 class=\"wp-block-heading\">Par\u00e1metros de consulta<\/h2>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>startDate<\/strong> (format: yyyy-MM-ddTHH:mm:ss)<\/li>\n\n\n\n\n\n\n<li><strong>endDate <\/strong>(format: aaaa-MM-ddTHH:mm:ss)<\/li>\n\n\n\n\n\n\n<li><strong>centersList <\/strong>(comma?separated list of centre IDs)<\/li>\n\n\n\n\n\n\n<li><strong>Response: <\/strong>200 OK with cash sheet records for the requested period and centres.<\/li>\n<\/ul>\n\n\n\n\n\n\n<p><strong>Observaciones:<\/strong> Los nombres de los par\u00e1metros pueden distinguir entre may\u00fasculas y min\u00fasculas. Usa los nombres exactos que se muestran en tu especificaci\u00f3n de OpenAPI si difieren (por ejemplo, StartDate frente a startDate). Para ver el esquema completo de solicitud\/respuesta y la documentaci\u00f3n interactiva, consulta la especificaci\u00f3n de OpenAPI en: <a class=\"\" 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\n\n\n<h2 class=\"wp-block-heading\"><strong>Errores de la API<\/strong><\/h2>\n\n\n\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>400 Bad Request: <\/strong>par\u00e1metros faltantes o no v\u00e1lidos. C\u00f3digo de mensaje de ejemplo 100: \"Par\u00e1metros no v\u00e1lidos. Debes proporcionar StartDate, EndDate y CenterLists v\u00e1lidos.\"<\/li>\n\n\n\n\n\n\n<li><strong>401 No autorizado: <\/strong>token no v\u00e1lido o ausente.<\/li>\n\n\n\n\n\n\n<li><strong>404 No encontrado: <\/strong>inquilino no encontrado. C\u00f3digo de mensaje de ejemplo 0: \"Configuraci\u00f3n del inquilino no encontrada.\"<\/li>\n\n\n\n\n\n\n<li><strong>500 Error interno del servidor: <\/strong>error inesperado del servidor.<\/li>\n<\/ul>\n\n\n\n\n\n\n<p><strong>Observaciones<\/strong>: Todas las solicitudes deben usar HTTPS. Los tokens caducan (consulta expires_in) y debes actualizarlos cuando caduquen. Si se compromete un token, el proveedor de la API puede revocarlo<\/p>\n\n\n\n\n\n\n\n\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como desarrollador que crea una interface entre tu sistema y Mapal OS, puedes recuperar de forma segura datos de ventas y efectivo a nivel de turno para conciliar en tiempo real las operaciones de caja con los registros de Mapal. La API de Cashrec es RESTful y est\u00e1 protegida con HTTPS y 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":[133067,133066],"tags":[],"class_list":["post-13452","post","type-post","status-publish","format-standard","hentry","category-empezando-2","category-cashrec-2"],"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\/es\/wp-json\/wp\/v2\/posts\/13452","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/users\/251210541"}],"replies":[{"embeddable":true,"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/comments?post=13452"}],"version-history":[{"count":0,"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/posts\/13452\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/media?parent=13452"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/categories?post=13452"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.mapal-os.com\/es\/wp-json\/wp\/v2\/tags?post=13452"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}