Ekstraktor XML z Factur-X/ZUGFeRD

Faktura wewnątrz faktury

Faktura Factur-X — w Niemczech nazywana ZUGFeRD — wygląda jak zwykły PDF i zachowuje się jak zwykły PDF: można go otworzyć, przeczytać, wydrukować. W rzeczywistości to jednak dwie faktury w jednym pliku: strony, które czyta człowiek, oraz ustrukturyzowana faktura XML osadzona wewnątrz PDF-a jako załącznik, przeznaczona dla oprogramowania. Ten pomysł jest elegancki — jeden plik obsługuje obu odbiorców — dopóki nie potrzebujesz osobno tej maszynowej połowy: Twój program księgowy prosi o XML, usługa walidacji chce go sprawdzić, albo procedura importu Twojej księgowej oczekuje gołego pliku. To narzędzie otwiera PDF w pamięci, wyciąga osadzony XML i zwraca Ci go samodzielnie.

Dlaczego XML ma znaczenie dla Twojej księgowości

XML to połowa, która oszczędza pracę: kwoty, rozbicia VAT, daty, dane stron i informacje o płatności trafiają jako ustrukturyzowane pola, które oprogramowanie księgowe importuje bez konieczności ręcznego przepisywania choćby jednej cyfry — a to właśnie tam giną błędy przy przepisywaniu. Dwie rzeczy są tu celowe. Wyodrębniony XML wychodzi identyczny bajt po bajcie z tym, co było osadzone: to cudzy dokument zgodności, a przepisanie choćby jednego znaku mogłoby naruszyć jego ważność. A wyodrębnienie to nie walidacja — to narzędzie nie ocenia treści. Jeśli pracujesz też z fakturami UBL i Peppol, obejmują tę stronę narzędzia towarzyszące: walidator strukturalny do ich sprawdzania oraz renderer, który zamienia je w czytelne pliki PDF.

Jeden załącznik, kilka albo żaden

Większość faktur Factur-X osadza dokładnie jeden plik, więc dostajesz z powrotem sam XML. Niektóre osadzają więcej — dokument dostawy, regulamin — i zamiast zmuszać Cię do zgadywania, który załącznik jest ważny, narzędzie zwraca plik .zip zawierający wszystko, co było w środku. Trzeci przypadek to częste rozczarowanie: PDF bez żadnych osadzonych plików. To po prostu zwykła faktura PDF — zeskanowana albo wyeksportowana ze zwykłego szablonu — i nie ma w niej ukrytego XML-a do znalezienia, niezależnie od tego, jak oficjalnie wygląda. Factur-X to coś, co oprogramowanie nadawcy musi celowo umieścić; to narzędzie może jedynie odzyskać to, co naprawdę tam było.

Czym Factur-X/ZUGFeRD różni się od zwykłej faktury PDF

Faktura Factur-X (rozwiązanie zapoczątkowane przez Francję i Niemcy, dziś stosowane w całej UE) lub ZUGFeRD to plik PDF/A-3, w którym jako załącznik osadzony jest ustrukturyzowany plik XML faktury (w formacie CII). Ludzie otwierają taki PDF jak każdą inną fakturę; oprogramowanie księgowe odczytuje zamiast tego osadzony XML. To narzędzie wyodrębnia ten XML z powrotem jako samodzielny plik.