Lorsqu'une organisation change de fournisseur Peppol, les enregistrements SMP doivent être transférés. Le protocole de migration Peppol garantit que ce transfert s'effectue sans interruption de service : les expéditeurs peuvent continuer à envoyer normalement pendant la migration. Le PSB propose deux scénarios de migration via l'API.

Lorsqu'une party quitte eConnect pour un autre fournisseur Peppol Access Point, vous préparez la migration via l'endpoint prepareToMigrate :

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

Cet endpoint effectue deux actions :

1. Il marque la party dans le SMP eConnect comme "en migration"
2. Il enregistre une clé de migration auprès du SML Peppol

L'API retourne la clé de migration dans la réponse. Transmettez cette clé au nouveau fournisseur, qui en a besoin pour reprendre l'enregistrement dans son SMP.

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

Après la migration, la party est automatiquement supprimée du SMP eConnect.

Lorsqu'une party arrive chez eConnect depuis un autre fournisseur Peppol Access Point, vous avez besoin de la clé de migration générée par le fournisseur actuel. Ajoutez cette clé à la configuration de la party via :

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

Avec l'objet migration dans le corps de la requête :

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

Le PSB effectue la migration automatiquement : l'enregistrement SMP est repris et le SML est mis à jour. À partir de ce moment, tous les messages Peppol pour cette party transitent par l'Access Point eConnect.

Si la clé de migration est invalide ou expirée, la migration échoue et l'API retourne un message d'erreur. Dans ce cas, demandez une nouvelle clé au fournisseur actuel.

Voie non-API (clients de la plateforme) : les clients qui n'utilisent pas l'API démarrent la migration via le formulaire de résiliation/cessation sur support.econnect.eu — pas via une demande au support. Après soumission, ils reçoivent un code de migration qu'ils transmettent au nouveau fournisseur. Deux conditions s'appliquent au transfert : (a) le client donne à eConnect un mandat écrit/juridique à cet effet, et (b) le client n'a pas d'obligations financières en cours envers eConnect. Les étapes ci-dessous décrivent la procédure équivalente via l'API.

Intermédiaire/lot sans rôle Administrateur : un intermédiaire disposant uniquement d'une autorisation (pas de rôle Administrateur) sur des organisations clientes ne peut généralement pas lancer lui-même une résiliation/migration en self-service pour ces organisations. Pour une transition en lot de plusieurs organisations clientes/environnements, cela passe par le support (une clé de migration par identifiant Peppol) — pas via la révocation des clés de connexion. La révocation des clés de connexion rompt uniquement la liaison API et ne constitue pas une désinscription SMP.

Nombre de clés pour les demandes en lot : le nombre de clés de migration uniques peut être inférieur au nombre d'organisations dans la demande — seules les organisations avec un enregistrement de réception actif reçoivent une clé. Plusieurs e-mails contenant les mêmes clés uniques forment ensemble une livraison complète dès que tous les identifiants Peppol à migrer sont couverts.

1. La party décide de passer à un autre fournisseur
2. Appelez GET /api/v1/peppol/{partyId}/prepareToMigrate
3. Transmettez la clé de migration au nouveau fournisseur
4. Le nouveau fournisseur reprend l'enregistrement SMP avec la clé
5. L'enregistrement chez eConnect est automatiquement nettoyé

1. La party décide de passer à eConnect
2. Le fournisseur actuel génère une clé de migration
3. Appelez PUT /api/v1/peppol/config/party/{partyId} avec la clé de migration
4. Le PSB reprend l'enregistrement SMP et met à jour le SML
5. Configurez ensuite les capabilities et les hooks souhaités

Le protocole de migration Peppol est conçu pour un fonctionnement sans interruption. Pendant le transfert, la party reste enregistrée dans le réseau. Les expéditeurs qui envoient une facture à ce moment atteignent la party via l'ancien ou le nouveau Access Point, selon le timing de la propagation SML. Aucun message n'est perdu.

Après une migration réussie vers eConnect, la party est immédiatement joignable, mais la propagation SMP sur l'ensemble du réseau Peppol peut prendre quelques minutes. Après la migration, configurez toujours les capabilities et mettez en place les hooks nécessaires.

N'oubliez pas non plus de configurer les droits utilisateurs et une éventuelle businessCard via l'Enrollment API si cela n'a pas encore été fait.

Besoin d'aide pour une migration ? Contactez TechSupport pour un accompagnement dans le processus de migration.

• Réseau Peppol via l'API : SMP et capabilities
• Inscription Peppol via l'API (Enrollment)
• Aperçu : le Procurement Service Bus (PSB)
• Qu'est-ce que Peppol et comment fonctionne le réseau ?
• Peppol international
• S'inscrire sur Peppol (plateforme)
• Facturation électronique avec eConnect