Dane do faktury

• Dotyczy wersji 0.5.0
• Zaktualizowano 6.10.2026
• 6 min czytania

Ustawienia

Sekcja „Dane do faktury” w zakładce WooCommerceUstawieniaDocket:

• „Pola faktury w kasie” włącza moduł. Domyślnie włączony.
• „Treść przełącznika” to etykieta pola wyboru w kasie. Puste pole oznacza „Chcę fakturę na firmę”.
• „Klucz meta NIP” to klucz, pod którym NIP trafia do zamówienia i do konta klienta. Puste pole oznacza _billing_nip.
• „Klucz meta »chce fakturę«” to klucz znacznika yes albo no przy zamówieniu. Puste pole oznacza _docket_wants_invoice.

W kluczach meta zostają tylko litery, cyfry, podkreślnik i myślnik. Inne znaki Docket usuwa przy zapisie.

Kasa klasyczna

W sekcji danych rozliczeniowych pojawia się pole wyboru z treścią przełącznika, a pod nim „Nazwa firmy” i „NIP”. Oba pola są schowane, dopóki klient nie zaznaczy faktury. Po zaznaczeniu stają się wymagane. Bez JavaScriptu pola są po prostu widoczne, a formularz działa dalej.

Jeśli pole firmy jest wyłączone w ustawieniach WooCommerce, Docket dodaje je z powrotem. Bez nazwy firmy faktury nie da się wystawić.

Przy zaznaczonej fakturze kasa nie przyjmie zamówienia bez kompletu danych. Komunikaty błędów:

• „Podaj NIP, jeśli chcesz fakturę na firmę.”
• „Numer NIP jest nieprawidłowy. Sprawdź, czy nie ma literówki.”
• „Podaj nazwę firmy do faktury.”

NIP i walidacja

Docket sprawdza trzy rzeczy: czy NIP ma 10 cyfr, czy nie składa się z jednej powtórzonej cyfry i czy zgadza się suma kontrolna. Kreski, spacje i prefiks „PL” nie przeszkadzają, bo przed sprawdzeniem zostają same cyfry. Tak też NIP jest zapisywany. W panelu, w e-mailu i w „Moim koncie” Docket pokazuje go w zapisie 123-456-78-90.

Walidacja sprawdza poprawność numeru, a nie istnienie firmy. Docket nie łączy się z GUS ani z białą listą VAT.

Kasa blokowa

W bloku „Kasa” Docket dodaje pola dodatkowe WooCommerce w sekcji danych kontaktowych. Wymaga to WooCommerce 9.9 lub nowszego.

Gdy pole „Firma” w adresie jest widoczne, Docket korzysta z niego. Tego pola nie da się uczynić warunkowo wymaganym, więc brak nazwy firmy przy zaznaczonej fakturze zatrzymuje zamówienie dopiero przy składaniu. Klient widzi wtedy komunikat „Podaj nazwę firmy do faktury (pole „Firma” w adresie rozliczeniowym)”.

Po złożeniu zamówienia NIP i znacznik faktury trafiają pod klucze meta z ustawień, tak jak w kasie klasycznej. WooCommerce trzyma dodatkowo własną kopię pod kluczami _wc_other/docket/…. Jeśli klient odznaczy fakturę, NIP nie zostaje przy zamówieniu, nawet gdy przeglądarka odeśle wartość ukrytego pola.

Poprawka NIP-u w edycji zamówienia w panelu też trafia pod klucz z ustawień.

Gdzie widać dane

• Panel zamówienia: pod adresem rozliczeniowym, jako „NIP do faktury”.
• E-maile: w metadanych zamówienia, jako „NIP”.
• „Moje konto” i strona podziękowania: pod tabelą zamówienia.
• REST API: pola docket_nip (same cyfry), docket_wants_invoice (prawda albo fałsz) i docket_order_number.

Nazwa firmy zapisuje się w standardowym polu firmy adresu rozliczeniowego WooCommerce.

NIP w koncie klienta

Gdy zamówienie z fakturą składa zalogowany klient, Docket zapisuje NIP także przy jego koncie, pod tym samym kluczem meta. Przy następnym zakupie pole NIP jest już wypełnione. Zalogowany klient nie wpisuje więc NIP-u drugi raz, w obu rodzajach kasy.

W kasie blokowej pola kontaktowe WooCommerce pokazuje też w „Moim koncie”, w danych konta. Tam klient może poprawić zapamiętany NIP.

Współpraca z programem do faktur

Docket dane zbiera, fakturę wystawia program albo wtyczka fakturowa. Wystarczy, że czyta ona NIP z tego samego klucza meta.

1. Sprawdź w dokumentacji swojej wtyczki fakturowej, pod jakim kluczem szuka NIP-u. Domyślny _billing_nip odczytuje większość polskich wtyczek fakturowych i integracji.
2. Jeśli klucz jest inny, wpisz go w „Klucz meta NIP”.
3. Jeśli program czyta znacznik „chce fakturę”, ustaw też „Klucz meta »chce fakturę«”.
4. Złóż testowe zamówienie z fakturą i sprawdź, czy program widzi NIP.

Jeśli piszesz integrację sam, nie czytaj klucza meta bezpośrednio. Użyj metody Docket\Checkout\InvoiceFields::nip_of( $order ). Zwraca NIP niezależnie od rodzaju kasy i ustawionego klucza.

$nip = class_exists( '\Docket\Checkout\InvoiceFields' )
	? \Docket\Checkout\InvoiceFields::nip_of( $order )
	: '';

Filtr docket_order_nip pozwala zmienić zwracany NIP, na przykład dołożyć NIP ze starszego pola, z którego sklep korzystał przed Docket. Przykłady są w artykule dla deweloperów.

Współpraca z Vetted

Gdy działa wtyczka Vetted, a klient ma zatwierdzone konto firmowe, przełącznik faktury jest w kasie od razu zaznaczony, a NIP pochodzi z wniosku o konto firmowe. Docket nie wymaga Vetted. Bez niego podpowiedzią jest NIP zapamiętany przy koncie klienta.

Ostatnia zmiana: 6.10.2026, wersja 0.5.0Zgłoś błąd w tej stronie