Turisuite v1.13.0

Esta versión consolida el ecosistema integral de interoperabilidad bidireccional entre Cotizarg (la plataforma de cotizaciones y planes de financiación en cuotas para agencias de viajes) y Turisuite (el motor de reservas, disponibilidad y back-office turístico).

Con la versión 1.13.0, la conexión entre ambas herramientas pasa de ser una importación manual a un circuito operativo completamente automatizado y en tiempo real: los presupuestos de Cotizarg ahora transfieren sus fechas y pasajeros de forma estructurada, las reservas creadas se enlazan mediante deep linking con apertura automática de modal, los vouchers oficiales en PDF pueden descargarse al instante al finalizar la reserva y las anulaciones se sincronizan en vivo liberando cupos de inmediato en el calendario.

---

Novedades Principales

1. Prellenado Inteligente y Estructurado de Fechas y Pasajeros

Al importar un plan de pago de Cotizarg en el asistente de reservas manuales (CreateManualBookingPage / ExcursionSelector):

• Cero carga manual: La integración ahora mapea y precompleta automáticamente la fecha programada de cada salida (turisuite_date), la cantidad de adultos (turisuite_adults) y la cantidad de menores (turisuite_children). El operador ya no necesita tipear ni seleccionar estos campos a mano.
• Desduplicación y agrupación inteligente: Cuando un presupuesto en Cotizarg discrimina líneas de adultos y menores por concepto de precio, Turisuite las consolida automáticamente por (excursión, fecha), unificando el importe total y asignando con total precisión el conteo correspondiente de adultos y niños.
• Normalización estricta de fechas: El sistema implementa normalización en formato ISO para prevenir cualquier desfasaje por husos horarios o formatos regionales del navegador.

---

2. Blindaje de Precios Pactados (Lock-in)

• Toda reserva creada a partir de un plan de Cotizarg se marca internamente con el flag from_cotizarg_plan: true.
• Esto aplica un bypass inteligente sobre el motor de Smart Yield y los descuentos dinámicos por ocupación, asegurando que las tarifas unitarias y totales acordadas contractualmente con el viajero en Cotizarg se respeten al centavo en Turisuite, sin alteraciones imprevistas.

---

3. Emisión y Descarga Inmediata de Voucher PDF Oficial

Para agilizar la atención en mostrador o vía WhatsApp:

• En la pantalla de confirmación final de la reserva manual (CreateManualBookingPage), se incorporó una tarjeta destacada de emisión de Voucher.
• Permite descargar con un solo clic el comprobante oficial en PDF (BookingVoucherPDF o ComboVoucherPDF con su código QR firmado), listo para enviar al cliente o imprimir.
• Incluye también un botón de acceso directo para visualizar el comprobante web público del viajero.

---

4. Deep Linking y Apertura Automática de Modal de Reserva

La navegación entre Cotizarg y Turisuite ahora es transparente y directa:

• La vista de administración de reservas (/admin/reservas) ahora admite los parámetros de URL ?bookingId=<id> y ?planId=<voucher_token>.
• Cuando un asesor comercial en Cotizarg presiona “Ver Reserva en Turisuite”, el sistema abre la plataforma y despliega de inmediato el modal de detalle (BookingDetailsModal) con toda la información cargada.
• Al cerrar el modal, los parámetros de la URL se limpian de manera transparente sin recargar la página, manteniendo una navegación limpia.

---

5. Sincronización Automática de Cancelación y Liberación de Cupos

Ante cualquier cancelación comercial en Cotizarg:

• Nuevo endpoint seguro: POST /partner-catalog?action=cancel-booking-plan.
• Cuando un agente presiona “Anular Presupuesto” en Cotizarg, se envía una notificación automática a Turisuite.
• Turisuite localiza las reservas vinculadas al plan y las pasa automáticamente al estado cancelado.
• Liberación inmediata de cupo: Los lugares retenidos por el plan se liberan al instante en el calendario de Turisuite para que queden disponibles para la venta online o por WhatsApp.
• Auditoría histórica: Se asienta una nota en el historial interno de cada reserva con fecha, hora y motivo de anulación.
• Protección contable: Si alguna reserva ya fue confirmada o cobrada (pagado), Turisuite bloquea la cancelación automática y advierte al administrador para su resolución manual.

---

6. Consulta de Estado de Reserva en Vivo desde Cotizarg

• Endpoint dedicado: GET /partner-catalog?action=check-booking-status&plan_id=<voucher_token>.
• Devuelve la información consolidada del plan: { exists, status, booking_count, booking_id, booking_ids }.
• Permite a Cotizarg conmutar dinámicamente sus botones de acción:
  • Si el plan aún no fue procesado: muestra “Crear Reserva en Turisuite”.
  • Si la reserva ya existe: muestra el estado operativo actual (pagando_plan, pagado, cancelado) y el botón directo “Ver Reserva en Turisuite” con enlace al modal correspondiente.

---

7. Preservación de Sesión y Redirecciones Multi-Tenant

• En ProtectedRoute y LoginPage, el sistema ahora preserva el destino mediante el parámetro ?redirect=<path>.
• Si un operador hace clic en un enlace directo desde Cotizarg hacia una reserva o hacia el importador sin tener una sesión activa iniciada, tras autenticarse es redirigido con total exactitud a la pantalla original solicitada.
• Hardening de subdominios: AgencyContext diferencia con precisión dominios apex (turisuite.com) de subdominios de cada agencia (<agencia>.turisuite.com o <agencia>.localhost), garantizando el aislamiento estricto de datos en entornos productivos y de desarrollo local.

---

Comparativa Operativa: Antes vs. Versión 1.13.0

Acción operativa	Antes de v1.13.0	Con Turisuite v1.13.0
Fecha de la excursión	El operador debía seleccionarla a mano en el calendario.	Se precompleta de forma automática desde el plan de Cotizarg.
Adultos y menores	Debían cargarse manualmente en el formulario.	Se mapean y desduplican automáticamente, respetando las cantidades de cada concepto.
Emisión del Voucher PDF	Había que salir del asistente, buscar la reserva en el listado y descargar el PDF.	Descarga inmediata en un clic desde la tarjeta final de creación de reserva.
Acceso desde Cotizarg	Solo existía enlace para crear una reserva nueva.	Botón directo “Ver Reserva” con deep link que abre el modal en Turisuite al instante.
Anulación de presupuestos	Había que avisar por chat o cancelar manualmente la reserva en Turisuite.	Sincronización instantánea: al anular en Cotizarg, se cancela la reserva y se liberan los cupos en vivo.
Sesión cerrada	Si el enlace se abría sin login, se perdía el plan y abría el dashboard principal.	Redirección inteligente: tras el login, el usuario vuelve exactamente al plan o reserva original.

---

Guías y Recursos Relacionados

• Cómo importar y gestionar Planes de Pago de Cotizarg en Turisuite: Guía paso a paso para operadores y administradores.
• Integración con Cotizarg: Sincronización de catálogo en tiempo real: Detalles sobre la sincronización de cupos, tarifas y descuentos.