Wenn eine Organisation den Peppol-Provider wechselt, müssen die SMP-Registrierungen übertragen werden. Das Peppol-Migrationsprotokoll stellt sicher, dass dies ohne Ausfallzeit geschieht: Absender können während der Migration weiter senden. Die PSB bietet zwei Migrationsszenarien über die API.

Wenn eine Party von eConnect zu einem anderen Peppol Access Point Provider wechselt, bereiten Sie die Migration über den prepareToMigrate-Endpoint vor:

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

Dieser Endpoint bewirkt zwei Dinge:

1. Er markiert die Party im eConnect SMP als „in Migration"
2. Er registriert einen Migrationsschlüssel beim Peppol SML

Die API gibt den Migrationsschlüssel in der Antwort zurück. Geben Sie diesen Schlüssel an den neuen Provider weiter, der den Schlüssel benötigt, um die Registrierung in seinem SMP zu übernehmen.

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

Nach der Migration wird die Party automatisch aus dem eConnect SMP entfernt.

Wenn eine Party von einem anderen Peppol Access Point Provider zu eConnect wechselt, benötigen Sie den Migrationsschlüssel, den der aktuelle Provider generiert hat. Fügen Sie diesen Schlüssel über folgenden Endpoint zur Party-Konfiguration hinzu:

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

Mit dem migration-Objekt im Request Body:

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

Die PSB schließt die Migration automatisch ab: Die SMP-Registrierung wird übernommen und das SML wird aktualisiert. Ab diesem Zeitpunkt laufen alle Peppol-Nachrichten für diese Party über den eConnect Access Point.

Wenn der Migrationsschlüssel ungültig oder abgelaufen ist, schlägt die Migration fehl und die API gibt eine Fehlermeldung zurück. Fordern Sie in diesem Fall einen neuen Schlüssel beim aktuellen Provider an.

1. Die Party entscheidet sich für einen Wechsel zu einem anderen Provider
2. Rufen Sie GET /api/v1/peppol/{partyId}/prepareToMigrate auf
3. Geben Sie den Migrationsschlüssel an den neuen Provider weiter
4. Der neue Provider übernimmt die SMP-Registrierung mit dem Schlüssel
5. Die Registrierung bei eConnect wird automatisch aufgeräumt

1. Die Party entscheidet sich für einen Wechsel zu eConnect
2. Der aktuelle Provider generiert einen Migrationsschlüssel
3. Rufen Sie PUT /api/v1/peppol/config/party/{partyId} mit dem Migrationsschlüssel auf
4. Die PSB übernimmt die SMP-Registrierung und aktualisiert das SML
5. Konfigurieren Sie anschließend die gewünschten Capabilities und Hooks

Das Peppol-Migrationsprotokoll ist für null Ausfallzeit konzipiert. Während der Übertragung bleibt die Party im Netzwerk registriert. Absender, die zu diesem Zeitpunkt eine Rechnung versenden, erreichen die Party über den alten oder den neuen Access Point, abhängig vom Timing der SML-Propagierung. Es gehen keine Nachrichten verloren.

Nach einer erfolgreichen Migration zu eConnect ist die Party sofort erreichbar, aber die SMP-Propagierung über das Peppol-Netzwerk kann einige Minuten dauern. Konfigurieren Sie nach der Migration immer die Capabilities und richten Sie die erforderlichen Hooks ein.

Vergessen Sie außerdem nicht, über die Enrollment API die Benutzerberechtigungen und eine eventuelle businessCard einzurichten, falls dies noch nicht geschehen ist.

Benötigen Sie Hilfe bei einer Migration? Kontaktieren Sie TechSupport für Unterstützung beim Migrationsprozess.

• Peppol-Netzwerk über die API: SMP und Capabilities
• Peppol-Registrierung über die API (Enrollment)
• Übersicht: die Procurement Service Bus (PSB)
• Was ist Peppol und wie funktioniert das Netzwerk?
• Peppol international
• Auf Peppol registrieren (Plattform)
• E-Rechnungsstellung mit eConnect