E-reporting i Zatwierdzona Platforma (PDP): dokumentacja
Instalacja i konfiguracja modułu e-reporting: reżim VAT, częstotliwość, przekazywanie do PDP (API lub ręcznie), cykl życia faktur i automatyczny cron.
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
- W panelu administracyjnym otwórz Moduły > Menedżer modułów, kliknij Wgraj moduł i wybierz plik ZIP.
- Po zakończeniu instalacji kliknij Konfiguruj. Moduł automatycznie tworzy swoje tabele oraz zakładkę E-reporting w menu Zamówienia.
- 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.