Wanneer een organisatie van Peppol-provider wisselt, moeten de SMP-registraties worden overgedragen. Het Peppol-migratieprotocol zorgt ervoor dat dit zonder downtime verloopt: afzenders kunnen tijdens de migratie gewoon blijven versturen. De PSB biedt twee migratiescenario's via de API.

Geen migratiesleutel nodig zonder ontvangstregistratie: heeft de party via eConnect geen actieve Peppol-ontvangstregistratie (geen SMP-claim voor ontvangst)? Dan is er niets te migreren en is prepareToMigrate niet nodig. Meld de party in dat geval rechtstreeks aan bij de nieuwe provider voor ontvangst. Alleen-verzenden met nog wel een SMP-claim bij eConnect is niet hetzelfde als "geen ontvangstregistratie" -- de claim blijft dan geclaimd en de migratiesleutel-route is alsnog nodig om die vrij te geven.

Als een party van eConnect overstapt naar een andere Peppol Access Point provider, bereid je de migratie voor via het prepareToMigrate endpoint:

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

Dit endpoint doet twee dingen:

1. Het markeert de party in de eConnect SMP als "in migratie"
2. Het registreert een migratiesleutel bij de Peppol SML

De API retourneert de migratiesleutel in de response. Geef deze sleutel door aan de nieuwe provider, die de sleutel nodig heeft om de registratie over te nemen in hun SMP.

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

Na de migratie wordt de party automatisch uit de eConnect SMP verwijderd.

Als een party naar eConnect komt vanuit een andere Peppol Access Point provider, heb je de migratiesleutel nodig die de huidige provider heeft gegenereerd. Voeg deze sleutel toe aan de party-configuratie via:

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

Met het migration-object in de request body:

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

De PSB voltooit de migratie automatisch: de SMP-registratie wordt overgenomen en het SML wordt bijgewerkt. Vanaf dat moment lopen alle Peppol-berichten voor deze party via het eConnect Access Point.

Als de migratiesleutel ongeldig of verlopen is, mislukt de migratie en retourneert de API een foutmelding. Vraag in dat geval een nieuwe sleutel aan bij de huidige provider.

Niet-API route (platformklanten): klanten die geen API gebruiken starten de migratie via het opzeg-/beëindigingsformulier op support.econnect.eu -- niet via een support-aanvraag. Na opgave ontvangen zij een migratiecode die zij doorgeven aan de nieuwe provider. Aan de overdracht zijn twee voorwaarden verbonden: (a) de klant geeft eConnect hiervoor schriftelijk/juridisch opdracht, en (b) de klant heeft geen openstaande financiele verplichtingen bij eConnect. De stappen hieronder beschrijven de API-equivalente procedure.

Intermediair/bulk zonder Beheerder-rol: een intermediair met alleen een machtiging (geen Beheerder-rol) op klantorganisaties kan zelf meestal geen selfservice-opzeg/-migratie starten voor die orgs. Voor bulk-overstap van meerdere klantorgs/omgevingen loopt het via support (één migratiesleutel per Peppol-ID) -- niet via connection keys revoken. Het intrekken van verbindingssleutels breekt alleen de API-koppeling en is geen SMP-deregistratie.

1. De party beslist om naar een andere provider over te stappen
2. Roep GET /api/v1/peppol/{partyId}/prepareToMigrate aan
3. Geef de migratiesleutel door aan de nieuwe provider
4. De nieuwe provider neemt de SMP-registratie over met de sleutel
5. De registratie bij eConnect wordt automatisch opgeruimd

1. De party beslist om naar eConnect over te stappen
2. De huidige provider genereert een migratiesleutel
3. Roep PUT /api/v1/peppol/config/party/{partyId} aan met de migratiesleutel
4. De PSB neemt de SMP-registratie over en werkt het SML bij
5. Configureer vervolgens de gewenste capabilities en hooks

Het Peppol-migratieprotocol is ontworpen voor zero downtime. Tijdens de overdracht blijft de party geregistreerd in het netwerk. Afzenders die op dat moment een factuur versturen, bereiken de party via het oude of het nieuwe Access Point, afhankelijk van de timing van de SML-propagatie. Er gaan geen berichten verloren.

Na een succesvolle migratie naar eConnect is de party direct bereikbaar, maar de SMP-propagatie over het Peppol-netwerk kan enkele minuten duren. Configureer na de migratie altijd de capabilities en stel de benodigde hooks in.

Vergeet ook niet om via de Enrollment API de gebruikersrechten en eventuele businessCard in te richten als dat nog niet is gebeurd.

Hulp nodig bij een migratie? Neem contact op met TechSupport voor begeleiding bij het migratieproces.