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

# Dokumentnummern in Vorlagen

> Drucken Sie Rechnungs-, Gutschrift- und Angebotsnummern mit `document_number`, das Rechnungsdatum mit `document_date` und einen Stornohinweis.

Wenn die Dokumentnummerierung aktiviert ist, vergibt Foliant für Rechnungen, Gutschriften und Angebote eigene fortlaufende Nummern, zum Beispiel `INV-0042`. Eine Vorlage druckt die Nummer mit `{{ document_number }}` oder im visuellen Editor mit dem Block **Dokumentnummer**.

## Bevor Sie beginnen

* Aktivieren Sie die Nummerierung unter **Einstellungen › Dokumente & Drucken › Dokumentnummerierung**. Siehe [Dokumentnummerierung einrichten](https://foliant-help.iforiti.com/de/invoices-and-numbering/document-numbering.md).
* Stellen Sie auf der Einstellungsseite der Vorlage den **Dokumenttyp** auf **Rechnung**, **Gutschrift** oder **Angebot**. Vorlagen vom Typ **Sonstiges (nicht nummeriert)** erhalten keine Nummern.

## Im visuellen Editor

Fügen Sie den Block **Dokumentnummer** hinzu (unter **Rechtliches**). Er druckt die Nummer und das Datum des Dokuments mit ihren Bezeichnungen, zum Beispiel „Rechnungsnummer“ und „Rechnungsdatum“ („Gutschriftsdatum“ bei einer Gutschrift, „Angebotsdatum“ bei einem Angebot), in der Sprache des Dokuments. Er erscheint nur auf nummerierten Dokumenten.

Sie können **Dokumentnummer** und **Dokumentdatum** auch zu den **Angaben unter dem Titel** eines **Kopfbereich**-Blocks hinzufügen oder **Dokumentnummer** als Inhalt eines **Barcode / QR**-Blocks verwenden.

## Im Code

| Variable | Bedeutung |
| - | - |
| `{{ document_number }}` | Die Nummer des Dokuments. Leer, wenn das Dokument keine Nummer hat. |
| `{{ document_issued_at }}` | Wann die Nummer vergeben wurde. Leer, wenn das Dokument keine Nummer hat. Formatieren Sie sie mit `date`. |
| `{{ document_date }}` | Das Datum des Dokuments, immer gesetzt: der Zeitpunkt, an dem seine Nummer vergeben wurde, sonst das Bestelldatum (bei einer Gutschrift das Erstattungsdatum). Verwenden Sie es als Rechnungsdatum. Formatieren Sie es mit `date`. |
| `{{ document_voided }}` | Wahr, wenn das Dokument storniert wurde. Seine Nummer bleibt verbraucht und wird nie erneut vergeben. |
| `{{ document_kind }}` | `invoice`, `credit_note` oder `quote`; leer, wenn die Vorlage nicht nummeriert ist. |

Drucken Sie die Nummer nur, wenn es eine gibt:

```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` druckt „Rechnungsdatum“ in der Sprache des Dokuments; verwenden Sie `document_date.credit_note` oder `document_date.quote` für die anderen Typen.

## Das Rechnungsdatum

Das Datum einer Rechnung ist der Tag, an dem sie ausgestellt wurde: der Tag, an dem ihre Nummer vergeben wurde. Das ist nicht das Bestelldatum und auch nicht das heutige Datum, das sich bei jedem erneuten Drucken ändert. `{{ document_date }}` liefert Ihnen dieses Datum:

* Bei einem nummerierten Dokument ist es der Tag, an dem die Nummer vergeben wurde, in der Zeitzone Ihres Shops. Wenn Sie das Dokument nächsten Monat erneut drucken, ändert es sich nicht.
* Bei einem Dokument ohne Nummer ist es das Bestelldatum. Bei Bestellungen, die von anderswo importiert wurden, ist das das Datum, an dem die Bestellung verarbeitet wurde. Eine Gutschrift verwendet das Datum ihrer Erstattung.

So funktioniert eine Vorlage unabhängig davon, ob die Nummerierung aktiviert ist oder nicht. Die integrierten Vorlagen für Rechnung, Gutschrift und Angebot drucken es bereits, mit der Bezeichnung „Rechnungsdatum“, „Gutschriftsdatum“ oder „Angebotsdatum“. Wenn Ihre eigene Vorlage `'now' | date` als Datum druckt, ersetzen Sie das durch `{{ document_date | date: '%d %B %Y' }}`.

## Wenn Ihre Vorlage die Nummer nicht druckt

Wenn die Vorlage eines nummerierten Dokuments `document_number` nirgends verwendet, fügt Foliant am Ende eine kleine Zeile mit der Nummer und dem Ausstellungsdatum hinzu, zum Beispiel „Rechnungsnummer: INV-0042 · 4. Oktober 2026“, damit die Nummer nie fehlt. Fügen Sie `{{ document_number }}` dort ein, wo Sie sie haben möchten, dann verschwindet die zusätzliche Zeile. Wenn Ihre Vorlage bereits `document_date` oder `document_issued_at` druckt, zeigt die Zeile nur die Nummer.

## Gut zu wissen

* Ein Dokument erhält seine Nummer, wenn es zum ersten Mal heruntergeladen, gedruckt oder exportiert wird, und behält sie.
* Die Vorschau im Editor zeigt die Nummer, die Ihr nächstes Dokument erhalten würde, ohne sie zu verbrauchen.
* Ein Barcode der Nummer: `{{ document_number | barcode }}`. Siehe [Barcodes und QR-Codes](https://foliant-help.iforiti.com/de/template-editor/liquid-barcodes-and-qr-codes.md).
* Vorlagen für alle ausgewählten Bestellungen werden nie nummeriert.

## Verwandte Artikel

* [Dokumentnummerierung einrichten](https://foliant-help.iforiti.com/de/invoices-and-numbering/document-numbering.md)
* [Block-Referenz](https://foliant-help.iforiti.com/de/template-editor/block-catalogue.md)
* [Barcodes und QR-Codes](https://foliant-help.iforiti.com/de/template-editor/liquid-barcodes-and-qr-codes.md)
* [Datumsangaben, Sprachen und Übersetzungen](https://foliant-help.iforiti.com/de/template-editor/liquid-dates-and-languages.md)


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