Crear reserva automática de parking

Última modificación: 23/04/2025

Crea una reserva manual de parking.

Comprueba las plazas a las que tiene acceso el usuario mediante los grupos de tipo “manual” y las cesiones disponibles y reserva aleatoriamente una de ellas.

Tiene en cuenta las reglas del parking seleccionado: Antelación con la que se puede reservar, tiempo máximo por tramo que puede reservar el usuario…

Para poder reservar el usuario tiene que tener el vehículo que ha solicitado para la reserva validado en el edificio que está intentando reservar

Si el usuario tiene plaza fija se crearán las cesiones pertinentes.

Si la organización NO tiene activado el módulo de vehículo requerido no hay que mandar el campo vehicleId. Si se manda la API devolverá un error.

Si la organización SI tiene activado el módulo de vehículo requerido si hay que mandar el campo vehicleId. Si no se manda la API devolverá un error.

¡IMPORTANTE!

La forma actual en la que se indica el vehículo asociado a la reserva mediante licensePlate queda deprecada y en su lugar se utilizará vehicleId.

Request

HTTP request

POST /api/v1/parkings/bookings/manual/automatic

Headers

Header	Value	Required
Authorization	Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT…	true

Request

{
    "buildingId": "13707331-087b-4693-b38f-c2c03bbf0157",
    "floorId": "13707331-087b-4693-b38f-c2c03bbf0157", // El uso de floorId será obligatorio en futuras versiones
    "subcategoryId": "aa825256-d267-4c26-8c85-ba7a9e3c2bf2",
    "bookingDays": [
        {
            "startDate": 1651042800000,
            "endDate": 1651046400000
        }
    ],
    "features": [
        "13707331-087b-4693-b38f-c2c03bbf0157",
        "13707331-087b-4693-b38f-c2c03bbf0156"
    ], // Opcional
    "maxCostPerHour": 19.99, // Opcional
    "covered": null, // true; false o null en caso de no querer que filtre
    "parkingSlotSize": null, // SMALL, MEDIUM, BIG o null en caso de no querer que filtre
    "licensePlate": "1234 ABC", // Deprecado
    "vehicleId": "7ff07a0f-44b9-4a99-a359-461c0fb62ba0",
    "electricCharger": null, // true; false o null en caso de no querer que filtre
}

Response

Se devuelve un código 201 con la información de la plaza reservada.

{
    "bookings": [
        {
            "id": "d0634020-c604-4fce-8f32-1f1471f0e24d",
            "startDate": 1651042800000,
            "endDate": 1651046400000,
            "duration": 3600000,
            "status": "UNDETERMINED",
            "accessControlType": "NONE",
            "creator": {
                "id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7",
                "name": "Aitor",
                "surname": "Jupiter",
                "alias": "072919a68fbd42aead115dbee1b02620",
                "upn": "a@bookker.es",
                "email": "txoflas@gmail.com",
                "organization": {
                    "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                },
                "userRule": {
                    "id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7"
                },
                "mobileRole": {
                    "id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
                },
                "canBeSearched": false,
                "type": "BOOKKER_INTERNAL",
                "userLanguage": "es-ES",
                "status": "ACTIVATED"
            },
            "organizer": {
                "id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7",
                "name": "Aitor",
                "surname": "Jupiter",
                "alias": "072919a68fbd42aead115dbee1b02620",
                "upn": "a@bookker.es",
                "email": "txoflas@gmail.com",
                "organization": {
                    "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                },
                "userRule": {
                    "id": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7"
                },
                "mobileRole": {
                    "id": "1dfde059-da65-49c9-8db3-dccc4f3292e4"
                },
                "canBeSearched": false,
                "type": "BOOKKER_INTERNAL",
                "userLanguage": "es-ES",
                "status": "ACTIVATED"
            },
            "resource": {
                "id": "e31d320f-d4a4-47be-b71f-ae37ea24397b",
                "name": "PARKING A2",
                "posterCode": "B-S2-PARK-A2",
                "approachable": false,
                "floor": {
                    "id": "72ee9939-2f87-40f4-865a-e462cc8f766f",
                    "name": "Sótano 2",
                    "floorNumber": -2,
                    "image": "https://api.develop.bookkercorp.com/api/v1/bookker/download/organizations/8aee218a-fce2-4900-9410-00f485a2729e/floors/07f6eaef9d3d4524a3d0c8c0d9405438.png",
                    "building": {
                        "id": "758a81f3-f171-404b-b48c-c922828aed49",
                        "name": "Júpiter Building",
                        "address": {
                            "country": "ES",
                            "city": "Madrid",
                            "address": "Avenida Gran Vía, 85",
                            "coordinates": null
                        },
                        "organization": {
                            "id": "8aee218a-fce2-4900-9410-00f485a2729e"
                        },
                        "timezone": "Europe/Madrid",
                        "status": "ACTIVATED",
                        "visible": true
                    },
                    "status": "ACTIVATED",
                    "type": "PARKING",
                    "visible": true
                },
                "subcategory": {
                    "id": "6e0a5df1-2de7-40f3-8590-2f8e7bc45ef8",
                    "priority": 0
                },
                "visible": true,
                "status": "ACTIVATED",
                "group": {
                    "id": "e97b9a4d-2fb5-48c4-ab90-3fd6dd9dfd3e",
                    "name": "Grupo Parking Jupiter SL",
                    "description": "",
                    "type": "PARKING_MANUAL",
                    "buildingId": "758a81f3-f171-404b-b48c-c922828aed49"
                },
                "covered": true,
                "parkingSlotSize": "BIG"
            },
            "buildingAccessStatus": "PENDING",
            "createdDate": 1650995133605,
            "resourceType": "PARKING",
            "vehicle": {
                "userId": "304a9cba-ad72-49a1-8782-9ac9a36cd8e7",
                "licensePlate": "1234 ABC",
                "brand": "Yamaha",
                "model": "TMax",
                "color": "Blanco",
                "type": "MOTORCYCLE"
            }
        }
    ]
}