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

# Números de documento en las plantillas

> Imprime números de factura, nota de crédito y presupuesto con {{ document_number }}, la fecha de la factura con {{ document_date }} y un aviso de anulación.

Cuando la numeración de documentos está activada, Foliant asigna a las facturas, notas de crédito y presupuestos sus propios números correlativos, como `INV-0042`. Una plantilla imprime el número con `{{ document_number }}` o, en el editor visual, con el bloque **Número de documento**.

## Antes de empezar

* Activa la numeración en **Configuración › Documentos e impresión › Numeración de documentos**. Consulta [Configurar la numeración de documentos](https://foliant-help.iforiti.com/es/invoices-and-numbering/document-numbering.md).
* En la página de configuración de la plantilla, establece su **Tipo de documento** en **Factura**, **Nota de crédito** o **Presupuesto**. Las plantillas de tipo **Otro (sin numerar)** no reciben números.

## En el editor visual

Añade el bloque **Número de documento** (en **Cumplimiento**). Imprime el número y la fecha del documento con sus etiquetas, como "Número de factura" y "Fecha de factura" ("Fecha de la nota de crédito" en una nota de crédito, "Fecha del presupuesto" en un presupuesto), en el idioma del documento. Solo aparece en documentos numerados.

También puedes añadir **Número de documento** y **Fecha del documento** a los **Datos bajo el título** de un bloque **Encabezado**, o usar **Número de documento** como lo que codifica un bloque **Código de barras / QR**.

## En código

| Variable | Qué es |
| - | - |
| `{{ document_number }}` | El número del documento. Vacío cuando el documento no tiene número. |
| `{{ document_issued_at }}` | Cuándo se emitió el número. Vacío cuando el documento no tiene número. Dale formato con `date`. |
| `{{ document_date }}` | La fecha del documento, siempre definida: cuando se emitió su número o, si no, la fecha del pedido (en una nota de crédito, la fecha del reembolso). Úsala como fecha de la factura. Dale formato con `date`. |
| `{{ document_voided }}` | Verdadero cuando el documento se anuló. Su número sigue usado y nunca se vuelve a asignar. |
| `{{ document_kind }}` | `invoice`, `credit_note` o `quote`; vacío cuando la plantilla no está numerada. |

Imprime el número solo cuando exista:

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` imprime "Fecha de factura" en el idioma del documento; usa `document_date.credit_note` o `document_date.quote` para los otros tipos.

## La fecha de la factura

La fecha de una factura es el día en que se emitió: el día en que se le asignó su número. No es la fecha del pedido ni la fecha de hoy, que cambia cada vez que la vuelves a imprimir. `{{ document_date }}` te da esa fecha:

* En un documento numerado, es el día en que se emitió el número, en la zona horaria de tu tienda. Volver a imprimir el documento el mes que viene no la cambia.
* En un documento sin número, es la fecha del pedido. En los pedidos importados de otro sitio, es la fecha en que se procesó el pedido. Una nota de crédito usa la fecha de su reembolso.

Así, una misma plantilla funciona tanto si la numeración está activada como si no. Las plantillas integradas de factura, nota de crédito y presupuesto ya la imprimen, con la etiqueta "Fecha de factura", "Fecha de la nota de crédito" o "Fecha del presupuesto". Si tu propia plantilla imprime `'now' | date` como fecha, sustitúyelo por `{{ document_date | date: '%d %B %Y' }}`.

## Si tu plantilla no imprime el número

Cuando la plantilla de un documento numerado no usa `document_number` en ningún sitio, Foliant añade al final una pequeña línea con el número y la fecha en que se emitió, como "Número de factura: INV-0042 · 4 de octubre de 2026", para que el número nunca falte. Añade `{{ document_number }}` donde lo quieras y la línea adicional desaparece. Si tu plantilla ya imprime `document_date` o `document_issued_at`, la línea muestra solo el número.

## Conviene saber

* Un documento recibe su número la primera vez que se descarga, imprime o exporta, y lo conserva.
* La vista previa del editor muestra el número que recibiría tu próximo documento, sin consumirlo.
* Un código de barras del número: `{{ document_number | barcode }}`. Consulta [Códigos de barras y códigos QR](https://foliant-help.iforiti.com/es/template-editor/liquid-barcodes-and-qr-codes.md).
* Las plantillas para todos los pedidos seleccionados nunca se numeran.

## Artículos relacionados

* [Configurar la numeración de documentos](https://foliant-help.iforiti.com/es/invoices-and-numbering/document-numbering.md)
* [Referencia de bloques](https://foliant-help.iforiti.com/es/template-editor/block-catalogue.md)
* [Códigos de barras y códigos QR](https://foliant-help.iforiti.com/es/template-editor/liquid-barcodes-and-qr-codes.md)
* [Fechas, idiomas y traducciones](https://foliant-help.iforiti.com/es/template-editor/liquid-dates-and-languages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.