Numery dokumentów w szablonach

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

{% 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.
Szablony dla wszystkich zaznaczonych zamówień nigdy nie są numerowane.

Witamy

Pierwsze kroki

Drukowanie

Szablony

Edytor szablonów

Projekty

Dostarczanie plików PDF

Szablony e-maili

Konta klientów

Eksporty

Faktury i numeracja

Podatki i dane prawne

Integracje

Płatności i plany

Ustawienia

Rozwiązywanie problemów

Informacje prawne