Suscripciones

Suscripciones es el módulo subscriptions: cobra mensualidades, trimestres y renovaciones anuales a clientes que ya están en el CRM. No es núcleo y hoy solo viene en el plan A medida. La lógica es deliberadamente simple: el sistema genera la cuota de cada período y el cobro lo cierras tú, salvo que el sitio tenga tarjeta tokenizada y una pasarela que sepa cobrarla sola.

Qué hace

• Suscripción con cliente, concepto, importe, intervalo (monthly, quarterly, yearly), estado (active, paused, cancelled) y próxima fecha de cobro.
• subscriptions:run, cada día a las 06:00, genera las cuotas vencidas: una por período con formato Y-m, creada una sola vez por la clave única subscription_id más period, y avanza la próxima fecha.
• Pone al día hasta 24 períodos por corrida; una suscripción parada mucho tiempo no se regulariza de golpe.
• Deja la cuota en la ficha del cliente como actividad, con el importe y el período.
• Cobros pendientes en el panel, con «Generar cuotas ahora» (POST /subscriptions/run) y el botón de marcar pagada.
• Recordatorio antes del cobro, a las 07:30, por WhatsApp; el aviso sale con tres días para mensual, siete para trimestral y quince para anual, y si no se entrega va en el resumen por correo.
• La ficha del cliente muestra sus suscripciones y sus pendientes, con el importe pendiente sumado.
• Cobro automático cuando hay payment_source_id y la pasarela del sitio implementa el cobro recurrente —hoy solo Wompi—: la cuota se marca pagada con su referencia.

De qué depende

• Del módulo subscriptions y del permiso de trabajo subscriptions, que no está en ningún perfil del catálogo.
• Del CRM: el cliente tiene que ser un lead del sitio; un id de otro sitio no pasa la validación.
• Del cobro automático, de Wompi configurado en Ajustes → Integraciones y de una tarjeta tokenizada.

Qué pasa cuando se apaga

El panel y la API responden 403 con {"module":"subscriptions"} y los recordatorios se paran, porque reminders:send filtra por módulo. La generación de cuotas no se para: subscriptions:run no consulta el entitlement, solo el estado de la suscripción, así que sigue creando cuotas pendientes aunque el módulo esté apagado o el sitio esté suspendido. Los datos quedan intactos.

Límites y trampas

• No hay enlace de pago. La tabla del panel rotula «Cobro con link» cuando no hay tarjeta, pero nada genera ese enlace: el recordatorio abre WhatsApp y el cobro se marca a mano.
• La tarjeta no se captura en el panel. POST /subscriptions/{id}/payment-source existe, y la pantalla solo permite quitarla: sin alguien que guarde el payment_source_id, no hay cobro automático.
• Borrar la suscripción no borra sus cuotas. Quedan pendientes, sin concepto asociado —el panel las muestra como «Cobro»— y se siguen sumando al saldo del cliente.
• Cambiar el importe no reescribe lo ya generado: las cuotas viejas conservan el suyo.
• Marcar pagada no cobra nada: solo cambia el estado y la fecha. La conciliación es tuya.
• Pausar evita cuotas nuevas; cancelar deja de listar la suscripción en la ficha del cliente, pero sus cuotas pendientes siguen ahí.

Ver también

• CRM — de dónde sale el cliente.
• Pagos — la pasarela con la que se cobra.
• Módulos — el catálogo completo.