Migrace na eConnect nebo z eConnect

Migrace registrací Peppol na eConnect nebo z eConnect: migrační klíč, API endpointy a proces.

Když organizace mění poskytovatele Peppol, SMP registrace musí být přeneseny. Během převodu zůstává Participant ID registrováno, takže odesílatelé mohou dál odesílat. PSB nabízí dva migrační scénáře přes API.

Migrace z eConnect k jinému poskytovateli

Pokud strana přechází z eConnect k jinému Peppol Access Point poskytovateli, migraci připravíte přes endpoint prepareToMigrate:

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

Tento endpoint provede dvě věci:

  1. Označí stranu v eConnect SMP jako "v migraci"
  2. Zaregistruje migrační klíč v Peppol SML

API vrátí migrační klíč v odpovědi. Tento klíč předejte novému poskytovateli, který ho potřebuje pro převzetí registrace do svého SMP.

Příklad odpovědi
{
  "migrationKey": "abc123-def456-ghi789"
}

Po dokončení se Service Group v eConnect SMP odstraní, případně s dočasným přesměrováním proti přerušení.

Migrace na eConnect od jiného poskytovatele

Pokud strana přichází na eConnect od jiného Peppol Access Point poskytovatele, potřebujete migrační klíč, který vygeneroval aktuální poskytovatel. Tento klíč přidejte do konfigurace strany přes:

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

S objektem migration v těle požadavku:

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

PSB dokončí migraci automaticky: SMP registrace se převezme a SML se aktualizuje. Od tohoto momentu procházejí všechny Peppol zprávy pro tuto stranu přes eConnect Access Point.

Pokud je migrační klíč neplatný nebo vypršený, migrace selže a API vrátí chybové hlášení. V takovém případě si vyžádejte nový klíč od aktuálního poskytovatele.

Migrační proces krok za krokem
Odchod z eConnect

Ne-API cesta (zákazníci platformy): začněte v platformě přes Moje prostředí → Zrušit účet → Migrovat. Samostatná žádost na podporu není zákaznická cesta. Bez přístupu do portálu spustí podporu formulář. Po formuláři, finanční clearance a zpracování superadmin support přijde migrační kód zabezpečeným e-mailem od TechSupport, ne v ticketu ani v oznamovacím e-mailu. Předejte ho jen novému poskytovateli. Dvě podmínky: (a) zákazník dá eConnect písemný/právní pokyn, a (b) zákazník nemá vůči eConnect otevřené finanční závazky. Následující kroky popisují ekvivalentní postup přes API.

Zprostředkovatel/hromadně bez role Administrátora: zprostředkovatel, který má na zákaznických organizacích pouze zmocnění (nikoli roli Administrátora), obvykle nemůže sám spustit samoobslužné zrušení/migraci pro tyto organizace. Pro hromadný přechod více zákaznických organizací/prostředí probíhá toto přes podporu (jeden migrační klíč na Peppol ID) — nikoli přes zneplatnění connection keys. Zneplatnění spojovacích klíčů přeruší pouze API vazbu a nejde o zrušení registrace SMP.

Počet klíčů při hromadné žádosti: počet jedinečných migračních klíčů může být nižší než počet organizací v žádosti — klíč obdrží pouze organizace s aktivní registrací příjmu. Více e-mailů se stejnými jedinečnými klíči dohromady tvoří úplné dodání, jakmile jsou pokryta všechna migrovaná Peppol ID.

  1. Strana se rozhodne přejít k jinému poskytovateli
  2. Zavolejte GET /api/v1/peppol/{partyId}/prepareToMigrate
  3. Předejte migrační klíč novému poskytovateli
  4. Nový poskytovatel převezme SMP registraci pomocí klíče
  5. Registrace v eConnect se automaticky vymaže
Příchod na eConnect
  1. Strana se rozhodne přejít na eConnect
  2. Aktuální poskytovatel vygeneruje migrační klíč
  3. Zavolejte PUT /api/v1/peppol/config/party/{partyId} s migračním klíčem
  4. PSB převezme SMP registraci a aktualizuje SML
  5. Následně nakonfigurujte požadované capabilities a hooky
Kontinuita během migrace

Během převodu zůstává strana registrována v síti, takže odesílatelé mohou dál odesílat. Faktury se zachytí na starém i novém Access Pointu, aby tok faktur nestál. Který bod zprávu přijme, závisí na čase aktualizace SML (DNS). Standardní migrace trvá obvykle několik pracovních dní. eConnect ji vede bezplatně. Během přenosu zůstává strana zaregistrována v síti. Odesílatelé, kteří v tom čase posílají fakturu, dosáhnou stranu přes starý nebo nový Access Point, v závislosti na načasování SML propagace. Žádné zprávy se neztratí.

Důležitá upozornění

Po úspěšné migraci na eConnect aktualizuje SML DNS záznamy. Nepočítejte s tím, že každý lookup už ve stejný okamžik ukazuje na eConnect Access Point. Po migraci vždy nakonfigurujte capabilities a nastavte potřebné hooky.

Nezapomeňte také přes Enrollment API nastavit uživatelská oprávnění a případně businessCard, pokud to ještě nebylo provedeno.


Potřebujete pomoc s migrací? Kontaktujte TechSupport pro asistenci při migračním procesu.

Začněte s PSB API

Související