Gdy organizacja zmienia dostawcę Peppol, rejestracje SMP muszą zostać przeniesione. Protokół migracji Peppol zapewnia, że odbywa się to bez przestojów: nadawcy mogą kontynuować wysyłanie podczas migracji. PSB oferuje dwa scenariusze migracji przez API.

Gdy party przechodzi z eConnect do innego dostawcy Peppol Access Point, migrację przygotowuje się przez endpoint prepareToMigrate:

GET /api/v1/peppol/{partyId}/prepareToMigrate

Ten endpoint wykonuje dwie operacje:

1. Oznacza party w SMP eConnect jako "w migracji"
2. Rejestruje klucz migracyjny w SML Peppol

API zwraca klucz migracyjny w odpowiedzi. Ten klucz należy przekazać nowemu dostawcy, który potrzebuje go do przejęcia rejestracji w swoim SMP.

{
  "migrationKey": "abc123-def456-ghi789"
}

Po migracji party jest automatycznie usuwana z SMP eConnect.

Gdy party przechodzi do eConnect od innego dostawcy Peppol Access Point, potrzebny jest klucz migracyjny wygenerowany przez obecnego dostawcę. Ten klucz dodaje się do konfiguracji party przez:

PUT /api/v1/peppol/config/party/{partyId}

Z obiektem migration w body żądania:

{
  "migration": {
    "key": "de-migratiesleutel-van-de-huidige-provider"
  }
}

PSB automatycznie kończy migrację: rejestracja SMP zostaje przejęta, a SML zaktualizowany. Od tego momentu wszystkie wiadomości Peppol dla tej party przechodzą przez Access Point eConnect.

Jeśli klucz migracyjny jest nieprawidłowy lub wygasł, migracja kończy się niepowodzeniem i API zwraca komunikat o błędzie. W takim przypadku należy poprosić obecnego dostawcę o nowy klucz.

Ścieżka poza API (klienci platformy): klienci, którzy nie korzystają z API, rozpoczynają migrację przez formularz rezygnacji/zakończenia na support.econnect.eu — nie poprzez zgłoszenie do wsparcia. Po zgłoszeniu otrzymują kod migracyjny, który przekazują nowemu dostawcy. Do przeniesienia stosują się dwa warunki: (a) klient udziela eConnect pisemnego/prawnego upoważnienia w tym celu, oraz (b) klient nie ma zaległych zobowiązań finansowych wobec eConnect. Poniższe kroki opisują procedurę równoważną przez API.

Pośrednik/masowo bez roli Administratora: pośrednik posiadający jedynie upoważnienie (brak roli Administratora) w organizacjach klientów zwykle nie może samodzielnie uruchomić samoobsługowej rezygnacji/migracji dla tych organizacji. W przypadku masowego przejścia wielu organizacji klientów/środowisk odbywa się to przez wsparcie (jeden klucz migracyjny na identyfikator Peppol) — nie poprzez unieważnienie kluczy połączenia. Unieważnienie kluczy połączenia przerywa jedynie połączenie API i nie stanowi wyrejestrowania z SMP.

Liczba kluczy przy zgłoszeniach masowych: liczba unikalnych kluczy migracyjnych może być niższa niż liczba organizacji w zgłoszeniu — klucz otrzymują wyłącznie organizacje z aktywną rejestracją odbioru. Kilka wiadomości e-mail z tymi samymi unikalnymi kluczami razem tworzą kompletną dostawę, gdy tylko pokryte zostaną wszystkie migrowane identyfikatory Peppol.

1. Party decyduje się na przejście do innego dostawcy
2. Wywołanie GET /api/v1/peppol/{partyId}/prepareToMigrate
3. Przekazanie klucza migracyjnego nowemu dostawcy
4. Nowy dostawca przejmuje rejestrację SMP za pomocą klucza
5. Rejestracja u eConnect zostaje automatycznie usunięta

1. Party decyduje się na przejście do eConnect
2. Obecny dostawca generuje klucz migracyjny
3. Wywołanie PUT /api/v1/peppol/config/party/{partyId} z kluczem migracyjnym
4. PSB przejmuje rejestrację SMP i aktualizuje SML
5. Następnie konfiguracja żądanych capability i hooków

Protokół migracji Peppol jest zaprojektowany dla zero downtime. Podczas transferu party pozostaje zarejestrowana w sieci. Nadawcy wysyłający fakturę w tym momencie docierają do party przez stary lub nowy Access Point, w zależności od timingu propagacji SML. Żadne wiadomości nie są tracone.

Po udanej migracji do eConnect party jest natychmiast osiągalna, ale propagacja SMP w całej sieci Peppol może zająć kilka minut. Po migracji zawsze należy skonfigurować capability i ustawić potrzebne hooki.

Nie należy też zapominać o konfiguracji przez Enrollment API uprawnień użytkowników i ewentualnej businessCard, jeśli nie zostało to jeszcze zrobione.

Potrzebna pomoc przy migracji? Kontakt z TechSupport w celu uzyskania wsparcia w procesie migracji.

• Sieć Peppol przez API: SMP i capabilities
• Rejestracja Peppol przez API (Enrollment)
• Przegląd: Procurement Service Bus (PSB)
• Czym jest Peppol i jak działa sieć?
• Peppol międzynarodowy
• Rejestracja na Peppol (platforma)
• E-fakturowanie z eConnect