Skip to main content

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:
Se encuentra en funcionamiento y se factura y cobra según el plan y complementos definidos.
Se encuentra detenida temporalmente. No se generan cobros, pero mantiene su configuración e historial.
Está detenida por un problema que impide su procesamiento.
Ejemplos: falta de folios o errores en el medio de pago.
No generará nuevos cobros. Ocurre cuando el cliente deja de pagar o finaliza el servicio.
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:
Menú Suscripciones ➝ Facturas recurrentes ➝ Nuevo
Permite que tus clientes se suscriban directamente desde tu sitio web o aplicación
Creación programática mediante el recurso de suscripciones

Crear una suscripción desde el panel de Piriod

  1. Ve al menú Suscripciones ➝ Facturas recurrentes
  2. Haz clic en Nuevo
  3. 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.
  1. Haz clic en Agregar un producto
  2. Selecciona el producto y luego el plan
  3. Asigna la cantidad del plan (no aplica a planes basados en consumo)
Opcional: Aplica un descuento al producto seleccionado
Captura De Pantalla 2026 04 24 A La(s) 19 01 55

Sección de complementos

Sección opcional para añadir complementos por tiempo limitado.
  1. Haz clic en Agregar un complemento
  2. Selecciona el complemento
  3. Asigna la cantidad
Captura De Pantalla 2026 04 24 A La(s) 19 03 16

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
Captura De Pantalla 2026 04 24 A La(s) 19 18 58 1

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
Comportamiento:
  • 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
Comportamiento:
  • 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
Para cada referencia debes indicar:
  • Documento
  • ID o número
  • Fecha
  • Descripción
  • 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”.