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.
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:
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.
{
"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í.
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.
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.
GET /api/v1/peppol/{partyId}/prepareToMigratePUT /api/v1/peppol/config/party/{partyId} s migračním klíčemBě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í.
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