Comprender el estado de Reserva temporal (Temporary Booking)

¿Qué significa?

Esta función introduce un estado de Reserva temporal (Temporary Booking), diseñado para modernizar nuestro proceso, garantizar una mejor gestión de la capacidad y mejorar la integración con canales de terceros (OTA).

El concepto de una Reserva temporal (Temporary booking) es un paso importante que reserva el inventario antes de que la reserva se confirme o se pague por completo, actuando efectivamente como una «Retención».

• Objetivo: Alinear nuestro proceso de reserva con los estándares del mercado, especialmente para las integraciones de API síncronas (webhook en línea).

• Mecanismo de retención: Cuando se inicia una reserva, la capacidad se reserva con el estado TEMPORARY en todos los sistemas y subsistemas conectados. Esto evita las reservas duplicadas mientras la confirmación está pendiente.

• Límite de tiempo: Un temporizador (normalmente de 45 minutos para las reservas mediante API) comienza inmediatamente. La reserva debe completarse dentro de este periodo.

• Confirmación/Eliminación:

  • Si la operación se realiza correctamente (por ejemplo, se obtiene la confirmación o se efectúa el pago), el estado cambia a BOOKED.

  • Si el temporizador vence, el pago falla (función futura) o se cancela la reserva, esta se elimina DELETED automáticamente y la capacidad se libera de inmediato.

Implementación actual

Actualmente, esta función solo está activa para:

• Reservas mediante API procedentes de TourCMS cuando hay un webhook en línea (webhook de notificación síncrono).

En esta fase inicial, la Reserva temporal se utiliza específicamente para gestionar el tiempo necesario para obtener una referencia externa necesaria (por ejemplo, de Vienna City Card o Vienna Pass mediante AVS) y transmitirla de vuelta a TourCMS.

Nota sobre el proceso: En esta fase exclusiva para API, el proceso consta de dos pasos: 1) Crear una Reserva temporal (se reserva la capacidad) y 2) Confirmar o eliminar (según el resultado de la referencia externa). Por ahora, se omite el paso de recopilar los datos del cliente y el pago.

• Nuevas reservas de BoxOffice cuando el vendedor llega al proceso de pago.

Las reservas temporales están disponibles en el nuevo BoxOffice para proteger la capacidad seleccionada mientras el vendedor se encuentra en el proceso de pago. Cuando se llega al proceso de pago, el sistema crea una reserva temporal a partir de la cesta actual y la cesta se cierra. Esta retención evita que los mismos asientos o la misma capacidad se vendan en otro lugar mientras el pago o la confirmación final siguen pendientes.

Si el vendedor cambia la cesta después de que ya se haya creado una reserva temporal, la retención anterior debe liberarse antes de crear una nueva cesta. De lo contrario, la propia reserva temporal del vendedor podría continuar reteniendo los asientos hasta que el proceso de vencimiento la elimine, lo que puede bloquear la nueva cesta en salidas casi completas.

1. El vendedor comienza creando una cesta en el nuevo BoxOffice.

2. Cuando accede al proceso de pago, el sistema crea una reserva TEMPORARY. Esto significa que los asientos o la capacidad se retienen durante un breve periodo y la cesta se cierra.

3. Si el vendedor finaliza la venta, la reserva pasa a ser BOOKED.

4. Si el vendedor necesita cambiar la cesta antes de finalizar, el nuevo BoxOffice inicia una nueva cesta e indica al sistema qué reserva temporal está reemplazando mediante el envío del bookingId anterior.

5. El sistema comprueba que la reserva anterior pertenece a ese vendedor y que todavía está en estado TEMPORARY. A continuación, cancela esa retención temporal, libera los asientos o la capacidad y crea la nueva cesta.

6. La nueva cesta comprueba la disponibilidad solo después de que se haya liberado la retención anterior. Esto evita que la retención previa del propio vendedor bloquee la reserva actualizada.

¿Qué debo hacer?

Para habilitar las Reservas temporales para tus integraciones de API de TourCMS elegibles, debes actualizar la URL de tu webhook en línea de la siguiente manera:

1. Busca tu URL de webhook en línea existente en TourCMS.

2. Añade ?temporaryBookingProcess=true al final de la URL. Esto es provisional; cuando la reserva temporal esté habilitada para todos los canales en futuras fases de la implementación, no será necesario añadir este parámetro.

Este parámetro es un requisito provisional. Actualmente es necesario para garantizar que las reservas temporales funcionen correctamente. En futuras fases de implementación, cuando las reservas temporales estén habilitadas en todos los canales de venta, este parámetro se gestionará automáticamente y ya no será necesario.

Ejemplo: https://api.palisis.com/tp/v1/tcms/webhook/notification/ABCD/EFGHI?temporaryBookingProcess=true

⚠️ Importante: Esta es una URL de webhook ficticia proporcionada únicamente con fines ilustrativos. No la utilices.

¿Cómo identificar una Reserva temporal (Temporary booking)?

Las Reservas temporales (Temporary bookings) están claramente marcadas en todo nuestro sistema para distinguirlas de las reservas confirmadas.

• Lista de reservas y manifiesto: Son visibles tanto en la Lista de reservas principal como en el Manifiesto, donde se designan explícitamente como «Temporales».

Página de lista de reservas

Vista detallada de la reserva

Manifiesto

• Página de salidas: Las reservas temporales también aparecen en esta página, reservando los asientos correspondientes.

• Informes: Las Reservas temporales (Temporary bookings) no se incluyen en los informes estándar ni en las liquidaciones de efectivo.

Consideraciones

Ten en cuenta las siguientes consideraciones técnicas y operativas relativas a las Reservas temporales: