Walidator faktur UBL/Peppol

Sprawdź strukturę, zanim zrobi to za Ciebie sieć

Kosztownym sposobem na odkrycie, że plik faktury jest wadliwy, jest jego wysłanie: wędruje do klienta albo punktu dostępowego, zostaje odrzucony godziny lub dni później, a zegar płatności zaczyna bieg od nowa. Tani sposób to trzydzieści sekund tutaj, wcześniej. Ten walidator odpowiada na proste, przydatne pytania: czy plik w ogóle jest poprawnie sformułowanym XML-em, czy rzeczywiście jest to faktura UBL oraz czy obecne są pola, jakich potrzebuje każda czytelna faktura — numer, daty, obie strony, pozycje i sumy. Pliki są sprawdzane w pamięci serwera i natychmiast odrzucane, co jest właściwym sposobem traktowania dokumentu niosącego nazwy, kwoty i dane bankowe. Przydaje się szczególnie w dwóch sytuacjach: małej firmie generującej swoje pierwsze faktury UBL z szablonu albo nieznanego modułu ERP, a także deweloperowi testującemu potok eksportu, który chce szybkiej, zewnętrznej opinii o wyniku, zanim skieruje go do prawdziwej sieci.

Czym jest kontrola strukturalna — i czym jest Schematron

Szczerość ma tu znaczenie. Oficjalna walidacja Peppol BIS Billing 3.0 to zestaw reguł Schematron: setki reguł biznesowych sprawdzających na przykład, czy kody kategorii VAT są spójne i czy sumy podatkowe zgadzają się z sumami pozycji. To narzędzie nie uruchamia tych reguł. Odczytuj oba wyniki odpowiednio do tego: niezaliczenie tutaj jest rozstrzygające — plik, który się nie parsuje albo brakuje mu obowiązkowych pól, nie przejdzie nigdzie indziej, więc napraw go przed wysłaniem. Zaliczenie tutaj oznacza, że struktura jest użyteczna, a nie że spełniona jest każda reguła biznesowa; sieć wciąż może odrzucić plik z powodu naruszenia na poziomie reguł. Najpierw kontrola strukturalna, potem Schematron — to naturalna kolejność sprawdzania. Ta granica jest celowa, nie leniwa: oficjalne zestawy reguł są wersjonowane i utrzymywane centralnie, a ich prawidłowe uruchamianie to zadanie samej infrastruktury Peppol — słabe naśladowanie służyłoby Ci gorzej niż jasne nazwanie granicy.

Awarie, które naprawdę widzimy

Większość odrzuconych plików mieści się w garści powtarzających się wzorców. Plik jest notą korygującą, a nie fakturą — to inny typ dokumentu UBL, którego ten walidator jeszcze nie obsługuje. Jest to PDF Factur-X, a nie surowy XML — faktura jest osadzona wewnątrz PDF-a i trzeba ją najpierw wyodrębnić narzędziem Factur-X na tej stronie. Plik został ucięty albo przekodowany gdzieś po drodze przez e-mail, więc XML już się nie parsuje. Albo eksport z ERP zostawił puste obowiązkowe pola stron albo sum, bo rekord danych podstawowych był niekompletny. Walidator wskazuje z nazwy, czego brakuje, co zwykle od razu naprowadza na to, który z tych przypadków wystąpił. Warto znać subtelniejszy wariant: plik, który bez problemu otwiera się w edytorze tekstu, może i tak nie sparsować się, bo bramka pocztowa albo krok kopiuj-wklej zmieniły jego kodowanie znaków — niewidoczne dla oka, śmiertelne dla XML-a. W takim wypadku wyeksportuj plik ponownie z systemu źródłowego, zamiast naprawiać go ręcznie.

Ten sam parser co renderer PDF — i kiedy zadzwonić do dostawcy

Ten walidator dzieli swój parser, linia po linii, z narzędziem Faktura UBL/Peppol na PDF na tej stronie. Daje Ci to niezawodny, mały schemat pracy: zwaliduj plik, a potem wyrenderuj go i przeczytaj fakturę tak, jak zrobiłby to człowiek — błędny IBAN czy absurdalną sumę często łatwiej dostrzec na stronie niż w XML-u. I wiedz, gdzie leży granica: jeśli plik przechodzi tutaj walidację, sensownie się renderuje, a mimo to wciąż zostaje odrzucony przez sieć Peppol, problem leży na poziomie reguł biznesowych albo transmisji. Ta rozmowa należy do Twojego punktu dostępowego albo dostawcy oprogramowania, który widzi oficjalny raport walidacji — zabierz ze sobą jego komunikat o błędzie, bo wskazuje on dokładną regułę, która zadziałała.

Co dokładnie jest sprawdzane

To narzędzie potwierdza, że plik jest poprawnie sformatowanym XML-em, ma element główny Invoice w standardzie UBL oraz zawiera pola potrzebne w czytelnej fakturze: numer faktury, daty, dane dostawcy i nabywcy, pozycje faktury oraz sumy. To strukturalna kontrola poprawności, a nie oficjalna walidacja Schematron dla Peppol BIS Billing 3.0 — nie wykryje każdego naruszenia reguł biznesowych (np. nieprawidłowo zsumowanych kwot podatku), a jedynie to, czy struktura jest w ogóle użyteczna.