Czym jest Peppol Message Level Response (MLR)?
Odpowiedź na poziomie wiadomości (MLR) to dokument biznesowy Peppol (profileTrdm071) używany przez BusinessDocumentReceiver do informowania BusinessDocumentSender o wyniku walidacji. Po odebraniu dokumentu odbiorca może go zweryfikować pod kątem schematów XML i reguł biznesowych. Relacja MLR raportuje jeden z trzech wyników:
Kluczowe koncepcje i funkcje relacji MLR
Relacja MLR to komunikat zwrotny wysyłany do nadawcy, zawierający informacje o tym, czy dokument przeszedł walidację, czy został zaakceptowany, czy też został odrzucony z powodu błędów w strukturze dokumentu lub regułach biznesowych.
Głównym celem MLR jest informowanie nadawcy o statusie dokumentu, w tym o tym, czy spełnia on wymagane standardy. MLR to nie tylko sprawdzanie struktury, ale także pełny proces walidacji, który obejmuje:
- Sprawdzenie wszystkich pól obowiązkowych
- Weryfikacja zgodności dokumentu z ustalonymi standardami i schematami (np. Peppol BIS, UBL)
- Zapewnienie poprawnego formatu i wersji dokumentu
Rodzaje komunikatów w Peppol
W sieci Peppol istnieje kilka rodzajów komunikatów zapewniających transparentność procesu wymiany dokumentów:
MLS (Message Level Status): Prosta wiadomość informująca nadawcę, czy dokument został zaakceptowany do dalszego przetwarzania.
MLR (Message Level Response): Bardziej szczegółowa odpowiedź, która zawiera informacje o tym, czy dokument spełnia wymaganą strukturę i jest gotowy do dalszego przetwarzania. Informuje również nadawcę o błędach walidacji, podając szczegóły dotyczące błędów i przyczyn odrzucenia, jeśli ma to zastosowanie. Odpowiedź zostanie wysłana z kodami statusu, takimi jak „AP” (Zaakceptowano), „AB” (Potwierdzono) lub „RE” (Odrzucono).
BLR (Odpowiedź na poziomie biznesowym): Ostateczna odpowiedź informująca nadawcę o akceptacji, odrzuceniu lub dalszym przetwarzaniu dokumentu.
Kiedy stosuje się MLR?
MLR stosuje się, gdy dokument został przesłany przez sieć Peppol i konieczna jest weryfikacja jego poprawności strukturalnej. Jest to szczególnie ważne na początkowym etapie, gdy dokument nie został jeszcze w pełni zaakceptowany do przetworzenia lub zatwierdzenia.
Opcjonalnie: Wysyłanie MLR jest opcjonalne. Jest ono wysyłane tylko wtedy, gdy nadawca oryginalnego dokumentu biznesowego zażądał MLR lub gdy walidacja zakończy się błędem krytycznym.
✓ Żądany MLR: Na żądanie odbiorca wysyła MLR z AP (zaakceptowane), AB (potwierdzono) lub RE (odrzucono) w zależności od wyniku.
✗ Nie zażądano: Jeśli nadawca nie zażądał MLR, odbiorca powinien wysłać MLR tylko w przypadku błędu krytycznego Wykryto błędy walidacji (kod odpowiedzi RE).
Struktura i format MLR
MLR w Peppol jest przesyłany jako ustrukturyzowana wiadomość w formacie UBL Application Response 2.1. Jest to standardowy format używany do opisu struktury wiadomości przesyłanych przez sieć Peppol.
Wiadomość MLR może zawierać następujące elementy:
Kod statusu — kod wskazujący wynik przetwarzania (np. „Zaakceptowano”, „Odrzucono”, „Błąd”)
Opis statusu — opis wyjaśniający kod statusu
Szczegóły błędu — szczegóły błędów, jeśli dokument nie przeszedł walidacji.
Zakres walidacji
MLR obejmuje walidację schematu XML i reguł biznesowych otrzymanego dokumentu. Następujące sytuacje powodują odrzucenie:
Krytyczne błędy w strukturze dokumentu.
Naruszenia zgodności ze standardami.
Nieprawidłowe wersje dokumentu.
Problemy takie jak nieznany nadawca, nieznany odbiorca lub nieprawidłowa koperta są obsługiwane przez Potwierdzenia transportu (Ack) i nie są objęte zakresem MLR.
Strony zaangażowane
-
BusinessDocumentSender/MLRReceiver: Organizacja wysyłająca oryginalny dokument i odbierająca MLR.
-
BusinessDocumentReceiver / MLRSender: Organizacja odbierająca dokument i wysyłająca MLR.
MLR jest wymieniany bezpośrednio między użytkownikami końcowymi za pośrednictwem ich dostawców usług (C2 i C3). Nie należy go mylić z Statusem Poziomu Wiadomości (MLS), który jest wymieniany wyłącznie między dostawcami usług.
Struktura wiadomości i przykłady
Poniżej znajdują się przykłady wiadomości MLR w formacie XML:
<ApplicationResponse xmlns="urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2">
<cac:DocumentResponse>
<cac:Response>
<cbc:ResponseCode> AP</cbc:ResponseCode>
<cbc:Description>Dokument został pomyślnie zweryfikowany i zostanie przetworzony.</cbc:Description>
</cac:Response>
<cac:DocumentReference>
<cbc:ID>EnvelopeID-12456789</cbc:ID>
</cac:DocumentReference>
</cac:DocumentResponse>
</ApplicationResponse>Przykład: Odrzucony dokument
<ApplicationResponse xmlns="urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2">
<cac:DocumentResponse>
<cac:Response>
<cbc:ResponseCode>RE</cbc:ResponseCode>
<cbc:Description>Dokument został odrzucony z powodu braku obowiązkowego pola „Numer faktury”.</cbc:Description>
</cac:Response>
<cac:DocumentReference>
<cbc:ID>EnvelopeID-12456789</cbc:ID>
</cac:DocumentReference>
</cac:DocumentResponse>
</ApplicationResponse>Interakcja MLR z innymi komunikatami Peppol
MLR jest integralną częścią całego procesu wymiany dokumentów w Peppol i służy do wstępnej walidacji przed pełną akceptacją. Oto jak to działa:
1Potwierdzenie transportu (Ack): Gdy dokument jest wysyłany za pośrednictwem sieci Peppol, nadawca otrzymuje najpierw komunikat Ack potwierdzający odbiór dokumentu przez system.
2Odpowiedź na poziomie wiadomości (MLR): Kolejnym krokiem jest MLR, który informuje nadawcę o statusie dokumentu. Jeśli jest on poprawny strukturalnie, MLR go potwierdza. W przypadku błędów MLR podaje szczegóły.
3Odpowiedź na fakturę (BLR): Po pełnym przetworzeniu dokumentu nadawca otrzymuje ostateczny status: zaakceptowany, odrzucony lub w trakcie przetwarzania.
Znaczenie MLR dla firm
Odpowiedź na poziomie komunikatu Peppol odgrywa kluczową rolę w automatyzacji i optymalizacji procesów elektronicznego przetwarzania faktur i dokumentów. Z MLR:
Wnioski
Mechanizm MLR (Mechanizm odpowiedzi na poziomie komunikatu Peppol) jest kluczowym elementem zapewniającym niezawodność i poprawność wymiany dokumentów w sieci Peppol. Pomaga on upewnić się, że zarówno nadawca, jak i odbiorca są zgodni co do statusu dokumentu, co umożliwia szybkie wprowadzanie poprawek i minimalizuje opóźnienia w procesie fakturowania.
