Lorsqu'une organisation change de fournisseur Peppol, les enregistrements SMP doivent être transférés. Pendant le transfert, l'identifiant Participant reste enregistré, afin que les expéditeurs puissent continuer à envoyer. 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 :

Pas de clé de migration sans enregistrement de réception : si la party n'a pas d'enregistrement de réception Peppol actif via eConnect (pas de claim SMP pour la réception), il n'y a rien à migrer et prepareToMigrate n'est pas nécessaire. Enregistrez la réception directement chez le nouveau fournisseur. L'envoi seul avec un claim SMP encore chez eConnect n'est pas la même chose que "pas d'enregistrement de réception" — le claim reste pris et la clé de migration reste nécessaire pour le libérer.

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"
}

Une fois terminé, le Service Group du SMP eConnect est retiré, éventuellement avec une redirection temporaire pour éviter une interruption.

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) : démarrez dans la plateforme via Mon environnement → Résilier le compte → Migrer. Une demande de support isolée n'est pas le parcours client. Sans accès au portail, le support lance le formulaire de résiliation. Après le formulaire, la clearance financière et le traitement par le support superadmin, vous recevez le code de migration dans un e-mail sécurisé de TechSupport, pas dans un ticket ni dans un e-mail d'annonce. Ne transmettez ce code qu'au nouveau fournisseur. Deux conditions : (a) le client donne à eConnect un mandat écrit/juridique, 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

Pendant le transfert, la party reste enregistrée dans le réseau, afin que les expéditeurs puissent continuer à envoyer. Les factures sont prises en charge sur l'ancien et le nouveau Access Point, pour que le flux de factures ne s'arrête pas. Le point atteint dépend du timing de la mise à jour SML (DNS). Une migration standard prend en général plusieurs jours ouvrés. eConnect accompagne ce processus sans frais.

Après une migration réussie vers eConnect, le SML met à jour les enregistrements DNS. Ne supposez pas que chaque recherche pointe déjà vers l'Access Point eConnect au même moment. 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