Documentation Index
Fetch the complete documentation index at: https://piriod-d406ac55.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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
- Cómo se factura y 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:Activa
Activa
Se encuentra en funcionamiento y se factura y cobra según el plan y complementos definidos.
Pausada
Pausada
Se encuentra detenida temporalmente. No se generan cobros, pero mantiene su configuración e historial.
Necesita atención
Necesita atención
Está detenida por un problema que impide su procesamiento.
Ejemplos: falta de folios o errores en el medio de pago.
Ejemplos: falta de folios o errores en el medio de pago.
Cancelada
Cancelada
No generará nuevos cobros. Ocurre cuando el cliente deja de pagar o finaliza el servicio.
Finalizada
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
Desde el panel
Menú Suscripciones ➝ Facturas recurrentes ➝ Nuevo
Signup Forms
Signup Forms
Permite que tus clientes se suscriban directamente desde tu sitio web o aplicación
API
API
Creación programática mediante el recurso de suscripciones
Crear una suscripción desde el panel de Piriod
- Ve al menú Suscripciones ➝ Facturas recurrentes
- Haz clic en Nuevo
- Selecciona un cliente de la lista para continuar
Sección de productos
Permite añadir los planes de precios 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 del plan (no aplica a planes basados en consumo)
Opcional: Aplica un descuento al producto seleccionado
-19.01.55.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=c42614e0a9dd3a7e4382343b3836c252)
Sección de complementos
Sección opcional para añadir complementos por tiempo limitado.- Haz clic en Agregar un complemento
- Selecciona el complemento
- 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 prorratearse 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)
Sección de Worklow
Define el orden en que se procesará la suscripción: facturación y pago.Procesar el pago primero
- Requiere que el cliente tenga una tarjeta registrada
- Si no hay tarjeta, esta opción no estará disponible
- Se intenta cobrar primero
- Si el pago falla, la suscripción pasa a estado “necesita atención” hasta resolver el problema
Crear la factura primero
- Es la opción por defecto cuando no hay tarjeta registrada
- Se genera primero el documento
- Luego se gestiona el pago
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.Sección de calendario
Define cuándo inicia y termina la suscripción.- Fecha de inicio
- Fecha de término (opcional)
Primera facturación
Puedes activar: 👉 Establecer fecha para la primera facturación Permite definir una fecha distinta (generalmente futura) para la primera factura.Sección de facturación
Define el comportamiento al emitir y cobrar las facturas.- Tipo de factura
- Días de vencimiento
- Comentario adicional
Opciones avanzadas (opcional)
Configuraciones adicionales que pueden afectar el procesamiento de la suscripción.Tipo de cambio personalizado
Permite definir un tipo de cambio fijo o dejar que Piriod lo calcule automáticamente según la fecha del ciclo.Requiere referencia
Al activar esta opción: 👉 La suscripción no se procesará si no se ingresa 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
- SEN
- Documento
- ID o número
- Fecha
- Descripción
- Fecha de vencimiento
