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. La secretaria activa el cobro automático desde Planes Activos presionando "Activar" en la fila del plan, o bien Lexa lo activa solo si el centro tiene habilitado el modo automático (ver "Activación automática vs manual" más abajo).
4. Flow genera una suscripción que cobra el monto mensual del plan en la fecha acordada.
5. Cada cobro exitoso se refleja en Lexa como un Payment asociado al plan del paciente.
6. 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 "Pago Automático"
   → Pulsa "Registrar tarjeta" y es redirigido a Flow
   → Ingresa datos de tarjeta en Flow (no en Lexa)
   → Vuelve al portal con tarjeta registrada (****1234, badge verde)
5. Activación del cobro (decisión de la empresa):
   • Modo manual (default): la secretaria entra a "Planes Activos",
     ve el botón "Activar" en la columna "Cobro Auto" del plan del paciente
     y lo pulsa. Lexa crea la suscripción en Flow.
   • Modo automático: si la empresa habilitó el toggle "Activar cobro
     automático al registrar tarjeta", Lexa crea la suscripción apenas
     el paciente termina el registro de la tarjeta, sin acción manual.
6. Flow programa el cobro mensual contra la tarjeta registrada.
7. Cada mes, Flow cobra automáticamente $170.000.
8. Flow notifica a Lexa vía webhook
   → Lexa crea un Payment y asocia al mes del plan (CarePlanMonth)
   → El paciente recibe comprobante por correo

Activación automática vs manual

Se controla con el toggle "Activar cobro automático al registrar tarjeta" en Configuración → Pagos Online (Flow.cl).

Comportamientos clave:

• El botón "Activar" en Planes Activos solo aparece si el paciente tiene tarjeta registrada y el plan tiene precio mayor que cero.
• Si el paciente no registró la tarjeta aún, la columna "Cobro Auto" muestra el badge "Sin tarjeta" en gris.
• Los planes con monto cero (becas totales, planes gratis) no generan suscripción ni en modo manual ni en automático.
• El modo automático solo aplica al momento del registro: si el toggle se enciende después de que un paciente ya tiene tarjeta, sus planes preexistentes hay que activarlos manual desde Planes Activos.

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.