Cómo importar y gestionar Planes de Pago de Cotizarg en Turisuite

Cuando una agencia de viajes comercializa paquetes de excursiones o experiencias de alto valor, ofrecer financiación propia en cuotas es uno de los mejores métodos para cerrar ventas. Con Cotizarg, tu agencia puede presupuestar itinerarios y estructurar planes de cuotas personalizados para tus clientes.

Sin embargo, vender en cuotas plantea un desafío operativo crítico: el cliente irá pagando a lo largo de varias semanas o meses, pero tu agencia necesita asegurar su lugar en la excursión hoy mismo para evitar la sobreventa.

Con la integración de Planes de Pago de Cotizarg en Turisuite, podés importar cualquier cotización financiada al asistente de Reserva Manual (POS), congelar el precio pactado, bloquear el cupo en el calendario operativo y entregarle al pasajero vouchers con código QR para que siga pagando sus cuotas en Cotizarg.

---

1. Paso a paso: Cómo importar un Plan de Pago en Turisuite

Podés importar un plan de pago directamente desde el panel de administración de Turisuite en cuestión de segundos.

Paso 1: Abrir el Creador de Reservas Manuales

1. Ingresá a tu Panel de Administración de Turisuite.
2. En el menú lateral, navegá a Reservas y hacé clic en Crear Reserva (o ingresá directamente a /admin/reservas/nueva).

Paso 2: Usar el Importador de Cotizarg

En la parte superior del primer paso (“1. Excursiones”), verás un recuadro destacado con el título Importar plan de pago de Cotizarg:

