Contenido del manual

1. Qué hace y conceptos clave

Este módulo lleva las suscripciones de Odoo Enterprise a Odoo Community. Una suscripción no es un documento nuevo: es una orden de venta a la que le asignas un plan recurrente. Al confirmarla, Odoo la factura periodo a periodo de forma automática y, si guardaste una tarjeta, también la cobra.

2. Instalación

Entra a Aplicaciones, busca Codfy - Suscripciones e instala. El módulo depende de Ventas y del framework de Pagos; ambos vienen en Community. Al terminar aparece la aplicación Suscripciones en el menú superior, con tres secciones: Suscripciones, Reportes y Configuración.

Timbrado CFDI (opcional). Si tienes instalado el módulo de timbrado de Codfy (c_invoice_cfdi), las facturas que genere la suscripción se timbran solas. Si no, simplemente se envían por correo. No hay que configurar nada extra.

3. Configuración: planes de suscripción

Menú Suscripciones > Configuración > Planes. El plan es el corazón de la recurrencia. El módulo trae dos planes listos (Mensual y Anual); puedes editarlos o crear los tuyos.

Ficha del plan, campo por campo

El botón inteligente Suscripciones en la parte superior de la ficha lleva a las suscripciones activas de ese plan.

4. Configuración: razones de cierre

Menú Configuración > Razones de cierre. Son los motivos por los que se cancela una suscripción; sirven para analizar el churn. El módulo trae cuatro (Demasiado caro, Ya no lo usa, Se fue con la competencia, Otra). Edita la lista a tu gusto; el orden se ajusta arrastrando.

5. Configuración: productos recurrentes

Para que una linea cuente como suscripción debes marcar el producto como recurrente. Abre el producto (normalmente un Servicio) y activa la casilla Producto recurrente, debajo de la Política de facturación. Solo las lineas con productos recurrentes se facturan cada periodo y suman al MRR.

6. Crear y gestionar una suscripción

Una suscripción se crea como cualquier cotización, agregando un plan y al menos un producto recurrente:

1. Menú Suscripciones > Suscripciones > Nuevo.
2. Elige el cliente y el Plan recurrente (junto a la lista de precios).
3. Agrega lineas con productos marcados como recurrentes.
4. (Opcional) en la pestaña Suscripción, asigna un Token de pago para cobro automático.
5. Pulsa Confirmar: la suscripción pasa a En progreso y se fijan las fechas.

La ficha de la suscripción

En la cabecera verás la barra de estado de la suscripción y los botones de accion. En suscripciones se oculta la barra de venta nativa para no confundir.

Pestaña Suscripción

Concentra los datos del contrato recurrente.

Ciclo de estados

Asistente de cierre

Al pulsar Cerrar suscripción se pide el motivo y la fecha de cierre, para llevar el control de cancelaciones.

Vistas de lista y kanban

El menú Suscripciones abre la lista (con el total de MRR) y un tablero kanban por estado. Usa los filtros En progreso / Pausadas / Canceladas / Por facturar y agrupa por plan o cliente.

7. Facturación y cobro automático

Tres acciones planificadas (crons) trabajan a diario. Las encuentras en Ajustes > Técnico > Acciones planificadas.

La factura generada

Cada periodo se emite una factura con las lineas recurrentes. Queda ligada a la suscripción (botón Facturas) y, si el módulo de timbrado está instalado, se timbra automáticamente.

Cobro automático de tarjeta (off-session)

Si la suscripción tiene un Token de pago (una tarjeta guardada), el cron cobra solo cada periodo mediante el proveedor de pago, sin que el cliente este presente. Si el cobro falla, la suscripción queda en excepcion, se envía el recordatorio y, pasado el límite del plan, se cierra sola.

Proveedores compatibles. El cobro automático requiere un proveedor con tokenización + cobro fuera de sesión. En Community y para México funcionan de forma nativa Stripe y Mercado Pago. Sin un token guardado, la suscripción opera en modo manual: solo emite y envía la factura.

8. Métricas: MRR y reportes

Cada cambio relevante de una suscripción deja un registro de MRR: alta, expansión (sube el importe), contracción (baja) y cancelación. Con eso, el menú Reportes > Análisis de MRR arma gráficos y tablas dinamicas, sin necesidad del widget de cohorte de Enterprise.

Mide la Variacion de MRR (cuánto creció o cayó el ingreso) y el MRR acumulado, agrupando por mes, tipo de evento, plan o cliente.

9. Portal de cliente

El cliente administra sus suscripciones desde su área privada (/my). Aparece una tarjeta Suscripciones con el número de contratos.

Desde ahi ve la lista de sus suscripciones y el detalle de cada una: plan, MRR, productos y facturas.

Si el plan lo permite (El cliente puede cancelar), aparece el botón Cancelar suscripción, que pide el motivo del cierre.

10. Casos de uso

11. Preguntas frecuentes

Necesito Odoo Enterprise? No. El módulo funciona en Odoo Community.

Se cobran las tarjetas solas? Si, cuando la suscripción tiene una tarjeta guardada y el proveedor soporta cobro fuera de sesión (Stripe, Mercado Pago). Sin token, opera en modo manual.

Timbra las facturas (CFDI)? Si tienes instalado el módulo de timbrado de Codfy, si; si no, la factura solo se envía por correo. Es una integracion opcional, sin configuración extra.

Qué pasa si un cobro falla? La suscripción queda en excepcion, el cliente recibe un recordatorio y, pasado el límite de días del plan, se cierra automáticamente.

Puedo facturar antes de tiempo? Si, con el botón Generar factura de la suscripción.