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.

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