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

# Numery dokumentów w szablonach

> Drukuj numery faktur, faktur korygujących i ofert za pomocą `document_number`, datę faktury za pomocą `document_date` oraz informację o anulowaniu.

Gdy numeracja dokumentów jest włączona, Foliant nadaje fakturom, fakturom korygującym i ofertom własne kolejne numery, np. `INV-0042`. Szablon drukuje numer za pomocą `{{ document_number }}`, a w edytorze wizualnym za pomocą bloku **Numer dokumentu**.

## Zanim zaczniesz

* Włącz numerację w **Ustawienia › Dokumenty i drukowanie › Numeracja dokumentów**. Zobacz [Skonfiguruj numerację dokumentów](https://foliant-help.iforiti.com/pl/invoices-and-numbering/document-numbering.md).
* Na stronie ustawień szablonu ustaw **Typ dokumentu** na **Faktura**, **Faktura korygująca** lub **Oferta**. Szablony typu **Inny (bez numeracji)** nie dostają numerów.

## W edytorze wizualnym

Dodaj blok **Numer dokumentu** (w sekcji **Zgodność z przepisami**). Drukuje on numer i datę dokumentu z etykietami, np. „Numer faktury” i „Data faktury” („Data faktury korygującej” na fakturze korygującej, „Data oferty” na ofercie), w języku dokumentu. Pojawia się tylko na dokumentach z numerem.

Możesz też dodać **Numer dokumentu** i **Data dokumentu** do pola **Dane pod tytułem** w bloku **Nagłówek** albo użyć **Numer dokumentu** jako treści kodowanej przez blok **Kod kreskowy / QR**.

## W kodzie

| Zmienna | Co to jest |
| - | - |
| `{{ document_number }}` | Numer dokumentu. Pusta, gdy dokument nie ma numeru. |
| `{{ document_issued_at }}` | Kiedy numer został nadany. Pusta, gdy dokument nie ma numeru. Sformatuj ją za pomocą `date`. |
| `{{ document_date }}` | Data dokumentu, zawsze ustawiona: dzień nadania numeru, a w przeciwnym razie data zamówienia (dla faktury korygującej data zwrotu). Używaj jej jako daty faktury. Sformatuj ją za pomocą `date`. |
| `{{ document_voided }}` | Prawda, gdy dokument został anulowany. Jego numer pozostaje wykorzystany i nigdy nie zostanie nadany ponownie. |
| `{{ document_kind }}` | `invoice`, `credit_note` lub `quote`; pusta, gdy szablon nie jest numerowany. |

Drukuj numer tylko wtedy, gdy istnieje:

```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` drukuje „Data faktury” w języku dokumentu; dla pozostałych typów użyj `document_date.credit_note` lub `document_date.quote`.

## Data faktury

Data faktury to dzień jej wystawienia, czyli dzień nadania numeru. To nie jest data zamówienia ani dzisiejsza data, która zmienia się przy każdym ponownym drukowaniu. `{{ document_date }}` podaje właśnie tę datę:

* Na dokumencie z numerem to dzień nadania numeru, w strefie czasowej Twojego sklepu. Ponowne wydrukowanie dokumentu w przyszłym miesiącu jej nie zmienia.
* Na dokumencie bez numeru to data zamówienia. Dla zamówień zaimportowanych z innych źródeł to data przetworzenia zamówienia. Faktura korygująca używa daty swojego zwrotu.

Dzięki temu jeden szablon działa niezależnie od tego, czy numeracja jest włączona. Wbudowane szablony faktury, faktury korygującej i oferty już ją drukują, z etykietą „Data faktury”, „Data faktury korygującej” lub „Data oferty”. Jeśli Twój własny szablon drukuje jako datę `'now' | date`, zastąp to przez `{{ document_date | date: '%d %B %Y' }}`.

## Jeśli Twój szablon nie drukuje numeru

Gdy szablon dokumentu z numerem nigdzie nie używa `document_number`, Foliant dodaje na końcu krótki wiersz z numerem i datą jego nadania, np. „Numer faktury: INV-0042 · 4 października 2026”, żeby numeru nigdy nie zabrakło. Dodaj `{{ document_number }}` tam, gdzie chcesz, a dodatkowy wiersz zniknie. Jeśli Twój szablon już drukuje `document_date` lub `document_issued_at`, wiersz pokazuje tylko numer.

## Warto wiedzieć

* Dokument dostaje numer przy pierwszym pobraniu, wydruku lub eksporcie i zachowuje go.
* Podgląd w edytorze pokazuje numer, który dostanie Twój następny dokument, bez jego wykorzystywania.
* Kod kreskowy numeru: `{{ document_number | barcode }}`. Zobacz [Kody kreskowe i kody QR](https://foliant-help.iforiti.com/pl/template-editor/liquid-barcodes-and-qr-codes.md).
* Szablony dla wszystkich zaznaczonych zamówień nigdy nie są numerowane.

## Powiązane artykuły

* [Skonfiguruj numerację dokumentów](https://foliant-help.iforiti.com/pl/invoices-and-numbering/document-numbering.md)
* [Przegląd bloków](https://foliant-help.iforiti.com/pl/template-editor/block-catalogue.md)
* [Kody kreskowe i kody QR](https://foliant-help.iforiti.com/pl/template-editor/liquid-barcodes-and-qr-codes.md)
* [Daty, języki i tłumaczenia](https://foliant-help.iforiti.com/pl/template-editor/liquid-dates-and-languages.md)


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