Spis treści
Instalacja
Wtyczkę dodaj do katalogu wp-content/plugins/, aktywuj w panelu WordPressa i upewnij się, że spełnione są wymagania: WordPress ≥ 6.2, WooCommerce ≥ 8.0, Flexible Invoices for WooCommerce PRO ≥ 5.3.6 oraz PHP ≥ 7.4. Dopiero wtedy interfejs Peppol się załaduje i skonfiguruje wszystkie potrzebne elementy.
Aktywacja subskrypcji
Peppol for Flexible Invoices działa jako dodatek do Flexible Invoices for WooCommerce PRO, więc aktywuj licencję tej wtyczki w ustawieniach Faktury. W przeciwnym razie nie zostaną udostępnione pola konieczne do eksportu danych Peppol (ustawienia, metabox, generowanie UBL).
Aktualizacja
Aktualizuj jak każdy plugin WordPressa (przez panel lub przez FTP). Po aktualizacji wejdź na stronę Faktury > Peppol i upewnij się, że dane sprzedawcy, schematy i stawki nadal są widoczne — interfejs automatycznie odczytuje zapisane wartości z opcji.
Ważne informacje
Peppol for Flexible Invoices rozszerza interfejs Flexible Invoices for WooCommerce PRO i wykorzystuje połączenie z usługą https://peppol.wpdesk.pl/api/xml do generowania plików UBL. Dlatego serwer musi mieć dostęp do internetu, a dane Peppol (ID, schematy, stawki) muszą być wprowadzone poprawnie w ustawieniach.
Pierwsze uruchomienie
Po aktywacji pod menu Faktury pojawia się nowa podstrona „Peppol”. Wypełnij tam:
- Peppol ID sprzedawcy (tekst)
- Peppol Scheme ID sprzedawcy (lista kodów)
- Stawkę zwolnioną (select) i powód zwolnienia (textarea) opartą o stawki podatkowe WooCommerce
- 0% rate (select) – wybierz odpowiednią stawkę 0%
Zapisane dane służą jako domyślne wartości podczas edycji dowolnego dokumentu.
Metabox Peppol na dokumentach
W edycji faktury (Rodzaj dokumentu: inspire_invoice) pojawia się metabox Peppol z trzema sekcjami:
- Seller – podgląd i edycja Peppol ID + schematu sprzedawcy
- Customer – pola buyer reference, PO number, Peppol ID i schemat klienta. Dane wypełniane są automatycznie, jeśli wcześniej dodano je w checkoutcie (pola Peppol ID, Scheme ID, buyer reference, PO number trafiają do meta
_wc_billing/fi_peppol/...). Można nadpisać ręcznie - Document – pole „Exempt reason” pozwala określić powód zwolnienia podatkowego na poziomie dokumentu
Jeśli nie zapiszesz dokumentu po zmianie danych, pojawi się ostrzeżenie „Data has been changed, please save changes to update data”, a przycisk pobierania UBL pozostanie nieaktywny do czasu zapisu.
Generowanie UBL
Przycisk „Download UBL” widoczny w metaboxie uruchamia AJAX, który:
- Weryfikuje uprawnienia osoby generującej UBL (
manage_woocommerce) - Pobiera dokument, dane sprzedawcy/klienta oraz ustawienia (w tym stawki VAT i powody zwolnień)
- Wysyła dane do zewnętrznego API (
/api/xml) i otrzymuje gotowy plik XML - Tworzy Blob w przeglądarce i automatycznie rozpoczyna pobranie oraz pokazuje komunikat o sukcesie lub błędzie (np. brak połączenia, niepoprawna odpowiedź)
Checkout i dodatkowe pola
W obu wersjach checkoutu WooCommerce (blokowy i shortcode) automatycznie dodawane są pola:
- Peppol ID
- Scheme ID (lista schematów z Peppol)
- Buyer Reference
- PO Number
Po zapisaniu zamówienia dane trafiają do meta _wc_billing/fi_peppol/..., skąd są automatycznie pobierane do metaboxa podczas edycji faktury. Jeśli korzystasz z niestandardowego checkoutu, upewnij się, że te pola nadal zapisują się do tych meta, aby eksport UBL miał komplet danych.
Kolumny i widoczność
Metadane Peppol (ID, schematy, buyer reference, PO number, powód zwolnienia) można dopisać do kolumn listy faktur przez opcje ekranu w Faktury > Wszystkie faktury. Wybierz interesujące kolumny, aby szybko sprawdzać status danych Peppol bez otwierania dokumentu.