Migrace | eConnect

Když organizace mění poskytovatele Peppol, SMP registrace musí být přeneseny. Migrační protokol Peppol zajišťuje, že proběhne bez výpadků: odesílatelé mohou během migrace nadále 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:

Označí stranu v eConnect SMP jako "v migraci"
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 migraci se strana automaticky odstraní z eConnect SMP.

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): zákazníci, kteří nepoužívají API, zahájí migraci přes formulář zrušení/ukončení na support.econnect.eu — nikoli přes žádost na podporu. Po odeslání obdrží migrační kód, který předají novému poskytovateli. Na přenos se vztahují dvě podmínky: (a) zákazník k tomu poskytne eConnect písemné/právní zmocnění, a (b) zákazník nemá vůči eConnect žádné neuhrazené 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.

Strana se rozhodne přejít k jinému poskytovateli
Zavolejte GET /api/v1/peppol/{partyId}/prepareToMigrate
Předejte migrační klíč novému poskytovateli
Nový poskytovatel převezme SMP registraci pomocí klíče
Registrace v eConnect se automaticky vymaže

Příchod na eConnect

Strana se rozhodne přejít na eConnect
Aktuální poskytovatel vygeneruje migrační klíč
Zavolejte PUT /api/v1/peppol/config/party/{partyId} s migračním klíčem
PSB převezme SMP registraci a aktualizuje SML
Následně nakonfigurujte požadované capabilities a hooky

Kontinuita během migrace

Migrační protokol Peppol je navržen pro nulové výpadky. 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 je strana okamžitě dosažitelná, ale SMP propagace v síti Peppol může trvat několik minut. 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í