Cobro Recurrente (Suscripciones Flow)

Módulo que permite cobrar automáticamente cada mes la mensualidad de los planes de atención a pacientes que hayan registrado su tarjeta de crédito en Lexa. El cobro lo gestiona Flow.cl por ti, sin intervención manual.

¿Qué hace?

1. Por cada plan de atención configurado en Lexa (Plan 1, Plan 2, Plan 3, etc.) se crea un plan equivalente en Flow.
2. El paciente (o su tutor) entra al portal y registra su tarjeta de crédito una sola vez.
3. Flow genera una suscripción que cobra el monto mensual del plan en la fecha acordada.
4. Cada cobro exitoso se refleja en Lexa como un Payment asociado al plan del paciente.
5. Si el cobro falla (tarjeta rechazada, sin saldo), Flow reintenta automáticamente por unos días y notifica al paciente.

¿Qué hace exactamente el botón "Sincronizar planes con Flow"?

El botón es seguro y no destructivo. Hace lo siguiente:

• Lee todos los planes de atención activos de tu empresa (CarePlanTemplate).
• Consulta a Flow si cada plan ya existe allá (por un identificador único lexa-{empresa}-plan-{id}).
• Solo crea los planes que aún no existen en Flow.
• No modifica planes existentes en Flow aunque hayas cambiado el precio en Lexa.
• No borra nada en Flow ni en Lexa.

Puedes presionarlo tantas veces como quieras — es idempotente: la segunda vez no duplica nada.

¿Cuándo lo necesito?

• La primera vez que habilitas Flow en tu empresa.
• Después de crear un nuevo plan de atención en Lexa (para registrarlo en Flow).
• Si tienes dudas de que algún plan esté en Flow y quieres asegurarte.

¿Cuándo NO lo necesito?

• Si ya sincronizaste antes y no creaste planes nuevos.
• Si cambiaste el precio de un plan existente — la sincronización no actualiza precios. Si necesitas cambiar el precio de un plan que ya tiene suscripciones activas en Flow, contacta al soporte de Flow (los cobros futuros usan el precio registrado al momento de la suscripción).

Cómo funciona el cobro mensual

1. Admin crea "Plan 2" en Lexa con MonthlyPrice = $170.000
2. Admin presiona "Sincronizar planes con Flow"
   → Lexa crea el plan en Flow con amount=170000, interval=monthly
3. Paciente es inscrito al Plan 2 en Lexa (CarePlanEnrollment)
4. Paciente abre el portal → sección "Suscripción"
   → Se le genera una URL de Flow para registrar su tarjeta
   → Ingresa datos de tarjeta en Flow (no en Lexa)
5. Flow crea la suscripción y programa el cobro mensual
6. Cada mes, Flow cobra automáticamente $170.000 a la tarjeta
7. Flow notifica a Lexa vía webhook
   → Lexa crea un Payment y asocia al mes del plan (CarePlanMonth)
   → El paciente recibe comprobante por correo

Requisitos

Antes de sincronizar asegúrate de:

• Flow habilitado en Configuración (interruptor "Habilitar pagos con Flow").
• API Keys de Flow configuradas (Producción + Sandbox si corresponde) en Configuración.
• Planes de atención creados en el módulo Planes de Atención con su MonthlyPrice definido.

Si falta algún requisito, el botón dará error y no hará nada.

Preguntas frecuentes

Si cambio el precio de un plan en Lexa, ¿se actualiza en Flow?

No automáticamente. El precio en Flow queda "fijado" al momento de crear el plan. Los pacientes ya suscritos siguen pagando el precio original. Para nuevos pacientes, necesitarías crear un plan nuevo en Lexa (con el precio actualizado) y sincronizar.

¿Qué pasa si un cobro falla?

Flow reintenta automáticamente durante unos días (configurado en el plan: days_until_due). Si sigue fallando, la suscripción queda en estado overdue y aparece en tu reporte de suscripciones vencidas. Puedes contactar al paciente para que actualice su tarjeta.

¿Puedo cancelar la suscripción de un paciente desde Lexa?

Sí, desde la ficha del paciente → pestaña Suscripciones → Cancelar. Esto cancela la suscripción en Flow también, por lo que no se harán más cobros.

¿Y si un paciente quiere pagar un mes puntual sin suscripción?

Ese es el flujo normal de pago: Invoice + Payment manual desde caja, o link de pago Flow individual. Las suscripciones son solo para el cobro automático mensual.

¿Flow me cobra comisión por cada cobro?

Sí, Flow cobra su comisión estándar sobre cada transacción (consulta con Flow el detalle vigente). Esa comisión se descuenta del monto depositado en tu cuenta bancaria.