Peppol-migratie: Access Point wisselen

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.

Migreren van eConnect naar een andere provider

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:

Het markeert de party in de eConnect SMP als "in migratie"
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.

Voorbeeld response

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

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

Migreren naar eConnect van een andere provider

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.

Het migratieproces stap voor stap

Van eConnect weg

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

Naar eConnect toe

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

Continuïteit tijdens migratie

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.

Aandachtspunten

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.

Veelgestelde vragen

Gaan er berichten verloren tijdens een Peppol-migratie?

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

Wat als de migratiesleutel ongeldig of verlopen is?

Als de migratiesleutel niet meer geldig is, mislukt de migratie en retourneert de API een foutmelding. Vraag in dat geval een nieuwe migratiesleutel aan bij de huidige provider. De oude sleutel kan verlopen zijn door een tijdslimiet of al zijn gebruikt door een andere provider.

Moet ik na een migratie naar eConnect opnieuw capabilities instellen?

Ja, na een succesvolle migratie configureer je de gewenste capabilities (welke documenttypes de party kan ontvangen) en stel je de benodigde hooks in. Vergeet ook niet om via de Enrollment API de gebruikersrechten en eventueel een 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.

Neem contact op over migratie

Gerelateerd