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

Una factura registra el cobro de productos o servicios a un cliente, incluyendo montos, impuestos y condiciones de pago. Desde Piriod puedes crear facturas manualmente, generarlas automáticamente desde suscripciones, emitirlas en lote, enviarlas por email y registrar pagos asociados.

***

### Estados de una factura

| Estado           | Descripción                                           |
| :--------------- | :---------------------------------------------------- |
| **Borrador**     | Editable antes de finalizar                           |
| **Finalizada**   | Lista para ser pagada                                 |
| → **Por cobrar** | Dentro del plazo de pago                              |
| → **Vencida**    | Plazo expirado sin pago                               |
| **Pagada**       | Pago recibido correctamente                           |
| **Cancelada**    | Anulada total o parcialmente mediante nota de crédito |

***

### **Formas de crear una factura**

Puedes crear facturas de distintas maneras según tu necesidad:

<AccordionGroup>
  <Accordion title="Desde una suscripción">
    Las suscripciones generan facturas automáticamente en cada ciclo de facturación.
  </Accordion>

  <Accordion title="Desde el panel de Piriod">
    Permite crear facturas manualmente cuando necesitas realizar un cobro puntual.
  </Accordion>
</AccordionGroup>

***

### Crear una factura desde el panel

**Paso 1: iniciar la creación**

Ve a **Facturación → Facturas → Nuevo → Factura única**

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(12).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=de5ee222a698a0784b9d0c7797463952" alt="Image (12)" width="1312" height="801" data-path="images/image-(12).png" />
</Frame>

Selecciona el cliente

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(13).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=84faf2e7c5511d5a78e562011db90315" alt="Image (13)" width="1308" height="808" data-path="images/image-(13).png" />
</Frame>

#### **Paso 2: agregar productos o servicios**

Aquí defines qué se cobrará al cliente.

Para cada ítem debes completar:

* **Nombre**
* **Descripción**
* **Cantidad**
* **Precio unitario**

Opcionalmente puedes agregar:

* **Descuento**
* **Código o SKU**
* **Unidad de medida**
* **Exento**, si el ítem no está afecto a impuestos

Puedes agregar uno o varios ítems en la misma factura.

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(14).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=2d12863530eba461f0bb3bbc1651cd5d" alt="Image (14)" width="1312" height="811" data-path="images/image-(14).png" />
</Frame>

#### **Paso 3: definir forma de pago**

Selecciona cómo se pagará la factura:

#### **Portal de pago**

Permite que el cliente pague desde el link de pago de la factura antes de la fecha de vencimiento.

#### **Cobro automático a tarjeta**

El cargo se realiza automáticamente al confirmar la factura.

Para usar esta opción, el cliente debe tener una tarjeta registrada previamente.

<Tabs>
  <Tab title="A través del portal de pagos">
    <Frame>
      <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(15).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=3f9ca5c04aa2c49dff9cffbd51d4084d" alt="Image (15)" width="2220" height="684" data-path="images/image-(15).png" />
    </Frame>
  </Tab>

  <Tab title="Con cargo a la tarjeta">
    <Frame>
      <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(16).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=ca020a662fe541a3efa3a2945853092b" alt="Image (16)" width="2228" height="520" data-path="images/image-(16).png" />
    </Frame>
  </Tab>
</Tabs>

#### Información adicional

* **Periodo de facturación** — fechas de inicio y término del cobro
* **Comentario** — nota visible en la factura impresa
* **Referencias** — documentos relacionados como contratos, órdenes de compra, etc.

Cuando todo esté listo, haz clic en **Crear factura**.

***

## **Visualizar las facturas**

Desde **Facturación → Facturas**, haz clic en cualquier factura para ver el resumen completo:

* Resumen transaccional (total, cliente, fecha, estado del pago)
* Eventos relacionados al pago, envío por email o creación de nota de crédito
* Información general
* Información de cobranza
* Agencia fiscal
* Pagos
* Productos
* Totales

También puedes realizar gestiones rápidas en cada factura a través de las opciones:

* Enviar por email

1. Haz clic en **Enviar factura**
2. Selecciona los destinatarios — incluye el email de facturación del cliente y los contactos con notificaciones activas
3. Completa el asunto y el cuerpo del mensaje. Puedes usar una plantilla desde **Elegir una plantilla** para agilizar el envío

<Info>
  Piriod adjunta automáticamente el PDF y el formato local. Cada envío queda registrado como evento en el detalle de la factura.
</Info>

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-29-a-la(s)-14.45.36.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=e9f791103e24e52328f614303a981dc8" alt="Captura De Pantalla 2026 04 29 A La(s) 14 45 36" width="2230" height="866" data-path="images/Captura-de-pantalla-2026-04-29-a-la(s)-14.45.36.png" />
</Frame>

