# E-reporting i Zatwierdzona Platforma (PDP): dokumentacja
> Ten moduł przekazuje francuskiej administracji podatkowej dane transakcji B2C (e-reporting) oraz cykl życia faktur, w ramach francuskiej reformy fakturowania elektronicznego. Generuje strumień w formacie oczekiwanym przez DGFiP (semantyka CII, strumień…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-30
- Inne języki: [fr](https://www.datafirefly.com/documentation/e-reporting-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/e-reporting-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/e-reporting-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/e-reporting-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/e-reporting-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/e-reporting-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/e-reporting-prestashop/index.md)
- Indeks:
Ten moduł przekazuje francuskiej administracji podatkowej dane transakcji B2C (e-reporting) oraz cykl życia faktur, w ramach francuskiej reformy fakturowania elektronicznego. Generuje strumień w formacie oczekiwanym przez DGFiP (semantyka CII, strumień 10, w XML i JSON) i przesyła go do Twojej Zatwierdzonej Platformy (PDP) albo pozwala Ci przesłać go ręcznie. Ten przewodnik obejmuje instalację, konfigurację i codzienną obsługę.
**Zakres prawny: Francja.** Moduł realizuje wyłącznie francuski obowiązek e-reportingu i francuski format DGFiP. Nie obsługuje polskiego krajowego systemu e-faktur (KSeF) ani żadnego innego systemu krajowego. Jeżeli prowadzisz sprzedaż z polskiego podmiotu, skonsultuj z doradcą podatkowym, które obowiązki Cię dotyczą, zanim wdrożysz ten moduł.
**Przypomnienie regulacyjne (prawo francuskie).** Od 1 września 2026 odbiór faktur elektronicznych jest obowiązkowy dla wszystkich przedsiębiorstw we Francji, a wystawianie oraz e-reporting stają się obowiązkowe dla dużych przedsiębiorstw i ETI. Małe i średnie firmy, mikroprzedsiębiorstwa oraz jednoosobowe działalności dołączają 1 września 2027. Każde brakujące przekazanie e-reportingu podlega karze 250 EUR, z rocznym limitem 45 000 EUR.
## Wymagania wstępne
- PrestaShop od 8.0 do 9.x, PHP od 7.4 do 8.3.
- Twój francuski numer SIREN (9 cyfr).
- Znajomość Twojego francuskiego reżimu VAT (réel normal, réel simplifié albo franchise en base).
- Do przekazywania automatycznego: dane połączenia dostarczone przez Twoją Zatwierdzoną Platformę (adres przesyłania, adres statusu, dane OAuth2 albo klucz API). W trybie ręcznym te dane nie są potrzebne.
## Instalacja
1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**, kliknij **Wgraj moduł** i wybierz plik ZIP.
2. Po zakończeniu instalacji kliknij **Konfiguruj**. Moduł automatycznie tworzy swoje tabele oraz zakładkę **E-reporting** w menu **Zamówienia**.
3. Przejdź do zakładki **Ustawienia**, aby wykonać konfigurację początkową.
## Konfiguracja początkowa
Wszystkie ustawienia znajdują się w zakładce **Ustawienia** na stronie konfiguracji modułu.
### Tożsamość i reżim
- **SIREN**: Twój dziewięciocyfrowy numer. Identyfikuje stronę sprzedającą w każdym przekazanym strumieniu.
- **Reżim VAT**: określa częstotliwość przekazywania. Réel normal to tryb dekadowy, réel simplifié to tryb miesięczny, franchise en base to tryb dwumiesięczny.
- **Rodzaj działalności**: towary, usługi albo mieszana. Działalność usługowa i mieszana uruchamia śledzenie wpłat, ponieważ w tych przypadkach obowiązek podatkowy powstaje z chwilą zapłaty.
- **Data początkowa**: pierwsza data, od której moduł zbiera transakcje. Ustaw ją najwcześniej na dzień wejścia w obowiązek.
### Opcje zbierania danych
- **Uwzględnij wewnątrzwspólnotową sprzedaż B2B**: dodaje do strumienia sprzedaż do firm z innego państwa członkowskiego UE, która również podlega e-reportingowi.
- **Uwzględnij korekty**: włącza dokumenty korygujące (order slips) do strumienia jako kwoty ujemne.
## Wybór trybu przekazywania
Ustawienie **Tryb PDP** określa sposób przekazywania strumieni.
### Tryb ręczny
Moduł generuje strumienie, Ty pobierasz je w XML lub JSON, przesyłasz samodzielnie na portal swojej platformy, a następnie oznaczasz przekazanie jako złożone. To tryb zalecany, jeśli Twoja platforma nie udostępnia jeszcze API albo jeśli wolisz zachować kontrolę.
### Tryb API
Moduł automatycznie przesyła strumienie do Twojej platformy. Uzupełnij:
- **Adres przesyłania** i **adres statusu** dostarczone przez platformę.
- **Tryb uwierzytelniania**: OAuth2 (client credentials), klucz API albo statyczny token Bearer.
- Zależnie od trybu: **adres tokena**, **Client ID** i **Client Secret** dla OAuth2, albo **klucz API**, albo token Bearer.
- **Format ładunku**: XML albo JSON, zgodnie z oczekiwaniami API Twojej platformy.
Użyj przycisku **Testuj połączenie z PDP**, aby zweryfikować dane uwierzytelniające przed uruchomieniem produkcyjnym.
**Sekret jest zachowywany.** Jeśli zapiszesz ustawienia, pozostawiając pole Client Secret lub klucz API puste, wcześniej zapisana wartość zostaje zachowana. Nie musisz więc wpisywać sekretu przy każdej zmianie.
## Generowanie i przekazywanie okresu
### Z pulpitu
Zakładka **Pulpit** wyświetla należne okresy, każdy z ustawowym terminem. Okres po terminie jest oznaczony na czerwono. Kliknij **Generuj** przy okresie, aby utworzyć jego strumień. Przycisk **Generuj wszystko** przetwarza za jednym razem wszystkie zakończone okresy.
### Z zakładki Przekazania
Zakładka **Przekazania** zawiera listę wszystkich wygenerowanych strumieni wraz ze statusem. Dla każdego przekazania możesz:
- Sprawdzić szczegóły podziału według stawek VAT.
- Pobrać strumień w formacie XML lub JSON.
- W trybie API kliknąć **Wyślij do PDP**.
- W trybie ręcznym oznaczyć przekazanie jako **złożone**, a następnie **zaakceptowane** albo **odrzucone**, zgodnie z odpowiedzią platformy.
- Usunąć przekazanie, dopóki nie zostało wysłane.
**Statusy przekazania.** Przekazanie przechodzi przez stany: wersja robocza, wygenerowane, wysłane, zaakceptowane, odrzucone albo błąd. Przekazania już wysłanego lub zaakceptowanego nie można usunąć, co chroni ścieżkę audytu.
## Częstotliwość według reżimu
Moduł automatycznie wylicza okresy na podstawie skonfigurowanego reżimu, zgodnie z francuskim dekretem 2022-1299:
- **Réel normal, tryb dekadowy**: trzy okresy w miesiącu (od 1 do 10, od 11 do 20, od 21 do końca miesiąca). Każdy strumień należy złożyć w ciągu 10 dni od zakończenia okresu.
- **Réel simplifié, tryb miesięczny**: jedno przekazanie w miesiącu, składane między 25 a 30 dniem następnego miesiąca.
- **Franchise en base, tryb dwumiesięczny**: jedno przekazanie co dwa miesiące.
## Jak liczone są kwoty
Moduł odtwarza podział według stawek VAT na podstawie rzeczywistych pozycji zamówienia. Dodaje koszty wysyłki według stawki przewoźnika, uwzględnia pakowanie na prezent oraz przenosi różnice zaokrągleń i rabaty na największą pozycję, tak aby przekazane sumy dokładnie odpowiadały sumom Twoich zamówień. Zamówienia w walucie obcej są przeliczane po kursie zapisanym w momencie sprzedaży. Korekty, jeśli są włączone, trafiają do strumienia jako kwoty ujemne i są rozdzielane proporcjonalnie na stawki zamówienia źródłowego.
## Cykl życia faktur
Zakładka **Cykl życia** pozwala śledzić statusy faktur: złożenie, odrzucenie, odmowę i wpłatę. Wpłaty są wykrywane automatycznie na podstawie płatności PrestaShop, a przejście zamówienia do stanu opłaconego zapisuje status wpłaty. Możesz też wprowadzić status ręcznie dla wybranego zamówienia. Ponadto na każdej karcie zamówienia w panelu administracyjnym wyświetla się panel podsumowujący jego status e-reportingu.
## Automatyzacja przez cron
Zakładka **Pulpit** pokazuje adres crona zabezpieczony tokenem. Skonfiguruj u swojego hostingodawcy zadanie cron wywołujące ten adres, na przykład raz dziennie. Przy każdym wywołaniu moduł generuje wszystkie zakończone okresy, a jeśli w trybie API włączona jest opcja **Automatyczne wysyłanie**, przesyła strumienie do Twojej platformy.
**Zachowaj poufność adresu crona.** Zawiera token uprawniający do generowania i wysyłania strumieni. Nie udostępniaj go publicznie. Jeśli podejrzewasz, że został ujawniony, wygeneruj nowy token w ustawieniach.
## Tryb testowy
Włącz **Tryb testowy**, aby zweryfikować cały łańcuch bez rzeczywistych skutków. Każdy strumień przekazany w tym trybie zawiera znacznik testu przewidziany przez oficjalny format: platforma traktuje go jako próbę. Dopóki opcja jest aktywna, w interfejsie widoczny jest baner **TRYB TESTOWY**. Wyłącz go przed pierwszym rzeczywistym przekazaniem.
## Najczęstsze pytania
### Czy dotyczy mnie to, jeśli sprzedaję wyłącznie osobom prywatnym?
Tak. Sprzedaż B2C podlega właśnie e-reportingowi: dane transakcji trzeba przekazywać okresowo, nawet jeśli nie jest wystawiana faktura elektroniczna.
### Czy moduł działa z moją Zatwierdzoną Platformą?
Klient API jest uniwersalny i współpracuje z każdą platformą udostępniającą API REST z uwierzytelnianiem OAuth2, kluczem API albo tokenem Bearer. Jeśli Twoja platforma nie ma API, pozostaje dostępny tryb ręczny.
### Czy jest zgodny z modułem Factur-X DataFirefly?
Tak. Oba moduły się uzupełniają: Factur-X obejmuje fakturowanie elektroniczne B2B, a ten moduł e-reporting transakcji B2C i cykl życia faktur. Można ich używać razem bez konfliktów.
### Co się stanie, jeśli zainstaluję moduł w trakcie roku?
Ustaw **Datę początkową** na dzień, od którego podlegasz obowiązkowi. Moduł generuje okresy dopiero od tej daty.