Modyfikacja faktury w WooCommerce: co można zmienić i jak zrobić to bezpiecznie

Na fakturze WooCommerce można zmienić wygląd, treść, widoczne dane i reguły generowania, jeśli pozwala na to używana wtyczka. Wtyczki różnią się zakresem, dlatego przed pracą sprawdź ich nazwę, wersję i dokumentację.

Zmiany wyglądu obejmują logo, kolory, marginesy, kolejność sekcji i szerokości kolumn. Zmiany treści dotyczą między innymi nagłówka, stopki i uwag. Zmiany danych dotyczą nazwy firmy, NIP, adresu, pozycji produktów, rabatu, dostawy, podatku i numeru dokumentu.

WooCommerce PDF Invoices pozwala kopiować szablon PDF do katalogu motywu i zmieniać układ oraz pola. Dokumentacja wtyczki wskazuje ścieżkę `wp-content/themes/YOUR_THEME/pdf_templates/template.php` oraz ograniczenia CSS wynikające z użycia DOMPDF. Podane możliwości dotyczą tej wtyczki, nie każdego generatora faktur.

Faktura, korekta, pro forma i dokument wysyłkowy mogą mieć odrębne szablony lub reguły. Zmianę formalnej treści dokumentu skonsultuj z księgowością.

Tabela rozdziela zmiany wizualne od zmian w danych i obiegu dokumentów.

Ustawienie wtyczki wystarczy, gdy zmiana dotyczy funkcji dostępnej w jej panelu; kod jest potrzebny, gdy trzeba pobrać własne dane lub zmienić logikę dokumentu. Zacznij od konfiguracji, a potem dobierz rozwiązanie do brakującej funkcji.

WooCommerce PDF Invoices opisuje kopiowanie szablonu do katalogu motywu. Inne wtyczki mogą stosować odmienny mechanizm nadpisywania, więc przed implementacją potwierdź procedurę w dokumentacji producenta.

Nie zmieniaj plików wtyczki bezpośrednio, bo jej aktualizacja może usunąć kod. Jeśli plan obejmuje przekazywanie faktur między sklepem a systemem księgowym, ustal właściciela dokumentu i mapowanie danych; informacje o KSeF w Subiekcie GT pomogą ocenić ten wariant obiegu.

Każde pole faktury powinno wskazywać konkretne źródło danych i sposób obsługi pustej wartości. Nazwa firmy może pochodzić z danych rozliczeniowych, a NIP z osobnego pola dodanego przez wtyczkę checkoutu.

1. Ustal źródło prawdy: zamówienie WooCommerce, wtyczka fakturowa albo system zewnętrzny.
2. Odczytaj klucz metadanych dla firmy, NIP i pozostałych własnych pól, a następnie potwierdź wartość na zamówieniu testowym.
3. Zapisz mapowanie nabywcy, adresu, produktów, ilości, rabatu, wysyłki, stawek podatku, sum i numeru dokumentu.
4. Ustal zachowanie dla pustego pola. Szablon powinien pominąć pustą etykietę albo pokazać uzgodniony komunikat, zamiast technicznego `null`.
5. Porównaj PDF z zamówieniem testowym dla nabywcy firmowego i konsumenckiego.

WooCommerce PDF Invoices udostępnia placeholdery oraz mechanizmy rozszerzania szablonu. Nazwy placeholderów i hooków są zależne od wtyczki i wersji, dlatego nie przenoś kodu między generatorami bez sprawdzenia dokumentacji.

Przy zamówieniu firmowym sprawdź nazwę firmy, NIP i adres. Przy konsumenckim potwierdź, że brak danych firmy nie tworzy pustej sekcji. Zweryfikuj też oddzielne adresy dostawy i rozliczeniowy oraz to, czy zmiana zamówienia nie modyfikuje dokumentu historycznego w sposób sprzeczny z ustalonym obiegiem.

Bezpieczną modyfikację przygotuj na kopii sklepu, zapisz w kontroli wersji i utrzymuj poza plikami wtyczki. Środowisko testowe pozwala porównać PDF przed zmianą i po niej bez ingerencji w bieżące zamówienia.

Przed rozpoczęciem zachowaj kopię konfiguracji i przykładowy PDF. Zanotuj wersje WooCommerce, WordPressa, PHP, motywu i wtyczki fakturowej. Zmieniaj jedną grupę elementów naraz, żeby łatwiej wskazać źródło błędu.

Dla WooCommerce PDF Invoices szablon znajduje się po skopiowaniu w `wp-content/themes/YOUR_THEME/pdf_templates/template.php`. Umieść go w obsługiwanym katalogu motywu potomnego, a nie w katalogu nadrzędnego motywu, który aktualizacja może zastąpić. Inny generator może udostępniać własną ścieżkę.

HTML w PDF nie zachowuje się tak samo jak w przeglądarce. Dokumentacja WooCommerce PDF Invoices wskazuje ograniczenia CSS biblioteki DOMPDF. Sprawdź łamanie stron, tabele, długie nazwy, polskie znaki i czcionki w gotowym pliku PDF.

