Faktury WooCommerce PRO – PEPPOL

Najważniejsze funkcje wtyczki

Wtyczka Peppol dla Faktur WooCommerce PRO rozszerza dokumenty sprzedaży o dane wymagane do przygotowania faktury elektronicznej w formacie UBL.

Najważniejsze funkcje wtyczki:

• dodaje pola Peppol ID , identyfikator schematu, referencję nabywcy i numer zamówienia do klasycznego oraz blokowego checkoutu WooCommerce,
• przenosi dane podane przez klienta do zamówienia i powiązanego dokumentu,
• umożliwia uzupełnienie lub zmianę danych Peppol sprzedawcy i nabywcy podczas edycji faktury,
• pozwala przypisać stawkę zwolnioną, powód zwolnienia oraz stawkę zerową,
• sprawdza, czy dokument zawiera dane wymagane do utworzenia pliku,
• generuje plik UBL XML na podstawie faktury wystawionej przez Faktury WooCommerce PRO i umożliwia jego pobranie z poziomu dokumentu.

Wtyczka może być przydatna przede wszystkim w sklepach realizujących sprzedaż B2B, w których kontrahenci przekazują identyfikator Peppol, numer zamówienia lub własną referencję. Ułatwia zebranie tych informacji już podczas składania zamówienia i wykorzystanie ich przy przygotowaniu faktury elektronicznej.

Do działania wymagane są WooCommerce i Faktury WooCommerce PRO oraz aktywna licencja umożliwiająca połączenie wtyczki z usługą generowania UBL.

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, Faktury WooCommerce PRO ≥ 5.3.6 oraz PHP ≥ 7.4. Dopiero wtedy interfejs Peppol się załaduje i skonfiguruje wszystkie potrzebne elementy.

Aktywacja subskrypcji

Faktury WooCommerce PRO – Peppol działa jako dodatek do Faktury 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

Faktury WooCommerce PRO – Peppol rozszerza interfejs Faktury 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:

1. Weryfikuje uprawnienia osoby generującej UBL (manage_woocommerce)
2. Pobiera dokument, dane sprzedawcy/klienta oraz ustawienia (w tym stawki VAT i powody zwolnień)
3. Wysyła dane do zewnętrznego API (/api/xml) i otrzymuje gotowy plik XML
4. 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.