Piotr Dejneka
Dokumentacja wtyczki

Numeracja zamówień

  • Dotyczy wersji 0.5.0
  • Zaktualizowano 1.10.2026
  • 5 min czytania
Na tej stronie
    W skrócie

    Docket nadaje każdemu nowemu zamówieniu własny, ciągły numer, na przykład 2026/00042. Numer powstaje raz i się nie zmienia. Widać go w panelu, w e-mailach, w „Moim koncie” i w REST API. Wcześniejsze zamówienia zachowują swoje numery.

    Po co osobna numeracja

    WooCommerce pokazuje jako numer zamówienia jego identyfikator w bazie. Ten licznik jest wspólny z innymi wpisami, więc numery mają luki. Docket prowadzi osobny licznik w małej tabeli bazy danych i pobiera kolejną wartość jedną operacją. Dwa zamówienia złożone w tej samej chwili nie dostaną tego samego numeru, także przy włączonym object cache.

    Ustawienia

    Sekcja „Numeracja zamówień” jest pierwsza w zakładce WooCommerceUstawieniaDocket. Pod nagłówkiem widzisz zdanie „Następne zamówienie otrzyma numer:” z podglądem. Podgląd nie zwiększa licznika.

    Ilustracja: sekcja numeracji z wartościami domyślnymi.

    Format numeru i znaczniki

    Pole „Format numeru” przyjmuje dowolny tekst i trzy znaczniki:

    ZnacznikZamienia się naPrzykład
    {rok}rok, czterema cyframi2026
    {miesiac}miesiąc, dwiema cyframi03
    {numer}wartość licznika uzupełniona zerami00042

    Kilka przykładów przy długości 5:

    • {rok}/{numer} daje 2026/00042 (domyślnie).
    • ZAM/{rok}/{numer} daje ZAM/2026/00042.
    • {rok}/{miesiac}/{numer} daje 2026/03/00042.

    Rok i miesiąc pochodzą z daty nadania numeru, w strefie czasowej ustawionej w WordPressie.

    Długość numeru

    „Długość numeru” to liczba cyfr znacznika {numer}. Krótszą wartość Docket uzupełnia zerami z lewej. Pole przyjmuje wartości od 1 do 10, domyślnie 5. Jeśli licznik przekroczy tę długość, numer po prostu się wydłuży.

    Zerowanie licznika

    „Zerowanie licznika” ma trzy opcje:

    • „Co rok” (domyślnie). Każdy rok ma własny licznik.
    • „Co miesiąc”. Każdy miesiąc ma własny licznik.
    • „Nigdy (jeden licznik)”. Jeden licznik na zawsze.
    Format musi pasować do zerowania

    Przy zerowaniu co miesiąc format powinien zawierać {rok} i {miesiac}. Przy zerowaniu co rok potrzebny jest co najmniej {rok}. Bez tego numery z różnych okresów będą się powtarzać.

    Zmiana sposobu zerowania w trakcie roku uruchamia inny licznik. Na przykład przejście z „Co rok” na „Nigdy (jeden licznik)” zacznie liczyć od numeru początkowego. Jeśli format nie zawiera wtedy daty, numery mogą się powtórzyć. Rób taką zmianę na początku okresu albo razem ze zmianą prefiksu.

    Numer początkowy

    „Numer początkowy” przydaje się przy przenosinach sklepu. Licznik w bieżącym okresie nie zejdzie poniżej tej wartości. Jeśli w starym systemie ostatnie zamówienie w tym roku miało numer 1250, wpisz 1251.

    Numer początkowy działa w każdym nowym okresie

    Licznik nowego roku albo miesiąca startuje od wartości „Numer początkowy”. Po pierwszym zerowaniu wróć do wartości 1, jeśli chcesz liczyć od początku.

    Gdzie widać numer

    Docket podstawia swój numer wszędzie, gdzie WooCommerce pokazuje numer zamówienia: na liście zamówień i w edycji zamówienia, w e-mailach, na stronie podziękowania i w „Moim koncie”. Integracje dostają go przez standardową metodę get_order_number(). Gdy włączony jest moduł danych do faktury, odpowiedź REST API zamówienia ma też pole docket_order_number.

    Numer jest zapisany przy zamówieniu w metadanej _docket_order_number, a sama wartość licznika w _docket_order_seq. Numer nadawany jest raz, przy utworzeniu zamówienia. Ponowny zapis zamówienia ani późniejsza zmiana formatu go nie zmieniają.

    Wyszukiwanie

    W wyszukiwarce na liście zamówień wpisz numer w formacie Docket, na przykład 2026/00042. Docket dodaje swój klucz do pól przeszukiwanych przez WooCommerce, zarówno przy tabelach zamówień (HPOS), jak i przy zapisie zamówień jako wpisów.

    Co z istniejącymi zamówieniami

    Docket nie przenumerowuje starych zamówień. Zamówienia sprzed włączenia modułu zachowują dotychczasowe numery, czyli identyfikatory WooCommerce. Nowa numeracja obowiązuje od pierwszego zamówienia po włączeniu.

    Zmiana formatu w działającym sklepie dotyczy tylko kolejnych zamówień. Nadane numery zostają bez zmian.

    Wyłączenie modułu

    Po odznaczeniu „Włącz numerację” Docket przestaje nadawać nowe numery. Nowe zamówienia dostają wtedy numery WooCommerce. Numery nadane wcześniej dalej są widoczne i dalej da się po nich szukać, bo klient zna je z e-maila. Licznik zostaje w bazie. Po ponownym włączeniu numeracja wraca do miejsca, w którym się zatrzymała.

    Najpierw format, potem sprzedaż

    Ustaw format, długość i zerowanie przed pierwszym zamówieniem. Późniejsze zmiany są możliwe, ale w księgowości lepiej wyglądają numery w jednym formacie przez cały rok.

    Czy ta strona pomogła?

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