Własna numeracja faktur: konfiguracja i pomoc

Prześlij i zainstaluj ZIP mprinvoicenumber w Moduły > "Module Manager". Kliknij Konfiguruj, aby otworzyć Numeracja faktur > Panel. W nowszych wersjach menu znajduje się w "Improve".

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.

Otwórz Ustawienia i sprawdź diagnostykę stanu nadpisań. Numeracja dokumentów dostawy oraz tytuły plików PDF dostaw i not kredytowych zależą od nadpisań zainstalowanych przez moduł:

override/classes/order/Order.php
override/classes/pdf/HTMLTemplateDeliverySlip.php
override/classes/pdf/HTMLTemplateOrderSlip.php

Użytkownik bazy danych potrzebuje uprawnień do utworzenia miejsca przechowywania liczników, numerów referencyjnych klientów i wygenerowanych numerów modułu. Przed testowaniem generowania dokumentów trzeba sprawdzić istniejące nadpisania tych samych metod.

Użyj sekcji Format faktury, Format dostawy i Format noty kredytowej. Każdy generator ma własny wzorzec, podgląd i ustawienia licznika. Zapisz wzorzec i ustawienia za pomocą odpowiednich przycisków.

W generatorze użyj "Document Abbreviation (Invoice)", "Document Abbreviation (Delivery)" lub "Document Abbreviation (Credit Slip)", aby zastąpić {DOC_TYPE}. Reset licznika i Ustaw następny numer dotyczą danego typu dokumentu. Pole następnego numeru jest domyślnie puste, a jego wartość jest używana jednorazowo podczas generowania odpowiedniego licznika.

Na przykład ustaw wzorzec faktury na {DOC_TYPE}/{YYYY}/{NNNNNN}, a pole Ustaw następny numer na 1000. Przy skrócie INV i dacie w 2026 roku następna wygenerowana wartość to INV/2026/001000, a kolejna INV/2026/001001, chyba że inny proces generowania zużyje numer.

Opcja Włącz niestandardową numerację ma domyślną wartość Tak. Wyłącz tę opcję, aby podczas jej wyłączenia używać standardowych ścieżek wyświetlania i generowania.

Karty ustawień to "Format", "Sequence" i "Reset Policy". Opcja Włącz niestandardową numerację i skróty znajdują się na karcie "Format". Udostępniają trzy wartości: "Invoice Abbreviation", "Delivery Abbreviation" i "Credit Slip Abbreviation"; pola "Next Number" dla poszczególnych dokumentów oraz "Invoice Counter Reset", "Delivery Counter Reset" i "Credit Slip Counter Reset". Wartości domyślne odpowiadają powyższej tabeli, a wartości następnego numeru są puste. Generatory formatów używają tych samych zapisanych opcji.

Numeracje faktur, dokumentów dostawy i not kredytowych są oddzielne. Wiersze liczników zawierają ID sklepu. Nie ma ustawienia jednej wspólnej numeracji dla wszystkich typów dokumentów.

Opcje resetowania i wymagane elementy daty to:

"Yearly" wymaga {YYYY} lub {YY}. "Monthly" wymaga także {MM}. Opcja Dzienny wymaga dodatkowo {DD}. Okresy resetowania korzystają z bieżącego czasu serwera/PHP, a znaczniki daty dokumentu preferują datę faktury, następnie datę noty kredytowej, a potem datę zamówienia, jeśli są dostępne. Dokładnie sprawdź dokumenty z datą wsteczną, gdy bieżący okres resetowania serwera różni się od daty dokumentu.

Obsługiwane znaczniki daty to {YYYY}, {YY}, {MM}, {DD}, {QUARTER} i {WEEK}. Znaczniki liczników obejmują od {N} do {NNNNNNNN} oraz odpowiadające im formy {GLOBAL_N...} i {CUSTOMER_N...}. Liczba znaków N określa uzupełnianie zerami; {number:5} nie jest obsługiwane.

Znaczniki kontekstu obejmują:

{DOC_TYPE} {ORDER_ID} {ORDER_REF} {INVOICE_ID}
{SHOP_ID} {SHOP_NAME} {CART_ID} {PAYMENT} {COUNTRY}
{CUSTOMER_ID} {CUSTOMER_EMAIL} {CUSTOMER_REF}
{PRODUCT_ID} {PRODUCT_REF}
{RAND2} {RAND4} {RAND6} {RAND7} {RAND8} {RAND9}

{CUSTOMER_EMAIL} zwraca część przed @. Znaczniki produktów używają produktu dominującego w koszyku wybranego przez mechanizm formatowania, a nie połączenia wszystkich produktów. {RAND2} zwraca litery, {RAND4} cyfry, a od {RAND6} do {RAND9} litery. Niedostępny kontekst może dać pustą wartość.

