Peppol BIS Billing 3.0: Reguły biznesowe i błędy walidacji
Kompletny techniczny przewodnik po regułach biznesowych Peppol BIS Billing 3.0 (BR-, PEPPOL-): co walidują, jak je interpretować i jak korygować błędy.
Czym są reguły biznesowe Peppol?
Peppol BIS Billing 3.0 definiuje dwa zestawy reguł walidacji poza strukturą XSD: reguły EN 16931 (prefiks BR-) implementujące normę europejską oraz reguły specyficzne dla Peppol (prefiks PEPPOL-) dodające dodatkowe ograniczenia.
Istnieje ponad 200 reguł biznesowych. Każda reguła ma unikalny identyfikator (np. BR-01, PEPPOL-EN16931-R001), opis tego, co waliduje i poziom ważności: fatal (odrzucenie) lub warning (ostrzeżenie).
Reguły fatal muszą być spełnione, aby faktura została zaakceptowana w sieci Peppol. Reguły warning wskazują dobre praktyki lub sytuacje, które mogą powodować problemy z przetwarzaniem downstream.
Najczęstsze błędy walidacji Peppol
Najczęściej spotykane błędy BR- i PEPPOL-:
BR-01: Faktura bez numeru
Element ID faktury jest obowiązkowy i musi być unikalny. Faktura bez numeru jest nieważna w Peppol.
BR-CO-15: Nieprawidłowa suma VAT
Zadeklarowana suma VAT musi być równa sumie kwot VAT dla każdej stawki. Częsty błąd obliczeniowy w systemach legacy.
PEPPOL-EN16931-R001: Niespójna waluta
Waluta faktury i waluta kwot VAT muszą być takie same. Błąd w źle skonfigurowanych fakturach wielowalutowych.
BR-S-08: Brak podstawy opodatkowania
Dla każdej linii z VAT kwota podstawy opodatkowania (TaxableAmount) jest obowiązkowa.
PEPPOL-EN16931-R004: Nieprawidłowy identyfikator profilu
CustomizationID musi być 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'. Nieprawidłowa lub brakująca wartość.
Jak interpretować i korygować reguły
Każdy komunikat o błędzie zawiera identyfikator reguły (np. BR-01), kontekst XPath gdzie znaleziono błąd oraz opis po angielsku. Identyfikator umożliwia konsultację oficjalnej dokumentacji Peppol.
Dla reguł BR- (EN 16931): zapoznaj się ze specyfikacją EN 16931-1 i dokumentem aplikacji EN 16931-3-2 (UBL). Dla reguł PEPPOL-: zapoznaj się z BIS Billing 3.0 dostępnym na docs.peppol.eu.
Nasz walidator UBL/Peppol wykonuje wszystkie reguły Schematron i prezentuje błędy z kontekstem XPath i pełnym opisem, ułatwiając diagnozę i korektę.
Dobre praktyki dla zgodności Peppol
Zawsze używaj prawidłowego profilu: CustomizationID musi dokładnie odpowiadać profilowi Peppol BIS Billing 3.0. Różnica wielkości liter lub dodatkowa spacja powoduje odrzucenie.
Testuj z prawdziwymi próbkami: używaj naszego walidatora z prawdziwymi fakturami przed wejściem na produkcję. Błędy obliczeniowe (sumy VAT, całkowita wartość faktury) są częste i zależą od konkretnych danych.
Aktualizuj reguły: OpenPeppol publikuje okresowe aktualizacje reguł Schematron. Regularnie sprawdzaj, czy Twój system używa najnowszych wersji.
Waliduj swoje faktury Peppol
Nasz walidator wykonuje wszystkie reguły BR- i PEPPOL- w czasie rzeczywistym w przeglądarce. Żadne dane nie są wysyłane na nasze serwery.
Waliduj terazCzęsto zadawane pytania
Jaka jest różnica między regułami BR- a PEPPOL-?
Reguły BR- implementują europejską normę EN 16931. Reguły PEPPOL- są specyficzne dla sieci Peppol i dodają dodatkowe ograniczenia do EN 16931.
Czy faktura z ostrzeżeniami Peppol może być wysłana?
Technicznie tak, ostrzeżenia nie blokują transmisji. Ale powinny być analizowane: mogą powodować problemy z przetwarzaniem w systemie odbiorcy.
Jak uzyskać pełną listę reguł Peppol?
Pełna lista jest dostępna na docs.peppol.eu. Reguły Schematron są publikowane w formacie XML i mogą być wykonywane standardowymi procesorami XSLT.
Dlaczego moja faktura nie spełnia reguły BR-CO-15?
BR-CO-15 sprawdza, czy suma VAT faktury (TaxTotal/TaxAmount) jest równa sumie TaxSubtotal/TaxAmount. Sprawdź obliczenia i zaokrąglenia dla każdej linii.
Czym jest CustomizationID i dlaczego jest krytyczny?
CustomizationID identyfikuje profil zgodności. Dla Peppol BIS Billing 3.0 musi być dokładnie 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'.
Czy reguły Peppol są takie same we wszystkich krajach?
Reguły core BR- i PEPPOL- są takie same. Niektóre kraje dodają rozszerzenia krajowe (np. NLCIUS dla Holandii, AUNZ dla Australii/Nowej Zelandii).
Jak testować reguły Peppol bez wysyłania do sieci?
Użyj naszego lokalnego walidatora (przetwarzanie w przeglądarce). Możesz również używać oficjalnego Peppol Testbed lub walidatora OpenPeppol dla bardziej kompletnych testów.
Czy wersja reguł Schematron ma znaczenie?
Tak, OpenPeppol publikuje nowe wersje okresowo. Upewnij się, że Twój system używa najnowszej wersji, aby unikać błędów z zaktualizowanymi Access Pointami.
Jak walidować faktury kredytowe (noty kredytowe) Peppol?
Noty kredytowe Peppol używają dokumentu CreditNote UBL (nie Invoice). Reguły są podobne, ale niektóre są specyficzne. Nasz walidator obsługuje oba typy.
Czy istnieją narzędzia open-source do walidacji Peppol?
Tak: phive (Java, od OpenPeppol), Mustang (Java, dla Factur-X/ZUGFeRD z obsługą Peppol) oraz Saxon (procesor XSLT do bezpośredniego wykonywania reguł Schematron).