> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piriod.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facturas recurrentes

## 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**

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

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-24-a-la(s)-19.01.55.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=c42614e0a9dd3a7e4382343b3836c252" alt="Captura De Pantalla 2026 04 24 A La(s) 19 01 55" width="901" height="164" data-path="images/Captura-de-pantalla-2026-04-24-a-la(s)-19.01.55.png" />
</Frame>

***

### 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

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-24-a-la(s)-19.03.16.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=d3d237a46a9e008271f5cd984465c93f" alt="Captura De Pantalla 2026 04 24 A La(s) 19 03 16" width="910" height="186" data-path="images/Captura-de-pantalla-2026-04-24-a-la(s)-19.03.16.png" />
</Frame>

#### 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

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-24-a-la(s)-19.18.58-1.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=a49b076e4d2eb6ee5aaaf63c036d955c" alt="Captura De Pantalla 2026 04 24 A La(s) 19 18 58 1" width="896" height="463" data-path="images/Captura-de-pantalla-2026-04-24-a-la(s)-19.18.58-1.png" />
</Frame>

***

### 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.

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/M3XM70Capupl5UoB/images/Captura-de-pantalla-2026-06-05-a-la(s)-18.01.36.png?fit=max&auto=format&n=M3XM70Capupl5UoB&q=85&s=ea648a181b9a703b88ecdea1463a1577" alt="Captura De Pantalla 2026 06 05 A La(s) 18 01 36" width="748" height="358" data-path="images/Captura-de-pantalla-2026-06-05-a-la(s)-18.01.36.png" />
</Frame>

***

### 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**.