Aliasy zapisane małymi literami obejmują:

Wzorce wymagają co najmniej jednego licznika i wygenerowanego podglądu o długości najwyżej 255 znaków. Wzorce z licznikiem klienta muszą także zawierać obsługiwany element rozróżniający: {CUSTOMER_REF}, {CUSTOMER_ID}, {ORDER_REF}, {CART_ID} lub od {RAND6} do {RAND9}. Wzorzec bez tego wymaganego elementu jest odrzucany podczas zapisu i przed zużyciem wartości licznika podczas generowania. Sformatowany numer już użyty dla tego samego typu dokumentu nadal zostanie odrzucony.

Hook faktury pozostawia numer faktury zapisany w PrestaShop w standardowej postaci liczbowej. Moduł zapisuje osobny sformatowany ciąg znaków i udostępnia go przez actionInvoiceNumberFormatted. Integracja dostaw może zapisywać wygenerowany liczbowy licznik dostawy w order_invoice; nadpisania PDF dostarczają sformatowane tytuły dokumentów dostawy i not kredytowych.

Pliki PDF faktur mogą używać nazwy pliku utworzonej przez oczyszczenie sformatowanego numeru. Tytuły plików PDF dostaw i not kredytowych zależą od zainstalowanych nadpisań. Sprawdź używane ścieżki generowania PDF, ponieważ zewnętrzne eksportery i inne generatory dokumentów mogą korzystać bezpośrednio ze standardowych pól.

Instalacja pozostawia istniejące dokumenty bez zmian. Wyświetlanie faktury jedynie odczytuje jej zapisany sformatowany numer. Faktura bez wpisu w dzienniku modułu zachowuje standardowe formatowanie, także gdy jest starszą fakturą; jej wyświetlanie nie generuje numeru ani nie zużywa wartości licznika. Nowe niestandardowe numery faktur są przydzielane podczas tworzenia faktur. Istniejące wpisy dziennika są ponownie używane, więc zmiana wzorca nie generuje ponownie już zapisanych numerów.

Użyj sekcji Wygenerowane numery, aby sprawdzić typ dokumentu, identyfikatory zamówienia/dokumentu, sklep, licznik, wzorzec, sformatowany numer i czas. Panel pokazuje liczniki i ostatnie wpisy.

Na potrzeby integracji programistycznej można wywołać istniejący hook formatowania faktur:

$formatted = Hook::exec('actionInvoiceNumberFormatted', [
    'order_invoice' => $orderInvoice,
]);

Hook formatowania wykonuje wyłącznie odczyt. Zwraca zapisany sformatowany numer lub pusty ciąg dla faktury bez wpisu w dzienniku, aby kod wywołujący mógł zachować standardowe formatowanie.

1. Zapisz wszystkie trzy formaty i pozostaw włączoną niestandardową numerację.
2. Utwórz fakturę testową i sprawdź jej wyświetlanie, tytuł PDF, nazwę pliku i wpis w sekcji Wygenerowane numery.
3. Wygeneruj dokument dostawy i notę kredytową, a następnie sprawdź ich pliki PDF i oddzielne liczniki.
4. Otwórz starszą fakturę bez wpisu w dzienniku i potwierdź, że standardowe formatowanie oraz wartości liczników pozostają bez zmian.
5. Ponownie otwórz fakturę z wpisem w dzienniku i potwierdź ponowne użycie jej sformatowanego numeru.

Jeśli wzorzec nie przechodzi walidacji, sprawdź składnię licznika, wymagane znaczniki daty resetowania, nieznane znaczniki i długość podglądu. Jeśli tytuł dokumentu dostawy lub noty kredytowej pozostaje standardowy, sprawdź stan nadpisań i kolidujące modyfikacje PDF. Jeśli generowanie odrzuca duplikat, sprawdź wybrany wzorzec i ustawienie następnego numeru zamiast wymuszać ponowne użycie. Generowanie numerów może zużywać liczniki przed późniejszym błędem, pozostawiając luki w numeracji.

Przed odinstalowaniem wyeksportuj dziennik wygenerowanych numerów i zapisz wszystkie liczniki. Odinstalowanie usuwa konfigurację, preferencje administracyjne, menu i tabele należące do modułu. Uruchamia też standardowe odinstalowanie modułu dla hooków i nadpisań. Standardowe numery faktur pozostają w PrestaShop, ale sformatowane ciągi znaków przechowywane wyłącznie w dzienniku modułu zostają utracone i nie można ich już wyświetlać przez moduł. Użyj "Disable", jeśli chcesz zachować zainstalowany dziennik do późniejszego wykorzystania.