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.

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