Factur-X

Francja · obowiązkowe od 1 wrz. 2026

Factur-X to francuski hybrydowy format e-faktury: zwykły, czytelny dla człowieka PDF z osadzonym wewnątrz zgodnym plikiem XML CII jako załącznikiem PDF/A-3. Jeden plik działa zarówno dla osoby, która go otwiera, jak i systemu, który go analizuje.

Czym to jest

Widoczny PDF i osadzony factur-x.xml (CII, profil EN 16931) opisują tę samą fakturę — to cały sens tego formatu. To także składnia XML używana przez niemiecki ZUGFeRD 2.x, więc poprawnie zbudowany dokument Factur-X jest w dużej mierze interoperacyjny na obu rynkach.

Gdzie jest obowiązkowe

Francuski mandat e-fakturowania B2B zaczyna się 1 września 2026: każda francuska faktura B2B musi przejść przez zarejestrowaną Plateforme Agréée, najczęściej jako Factur-X. Zobacz naszą dedykowaną stronę pre-flight po pełny zestaw reguł BR-FR (61 kodów) i wskazówki specyficzne dla PA — ta strona dotyczy samego formatu dokumentu Factur-X.

Czego nie robimy. CrateAPI nie jest Plateforme Agréée i nie przesyła faktur za jej pośrednictwem. Generujemy i walidujemy dokument; przesłanie go przez zarejestrowaną PA pozostaje osobnym krokiem.

Wypróbuj

curl -X POST "$BASE/v1/generate/facturx/embed" \
  -H "X-API-Key: $KEY" \
  -F "invoice=<invoice.json" -F "pdf=@branded.pdf" -o facturx.pdf

Istotne endpointy

Endpoint	Uwagi
`POST /v1/generate/facturx`	Z modelu faktury JSON — nasz własny układ wizualny, osadzony CII EN 16931.
`POST /v1/generate/facturx/embed`	Flagowy endpoint: zachowuje TWÓJ PDF z marką, osadza zgodny XML. Multipart, PDF do 10 MB.
`POST /v1/pdfa/validate?flavour=3b`darmowe	Strukturalna kontrola veraPDF kontenera PDF/A-3 — zaliczone/niezaliczone reguły i klauzule.
`POST /v1/pdfa/consistency`	Porównuje osadzony XML z widocznym tekstem PDF, wykrywa rozbieżności między nimi.

Przykłady i dokumentacja

Pobierz zwalidowany przykład Factur-X z naszej biblioteki przykładów, przeczytaj nasz przewodnik pre-flight dla Francji, lub pełną dokumentację API.

FAQ

Czy Factur-X zastępuje mój obecny projekt faktury?

Niekoniecznie — POST /v1/generate/facturx/embed bierze Twój istniejący PDF z marką i osadza w nim zgodny XML, zachowując Twój układ.

Czy to to samo co ZUGFeRD?

Ten sam rdzeń CII i ta sama idea hybrydowego PDF, ale różne krajowe ekosystemy — plik Factur-X jest zwykle czytelny dla narzędzi ZUGFeRD 2.x. Zobacz naszą stronę XRechnung dla niemieckiej opcji samego XML.

Czy CrateAPI przesyła moją fakturę do Plateforme Agréée?

Nie — przesłanie przez PA pozostaje osobnym krokiem. Zobacz /plateforme-agreee/ po listę kontrolną pre-flight.

Wypróbuj darmowy walidator Przeczytaj dokumentację