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.
Zweryfikuj swój plik teraz
Za darmo, natychmiast i w 100% w przeglądarce - żaden plik nie jest przesyłany.
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-:
PEPPOL-EN16931-R003: Referencja nabywcy (BT-10) obowiązkowa
Peppol BIS 3.0 czyni referencję nabywcy (cbc:BuyerReference lub cac:OrderReference/cbc:ID) obowiązkową, mimo że jest opcjonalna w bazowej normie EN 16931. Referencja nabywcy służy do kierowania faktury wewnątrz organizacji nabywcy. Jej brak powoduje odrzucenie w punktach dostępowych Peppol.
Kod sposobu płatności musi pochodzić z dozwolonego podzbioru UNCL4461
Podczas gdy EN 16931 dopuszcza dowolny kod sposobu płatności UNCL4461, Peppol BIS 3.0 ogranicza dozwolone kody. Najczęstsze prawidłowe kody to 30 (Polecenie przelewu), 49 (Polecenie zapłaty) oraz 58 (Przelew SEPA). Kod 1 (instrument nieokreślony inaczej) nie jest akceptowany.
PEPPOL-EN16931-R010: Elektroniczny adres nabywcy (EndpointID) obowiązkowy
Peppol BIS 3.0 wymaga elektronicznego adresu nabywcy (cbc:EndpointID z prawidłowym identyfikatorem schematu EAS), aby faktura mogła zostać skierowana do odbiorcy w sieci. Brakujący lub błędnie oznaczony schematem punkt końcowy nabywcy to jedna z najczęstszych przyczyn odrzucenia faktury Peppol.
PEPPOL-EN16931-R004: CustomizationID musi mieć prawidłową wartość Peppol
cbc:CustomizationID musi mieć dokładnie postać: urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0. Nawet drobne odchylenia (nieprawidłowy separator, numer wersji) powodują niepowodzenie identyfikacji schematu. Ta wartość rozróżnia wielkość liter.
PEPPOL-EN16931-R120: Obliczanie kwoty netto wiersza faktury
Kwota netto wiersza faktury (BT-131) musi być równa ilości pomnożonej przez cenę netto (na jednostkę bazową), powiększonej o obciążenia na poziomie wiersza i pomniejszonej o rabaty na poziomie wiersza. Nawet różnica zaokrąglenia 0.01 na pojedynczym wierszu powoduje odrzucenie w punkcie dostępowym nabywcy.
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?
Tak. Reguła Peppol BIS 3.0 PEPPOL-EN16931-R003 czyni referencję nabywcy (BT-10, mapowaną na cbc:BuyerReference lub cac:OrderReference/cbc:ID) obowiązkową. Poproś swoich nabywców o preferowaną wartość referencji - zwykle jest to numer zamówienia zakupu lub kod centrum kosztów używany do wewnętrznego kierowania.
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.
Jak naprawić PEPPOL-EN16931-R004?
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).