Bookker API Documentation logo Bookker API Documentation

Creación de reserva automática de puesto fijo cedido

Última modificación: 15/12/2023

Intenta crear una / o varias reservas en un puesto fijo cedido elegido aleatoriamente dentro del edificio o planta que se ha indicado en la petición. También se puede enviar una lista de los identificadores de características que se necesita que tenga el recurso.

Las reservas solo se crearán si se pueden realizar todas con éxito, en el momento en el que falle una el resto no se tendrá en cuenta.

Unicamente se tendrán en cuenta puestos fijos cuya cesión incluya total o parcialmente la reserva.

Acceso al edificio

Dentro de la información de la reserva hay un campo llamado “buildingAccessStatus”, que indica si se ha concedido al usuario acceso al edificio para esa reserva.

Este campo tiene tres posibles valores:

Request

HTTP request
POST /api/v1/bookings/cededfixedworkstations/automatic
Headers
Header Value Required
Authorization Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT… true
Body

En el cuerpo de la solicitud, proporcione una representación JSON del siguiente objeto:

{
   "bookingDays": [
       {
            "startDate": 1657404000000,
            "endDate" : 1657412100000
       }
   ],
    "buildingId": "e2693a87-e247-435a-abbd-625c908d197b",
    "floorId": "f83baf77-b240-4905-8df9-007c957ab8e5", // Opcional
    "subcategoryId": "44b3e772-5441-49e3-9582-9bc6091eb443",
    "allDayBooking": false,
    "featureIds": [
        "9fe8e2ac-bc59-42a7-b80b-a312d0ce53a0",
        ...
    ], // Opcional
    "maxCostPerHour": 29.99 // Opcional
}

Response

Si se han conseguido crear las reservas, se devuelve un código 201 con la información de las mismas.

Body
HTTP/1.1 201 CREATED
Content-type: application/json

{
    "bookings": [
        {
            "id": "c2b41efe-d855-44a7-84e1-deed11e4c20b",
            "startDate": 1657404000000,
            "endDate": 1657412100000,
            "duration": 8100000,
            "status": "PENDING",
            "accessControlType": "ANY",
            "creator": {
                "id": "c1a7948d-00ee-4fcc-a829-7c1c17bd2e13",
                "name": "android",
                "surname": "1",
                "alias": "550fcaa5cac442c68fac8fba56b4b461",
                "upn": "android@pruebas.com",
                "email": "android@pruebas.com",
                "organization": {
                    "id": "00a0f656-46ba-4f88-a8d1-4095e7d66c48"
                },
                "userRule": {
                    "id": "c1a7948d-00ee-4fcc-a829-7c1c17bd2e13"
                },
                "mobileRole": {
                    "id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
                },
                "canBeSearched": false,
                "type": "BOOKKER_INTERNAL",
                "userLanguage": "es-ES",
                "status": "ACTIVATED"
            },
            "organizer": {
                "id": "c1a7948d-00ee-4fcc-a829-7c1c17bd2e13",
                "name": "android",
                "surname": "1",
                "alias": "550fcaa5cac442c68fac8fba56b4b461",
                "upn": "android@pruebas.com",
                "email": "android@pruebas.com",
                "organization": {
                    "id": "00a0f656-46ba-4f88-a8d1-4095e7d66c48"
                },
                "userRule": {
                    "id": "c1a7948d-00ee-4fcc-a829-7c1c17bd2e13"
                },
                "mobileRole": {
                    "id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
                },
                "canBeSearched": false,
                "type": "BOOKKER_INTERNAL",
                "userLanguage": "es-ES",
                "status": "ACTIVATED"
            },
            "resource": {
                "id": "04322ff4-25c6-4127-abd5-316c0f5714f9",
                "name": "PUESTO P2",
                "posterCode": "BCN-01-PE-P2",
                "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/users/5432a51ff76e4e349a0fcd6759eeaa0a.jpeg",
                "mapCoordinates": {
                    "topLeftX": 2618,
                    "topLeftY": 2204,
                    "bottomRightX": 2663,
                    "bottomRightY": 2249
                },
                "approachable": false,
                "floor": {
                    "id": "f83baf77-b240-4905-8df9-007c957ab8e5",
                    "name": "Planta 1",
                    "floorNumber": 1,
                    "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/00a0f656-46ba-4f88-a8d1-4095e7d66c48/floors/00471ef8317348abb0dc8077ff4bf8b1.png",
                    "building": {
                        "id": "e2693a87-e247-435a-abbd-625c908d197b",
                        "name": "Barcelona",
                        "address": {
                            "country": "ES",
                            "city": "Barcelona",
                            "address": "C/ Real Nº123",
                            "coordinates": null
                        },
                        "organization": {
                            "id": "00a0f656-46ba-4f88-a8d1-4095e7d66c48"
                        },
                        "timezone": "America/Sao_Paulo",
                        "status": "ACTIVATED",
                        "visible": true
                    },
                    "status": "ACTIVATED",
                    "type": "OFFICE",
                    "visible": true
                },
                "subcategory": {
                    "id": "44b3e772-5441-49e3-9582-9bc6091eb443",
                    "name": "Puesto",
                    "category": "WORKSTATION",
                    "organization": {
                        "id": "00a0f656-46ba-4f88-a8d1-4095e7d66c48"
                    },
                    "deleteHistorial": false,
                    "hideBookings": false,
                    "canBeSearched": true,
                    "shifts": false,
                    "simultaneousBookingsType": "ONLY_BETWEEN_CATEGORIES",
                    "priority": 0
                },
                "resourceRule": {
                    "id": "7382f637-0c05-4d77-8d61-0922a8db409e",
                    "advanceCheckIn": 900000,
                    "expirationMargin": 3600000,
                    "startTime": 3600000,
                    "endTime": 82800000,
                    "maximumDuration": 79200000,
                    "maximumAdvance": 40,
                    "accessControlType": "ANY",
                    "requiresApproval": false,
                    "allDayBookings": false,
                    "allDayBookingsCheckInMS": 75600000
                },
                "visible": true,
                "features": [
                    {
                        "id": "0c86fff0-2bce-45b7-96cc-1f636ea447fb",
                        "name": "Plaza Grande",
                        "email": "",
                        "organization": {
                            "id": "00a0f656-46ba-4f88-a8d1-4095e7d66c48"
                        }
                    }
                ],
                "status": "ACTIVATED",
                "group": {
                    "id": "216db43f-ba78-4675-975e-59acca24bd42",
                    "name": "BCN",
                    "description": "BCN",
                    "type": "OFFICE",
                    "buildingId": "e2693a87-e247-435a-abbd-625c908d197b"
                }
            },
            "buildingAccessStatus": "PENDING",
            "createdDate": 1657274438948,
            "resourceType": "WORKSTATION",
            "allDayBooking": false
        }
    ]
}