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.

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.

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

Po migraci se strana automaticky odstraní z eConnect SMP.

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.

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

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

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í.

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.

• Síť Peppol přes API: SMP a capabilities
• Registrace Peppol přes API (Enrollment)
• Přehled: Procurement Service Bus (PSB)
• Co je Peppol a jak funguje síť?
• Peppol mezinárodní
• Registrace na Peppol (platforma)
• Elektronická fakturace s eConnect