W repozytorium przechowuj własny szablon i kod integracji, ale nie umieszczaj danych klientów, sekretów ani produkcyjnych faktur. Przygotuj możliwość wycofania zmiany przez przywrócenie poprzedniego szablonu i konfiguracji.

Po aktualizacji WooCommerce, motywu lub wtyczki fakturowej ponownie sprawdź pola i generowanie PDF na środowisku testowym. Zachowanie pliku szablonu nie potwierdza, że wtyczka nadal udostępnia te same dane.

Przed aktualizacją produkcji sprawdź changelog producenta, szczególnie zmiany szablonów, placeholderów, hooków i wymagań PHP. Aktualizację najpierw odtwórz na stagingu i wygeneruj testowe dokumenty.

Edytor witryny WordPress zmienia szablony stron sklepu, a nie szablon PDF faktury. Dokument PDF modyfikuj przez konfigurację lub API generatora dokumentów.

Przed wdrożeniem wygeneruj PDF-y dla zamówień obejmujących różne dane, kwoty i typy dokumentów. Każdy przypadek powinien mieć kryterium, które da się porównać z zapisanym zamówieniem.

WooCommerce PDF Invoices opisuje generowanie dokumentu dla opłaconego lub zrealizowanego zamówienia oraz pobieranie go przez klienta. Konkretna ścieżka w panelu zależy od wersji wtyczki, dlatego sprawdź instrukcję przypisaną do zainstalowanego produktu.

Porównaj numer zamówienia i dokumentu, datę, nabywcę, pozycje, podatki, rabaty, dostawę i sumy. Sprawdź również pobieranie PDF przez klienta i załącznik e-mail, jeśli sklep wysyła dokument automatycznie. Gdy plik jest pusty albo generator go nie tworzy, sprawdź logi PHP, uprawnienia zapisu oraz zgodność wersji wtyczki i szablonu.

Najczęstsze błędy wynikają z błędnego źródła danych, konfliktu dodatków albo zmian w szablonie. Pusty NIP może oznaczać nieprawidłowy klucz metadanych, a zdublowane pole może być dodawane jednocześnie przez konfigurację i własny kod.

Przy niezgodnych kwotach porównaj PDF z podsumowaniem zamówienia, w tym rabat, wysyłkę, podatki i zaokrąglenia. Nie poprawiaj obliczeń w szablonie bez sprawdzenia wartości źródłowych. Różnicę może powodować także niezgodność walut albo moment pobrania zamówienia przez integrację.

Rozjechany układ sprawdzaj na długim dokumencie i kolejnych stronach. Pusty PDF wymaga kontroli logów PHP, uprawnień zapisu, biblioteki PDF i zgodności szablonu. Brak polskich znaków wymaga sprawdzenia pliku czcionki, kodowania i tego, czy generator potrafi tę czcionkę odczytać.

Diagnozuj problem na kopii sklepu. Zapisz identyfikator zamówienia testowego, sprawdź metadane i logi, a konfliktujące dodatki wyłączaj pojedynczo na stagingu. Po każdej zmianie ponownie wygeneruj PDF.

Do wyceny przygotuj przykładowy PDF z danymi testowymi, listę zmian oraz nazwę i wersję wtyczki fakturowej. Opisz także warianty dokumentów, źródła danych i integracje, których dotyczy praca.

Przekaż wykonawcy:

• Wersje WordPressa, WooCommerce, PHP, motywu i wtyczki fakturowej.
• Przykładowy dokument z zaznaczonymi elementami do zmiany, bez niepotrzebnych danych klientów.
• Listę nowych pól, ich źródło i oczekiwane zachowanie, gdy pole jest puste.
• Rodzaje dokumentów i statusy zamówień, które mają uruchamiać generowanie.
• Przykłady zamówień firmowych, konsumenckich, z rabatem, podatkami i zwrotem.
• Opis integracji oraz systemu, który odpowiada za numerację i obieg dokumentu.

Poproś o osobne wskazanie zakresu analizy, implementacji i testów. Ustal sposób odbioru przez PDF-y dla umówionych przypadków, listę zmienionych plików i procedurę wycofania.

Perspektywa KC Mobile: przy pracy nad dokumentem najpierw sprawdzamy zapis zamówienia i źródło danych, a dopiero później układ PDF. Taka kolejność pomaga odróżnić błąd szablonu od problemu w obiegu danych.

Jeżeli faktury WooCommerce mają być przekazywane do Subiekta GT, zakres może obejmować także mapowanie zamówień i obieg dokumentów. Informacje o integracji Subiekta GT z KSeF pomogą ocenić, jak zaplanować ten proces. Osobna integracja Subiekta z WooCommerce opisuje usługę dopasowaną do przekazywania zamówień między systemami. Artykuł o konfiguracji faktur w WooCommerce pomaga uporządkować ustawienia generatora przed planowaniem zmian, a koszty faktur i integracji KSeF przedstawiają kwestie kosztowe.

• Zaawansowane filtry faktur WooCommerce: jak usprawnić pracę z dokumentami
• Wystawianie faktur do paragonów w sklepie internetowym: proces, wyjątki i kontrola
• Data sprzedaży na fakturze: jak ustalić ją w sklepie internetowym
• Jak wysłać klientowi fakturę e-mailem w Shoperze: instrukcja i kontrola ustawień