Skip to main content

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:
EstadoDescripción
ActivaEn funcionamiento — se factura y cobra según el plan y complementos definidos
PausadaDetenida temporalmente. No genera cobros pero mantiene su configuración e historial
Necesita atenciónDetenida por un problema que impide su procesamiento. Ej: falta de folios o error en el medio de pago
CanceladaNo generará nuevos cobros. Ocurre cuando el cliente deja de pagar o finaliza el servicio
FinalizadaTerminó 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

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

Complementos

Sección opcional para añadir cargos adicionales por tiempo limitado.
  1. Haz clic en Agregar un complemento
  2. Selecciona el complemento y 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 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
Captura De Pantalla 2026 04 24 A La(s) 19 18 58 1

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.
Captura De Pantalla 2026 06 05 A La(s) 18 01 36

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.