Retener y reanudar una reserva

Como parte de un modelo de reservas de 2 pasos, un socio o viajero puede retener una habitación individual sin realizar un cargo inmediato y sin incurrir en penalizaciones por cancelación, si quisiera cancelar o abandonar la habitación sin finalizar la reserva.

Si el viajero o socio quisiera confirmar la habitación en el periodo de una ventana temporal dada, podrá finalizar la reserva como segundo paso. Si se abandona la reserva, esta se revertirá automáticamente y el inventario seleccionado quedará liberado.

Descripción general

¿Qué cambios son necesarios?

«Retener y reanudar» utiliza APIs de Rapid existentes con nuevas marcas de solicitud y nuevos enlaces tokenizados en las respuestas. No es necesario integrar nuevos métodos discretos de la API. Para integrar «retener y reanudar», necesitará actualizar la gestión de la solicitud y/o la respuesta para:

1.     Gestión de la creación de reservas

2.     Gestión de la recuperación de reservas

3.     Reanudación - nueva gestión del enlace token desde la respuesta de recuperación

4.     Cancelación - nueva gestión del enlace token desde la respuesta de creación

Para que pueda comprender mejor todo el proceso de retención y reanudación, examine esta página en su totalidad antes de consultar la integración en los documentos individuales de nuestra API. Las opciones específicas documentadas en esta página también están disponibles en las páginas respectivas de documentación dedicadas a nuestras APIs existentes de reservas y gestión de las reservas.

Creación de una reserva retenida

La solicitud de reserva tiene actualmente un nuevo campo booleano denominado hold. Enviar un valor true sitúa el establecimiento en estado de retención. 

Las reservas retenidas solo deberían dejarse en estado de retención durante el tiempo mínimo requerido para realizar la solicitud específica. La reserva se revertirá automáticamente si se deja en estado de retención sin ser confirmada. 

Una respuesta de reserva retenida realizada correctamente devuelve un enlace tokenizado adicional que se utiliza para reanudar (confirmar y pagar) la reserva retenida. También omite la matriz rooms utilizada normalmente para proporcionar enlaces de cancelación, ya que no hay todavía ninguna habitación que cancelar.

Ejemplo de respuesta durante la reserva para una reserva retenida

{
  "itinerary_id": "2667552437552",
  "links": [
    {
      "rel": "retrieve",
      "method": "GET",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "resume",
      "method": "PUT",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "cancel",
      "method": "DELETE",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  ]
}

Si el indicador hold se utiliza para reservar, no se carga ningún pago por la reserva. La reserva se finaliza y el pago se carga solamente cuando el enlace del método PUT en la respuesta de la reserva retenida se utiliza dentro del periodo de retención.

Recuperación de una reserva retenida

Recupere una reserva retenida utilizando el enlace retrieve facilitado en la respuesta de la reserva retenida. El método de recuperación de una reserva para «retener y reanudar» no es distinto de la recuperación habitual de la reserva en 1 paso y no necesita un cuerpo de solicitud.

Situaciones de respuesta:

• Recuperar una reserva retenida que continúa estando retenida devolverá una respuesta con datos limitados, que incluyen enlaces para reanudar inmediatamente y finalizar, o para cancelar la reserva.
• Recuperar una reserva retenida que ha sido cancelada (revertida mediante solicitud) o ha superado el tiempo de espera (revertida automáticamente) devolverá un error de «itinerario no encontrado».
• Recuperar una reserva retenida que haya sido previamente reanudada y confirmada se comportará de la misma manera que una recuperación de un itinerario estándar y devolverá toda la información sobre la reserva.

Ejemplo de respuesta de recuperación de una reserva retenida

{
    "itinerary_id": "8701934321257",
    "creation_date_time": "2018-03-09T14:42:58.159Z",
    "links": {
        "resume": {
            "method": "PUT",
            "href": "/2/itineraries/8701934321257?token=QldfCGlcUA…{example trimmed for length}="
        },
        "cancel": {
            "method": "DELETE",
            "href": "/2/itineraries/9700934721257?token=QldfCGlcUA…{example trimmed for length}="
        }
    }
}

Ejemplo de respuesta de recuperación de una reserva retenida que ha sido cancelada o que ha agotado el tiempo de espera

{
  "type": "resource_not_found",
  "message": "Itinerary was not found with provided request."
}

Reanudación de una reserva retenida

Para confirmar una reserva que haya sido retenida y finalizar el pago, debe reanudarse la reserva.

La reanudación de una reserva retenida se realiza utilizando el enlace resume facilitado en la respuesta de la reserva retenida original y no necesita un cuerpo de solicitud.

Situaciones de respuesta:

• Al reanudar una reserva retenida que todavía esté retenida, se finalizará la reserva y se devolverá una respuesta HTTP 204 - Sin contenido para indicar que se ha finalizado correctamente. Utilice el enlace GET de la respuesta de la reserva retenida inicial para recuperar todo el itinerario.
• Reanudar una reserva retenida que ha sido cancelada (revertida mediante solicitud) o que ha agotado el tiempo de espera (revertida automáticamente) devolverá el mismo error de «itinerario no encontrado» detallado en la sección previa sobre recuperación.
•  Reanudar una reserva retenida que ya ha sido reanudada correctamente devolverá un error que declare que la reserva ya ha sido enviada.

Ejemplo de respuesta de reanudación de una reserva que ya ha sido reanudada

{
  "type": "resume.already_committed",
  "message": "Booking has already been committed."
}

Cancelación de una reserva retenida (reversión)

El enlace tokenizado de cancel facilitado en la creación de la reserva y en las respuestas de recuperación actúa en el nivel del itinerario. Cuando se utiliza, liberará el establecimiento solicitado de la retención y revertirá el itinerario retenido. Los enlaces para la cancelación del nivel de las habitaciones únicamente se facilitan en la respuesta de recuperación después de que una reserva se haya reanudado correctamente.

Cuando se realice una operación de cancel, se devolverá un código de estado HTTP 204, el mismo de una respuesta de reanudación correcta. HTTP 204 se utiliza en ambos estados para indicar que el servidor ha realizado correctamente la solicitud y que no hay que enviar ningún contenido adicional en el cuerpo de la carga neta de la respuesta.

Solicitar la cancelación de una reserva retenida genera la misma situación final que cuando se permitió que la reserva se revirtiese automáticamente.

Situaciones de respuesta:

• Cancelar una reserva retenida que todavía está retenida liberará el inventario de la retención y devolverá un estatus HTTP 204
• Cancelar una reserva retenida que ya ha sido cancelada (revertida mediante solicitud) o que ha agotado el tiempo de espera (revertida automáticamente) devolverá el error de «itinerario no encontrado» documentado anteriormente en esta página
• Cancelar una reserva retenida que ya ha sido reanudada correctamente devolverá un mensaje de error «cancelación del nivel de itinerario no admitida». Realice una llamada de recuperación y utilice los enlaces de nivel de habitaciones facilitados en la respuesta para cancelar las habitaciones individuales.

Ejemplo de respuesta de cancelación de una reserva que ya ha sido reanudada

{
  "type": "resume.itinerary_level_cancel_not_supported",
  "message": "Itinerary level cancel on confirmed booking is not supported."
}