Quando un'organizzazione cambia provider Peppol, le registrazioni SMP devono essere trasferite. Il protocollo di migrazione Peppol garantisce che ciò avvenga senza interruzioni: i mittenti possono continuare a inviare durante la migrazione. Il PSB offre due scenari di migrazione tramite l'API.

Se una party passa da eConnect a un altro provider Peppol Access Point, si prepara la migrazione tramite l'endpoint prepareToMigrate:

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

Questo endpoint fa due cose:

1. Contrassegna la party nell'SMP di eConnect come "in migrazione"
2. Registra una chiave di migrazione nell'SML di Peppol

L'API restituisce la chiave di migrazione nella risposta. Consegna questa chiave al nuovo provider, che ne ha bisogno per assumere la registrazione nel proprio SMP.

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

Dopo la migrazione, la party viene automaticamente rimossa dall'SMP di eConnect.

Se una party arriva a eConnect da un altro provider Peppol Access Point, è necessaria la chiave di migrazione generata dal provider attuale. Aggiungi questa chiave alla configurazione della party tramite:

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

Con l'oggetto migration nel corpo della richiesta:

{
  "migration": {
    "key": "la-chiave-di-migrazione-del-provider-attuale"
  }
}

Il PSB completa la migrazione automaticamente: la registrazione SMP viene assunta e l'SML viene aggiornato. Da quel momento, tutti i messaggi Peppol per questa party passano attraverso l'Access Point di eConnect.

Se la chiave di migrazione non è valida o è scaduta, la migrazione fallisce e l'API restituisce un messaggio di errore. In tal caso, richiedi una nuova chiave al provider attuale.

Percorso non-API (clienti della piattaforma): i clienti che non usano l'API avviano la migrazione tramite il modulo di disdetta/cessazione su support.econnect.eu — non tramite una richiesta al supporto. Dopo l'invio, ricevono un codice di migrazione che consegnano al nuovo provider. Alla cessione si applicano due condizioni: (a) il cliente conferisce a eConnect un mandato scritto/legale a tal fine, e (b) il cliente non ha obbligazioni finanziarie in essere verso eConnect. I passaggi seguenti descrivono la procedura equivalente via API.

Intermediario/in blocco senza ruolo Amministratore: un intermediario che dispone solo di una delega (nessun ruolo Amministratore) sulle organizzazioni clienti di norma non può avviare da solo una disdetta/migrazione self-service per tali organizzazioni. Per un passaggio in blocco di più organizzazioni/ambienti clienti, questo avviene tramite il supporto (una chiave di migrazione per identificativo Peppol) — non tramite la revoca delle connection key. La revoca delle chiavi di connessione interrompe solo il collegamento API e non costituisce una cancellazione dell'SMP.

Numero di chiavi per richieste in blocco: il numero di chiavi di migrazione univoche può essere inferiore al numero di organizzazioni nella richiesta — solo le organizzazioni con una registrazione di ricezione attiva ricevono una chiave. Più e-mail con le stesse chiavi univoche formano insieme una consegna completa una volta coperti tutti gli ID Peppol da migrare.

1. La party decide di passare a un altro provider
2. Chiama GET /api/v1/peppol/{partyId}/prepareToMigrate
3. Consegna la chiave di migrazione al nuovo provider
4. Il nuovo provider assume la registrazione SMP tramite la chiave
5. La registrazione presso eConnect viene ripulita automaticamente

1. La party decide di passare a eConnect
2. Il provider attuale genera una chiave di migrazione
3. Chiama PUT /api/v1/peppol/config/party/{partyId} con la chiave di migrazione
4. Il PSB assume la registrazione SMP e aggiorna l'SML
5. Configura poi le capabilities e gli hook desiderati

Il protocollo di migrazione Peppol è progettato per zero interruzioni. Durante il trasferimento, la party rimane registrata nella rete. I mittenti che inviano una fattura in quel momento raggiungono la party tramite il vecchio o il nuovo Access Point, a seconda dei tempi di propagazione dell'SML. Nessun messaggio viene perso.

Dopo una migrazione riuscita verso eConnect, la party è immediatamente raggiungibile, ma la propagazione SMP sulla rete Peppol può richiedere alcuni minuti. Dopo la migrazione, configura sempre le capabilities e imposta gli hook necessari.

Non dimenticare di configurare anche i permessi utente e, opzionalmente, una businessCard tramite la Enrollment API se non è già stato fatto.

Hai bisogno di aiuto con una migrazione? Contatta TechSupport per assistenza durante il processo di migrazione.

• Rete Peppol tramite l'API: SMP e capabilities
• Registrazione Peppol tramite l'API (Enrollment)
• Panoramica: la Procurement Service Bus (PSB)
• Cos'è Peppol e come funziona la rete?
• Peppol internazionale
• Registrarsi su Peppol (piattaforma)
• Fatturazione elettronica con eConnect