Wenn eine Organisation den Peppol-Provider wechselt, müssen die SMP-Registrierungen übertragen werden. Während der Übernahme bleibt die Participant-ID registriert, sodass Absender weiter senden können. 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:

Kein Migrationsschlüssel ohne Empfangsregistrierung: Hat die Party über eConnect keine aktive Peppol-Empfangsregistrierung (kein SMP-Claim für Empfang), gibt es nichts zu migrieren und prepareToMigrate ist nicht nötig. Melden Sie den Empfang direkt beim neuen Provider an. Nur-Senden mit noch bestehendem SMP-Claim bei eConnect ist nicht dasselbe wie "keine Empfangsregistrierung" — der Claim bleibt belegt und der Migrationsschlüssel ist nötig, um ihn freizugeben.

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 Abschluss wird die Service Group in der eConnect-SMP entfernt, gegebenenfalls mit einer temporären Weiterleitung gegen Unterbrechung.

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): Start im Platform über Meine Umgebung → Account kündigen → Migrieren. Eine lose Support-Anfrage ist nicht der Kundenweg. Ohne Portalzugang startet der Support das Kündigungsformular. Nach Formular, finanzieller Freigabe und Verarbeitung durch Superadmin-Support erhalten Sie den Migrationscode per gesicherter E-Mail von TechSupport, nicht im Ticket oder in einer Ankündigungsmail. Geben Sie den Code nur an den neuen Provider weiter. Zwei Bedingungen: (a) der Kunde erteilt eConnect 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

Während der Übernahme bleibt die Party im Netzwerk registriert. Rechnungen werden am alten und am neuen Access Point aufgefangen, damit der Rechnungsfluss nicht stehen bleibt. Welcher Punkt eine Nachricht erreicht, hängt vom Timing des SML-Updates (DNS) ab. Eine Standardmigration dauert meist einige Arbeitstage. eConnect begleitet das kostenlos.

Nach einer erfolgreichen Migration zu eConnect aktualisiert die SML die DNS-Einträge. Rechnen Sie nicht damit, dass jede Abfrage im selben Moment bereits auf den eConnect Access Point zeigt. 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