/ docs
ProduktZnalostiVývojári
Platforma Control
Migrácia na eConnect alebo z eConnect

Migrácia registrácií Peppol na eConnect alebo z eConnect: migračný kľúč, API endpointy a proces.

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.

Migrácia z eConnect k inému poskytovateľovi

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.

Príklad odpovede
{
  "migrationKey": "abc123-def456-ghi789"
}

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

Migrácia na eConnect od iného poskytovateľa

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.

Migračný proces krok za krokom
Odchod z eConnect
  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
Príchod na eConnect
  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
Kontinuita počas migrácie

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.

Dôležité upozornenia

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.

Začnite s PSB API

Súvisiace
PreviousRegistrácia Peppol
NextMulti-channel