Trabajando con suscripciones
Una suscripción representa la relación entre un cliente y los productos o servicios que ha contratado. Define qué se cobra, cada cuánto se cobra y cómo se gestiona el cobro de forma periódica.Estados de una suscripción
El estado de una suscripción indica su situación actual y se muestra tanto en la lista como en el detalle. Una suscripción puede tener los siguientes estados:| Estado | Descripción |
|---|---|
| Activa | En funcionamiento — se factura y cobra según el plan y complementos definidos |
| Pausada | Detenida temporalmente. No genera cobros pero mantiene su configuración e historial |
| Necesita atención | Detenida por un problema que impide su procesamiento. Ej: falta de folios o error en el medio de pago |
| Cancelada | No generará nuevos cobros. Ocurre cuando el cliente deja de pagar o finaliza el servicio |
| Finalizada | Terminó según la fecha de término configurada. Solo aplica a suscripciones con duración definida |
Formas de crear una suscripción
Puedes crear suscripciones en Piriod de distintas formas:- Desde el panel — ve a Suscripciones → Facturas recurrentes → Nuevo
- Signup Forms — tus clientes se suscriben directamente desde tu sitio web o aplicación
- API — creación programática mediante el recurso de suscripciones
Crear una suscripción desde el panel de Piriod
- Ve a Suscripciones → Facturas recurrentes → Nuevo
- Selecciona un cliente de la lista para continuar
Productos
Agrega los planes a los que el cliente estará suscrito.La frecuencia de facturación de la suscripción se define según la frecuencia del primer plan seleccionado.
- Haz clic en Agregar un producto
- Selecciona el producto y luego el plan
- Asigna la cantidad (no aplica a planes basados en consumo)
- Opcionalmente aplica un descuento al producto seleccionado
-19.01.55.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=c42614e0a9dd3a7e4382343b3836c252)
Complementos
Sección opcional para añadir cargos adicionales por tiempo limitado.- Haz clic en Agregar un complemento
- Selecciona el complemento y asigna la cantidad
-19.03.16.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=d3d237a46a9e008271f5cd984465c93f)
Facturación prorrateada
Los complementos con tipo de cargo Una vez pueden distribuirse hasta en 6 ciclos de facturación. Ejemplo:Un servicio de instalación de 200 USD puede cobrarse en 4 ciclos de 50 USD, agregando el ítem en cada factura correspondiente. Para configurarlo:
- Activa la facturación prorrateada
- Define ciclo, porcentaje y descripción
-19.18.58-1.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=a49b076e4d2eb6ee5aaaf63c036d955c)
Workflow
Define el orden en que se procesará la suscripción. Procesar el pago primero — intenta cobrar antes de emitir el documento. Requiere que el cliente tenga una tarjeta registrada. Si el cobro falla, la suscripción pasa a estado necesita atención. Crear la factura primero — emite el documento primero y luego gestiona el pago. Es la opción por defecto cuando no hay tarjeta registrada.Método de pago
Depende del workflow seleccionado:- Crear la factura primero
→ Se enviará la factura con un enlace de pago - Procesar el pago primero
→ Se habilita la selección de tarjetas disponibles del cliente
Descuento global
Permite aplicar un descuento sobre el total de la suscripción.Calendario
Define cuándo inicia y termina la suscripción. La fecha de término es opcional. Activa Establecer fecha para la primera facturación si necesitas que la primera factura se emita en una fecha distinta a la de inicio — por ejemplo, al comienzo del mes siguiente.-18.01.36.png?fit=max&auto=format&n=M3XM70Capupl5UoB&q=85&s=ea648a181b9a703b88ecdea1463a1577)
Facturación
Define el comportamiento al emitir las facturas:- Tipo de factura
- Días de vencimiento
- Comentario adicional
Opciones avanzadas
Tipo de cambio personalizado — define un tipo de cambio fijo o deja que Piriod lo calcule automáticamente según la fecha del ciclo. Requiere referencia — cuando está activo, la suscripción no se procesará si no se ha ingresado al menos una referencia. Referencias — permite asociar documentos a la suscripción. Tipos disponibles: Orden de compra, Nota de pedido, Contrato, Cotización, HES, Orden de trabajo y SEN. Por cada referencia debes indicar el tipo de documento, ID o número, fecha, descripción y fecha de vencimiento.La fecha de vencimiento debe ser posterior a la fecha de la referencia. De lo contrario, la suscripción no se procesará y quedará en estado necesita atención.
