Factur-X: kompletny przewodnik (PrestaShop 8 i 9)

Ten przewodnik opisuje instalację, konfigurację i użycie modułu DataFirefly Factur-X (dffacturx) 2.0.0 dla PrestaShop 8 i 9. Moduł zamienia natywne faktury i faktury korygujące PrestaShop w faktury elektroniczne Factur-X: czytelny i drukowalny PDF/A-3, który zawiera XML CII zgodny z normą EN 16931. Każdy dokument jest sprawdzany zaraz po wygenerowaniu i ma własny raport zgodności.

Prezentacja

Faktura Factur-X to jeden plik. Twój klient otwiera zwykły PDF, a jego program księgowy lub platforma odczytuje osadzony XML. Moduł:

• renderuje natywną fakturę i fakturę korygującą PrestaShop do PDF/A-3b, z Twoim szablonem i modułami, które modyfikują fakturę, oraz osadza w nich plik factur-x.xml;
• buduje XML na podstawie kwot z faktury, w wybranym profilu: MINIMUM, BASIC WL, BASIC, EN 16931 lub EXTENDED;
• dodaje dane i adnotacje francuskiej reformy 2026/2027, w XML i na PDF;
• sprawdza każdy dokument i wyświetla raport zgodności;
• udostępnia dokumenty na koncie klienta i w e-mailach oraz przygotowuje eksporty ZIP (PDF, CII, UBL 2.1, pakiet dla akredytowanej platformy).

Wymagania

• PrestaShop 8.0 do 9.x (testowany na 9.1.5 i 8.2.1, motywy Classic i Hummingbird).
• PHP minimum 7.4, zalecane 8.1 lub nowsze.
• Rozszerzenia PHP dom, libxml i zlib; zip dla eksportów ZIP.
• Brak zależności zewnętrznych: bez Composera, bez Javy. Używany jest TCPDF dostarczany z PrestaShop.

Instalacja i aktualizacja

1. W panelu administracyjnym otwórz Moduły > Menedżer modułów i kliknij Załaduj moduł.
2. Prześlij plik dffacturx-2.0.0.zip.
3. Otwórz Zamówienia > Factur-X. Dopóki konfiguracja nie jest zakończona, pulpit proponuje asystenta konfiguracji.

Podczas instalacji nazwa firmy, adres, telefon i e-mail są pobierane z danych kontaktowych sklepu, a kody form płatności są wykrywane dla zainstalowanych modułów płatności.

Aktualizacja z wersji 1.0.0: zainstaluj plik zip 2.0.0 na istniejącą wersję. Twoje ustawienia zostają zachowane, tworzona jest tabela dokumentów, a stary katalog generated/ zostaje zamknięty dla dostępu z sieci (bez usuwania plików). Jeśli numer SIREN był już uzupełniony, asystent jest uznawany za zakończony; mimo to otwórz jego kroki, aby sprawdzić nowe ustawienia.

Asystent konfiguracji

Asystent znajduje się w Zamówienia > Factur-X > Ustawienia. Ma pięć kroków; każde pole jest sprawdzane przy zapisie. W trybie multisklepu konfiguracja odbywa się osobno dla każdego sklepu.

1. Firma

• Nazwa firmy, forma prawna, kapitał zakładowy i RCS (francuski rejestr handlowy): przenoszone do noty prawnej w XML.
• SIREN (francuski numer identyfikacyjny firmy, 9 cyfr) i SIRET (numer zakładu, 14 cyfr): sprawdzana jest cyfra kontrolna. SIREN jest przekazywany z identyfikatorem schematu 0002, SIRET z 0009.
• Numer VAT UE: sprawdzany jest klucz FR, a numer jest proponowany na podstawie SIREN.
• Adres do fakturowania elektronicznego (katalog adresów reformy): domyślnie SIREN.
• Adres, osoba kontaktowa, telefon i e-mail.

2. Profil

Profil określa zawartość XML:

• EN 16931 (zalecany): pełna podstawa normy europejskiej.
• EXTENDED: dane dodatkowe, podstawy zwolnienia powtarzane w pozycjach.
• BASIC: pozycje faktury, bez osoby kontaktowej i zaokrąglenia.
• MINIMUM i BASIC WL: bez pozycji. Nie stanowią pełnej faktury w rozumieniu reformy; asystent to sygnalizuje.

