Cancelar reserva

Última modificación: 19/02/2024

Permite cancelar una reserva del usuario. La reserva no debe estar expirada, cancelada, confirmada o haber finalizado.

También se contemplan las reservas supervisadas. El usuario supervisor será el único que podrá cancelar una reserva de este tipo.

Se puede asignar el id de una razón de cancelación si así se desea.

¡IMPORTANTE!

Es importante que si se trata de una reserva de espacios de trabajo se añada la cabecera "user-access-token" con el token de acceso de Microsoft del usuario (en caso de ser necesario).

¡Importante!

Las reservas de espacios que tengan el parámetro isExternalOrganizer a true NO se podrán ni editar, ni cancelar, ni hacer check-out.

Request

HTTP request

DELETE /api/v2/bookings/{bookingId}

Headers

Header	Value	Required
Authorization	Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT…	true
user-access-token	eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MT…	false

Params

Param	Value	Required
cancellationReasonId	String - Identificador del motivo de cancelación (Ej: 65c0eb54-5da2-4540-b7ef-1cd9126038ff)	false

Ejemplo de petición

DELETE /api/v2/bookings/brYc132a-9c8b-4e6a-8f6b-506f50e09pou HTTP/1.1
Host: 127.0.0.1:9010
app-version: WEBAPP/1.3.5
Authorization: Bearer eyJ0eXBlIjoiSldUIiwiYWxnIjoiSFM1MTIifQ.eyJpc3MiOiJzZWN1cmUtYXBpIiwiYXVkIjoic2VjdXJlLWFwcCIsInN1YiI6ImFAYm9va2tlci5lcyIsImV4cCI6MTY1MTg1Njg2Nywicm9sIjpbIjFkZmRlMDU5LWRhNjUtNDljOS04ZGIzLWRjY2M0ZjMyOTJlNCJdfQ.WEnDQYfPypSOljtxsh52TWkl8aYkxpUP7TT6sRYu274Uo-Ylc0ncfP1n-TVdmArPbzStONYqT-t31KDqZXs74g

Response

Si se ha conseguido cancelar correctamente la reserva se devolverá un 204 No Content.

Lista de posibles errores

ErrorCode	HttpStatus	Descripción
3001 - USER_HAS_GOT_NOT_ACCESS	401	El usuario no tiene acceso.
1000 - USER_NOT_FOUND	404	El usuario no se ha encontrado.
1002 - RESOURCE_NOT_FOUND	404	El recurso no se ha encontrado.
1011 - BOOKING_NOT_FOUND	404	La reserva no ha sido encontrada.
1016 - CANCELLATION_REASON_NOT_FOUND	404	La razon de cancelación no se ha encontrado.
1025 - SUPERVISED_BOOKING_NOT_FOUND	404	La reserva supervisada no se ha encontrado.
1027 - MODULE_NOT_FOUND	404	Los módulos de la organización no se han encontrado.
3012 - BOOKING_IS_FIND_SLOT	409	La reserva es find slot. No puede ser cancelada.
4011 - BOOKING_CAN_NOT_BE_MODIFIED	409	La reserva tiene un organizador externo y no puede ser cancelada.
4072 - INVALID_DATE_BY_MIN_CANCELLATION_OF_THE_RESERVABLE	409	No se puede modificar/eliminar la reserva debido al tiempo mínimo de cancelación de un servicio/medio físico.
4080 - SUPERVISED_BOOKING_CAN_NOT_BE_CANCELLED	409	La reserva es supervisada. No puede ser cancelada mediante este método.
6000 - 6999 Todos los errores de Microsoft Graph	409	Esta llamada sincroniza con Microsoft, así que existe la posibilidad de que se devuelvan todos los errores de la seríe 6000.
7002 - INTERNAL_ORGANIZATIONS_API_COMMUNICATION_ERROR	500	Error en la comunicación con el API interno de organizaciones.
7003 - INTERNAL_BOOKINGS_API_COMMUNICATION_ERROR	500	Error en la comunicación con el API interno de reservas.