1. Pegá la referencia del plan:
   • Podés pegar el enlace público completo del voucher de Cotizarg (por ejemplo: https://app.cotizarg.site/voucher/9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d).
   • O podés pegar únicamente el token identificador (UUID: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d).
2. Hacé clic en el botón Importar plan.

[!TIP] Acceso directo con parámetro en la URL: Si solés pasar de Cotizarg a Turisuite desde tu navegador, podés abrir directamente la URL: /admin/reservas/nueva?import_cotizarg_plan=<token> El sistema detectará el parámetro e importará automáticamente todos los conceptos sin necesidad de que los pegues a mano.

---

2. Qué hace Turisuite automáticamente al importar

Al presionar “Importar plan”, la plataforma ejecuta una serie de validaciones y transformaciones inteligentes:

1. Consulta segura y Aislamiento de Agencia (Multi-Tenant): Turisuite se comunica con Cotizarg y valida que los conceptos incluidos en el presupuesto correspondan efectivamente a excursiones de tu propia agencia. Si el plan incluye servicios externos u hoteles, solo se importarán las excursiones gestionadas por tu agencia.
2. Conversión de Moneda en Planes en USD: Si el presupuesto en Cotizarg fue pactado en dólares estadounidenses, Turisuite convierte los importes a moneda local utilizando la tasa de cambio congelada al momento de la cotización, garantizando coincidencia exacta de centavos.
3. Prellenado estructurado de fechas y pasajeros: La fecha programada para cada excursión (turisuite_date), la cantidad de adultos (turisuite_adults) y la de menores (turisuite_children) vienen estructuradas directamente desde Cotizarg, completándose de forma automática en cada fila del asistente sin necesidad de tipeo manual.
4. Agrupamiento y desduplicación inteligente: En Cotizarg, una excursión contratada para adultos y menores suele generar dos líneas de presupuesto separadas por concepto tarifario. Turisuite las consolida automáticamente en una sola reserva por excursión y fecha, sumando los importes totales y asignando con exactitud los pasajeros de cada grupo.
5. Precio pactado blindado (from_cotizarg_plan): Las excursiones importadas se marcan como originadas en un plan. Esto desactiva los recálculos automáticos y evita que las reglas de descuentos dinámicos (Smart Yield) alteren el monto total acordado con el cliente.
6. Pre-llenado de datos del cliente titular: En el Paso 2 (“Cliente Titular”), el asistente completa de forma automática el nombre completo y el correo electrónico del comprador registrados en Cotizarg.
7. Selección automática del método de pago: En el Paso 4 (“Resumen y Pago”), el método de pago queda fijado como Plan de Pago de Cotizarg, asociando el identificador y el enlace web del plan a cada una de las reservas generadas.

[!TIP] Edición flexible antes de confirmar: Si por alguna razón el pasajero solicita reprogramar una fecha o cambiar la cantidad de personas al momento de registrar la reserva en Turisuite, el operador puede ajustar libremente los campos antes de guardar.

---

3. El estado “Pagando Plan” y el bloqueo de cupo

Al confirmar la reserva manual importada desde Cotizarg, esta no se crea como un simple “Pendiente” ni como “Pagado”, sino con el estado operativo exclusivo: pagando_plan (“Pagando Plan”).

¿Por qué este estado es fundamental para la agencia?

• Bloquea cupo real: A diferencia de una reserva en proceso de pago online que puede expirar si el cliente abandona, una reserva en estado pagando_plan ocupa cupo de manera efectiva en el calendario de Turisuite.
• Protección contra sobreventa: Si tu excursión tiene un tope de 15 pasajeros y hay 4 pasajeros en estado “Pagando Plan”, Turisuite descontará esos 4 lugares de la disponibilidad general. Ningún otro cliente podrá comprar esos asientos por la web ni por WhatsApp.
• Alertas de capacidad: Las notificaciones internas del panel al alcanzar el 50% o el 100% de ocupación de una salida contabilizan con total precisión a los pasajeros de planes de pago.

---

4. Vouchers para el cliente con Código QR dinámico

El pasajero recibe comprobantes claros y profesionales diseñados específicamente para compras en cuotas:

A. Descarga Inmediata al Confirmar la Reserva

Apenas finalizás el proceso en el asistente de creación manual:

• Se presenta una tarjeta destacada de emisión de Voucher.
• Podés hacer clic en “Descargar Voucher PDF” para obtener al instante el documento oficial (BookingVoucherPDF o ComboVoucherPDF con QR firmado), listo para enviar por WhatsApp o imprimir para el cliente.
• O hacer clic en “Ver Comprobante Web” para previsualizar la página del voucher del cliente.

B. Voucher Web Público (/reserva-confirmada)

Cuando el cliente abre el enlace público de su reserva:

• Visualiza una cabecera violeta con el título “Plan de Pago en Curso”.
• Mensaje informativo: “Tu reserva está registrada y se paga a través de un plan de pago. Escaneá el QR o entrá al link para ver los conceptos, las cuotas y seguir pagando.”
• Botón de acción destacado: “Ver plan de pago y pagar cuota”, que lo lleva directamente a su plan en Cotizarg para abonar las cuotas restantes con los medios de pago configurados.
• En la sección financiera, el estado figura como PAGANDO PLAN y se detalla: “Se paga en cuotas vía Cotizarg”.

C. Voucher en PDF con Código QR de Pago

El voucher en PDF generado por Turisuite incorpora el componente PlanPaymentQrBlock:

• Una tarjeta destacada en tono violeta con un código QR de alta definición.
• Al escanear el QR con la cámara de cualquier teléfono móvil, el pasajero es dirigido inmediatamente a su plan de cuotas en Cotizarg.
• Texto aclaratorio en el PDF: “Escaneá el código QR para ver los conceptos y cuotas, y seguir pagando tu reserva en Cotizarg.”

D. Notificaciones por Correo Electrónico

El correo de confirmación de reserva que envía Turisuite se adapta dinámicamente:

• Asunto del email: Plan de Pago en Curso - [Nombre de la Excursión].
• Insignia destacada: Estado: PLAN DE PAGO EN CURSO 💳.
• Enlace directo: El cliente cuenta con un botón en el cuerpo del correo para acceder a sus cuotas con un solo clic.

---

5. Ciclo de vida y confirmación final de la reserva

Una vez creada la reserva, su gestión en el día a día es sumamente sencilla:

1. Presupuesto aceptado en Cotizarg: Se acuerdan las cuotas y montos con el cliente.
2. Importación en Turisuite: Se crea la reserva como “Pagando Plan”, bloqueando los lugares en el calendario y emitiendo el voucher con QR.
3. El cliente abona sus cuotas en Cotizarg: La agencia hace el seguimiento del cobro de cuotas.
4. Confirmación al saldar: Cuando todas las cuotas están pagadas, el operador confirma la reserva en Turisuite pasándola a estado “Pagado”.

A. Seguimiento desde el Listado de Reservas y Deep Linking

En la sección Reservas de tu panel de administración:

• Las reservas con plan de pago se distinguen rápidamente por su badge violeta: PAGANDO PLAN.
• Al hacer clic en el ícono del ojo para ver el detalle de la reserva, el modal incluye el enlace directo: “Ver plan de pago en Cotizarg”, permitiendo al operador verificar en tiempo real cuántas cuotas fueron abonadas.

[!TIP] Apertura automática de modal desde Cotizarg (Deep Linking): En Cotizarg, el detalle del presupuesto cuenta con el botón directo “Ver Reserva en Turisuite” (mediante /admin/reservas?bookingId=<id>&planId=<token>). Al presionarlo, Turisuite abre la pantalla y despliega de inmediato el modal de la reserva sin que tengas que buscarla manualmente en la lista. Si tu sesión estaba cerrada, Turisuite te pedirá iniciar sesión y te redirigirá automáticamente a la reserva sin perder la navegación.

B. Confirmación definitiva al saldar las cuotas

Cuando el cliente termina de pagar la totalidad de las cuotas acordadas en Cotizarg:

1. Abrí el detalle de la reserva en Turisuite.
2. Hacé clic en el botón verde Confirmar Reserva.
3. El estado de la reserva cambiará inmediatamente a pagado, completando el ciclo administrativo con éxito.

C. ¿Qué pasa si el cliente desiste o anula el plan?

Si por algún motivo el pasajero no puede continuar pagando y el plan se cancela en Cotizarg:

• Al presionar “Anular Presupuesto” en Cotizarg, el sistema invoca automáticamente el endpoint seguro de cancelación de Turisuite (action=cancel-booking-plan).
• Las reservas asociadas pasan de forma automática a estado cancelado.
• Liberación inmediata de cupos: Los lugares bloqueados se liberan de inmediato en el calendario operativo de Turisuite, quedando disponibles para nuevos clientes.
• Auditoría registrada: Se agrega una nota en el historial de la reserva indicando la fecha, hora y motivo de cancelación originado desde Cotizarg.
• Nota de seguridad: Si la reserva ya había sido marcada como pagado, el sistema impide la anulación automática y solicita resolución manual del administrador.

---

Preguntas frecuentes

¿Puedo deshacer la importación si me equivoqué de link?

Sí. Antes de guardar la reserva, en el Paso 4 del asistente podés hacer clic en “Deshacer plan importado”. El formulario removerá las excursiones cargadas desde el plan y restaurará el modo de cobro tradicional sin alterar nada en tu base de datos.

¿Se pueden importar planes con varias excursiones a la vez?

Sí. Si el presupuesto de Cotizarg incluye excursiones en días distintos (por ejemplo, City Tour el lunes y Alta Montaña el miércoles), Turisuite importará cada una como una línea independiente dentro del asistente, vinculando el mismo plan a todas las reservas generadas.

¿Por qué no se aplican los descuentos de Smart Yield sobre las excursiones importadas?

Porque el precio ya fue cotizado y pactado contractualmente con el cliente en Cotizarg. Aplicar descuentos por ocupación en ese momento alteraría el importe acordado en las cuotas. Por ello, Turisuite respeta fielmente el precio final importado.