Recuperar eventos de estado de trabajo del usuario v2
Creación: 06/06/2024
Última modificación: 20/06/2024
Recuperar eventos de estado de trabajo del usuario
Recupera los eventos de estado de trabajo del usuario, con rango de fechas indicados por parámetro mediante el body de la petición
También, si el usuario tiene calendario, recupera éste y sus recurrencias siempre y cuando estén dentro de las fechas indicadas mediante parámetro.
Dentro de cada recurrencia hay varios datos:
- Fecha de inicio: La fecha en la que empieza a tener efecto la recurrencia
- Días de la semana: Son los días de la semana en los que será válida la recurrencia.
- Frecuencia: Siempre en semanas, mínimo 1, máximo 4, es decir, se repetirá como mínimo cada semana, y como máximo cada 4.
- Prioridad: Como es posible que entre varias recurrencias se repitan días de la semana, se tendrá en cuenta la prioridad (la prioridad más alta es la 1).
IMPORTANTE: Si no se recibe calendario de trabajo, rellenar los días libres con el estado de “En oficina”, que se recibe en la llamada de “Recuperar estados de trabajo de la organización”.
Si se recibe calendario, pintar los días desde el día de hoy hasta un año vista.
Estados de trabajo
Dentro del objeto de los estados de trabajo encontramos dos campos especialmente importantes:
- mustBlockBookings: Se trata de un booleano que indica si el estado de trabajo bloquea o no la creación de reservas por parte del usuario.
- mustCedeParkingSlot: Se trata de un booleano que indica si el estado de trabajo cesará automáticamente la plaza fija del usuario.
Request
HTTP request
GET /api/v2/users/me/workingstatus
GET /api/v2/users/{userId}/workingstatus
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… | true |
Path variables
| Path variable | Value | Required |
|---|---|---|
| userId | 3f45617f-2d97-42c4-8e19-1d7b8905e139 | false |
Request params
| Params | Value | Required |
|---|---|---|
| rangeStartDate | 2023-07-10 | true |
| rangeEndDate | 2024-06-20 | true |
Response
Se devuelve un código 200 con los eventos.
{
"userWorkingStatusExceptions": [
{
"id": "61214123-0b6a-4905-867d-2175b63554ba",
"type": "SERIES_MASTER",
"startDate": "2020-05-25",
"endDate": "2020-05-27",
"seriesMasterId": "ad3011c0-3017-4a3a-a655-61433c5e725c",
"workingStatus": {
"id": "3be693d6-6bda-47cd-b8e7-ca7aade1e6c3",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "TELEWORKING",
"description": "Teletrabajo",
"color": "6f6edb",
"mustBlockBookings": false,
"mustCedeParkingSlot": false
}
},
{
"id": "9f0de96c-df6c-4501-bbe7-4a491787d60a",
"type": "SINGLE_INSTANCE",
"startDate": "2020-05-22",
"endDate": "2020-05-22",
"workingStatus": {
"id": "3be693d6-6bda-47cd-b8e7-ca7aade1e6c3",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "TELEWORKING",
"description": "Teletrabajo",
"color": "6f6edb",
"mustBlockBookings": false,
"mustCedeParkingSlot": false
}
},
{
"id": "b32c93ce-c99f-4eee-8631-e3229337dc3b",
"type": "SINGLE_INSTANCE",
"startDate": "2020-05-29",
"endDate": "2020-05-29",
"workingStatus": {
"id": "3be693d6-6bda-47cd-b8e7-ca7aade1e6c3",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "TELEWORKING",
"description": "Teletrabajo",
"color": "6f6edb",
"mustBlockBookings": false,
"mustCedeParkingSlot": false
}
}
],
"userWorkingCalendar": {
"id": "02d10224-721c-4a88-9689-eba96979d9d4",
"name": "Calendario General Jupiter SL 1",
"defaultWorkingStatus": {
"id": "3be693d6-6bda-47cd-b8e7-ca7aade1e6c3",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "TELEWORKING",
"description": "Teletrabajo",
"color": "6f6edb",
"mustBlockBookings": false,
"mustCedeParkingSlot": false
},
"recurrences": [
{
"id": "b518040a-9213-4828-902c-367a766e98cd",
"calendarId": "02d10224-721c-4a88-9689-eba96979d9d4",
"recurrenceWorkingStatus": {
"id": "363b6e37-f295-44fc-906a-4511f5aef4bf",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "En cliente",
"description": "En cliente",
"color": "88f78e"
},
"daysOfWeek": "Monday;Tuesday;Thursday;",
"frequency": 1,
"startDate": "2020-05-21",
"priority": 2
},
{
"id": "c6861ae0-ec07-48c4-b5da-b3da4d0b5d70",
"calendarId": "02d10224-721c-4a88-9689-eba96979d9d4",
"recurrenceWorkingStatus": {
"id": "714a4649-f74a-463d-a8e4-51840385c761",
"organizationId": "8aee218a-fce2-4900-9410-00f485a2729e",
"name": "test",
"description": "test",
"color": "e81e1e"
},
"daysOfWeek": "Wednesday;Thursday;Friday;",
"frequency": 1,
"startDate": "2020-05-13",
"priority": 1
}
]
}
}