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.

Nicht-API-Route (Plattformkunden): Kunden, die die API nicht nutzen, starten die Migration über das Kündigungs-/Beendigungsformular auf support.econnect.eu — nicht über eine Support-Anfrage. Nach der Einreichung erhalten sie einen Migrationscode, den sie an den neuen Provider weitergeben. Für die Übertragung gelten zwei Bedingungen: (a) der Kunde erteilt eConnect hierfür einen schriftlichen/rechtlichen Auftrag, und (b) der Kunde hat keine offenen finanziellen Verpflichtungen gegenüber eConnect. Die folgenden Schritte beschreiben das API-äquivalente Verfahren.

Intermediär/Bulk ohne Administrator-Rolle: Ein Intermediär mit nur einer Berechtigung (keine Administrator-Rolle) auf Kundenorganisationen kann in der Regel selbst keinen Self-Service-Kündigungs-/Migrationsprozess für diese Organisationen starten. Für einen Bulk-Wechsel mehrerer Kundenorganisationen/-umgebungen läuft dies über den Support (ein Migrationsschlüssel pro Peppol-ID) — nicht über das Widerrufen von Connection Keys. Das Widerrufen von Verbindungsschlüsseln unterbricht lediglich die API-Verbindung und ist keine SMP-Deregistrierung.

Anzahl Schlüssel bei Bulk-Anfragen: Die Anzahl eindeutiger Migrationsschlüssel kann niedriger sein als die Anzahl der Organisationen in der Anfrage — nur Organisationen mit einer aktiven Empfangsregistrierung erhalten einen Schlüssel. Mehrere E-Mails mit denselben eindeutigen Schlüsseln bilden zusammen eine vollständige Lieferung, sobald alle zu migrierenden Peppol-IDs abgedeckt sind.

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