Opcja Numer faktury akceptowany przez francuskie przepisy usuwa z numeru elektronicznego znaki, których francuskie przepisy nie akceptują (na przykład #). Faktury nie są przenumerowywane: PDF podaje wtedy numer elektroniczny.

3. VAT

Moduł automatycznie przypisuje kategorię VAT do każdej pozycji:

• S: stawka dodatnia;
• G: eksport poza Unię Europejską (lub O dla faktury za usługi);
• K: wewnątrzwspólnotowa dostawa towarów dla klienta z numerem VAT; AE dla usług (odwrotne obciążenie);
• E: zwolnienie, z podstawą VATEX-FR-FRANCHISE, jeśli korzystasz ze zwolnienia podmiotowego z VAT dla małych firm (franchise en base).

W przypadku szczególnym dla Twojej działalności przypisz kategorię i kod VATEX do reguły podatkowej. Domyślne podstawy zwolnienia to francuskie teksty prawne, które można edytować.

4. Płatność

• IBAN i BIC: obowiązkowe przy płatności przelewem; IBAN jest sprawdzany.
• Termin płatności: służy do obliczenia terminu zapłaty nieopłaconych faktur.
• Adnotacje: kary za opóźnienie w płatności (PMD), zryczałtowana opłata windykacyjna 40 € (PMT), skonto za wcześniejszą płatność (AAB).
• Opcja zapłaty VAT według debetów (francuska opcja rozliczania VAT w momencie wystawienia faktury), jeśli ją wybrałeś.
• Kod formy płatności dla każdego modułu płatności (UNTDID 4461): wykrywany automatycznie, można go zmienić.

Dla faktury już opłaconej XML podaje zapłaconą kwotę, kwotę do zapłaty równą zero i datę płatności.

5. Dystrybucja

• Generuj automatycznie: dokument jest tworzony przy każdej nowej fakturze i każdej nowej fakturze korygującej.
• Natywne faktury w formacie Factur-X (PrestaShop 9): pliki PDF faktur i faktur korygujących w panelu administracyjnym, na koncie klienta i w e-mailach stają się plikami Factur-X. Zbiorcze eksporty wielu faktur pozostają plikami PDF/A-3 bez XML, a dowody dostawy się nie zmieniają.
• Factur-X w e-mailach: faktura dołączana do e-maili PrestaShop jest zastępowana jej wersją Factur-X.
• Pobieranie na koncie klienta: blok w szczegółach zamówienia i strona „Moje faktury elektroniczne”.
• Nowe adnotacje na fakturze PDF: kategoria transakcji, SIREN klienta, podstawy zwolnienia, faktura pierwotna dla faktury korygującej.

Pulpit

Pulpit pokazuje liczbę dokumentów wygenerowanych, zgodnych, z ostrzeżeniami, z błędami, niewygenerowanych i wyeksportowanych. Przycisk Wygeneruj brakujące dokumenty przetwarza faktury i faktury korygujące partiami, z paskiem postępu. Znajdziesz tam też najnowsze dokumenty, wskaźnik gotowości na reformę i kalendarz.

Dokumenty i eksporty

Strona Dokumenty wyświetla faktury i faktury korygujące z ich profilem, kategoriami VAT i statusem. Możesz szukać po numerze lub kliencie, filtrować według zgodności, typu, okresu lub stanu eksportu, a następnie zaznaczyć dokumenty, aby:

• pobrać ZIP z plikami PDF Factur-X, XML CII lub XML UBL 2.1;
• przygotować pakiet dla akredytowanej platformy: pliki PDF, plik index.csv i plik SHA256SUMS. Dokumenty są oznaczane jako wyeksportowane; wysyłka do platformy pozostaje po Twojej stronie;
• wygenerować dokumenty ponownie, na przykład po poprawieniu ustawień.

Raport zgodności

Każdy dokument ma swój raport. Kontrole są podzielone na błędy, ostrzeżenia i informacje, z kodem odpowiedniej reguły (BR-…, BR-FR-…). Raport szczegółowo przedstawia pozycje, zestawienie VAT oraz sumy BT-106 do BT-115, porównane z sumą faktury PrestaShop.

Osadzony XML jest wyświetlany w kolorze i można go skopiować.

Wbudowana kontrola sprawdza schemat XSD Factur-X 1.09.2 danego profilu, kluczowe reguły EN 16931 (sumy, zestawienie, kategorie, płatność) oraz kontrole francuskie. Dokument z błędami nigdy nie jest udostępniany klientowi ani włączany do natywnego PDF.

Panel na stronie zamówienia

Na każdym zamówieniu panel Factur-X wyświetla faktury i faktury korygujące z ich statusem oraz przyciskami PDF, CII, UBL i raportu. Jeśli zamówienie zostało zmienione po wygenerowaniu, alert proponuje ponowne wygenerowanie dokumentu.

Faktura PDF/A-3

PDF to Twoja natywna faktura PrestaShop, renderowana do PDF/A-3b, z osadzonym XML i metadanymi XMP Factur-X. Potrzebne adnotacje reformy są dodawane na dole faktury przez hooki PDF PrestaShop, bez zmiany Twoich szablonów. Jeśli aktywny jest moduł DataFirefly Invoice Editor, jego układ zostaje zachowany.

Konto klienta i e-maile

Gdy faktura jest widoczna dla klienta (ta sama reguła co w PrestaShop: status zamówienia z fakturą), klient pobiera ją w formacie Factur-X ze szczegółów swojego zamówienia lub ze strony Moje faktury elektroniczne, razem z XML. Moduł sprawdza, czy dokument należy do zalogowanego klienta.

Walidacja przed wdrożeniem produkcyjnym

Wygeneruj kilka faktur reprezentatywnych dla Twojej działalności (kilka stawek VAT, rabat, klient firmowy, klient zagraniczny, faktura korygująca), a następnie sprawdź je oficjalnymi walidatorami:

• usługą walidacji FNFE-MPE lub Mustang, dla XML i reguł francuskich;
• veraPDF, dla zgodności z PDF/A-3.

Przycisk CII w panelu zamówienia pobiera sam XML, co jest wygodne na tym etapie.

Reforma 2026/2027: co robi moduł

We Francji wszystkie firmy podlegające VAT muszą być w stanie odbierać faktury elektroniczne od 1 września 2026. Wystawianie staje się obowiązkowe od tej daty dla dużych firm i ETI (średnich przedsiębiorstw), a od 1 września 2027 dla MŚP i mikroprzedsiębiorstw.

• Tworzenie i sprawdzanie faktur Factur-X z danymi reformy: to rola modułu. Żadna certyfikacja nie jest wymagana.
• Przesyłanie faktur i e-reporting: to rola wybranej przez Ciebie akredytowanej platformy. Moduł przygotowuje pliki i pakiet eksportu; niczego nie wysyła.

Strona Reforma 2026/2027 modułu przedstawia kalendarz, profile, walidatory i FAQ.

Rozwiązywanie problemów

Dokument ma błędy

Otwórz jego raport: każdy błąd wskazuje regułę i dane, których dotyczy. Najczęstsze przyczyny to brak numeru SIREN lub numeru VAT, brak IBAN przy płatności przelewem lub niepełny adres klienta. Popraw ustawienie lub dane, a następnie wygeneruj dokument ponownie.

Ostrzeżenie dotyczące opłaty ekologicznej

Gdy funkcja ekopodatku jest wyłączona w PrestaShop, opłata ekologiczna (éco-participation) pozostaje w cenie pozycji, ale nie w sumach zamówienia. XML odpowiada faktycznie zafakturowanej sumie, a raport to sygnalizuje. Sprawdź ustawienia ekopodatku i powiązaną regułę podatkową.

Faktura nie pojawia się na koncie klienta

Klient widzi swoje faktury, gdy status zamówienia dopuszcza fakturę, tak jak w PrestaShop. Sprawdź też opcję konta klienta w kroku Dystrybucja oraz czy dokument nie ma błędów.

Eksporty ZIP są niedostępne

Rozszerzenie PHP zip nie jest włączone na serwerze. Pobieranie pojedynczych plików pozostaje dostępne.

Na fakturze brakuje logo

PrestaShop ładuje logo faktury przez adres URL sklepu. Jeśli serwer nie może połączyć się z własnym adresem URL, logo brakuje również na fakturach natywnych; problem wynika wtedy z konfiguracji serwera, nie z modułu.

Changelog

2.0.0 (2 listopada 2026)

• XML CII napisany od nowa: przestrzenie nazw, kolejność schematu i zawartość właściwa dla każdego profilu.
• Natywna faktura i faktura korygująca PrestaShop renderowane do PDF/A-3b, poprawione metadane XMP.
• Kwoty pobierane z faktury PrestaShop: rabaty według stawki, wysyłka, pakowanie, opłata ekologiczna, zaokrąglenia.
• Kategorie VAT S, Z, E, AE, K, G, O z podstawami zwolnienia; faktury korygujące (typ 381); faktury w walucie obcej.
• Dane i adnotacje francuskiej reformy w XML i na PDF.
• Wbudowana kontrola i raport zgodności dla każdego dokumentu.
• Nowy panel administracyjny: pulpit, dokumenty, asystent, pomoc dotycząca reformy, panel zamówienia.
• Eksporty ZIP w formatach PDF, CII i UBL 2.1; pakiet dla akredytowanej platformy.
• Poprawione konto klienta, Factur-X w e-mailach, natywne faktury w formacie Factur-X w PrestaShop 9.
• Bezpieczeństwo: żadnych plików w katalogu publicznym, żadnej faktury bez numeru PrestaShop.
• Tłumaczenia FR, EN, ES, DE, IT, PL, NL, PT; aktualizacja z wersji 1.0.0 z zachowaniem ustawień.

1.0.0 (4 czerwca 2026)

• Pierwsza wersja: generowanie faktur Factur-X (PDF/A-3 + XML CII), profile BASIC, EN 16931 i EXTENDED, pobieranie z zamówienia, generowanie masowe, link na koncie klienta.