Czym jest status poziomu wiadomości Peppol (MLS)?
MLS to standardowy komunikat statusowy używany w sieci Peppol eDelivery, umożliwiający dostawcom usług komunikowanie wyników przetwarzania i dostarczania dokumentów biznesowych.
MLS (Msg) Peppol to standardowy komunikat statusowy używany w sieci Peppol eDelivery. Umożliwia on dostawcy usług, który odbiera dokument biznesowy (C3), poinformowanie dostawcy usług wysyłających (C2) o wynikach przetwarzania i dostarczania tego dokumentu. Komunikat MLS jest oparty na wcześniejszej specyfikacji MLR (Msg), ale rozszerza ją o obsługę raportowania między dostawcami usług Peppol.
Cel i przypadki użycia
Wiadomość MLS informuje nadawcę (C2) o jednej z następujących sytuacji:
1Wiadomość odrzucona
Dokument biznesowy nie spełniał zasad zgodności lub nie mógł zostać dostarczony do odbiorcy końcowego (C4).
2Dostarczenie do C4 nie powiodło się
C3 nie mógł przekazać wiadomości do C4 (np. z powodu problemów technicznych).
3Dostarczenie do C4 powiodło się z potwierdzeniem
C3 otrzymał weryfikowalne potwierdzenie od C4, że wiadomość została przyjęta.
4Dostarczenie do C4 zrealizowane (bez potwierdzenia)
Wiadomość została przekazana do C4, ale C3 nie otrzymał potwierdzenia odbioru (np. dostarczono ją e-mailem lub pocztą).
Ważne: C3 nie może wysyłać więcej niż jednej wiadomości MLS na dokument biznesowy, a wiadomości MLS są zawsze wysyłane z C3 do C2 (nigdy w odpowiedzi na inną wiadomość MLS lub MLR).
Strony i role
MLS używa modelu Peppol Corner do identyfikacji uczestników:
С1Twórca dokumentu
Podmiot gospodarczy tworzący dokument (np. fakturę).
С2Dostawca usług wysyłających
Dostawca usług wysyłający dokument i odbieranie MLS.
С3Dostawca odbierający
Dostawca usług odbierający dokument i tworzący MLS.
C4Ostateczny odbiorca
Ostateczny odbiorca przetwarzający dokument.
Wiadomości MLS umożliwiają C2 monitorowanie, czy C3 pomyślnie zweryfikował i przekazał dokument do C4. Jest to szczególnie przydatne, gdy uczestnicy korzystają z różnych dostawców usług lub punktów dostępu.
Przegląd procesu MLS
Proces MLS przebiega według określonej sekwencji:
1Odbierz dokument C3 otrzymuje dokument biznesowy i kopertę z wiadomością od C2.
2Określ warunkiC3 odczytuje kopertę wiadomości (SBDH), aby zdecydować, czy MLS powinien zostać wysłany i do którego identyfikatora uczestnika (C2 czy alternatywnego).
3Walidacja i przekazanieC3 przeprowadza walidację (schematu, reguł biznesowych itp.) i przekazuje dokument do C4.
3Wybierz odpowiedź MLSNa podstawie wyników walidacji i ustawień SBDH, C3 określa, czy wysłać MLS i z jakim kodem odpowiedzi.
Logika decyzyjna odpowiedzi MLS:
Jeśli walidacja zakończy się powodzeniem, a SBDH zażąda MLS tylko w przypadku błędów → MLS nie zostanie wysłany
Jeśli walidacja zakończy się powodzeniem i SBDH zażąda MLS dla wszystkich wyników → pozytywny MLS (AP lub AB)
Jeśli walidacja się nie powiedzie → negatywny MLS (RE) ze szczegółami błędu
Preferencje dostarczania MLS (rozszerzenie SBDH)
C2 może wskazywać preferencje dostarczania za pomocą opcjonalnych pól SBDH:
MLS_TO
Określa alternatywny identyfikator uczestnika do odbioru komunikatu MLS (przydatne, gdy C2 obsługuje wiele punktów dostępu). Jeśli wartość jest nieprawidłowa, MLS musi zostać wysłany na domyślny identyfikator dostawcy usługi C2.
MLS_TYPE
Określa, kiedy wiadomości MLS powinny być wysłano:
FAILURE_ONLY – Wysyłaj MLS tylko w przypadku odrzuconych wiadomości (RE)
ALWAYS_SEND – wysyłaj MLS dla wszystkich wyników (AP, AB i RE)
Jeśli MLS_TYPE jest nieobecny lub nieprawidłowy, C3 musi użyć domyślnej polityki, która obecnie wymaga wysyłania MLS dla wszystkich kodów odpowiedzi.
Kody odpowiedzi i ich znaczenie
MLS używa prostego systemu trzech kodów:
| Kod | Znaczenie (status ogólny) |
|---|---|
| AP | Dostarczono z potwierdzeniem – C3 pomyślnie dostarczył wiadomość do C4 i otrzymał weryfikowalne potwierdzenie. |
| AB | Dostarczono bez potwierdzenia – C3 przekazał wiadomość do C4, ale nie może potwierdzić odbioru. |
| RE | Odrzucono / Nie udało się dostarczyć – C3 nie mógł dostarczyć wiadomości z powodu problemów ze zgodnością lub awarii technicznej. |
Jeśli status to RE, MLS musi zawierać powody odrzucenia, aby nadawca mógł rozwiązać problemy.
Kody przyczyn statusu
Jeśli wiadomość zostanie odrzucona (RE), C3 powinien zawierać konkretne kody przyczyn statusu, wskazujące przyczynę niedostarczenia dokumentu. Specyfikacja MLS definiuje cztery kody przyczyn:
| Kod | Opis |
|---|---|
| SV | Składnia naruszenie – dokument nie przeszedł walidacji schematu lub struktury XML. |
| BV | Naruszenie reguł biznesowych (fatalne) – naruszenia reguł biznesowych Peppol lub UBL, takie jak puste elementy, nieprawidłowa wersja UBL lub niezgodne wartości. |
| BW | Ostrzeżenie dotyczące reguły biznesowej – ostrzeżenia niekrytyczne, które mogą towarzyszyć odrzuceniu lub zostać zgłoszone dodatkowo. |
| FD | Błąd dostarczenia – C3 nie mógł dostarczyć wiadomości do C4 (np. z powodu problemów z siecią lub systemem) problemy). |
Wiadomość MLS z odrzuceniem (RE) musi zawierać wystarczająco dużo szczegółów (lokalizację problemu, opis i klasyfikację), aby C2 mógł zidentyfikować źródło problemu.
Struktura wiadomości MLS
MLS jest oparty na formacie UBL Application Response i zawiera określone terminy biznesowe (BT) i grupy biznesowe (BG). Kluczowe elementy obejmują:
BT-001
Odwołuje się do wersji specyfikacji MLS.
BT-002
Wskazuje kontekst biznesowy transakcja.
BT-003
Unikalny identyfikator wiadomości MLS.
BT-004/005
Data (bez strefy czasowej) i godzina (z uwzględnieniem strefy czasowej, najlepiej UTC) wydania MLS.
BT-006 do BT-011
Zidentyfikuj C3 i C2 wraz ze schematami ich identyfikacji.
BT-010/011
Status MLS (AP, AB lub RE) i opcjonalny opis czytelny dla człowieka.
Zasady i obowiązki
Specyfikacja określa zasady operacyjne dla dostawców usług:
Każdy dokument biznesowy może skutkować zerową lub jedną wiadomością MLS.
MLS musi zostać wysłany, gdy tylko znany będzie status.
Identyfikatory nadawcy i odbiorcy w systemie MLS muszą odpowiadać odpowiednio C3 i C2.
MLS musi zawierać specyfikację i identyfikatory procesu, datę/godzinę wydania oraz oryginalny identyfikator koperty.
Wiadomości MLS nie mogą odpowiadać na inne wiadomości MLS ani MLR.
Czym MLS różni się od MLR
Poziom wiadomości Odpowiedź
Weryfikuje strukturę dokumentu i jest zazwyczaj wysyłana przez odbiorcę biznesowego (C2/C4).
Status poziomu wiadomości
Koncentruje się na stanie wymiany wiadomości między dostawcami usług (C2 i C3).
MLS informuje C2, czy dokument został dostarczony do C4, czy odrzucony z powodu problemów z walidacją lub dostarczeniem. Dostarcza kody odpowiedzi wysokiego poziomu i kody przyczyn, ale nie potwierdza akceptacji biznesowej przez ostatecznego odbiorcę; To pozostaje rolą Reakcji na Poziomie Biznesowym (BLR).
Podsumowanie
Status na Poziomie Wiadomości Peppol (MLS) to mechanizm, za pomocą którego dostawca usługi odbierającej (C3) informuje dostawcę usługi wysyłającej (C2). o statusie przetwarzania i dostarczania dokumentu biznesowego w sieci Peppol.
Pomaga zapewnić nadawcy terminową informację zwrotną o dostarczeniu lub odrzuceniu dokumentu. Wykorzystuje proste kody odpowiedzi (AP, AB, RE) i szczegółowe kody przyczyn (SV, BV, BW, FD). Dzięki wdrożeniu MLS, uczestnicy Peppol zyskują przejrzystość i niezawodność w wymianie wiadomości między dostawcami.