<Note>
  Por defecto el email se envía desde un dominio de Piriod. Puedes conectar tu propia cuenta de email en la configuración.
</Note>

* **PDF** Visualiza e imprime la factura directamente desde el panel. Haz clic en **Descargar PDF** para guardar el archivo.
* **Duplicar** Crea una copia en estado borrador para editar antes de emitir. Es útil cuando necesitas emitir facturas similares de forma recurrente sin tener que completar todo desde cero.
* **Crear nota de crédito** Genera una nota de crédito para anular total o parcialmente la factura.

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-29-a-la(s)-18.34.43-1.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=f91b016dd80f202379ab884f8a8163d3" alt="Captura De Pantalla 2026 04 29 A La(s) 18 34 43 1" width="2362" height="860" data-path="images/Captura-de-pantalla-2026-04-29-a-la(s)-18.34.43-1.png" />
</Frame>

***

### Eliminar una factura

Solo puedes eliminar facturas en estado **borrador**.

1. Haz clic en **Eliminar borrador**
2. Confirma la eliminación

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-29-a-la(s)-14.53.19.png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=c4046be88f76b3a04cad518b197ba028" alt="Captura De Pantalla 2026 04 29 A La(s) 14 53 19" width="2342" height="1158" data-path="images/Captura-de-pantalla-2026-04-29-a-la(s)-14.53.19.png" />
</Frame>

<Warning>
  Si necesitas eliminar una factura finalizada, deberás anularla con una nota de crédito.
</Warning>

***

### Facturación por lote

Cuando necesitas emitir un alto volumen de facturas de una sola vez, puedes hacerlo cargando un archivo `.xlsx` o `.csv` con los datos de cada documento.

> [Descarga el archivo base para importación por lote desde aquí](https://docs.google.com/spreadsheets/d/1D-o_5voK6OpPj4UFQCANIhDCKpESmjPV/edit?usp=drive_link\&ouid=109386486582398522693\&rtpof=true\&sd=true)

***

#### Preparar el archivo

| Columna                 | Requerido | Descripción                                      |
| :---------------------- | :-------- | :----------------------------------------------- |
| `customer`              | Sí        | Nombre exacto del cliente (distingue mayúsculas) |
| `tax_id`                | No        | ID fiscal del cliente                            |
| `collection_method`     | Sí        | Tipo de cargo (por defecto: `deferred`)          |
| `date`                  | Sí        | Fecha de emisión `YYYY-MM-DD`                    |
| `document`              | Sí        | ID del tipo de factura                           |
| `due_date`              | Sí        | Fecha de vencimiento `YYYY-MM-DD`                |
| `line_name`             | Sí        | Nombre o descripción del ítem                    |
| `line_amount`           | Sí        | Precio unitario sin impuestos                    |
| `line_quantity`         | Sí        | Cantidad                                         |
| `line_discount`         | No        | Monto de descuento del ítem                      |
| `line_discount_scheme`  | No        | Tipo de descuento: `%` o `$`                     |
| `line_code`             | No        | Código de producto                               |
| `line_code_scheme`      | No        | Tipo de código (por ejemplo:`SKU`)               |
| `discount`              | No        | Descuento sobre el subtotal                      |
| `discount_scheme`       | No        | Tipo de descuento sobre subtotal: `%` o `$`      |
| `note`                  | No        | Nota visible en la factura                       |
| `reference_date`        | No        | Fecha del documento de referencia                |
| `reference_description` | No        | Descripción del documento de referencia          |
| `reference_serial`      | No        | Número o serial del documento de referencia      |

<Info>
  Para identificar al cliente puedes usar `customer` o `tax_id`. Si ambos están presentes, `customer` tiene prioridad.
</Info>

***

#### Crear el proceso

1. Ve a **Facturación → Facturas → Nuevo → Facturas por lote**
2. Selecciona la fuente de datos y el tipo de archivo
3. Activa **Generar solo borradores** si quieres revisar antes de emitir
4. Activa **Enviar vía email** si quieres notificar al cliente al emitir (no disponible en modo borrador)
5. Haz clic en **Continuar**

***

#### Aprobar

Revisa el resumen del proceso y haz clic en **Aprobar todo** para iniciar. El tiempo de procesamiento varía según el volumen — en modo borrador es casi instantáneo.

***

#### Eliminar el proceso

Disponible cuando el proceso está **pendiente**, o **finalizado en modo borrador**.

1. Haz clic en **Eliminar proceso**
2. Confirma la eliminación