# Factur-X: kompletny przewodnik (PrestaShop 8 i 9)
> Dokumentacja modułu Factur-X dla PrestaShop 8 i 9: tożsamość sprzedawcy, profile EN 16931 i BASIC, generowanie PDF/A-3b z osadzonym XML.
- Strona:
- Język: pl
- Zaktualizowano: 2026-11-02
- Inne języki: [fr](https://www.datafirefly.com/documentation/dffacturx/index.md), [en](https://www.datafirefly.com/en/documentation/dffacturx/index.md), [es](https://www.datafirefly.com/es/documentation/dffacturx/index.md), [de](https://www.datafirefly.com/de/documentation/dffacturx/index.md), [it](https://www.datafirefly.com/it/documentation/dffacturx/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffacturx/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffacturx/index.md)
- Indeks:
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).
Moduł nie przesyła faktur do akredytowanej platformy (PA), nie realizuje e-reportingu i nie odbiera faktur od dostawców. Zobacz sekcję **Reforma 2026/2027: co robi moduł**.
## 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.
Kreator konfiguracji: dane firmy z kontrolą SIREN, numeru VAT i IBAN
### 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.
Wybór profilu Factur-X: MINIMUM, BASIC WL, BASIC, zalecany EN 16931, EXTENDED
### 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ć.
Kategorie VAT i podstawy zwolnienia: zwolnienie podmiotowe, odwrotne obciążenie, eksport
### 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.
Płatność: IBAN, termin, adnotacje o karach i kody środków płatności dla modułów
### 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.
Udostępnianie: automatyczne generowanie, natywne faktury Factur-X, e-maile, konto klienta
## 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.
Pulpit Factur-X: faktury wygenerowane, zgodne, z ostrzeżeniami lub błędami
## 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ń.
Lista faktur i korekt Factur-X z filtrami, kategoriami VAT i eksportem zbiorczym
## 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.
Raport zgodności faktury: kontrole, pozycje, zestawienie VAT i sumy
Osadzony XML jest wyświetlany w kolorze i można go skopiować.
XML CII EN 16931 osadzony w PDF Factur-X, widoczny w panelu administracyjnym
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.
Na fakturze dla osoby prywatnej lub zagranicznego nabywcy ostrzeżenie BR-FR-12 (adres elektroniczny nabywcy) jest oczekiwane: tacy klienci nie mają adresu we francuskim katalogu.
## 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.
Panel Factur-X na stronie zamówienia: status zgodności i pobieranie PDF, CII, UBL
## 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.
Natywna faktura PrestaShop w PDF/A-3 z nowymi adnotacjami reformy
## 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.
Konto klienta: strona „Moje faktury elektroniczne” z PDF Factur-X i XML
## 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.
Pomoc dotycząca reformy e-faktur 2026/2027: harmonogram, profile, 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.