Keď organizácia mení poskytovateľa Peppol, SMP registrácie musia byť prenesené. Migračný protokol Peppol zabezpečuje, že prebehne bez výpadkov: odosielatelia môžu počas migrácie naďalej odosielať. PSB ponúka dva migračné scenáre cez API.

Ak strana prechádza z eConnect k inému Peppol Access Point poskytovateľovi, migráciu pripravíte cez endpoint prepareToMigrate:

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

Tento endpoint vykoná dve veci:

1. Označí stranu v eConnect SMP ako "v migrácii"
2. Zaregistruje migračný kľúč v Peppol SML

API vráti migračný kľúč v odpovedi. Tento kľúč odovzdajte novému poskytovateľovi, ktorý ho potrebuje na prevzatie registrácie do svojho SMP.

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

Po migrácii sa strana automaticky odstráni z eConnect SMP.

Ak strana prichádza na eConnect od iného Peppol Access Point poskytovateľa, potrebujete migračný kľúč, ktorý vygeneroval aktuálny poskytovateľ. Tento kľúč pridajte do konfigurácie strany cez:

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

S objektom migration v tele požiadavky:

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

PSB dokončí migráciu automaticky: SMP registrácia sa prevezme a SML sa aktualizuje. Od tohto momentu prechádzajú všetky Peppol správy pre túto stranu cez eConnect Access Point.

Ak je migračný kľúč neplatný alebo vypršaný, migrácia zlyhá a API vráti chybové hlásenie. V takom prípade si vyžiadajte nový kľúč od aktuálneho poskytovateľa.

Ne-API cesta (zákazníci platformy): zákazníci, ktorí nepoužívajú API, začnú migráciu prostredníctvom formulára na zrušenie/ukončenie na support.econnect.eu — nie prostredníctvom žiadosti na podporu. Po odoslaní dostanú migračný kód, ktorý odovzdajú novému poskytovateľovi. Na prevod sa vzťahujú dve podmienky: (a) klient na to poskytne eConnect písomné/právne splnomocnenie, a (b) klient nemá voči eConnect žiadne neuhradené finančné záväzky. Nasledujúce kroky popisujú ekvivalentný postup cez API.

Sprostredkovateľ/hromadne bez role Administrátora: sprostredkovateľ, ktorý má na klientskych organizáciách iba splnomocnenie (nie rolu Administrátora), obvykle nemôže sám spustiť samoobslužné zrušenie/migráciu pre tieto organizácie. Pri hromadnom prechode viacerých klientskych organizácií/prostredí to prebieha cez podporu (jeden migračný kľúč na Peppol ID) — nie prostredníctvom zrušenia connection keys. Zrušenie spojovacích kľúčov prerušuje iba API prepojenie a nejde o zrušenie registrácie SMP.

Počet kľúčov pri hromadnej žiadosti: počet jedinečných migračných kľúčov môže byť nižší ako počet organizácií v žiadosti — kľúč dostane iba organizácia s aktívnou registráciou príjmu. Viacero e-mailov s rovnakými jedinečnými kľúčmi spolu tvoria úplné dodanie, akonáhle sú pokryté všetky migrované Peppol ID.

1. Strana sa rozhodne prejsť k inému poskytovateľovi
2. Zavolajte GET /api/v1/peppol/{partyId}/prepareToMigrate
3. Odovzdajte migračný kľúč novému poskytovateľovi
4. Nový poskytovateľ prevezme SMP registráciu pomocou kľúča
5. Registrácia v eConnect sa automaticky vymaže

1. Strana sa rozhodne prejsť na eConnect
2. Aktuálny poskytovateľ vygeneruje migračný kľúč
3. Zavolajte PUT /api/v1/peppol/config/party/{partyId} s migračným kľúčom
4. PSB prevezme SMP registráciu a aktualizuje SML
5. Následne nakonfigurujte požadované capabilities a hooky

Migračný protokol Peppol je navrhnutý na nulové výpadky. Počas prenosu zostáva strana zaregistrovaná v sieti. Odosielatelia, ktorí v tom čase posielajú faktúru, dosiahnu stranu cez starý alebo nový Access Point, v závislosti od načasovania SML propagácie. Žiadne správy sa nestratia.

Po úspešnej migrácii na eConnect je strana okamžite dosiahnuteľná, ale SMP propagácia v sieti Peppol môže trvať niekoľko minút. Po migrácii vždy nakonfigurujte capabilities a nastavte potrebné hooky.

Nezabudnite tiež cez Enrollment API nastaviť používateľské oprávnenia a prípadne businessCard, ak to ešte nebolo urobené.

Potrebujete pomoc s migráciou? Kontaktujte TechSupport pre asistenciu pri migračnom procese.

• Sieť Peppol cez API: SMP a capabilities
• Registrácia Peppol cez API (Enrollment)
• Prehľad: Procurement Service Bus (PSB)
• Čo je Peppol a ako funguje sieť?
• Peppol medzinárodný
• Registrácia na Peppol (platforma)
• Elektronická fakturácia s eConnect