--- title: API's - Enterprise Service Platform slug: dev-es/apis-enterprise-service-platform description: Learn about the communication framework REST and how it facilitates the login process, contract listing, request denial, and solicitation status between applications and backend servers. This document outlines the request and response formats for various createdAt: 2022-06-26T18:38:22.000Z --- Esta sección pretende describir el marco de comunicación REST, establecida entre las aplicaciones y el servidor back-end. :::hint{type="warning"} ⚠️**¡Atención!** ******4biz\_URL****:** prefijo de URL inmutable, para que pueda acceder a los servicios disponibles para aplicaciones móviles. Cada API que necesite un "**sessionID**" deberá estar en una sesión proporcionada por el "Inicio de sesión" de la API. ::: *** ### Inicio de sesión Inicio de sesión del usuário para utilizar los Servicios **4biz****:** :::CodeblockTabs Método ```none POST ``` ```html <4biz_URL>/services/v2/login ``` Solicitación ```json Solicitación { "userName": "mobile", "password": "123456", "token": "API132654ASFE32132121­5412", "platform": "android" } ``` ::: :::CodeblockTabs Respuesta ```json Response { "sessionID": "2355A68BF75281B73607EEC1A7191645", "rangeAction": 10, "locationInterval": 10 } ``` Campos ```none Solicitación: userName: alfanumérico no vacío y no nulo; password: alfanumérico no vacío y no nulo; token: alfanumérico no vacío y no nulo, se refiere al identificador del dispositivo para enviar la notificación push; platform: se refiere al tipo de plataforma (ios o android) donde el usuário efectuará login; Respuesta: sessionID: no puede ser vacío o nulo. rangeAction: es entero, no nulo y no puede ser cero. Representa el radio de acción de un usuario de campo en KM. locationInterval: es entero, no nulo y mayor que cero. Representa, en minutos, el intervalo de tiempo que la aplicación debe enviar la posición del asistente. ``` ::: ### ListContracts Lista de contratos accesibles para el asistente. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/contracts ``` Solicitación ```json { "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412101947000, "operationID": 65, "error": null, "contracts": [ { "id": 1, "description": "Test Name" } ] } ``` Campos ```none Solicitación : sessionID: alfanumérico no nulo y no vacío; Respuesta : dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; contracts: no vacío ni nulo; id: numérico no vacío ni nulo; description: alfanumérico no vacío ni nulo. ``` ::: ### ListDeniedReasons Lista de razones para rechazar una solicitud, por ejemplo, en el check-in: :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/deniedReasons ``` Solicitación ```json { "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412101988000, "operationID": 666, "error": null, "reasons": [ { "id": 1, "description": "First Suspension Reason" }, { "id": 2, "description": "Second Suspension Reason" } ] } ``` Campos ```none Solicitación : sessionID: alfanumérico no nulo y no vacío; Respuesta : dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; contracts: no vacío ni nulo; id: numérico no vacío ni nulo; description: alfanumérico no vacío ni nulo. ``` ::: ### ListSolicitationStatus Enumera los estados de una solicitud que se utilizará, por ejemplo, en el servicio de checkout. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/status ``` Solicitación ```json { "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412101662000, "operationID": 64, "error": null, "status": [ { "id": 1, "description": "In progress" }, { "id": 2, "description": "Suspended", "justifications": [ { "id": 1, "description": "First Suspension Reason" }, { "id": 2, "description": "Second Suspension Reason" } ] }, { "id": 3, "description": "Canceled" }, { "id": 4, "description": "Solved", "justifications": [ { "id": 1, "description": "Reconfigured database user", "parentId": null }, { "id": 2, "description": "Any other solution here", "parentId": 1 } ] } ] } ``` Campos ```none Solicitación : sessionID: alfanumérico no vacío y no nulo; Respuesta : dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; contracts: no vacío ni nulo; id: numérico no vacío ni nulo; description: alfanumérico no vacío ni nulo. ``` ::: ### ListUnits Enumera las unidades de un contrato: :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/units ``` Solicitación ```json { "sessionID": "2355A68BF75281B73607EEC1A7191645" "contractID": 1233 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412101988000, "operationID": 66, "error": null, "units": [ { "id": 1, "description": "Default" }, { "id": 2, "description": "Unit Test" } ] } ``` Campos ```none Solicitación : sessionID: alfanumérico no vacío y no nulo; contractID: numérico no nulo Respuesta : dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; contracts: no vacío ni nulo; id: numérico no vacío ni nulo; description: alfanumérico no vacío ni nulo. ``` ::: ### SendCoordinates Actualiza las coordenadas geográficas de una unidad. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/coordinates ``` Solicitación ```json { "unitID": 222, "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412102841000, "operationID": 68, "error": null, "success": true } ``` Campos ```none Solicitación: unitID: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; success: boolean; ``` ::: ### DeviceDisassociate Desvincular un usuario de un dispositivo para que, al eliminar una conexión, el usuario deje de recibir la notificación push de la conexión eliminada. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/coordinates ``` Solicitación ```json { "unitID": 222, "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412102841000, "operationID": 68, "error": null, "success": true } ``` Campos ```none Solicitación: unitID: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; success: boolean; ``` ::: ### GetNewest Recupera la solicitud más reciente del usuario en el grupo a partir de la última (newestNumber) en la aplicación. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/getNewest ``` Solicitación ```json { "notificationType": 0, "onlyApproval": 1, "newestNumber": 322, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618318000, "operationID": 336, "error": null, "notifications": [ { "number": 95933, "taskId": 22737, "type": 1, "date": "27/08/2013", "timeFlag": 12345, "timeSLA": 12, "latitude": 32.9984730, "longitude": 29.9984730, "endSLA": "null", "task": "Validar requisição", "personal": true, "inService": true, "inCkeckin": 0, "typeRequest": 0, "waiting": 1, "service": "SERVICES AND PRODUCTS REQUEST", "contract": 1, "unit": 15, "priorityorder": 1 } ] } ``` Campos ```none Solicitación: notificationType: numérico no nulo; onlyApproval: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; newestNumber: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; notifications: no nulo; number: numérico no nulo; taskId: numérico no nulo; type: numérico no vacío ni nulo; 0 - Todo 1 - Compras 2 - Viajes 3 - RH 4 - Incidentes 5 - Otros 6 - Esperando data: string de fecha en el formato dd/mm/aaaa; timeFlag: Número que define el periodo; 0 - A tiempo 1 - Menos de una hora 2 - Atrasado timeSLA: numérico entero no nulo, en minutos; latitude: numérico; longitude: numérico; endSLA: fecha en alfanumérico en los patrones dd/MM/aaaa HH:mm o MM/dd/aaaa HH:mm, dependiendo de la configuración regional, que puede tener valor nulo. task: alfanumérico no vacío n nulo; personal: boolean que identifica si la solicitud está destinada al usuario o al grupo; inService: Boolean no nulo que identifica si la solicitud se está cumpliendo; inCheckin: Flag que identifica si la solicitud está en check Personal (true o false); 0 – Esperando checkin 1 – En Checkin service: alfanumérico no vacío ni nulo; typeRequest: Flag que identifica el tipo de ejecución de la solicitud 0 - Ejecución de la Solicitud 1 - Aprobación de la Solicitud waiting: Flag que define el estado de la solicitud. 0 - Acompañando 1 - Ejecución disponible contract: numérico no nulo; unit: numérico no nulo; priorityorder: valor numérico que puede tener un valor nulo, número de secuencia que identifica si el gestor solicitó el servicio; ``` ::: ### GetOldest Recupera la solicitud más reciente del usuario en el grupo a partir de la más antigua. :::CodeblockTabs Método ```Text { "notificationType": 0, "onlyApproval": 1, "oldestNumber": 322, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` URL ```html <4biz_URL>/services/v2/getOldest ``` Solicitación ```json { "notificationType": 0, "onlyApproval": 1, "oldestNumber": 322, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618318000, "operationID": 336, "error": null, "notifications": [ { "number": 95933, "taskId": 22737, "type": 1, "date": "27/08/2013", "timeFlag": 12345, "timeSLA": 12, "latitude": 32.9984730, "longitude": 29.9984730, "endSLA": "null", "task": "Validate request", "personal": true, "inService": true, "inCheckin": 1, "typeRequest": 0, "waiting": 1 "service": "SERVICES AND PRODUCTS REQUEST", "contract": 1, "unit": 15, "priorityorder": 1 } ] } ``` Campos ```none Solicitación: notificationType: numérico no nulo; onlyApproval: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; oldestNumber: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; notifications: no nulo; number: numérico no nulo; taskId: numérico no nulo; type: numérico no vacío ni nulo; 0 - Todo 1 - Compras 2 - Viajes 3 - RH 4 - Incidentes 5 - Otros 6 - Esperando date: fecha en el formato dd/mm/aaaa; timeFlag: Número que define el período; 0 - A tiempo 1 - Menos de una hora 2 - Atrasado timeSLA: numérico entero no nulo, en minutos; latitude: numérico; longitude: numérico; endSLA: fecha en alfanumérico en los patrones dd/MM/aaaa HH:mm o MM/dd/aaaa HH:mm, dependiendo de la configuración regional, que puede tener valor nulo. task: alfanumérico no vacío ni nulo; personal: boolean que identifica si la solicitud está destinada al usuario o al grupo; inService: Boolean no nulo que identifica si la solicitud se está cumpliendo; inCheckin: Flag que identifica si la solicitud está en el checkin Personal (true o false); 0 – Esperando checkin 1 – En Checkin service: alfanumérico no vacío ni nulo; typeRequest: Flag que identifica el tipo de ejecución de una solicitación 0 - Ejecución de la Solicitud 1 - Aprobación de la Solicitud waiting: Flag que define el estado de la Solicitud 0 - Acompañando 1 - Ejecución disponible contract: numérico no nulo; unit: numérico no nulo; priorityorder: valor numérico que puede tener valor nulo, número de secuencia que identifica si el gestor solicitó el servicio; ``` ::: ### GetByCoordinates Recupera la solicitud más reciente del usuario en el grupo desde las coordenadas actuales del usuario. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/getByCoordinates ``` Solicitación ```json POST ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618318000, "operationID": 336, "error": null, "notifications": [ { "number": 95933, "taskId": 22737, "type": 1, "date": "27/08/2013", "timeFlag": 12345, "timeSLA": 12, "latitude": 32.9984730, "longitude": 29.9984730, "endSLA": "null", "task": "Validate request", "typeRequest": 0, "waiting": 1 "personal": true, "inService": true, "inCheckin": 1, "service": "SERVICES AND PRODUCTS REQUEST", "contract": 1, "unit": 15, "priorityorder": 1 } ], "paging": { "page": 1, "size": 1, "totalElements": 5, "totalPages": 5 } } ``` Campos ```none Solicitación: notificationType: numérico no nulo; onlyApproval: numérico no nulo; latitude: numérico no nulo; longitude: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; pager: información de paginación: page: número de página que se debe consultar, a partir de 1; size: número de elementos a devolver; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que no puede ser ni nulo ni vacío; notifications: no nulo; number: numérico no nulo; taskId: numérico no nulo; type: numérico no vacío ni nulo; 0 - Todo 1 - Compras 2 - Viajes 3 - RH 4 - Incidentes 5 - Otros 6 - Esperando date: fecha en el formato dd/mm/aaaa; timeFlag: Número que define el período; 0 - A tiempo 1 - Menos de una hora 2 - Atrasado timeSLA: entero numérico no nulo, en minutos; latitude: numérico no nulo; longitude: numérico no nulo; endSLA: fecha en alfanumérico en los patrones dd/MM/aaaa HH:mm o MM/dd/aaaa HH:mm, dependiendo de la configuración regional, que puede tener valor nulo. task: alfanumérico no vacío ni nulo; personal: boolean que identifica si la solicitud estaba destinada al usuario o al grupo; inService: Boolean no nulo que identifica si la solicitud se está cumpliendo; inCheckin: Flag que identifica si la solicitud está en el checkin Personal (true o false); 0 – Esperando checkin 1 – En Checkin service: alfanumérico no vacío ni nulo; typeRequest: Flag que identifica el tipo de ejecución de una solicitud 0 - Ejecución de la Solicitud 1 - Aprobación de la Solicitud waiting: Flag que define el estado de la Solicitud. 0 - Acompañando 1 - Ejecución disponible contract: numérico no nulo; unit: numérico no nulo; priorityorder: valor numérico que puede tener valor nulo, número de secuencia que identifica si el gestor solicitó el servicio; paging: información de paginación 1. page: número de página actual 2. size: tamaño de la página devuelta 3. totalElements: número de elementos según la consulta totalPages: número de páginas según la consulta ``` ::: ### UpdateNotification Recupera las tareas de un servicio. :::CodeblockTabs Respuesta ```json { "dateTime": 1377618318000, "operationID": 336, "error": null, "notifications": [ { "number": 95933, "taskId": 22737, "type": 1, "date": "27/08/2013", "timeFlag": 12345, "timeSLA": 12, "latitude": 32.9984730, "longitude": 29.9984730, "endSLA": "null", "task": "Validate request", "personal": true, "inService": true, "inCheckin": 1, "typeRequest": 0, "waiting": 1 "service: "SERVICES AND PRODUCTS REQUEST", "contract": 1, "unit": 15, "priorityorder": 1 } ] } ``` Campos ```none Solicitación: notificationType: numérico no nulo; onlyApproval: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; oldestNumber: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que no puede ser ni nulo ni vacío; notifications: no nulo; number: numérico no nulo; taskId: numérico no nulo; type: numérico no vacío ni nulo; 0 - Todo 1 - Compras 2 - Viajes 3 - RH 4 - Incidentes 5 - Otros 6 - Esperando date: fecha en el formato dd/mm/aaaa; timeFlag: Número que define el período; 0 - A tiempo 1 - Menos de una hora 2 - Atrasado timeSLA: entero numérico no nulo, en minutos; latitude: numérico no nulo; longitude: numérico no nulo; endSLA: fecha en alfanumérico en los patrones dd/MM/aaaa HH:mm o MM/dd/aaaa HH:mm, dependiendo de la localidad, que puede tener valor nulo. task: alfanumérico no vacío ni nulo; personal: Boolean que identifica si la solicitud estaba destinada al usuario o al grupo; inService: Boolean no nulo que identifica si la solicitud se está cumpliendo; inCheckin: Flag que identifica si la solicitud está en el checkin Personal (true o false); 0 – Esperando checkin 1 – En Checkin service: alfanumérico no vacío ni nulo; typeRequest: Flag que identifica el tipo de ejecución de una solicitud 0 - Ejecución de la Solicitud 1 - Aprobación de la Solicitud waiting: Flag que define el estado de la solicitud. 0 - Acompañando 1 - Ejecución disponi contract: numérico não nulo; unit: numérico não nulo; priorityorder: valor numérico que pode apresentar valor nulo, número de sequência que identifica se o gerente solicitou o serviço; ``` ::: :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/update ``` Solicitación ```json { number": 322, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: ### GetById Recupera los detalles de una solicitud, de acuerdo con su identificador. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/getById ``` Solicitación ```json { "taskId": 22737, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618392000, "operationID": 337, "error": null, "notification": { "endSLA": "null", "task": "Validate request", "service": "SERVICES AND PRODUCTS REQUEST", "description": " test", "status": "In progress", "taskStatus": "Available", "timeSLA": 12 } } ``` Campos ```none Solicitación: taskId: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; notification; no vacío ni nulo; endSLA: fecha en alfanumérico según los patrones dd/MM/aaaa HH:mm o MM/dd/aaaa HH:mm, dependiendo de la configuración regional. task: alfanumérico no vacío ni nulo; service: alfanumérico no vacío ni nulo; description: alfanumérico no vacío ni nulo; status: alfanumérico no vacío ni nulo; taskStatus: alfanumérico no vacío ni nulo; timeSLA: numérico entero no nulo, en minutos; ``` ::: ### GetReasons Recuperar os motivos a serem utilizados na aprovação de uma solicitação, de acordo com a solicitação. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/getReasons ``` Solicitación ```json { "taskId": 22737, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618482000, "operationID": 339, "error": null, "amount": 4, "reasons": [ { "id": 1, "desc": "Non-refundable authorization" }, { "id": 4, "desc": "Purchase necessary to the business" }, { "id": 6, "desc": "Purchase need supplied with another solution" }, { "id": 5, "desc": "Value of quotation above the budget of the contract" } ] } ``` Campos ```none Solicitación: taskId: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; amount: numérico no vacío ni nulo; reasons; no vacío ni nulo; id: numérico no vacío ni nulo; desc: alfanumérico no vací ni nulo; ``` ::: ### AttendRequest Informar el inicio de la atención de una solicitud de servicio. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/attendRequest ``` Solicitación ```json { "number": 89647, "latitude": -19.369852147, "longitude": -49.369852147, "dateTime": 1377618517000, "sessionID": "2355A68BF75281B73607EEC1A7191645" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618517000, "operationID": 341, "error": null, "success": true } ``` Campos ```none Solicitación: number: numérico no nulo; latitude: numérico no nulo; longitude: numérico no nulo; dateTime: timestamp no vacío ni nulo; sessionID: alfanumérico no vacío ni nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; success: Boolean que identifica la finalización con éxito de la operación; ``` ::: ### AttendantLocation Informa la ubicación automática de la posición del asistente. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/location ``` Solicitación ```json { "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147, "dateTime": 1412102841000 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1412102841000, "operationID": 68, "error": null, "success": true } ``` Campos ```none N/A ``` ::: ### Feedback Registra la aprobación o denegación de una solicitud de servicio. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/feedback ``` Solicitación ```json { "taskId": 22736, "feedback": 0, "reasonId": 1, "comments": "Comments", "sessionID": "2355A68BF75281B73607EEC1A7191645 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618517000, "operationID": 341, "error": null } ``` Campos ```none Solicitación: taskId: numérico no nulo; feedback: numérico no nulo; 0 - rechazo de la solicitud; 1 - aprobación de la solicitud; reasonId: numérico no nulo; comments: alfanumérico no vacío ni nulo; sessionID: alfanumérico no vacío ni nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; ``` ::: ### New Cree una nueva solicitud. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/new ``` Solicitación ```json { "description": "Teste mobile", "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618543000, "operationID": 342, "error": null, "number": 95935 } ``` Campos ```none Solicitación: description: alfanumérico no vacío ni nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; number: alfanumérico no vacío ni nulo; ``` ::: ### Check-In Check-in del asistente en una solicitud. En otras palabras, inicia el cumplimiento de la solicitud. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/checkin ``` Solicitación ```json { "taskId": 22778, "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147, "startTime": 1377618543000 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618543000, "operationID": 342, "error": null, "number": 95935 } ``` Campos ```none Solicitación: taskId: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; startTime: timestamp no vacío ni nulo del momento en que el asistente solicita el "Check-in" Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; number: alfanumérico no vacío ni nulo; ``` ::: ### Check-Out Comprueba un asistente en una solicitud, actualizando su estado ("Suspendido", "Resuelto", etc.). :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/checkout ``` Solicitación ```json { "taskId": 22778, "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147, "status": 5, "solution": 5, "descSolution": "Descrição da Solução" } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618517000, "operationID": 342, "error": null, "number": 95935 } ``` Campos ```none Solicitación: taskId: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; status: número no nulo, según el retorno del servicio "ListNotivicationStatus" solution: numérico, informado sólo cuando el estado es “Resuelto (4)” or “Suspendido (2)” descSolution: alfanumérico, no vacío ni nulo, informado sólo cuando el estado es “Resuelto (4)” or “Suspendido (2)” Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; number: alfanumérico no vacío ni nulo; ``` ::: ### Check-InDenied Registrar la denegación de una solicitud de servicio por parte del asistente, en los casos de rechazo al check-in. :::CodeblockTabs Método ```Text POST ``` URL ```html <4biz_URL>/services/v2/denied ``` Solicitación ```json { "taskId": 22778, "sessionID": "2355A68BF75281B73607EEC1A7191645", "latitude": -19.369852147, "longitude": -49.369852147, "dateTime": 1377618543000, "reasonId": 1377618543000 } ``` ::: :::CodeblockTabs Respuesta ```json { "dateTime": 1377618543000, "operationID": 342, "error": null } ``` Campos ```none Solicitación: taskId: numérico no nulo; sessionID: alfanumérico no vacío ni nulo; latitude: numérico no nulo; longitude: numérico no nulo; reasonId: numérico y no nulo. Obtenido a través de la llamada de servicio "GetDeniedReasons"; Respuesta: dateTime: timestamp no vacío ni nulo; operationID: numérico no vacío ni nulo; error: valor alfanumérico que puede ser nulo pero no vacío; number: alfanumérico no vacío ni nulo; ``` :::