Správa životního cyklu předplatného SaaS

Komerční marketplace spravuje celý životní cyklus předplatného SaaS po jeho nákupu koncovým uživatelem. Používá cílovou stránku, rozhraní API pro plnění, rozhraní API operací a webhook jako mechanismus pro řízení skutečné aktivace, využití, aktualizací a zrušení předplatného SaaS. Vyúčtování koncového uživatele vychází ze stavu předplatného SaaS, které Microsoft udržuje.

Stavy předplatného SaaS

Následující diagram znázorňuje stavy předplatného SaaS a příslušné akce.

Zakoupené, ale ještě neaktivované (PendingFulfillmentStart)

Jakmile koncový uživatel nebo poskytovatel cloudových řešení (CSP) koupí nabídku SaaS na komerčním marketplace, vydavatel o nákupu obdrží oznámení. Vydavatel pak může vytvořit a nakonfigurovat nový účet SaaS na straně vydavatele pro koncového uživatele.

K vytvoření účtu může dojít:

1. Zákazník vybere tlačítko Konfigurovat účet, které je dostupné pro nabídku SaaS po úspěšném nákupu v Microsoft AppSource nebo na webu Azure Portal. Případně může zákazník použít tlačítko Konfigurovat hned v e-mailu, které obdrží krátce po nákupu.
2. Microsoft pak partnera upozorní na nákup otevřením adresy URL cílové stránky s parametrem tokenu (identifikační token nákupu z komerčního marketplace) na nové kartě prohlížeče.

Příkladem takového volání je https://contoso.com/signup?token=<blob>ale adresa URL cílové stránky pro tuto nabídku SaaS v Partnerském centru.https://contoso.com/signup Tento token poskytuje vydavateli ID, které jednoznačně identifikuje nákup SaaS a zákazníka.

V dalším kroku musí vydavatel předat token zpět Microsoftu voláním rozhraní API Pro překlad SaaS a zadáním tokenu jako hodnoty parametru x-ms-marketplace-token header . V důsledku volání rozhraní API resolve se token vymění za podrobnosti o nákupu SaaS, jako je jedinečné ID nákupu, ID zakoupené nabídky a ID zakoupeného plánu.

Na cílové stránce by měl být zákazník přihlášen k novému nebo existujícímu účtu SaaS prostřednictvím jednotného přihlašování (SSO) Microsoft Entra.

Vydavatel by měl implementovat jednotné přihlašování, aby poskytoval uživatelské prostředí vyžadované Microsoftem pro tento tok. Při konfiguraci jednotného přihlašování nezapomeňte použít víceklientské aplikace Microsoft Entra a povolit pracovní i školní účty nebo osobní účty Microsoft. Tento požadavek se vztahuje pouze na cílovou stránku pro uživatele, kteří jsou přesměrováni do služby SaaS, když už přihlášení pomocí přihlašovacích údajů Microsoftu. Jednotné přihlašování se nevyžaduje pro všechna přihlášení ke službě SaaS.

Po přihlášení by zákazník měl dokončit konfiguraci SaaS na straně vydavatele. Vydavatel pak musí volat rozhraní API pro aktivaci předplatného, aby odeslal signál do Azure Marketplace, že je zřizování účtu SaaS dokončené. Tato akce spustí fakturační cyklus zákazníka. Pokud volání rozhraní API pro aktivaci předplatného není úspěšné, zákazník se za nákup neúčtuje.

Kupující i vlastník fakturačního účtu obdrží e-mail s žádostí o konfiguraci účtu.

Aktivní (přihlášení k odběru)

Aktivní (přihlášení k odběru) je stabilní stav zřízeného předplatného SaaS. Po zpracování volání rozhraní API aktivovat předplatné Microsoft se předplatné SaaS označí jako předplacené. Zákazník teď může používat službu SaaS na straně vydavatele a fakturuje se.

Pokud už je předplatné SaaS aktivní, může zákazník vybrat Možnost Spravovat prostředí SaaS z webu Azure Portal nebo Správa Microsoftu 365 Center. Tato akce také způsobí, že Microsoft zavolá adresu URL cílové stránky s parametrem tokenu, jak se stane v toku Activate. Vydavatel by měl rozlišovat mezi novými nákupy a správou stávajících účtů SaaS a odpovídajícím způsobem zpracovávat volání adresy URL cílové stránky.

E-mail s oznámením o aktivaci se odešle kupujícímu i vlastníkovi fakturačního účtu.

Probíhá aktualizace (přihlášení k odběru)

Tato akce znamená, že microsoft i vydavatel zpracovává aktualizaci existujícího aktivního předplatného SaaS. Takovou aktualizaci může iniciovat:

• Zákazník z komerčního marketplace.
• CSP z komerčního marketplace.
• Zákazník z webu SaaS vydavatele (ale ne pro nákupy prováděné poskytovatelem CSP).

Pro předplatné SaaS jsou k dispozici dva typy aktualizací:

• Aktualizujte plán, když zákazník zvolí jiný plán předplatného.
• Aktualizujte množství, když zákazník změní počet zakoupených licencí pro předplatné.

Aktualizovat je možné pouze aktivní předplatné. Během aktualizace předplatného zůstane jeho stav na straně Microsoftu aktivní.

Aktualizace iniciovaná z komerčního marketplace

V tomto toku zákazník změní plán předplatného nebo množství licencí z webu Azure Portal nebo Správa Microsoftu 365 Center.

1. Po zadání aktualizace bude Microsoft volat adresu URL webhooku vydavatele nakonfigurovanou v poli Připojení webhooku na stránce Technická konfigurace v Partnerském centru s odpovídající hodnotou pro akci a další relevantní parametry.
2. Strana vydavatele by měla provést požadované změny ve službě SaaS a po dokončení upozornit Microsoft voláním rozhraní API pro aktualizaci stavu operace.
3. Pokud se oprava odešle se stavem selhání , proces aktualizace se na straně Microsoftu nedokončí. Předplatné SaaS uchovává stávající plán a množství licencí.

Posloupnost volání rozhraní API pro scénář aktualizace, který je zahájen z komerčního marketplace, je znázorněno v následujícím diagramu.

Aktualizace iniciovaná vydavatelem

V tomto toku zákazník změní plán předplatného nebo množství licencí zakoupených přímo ze služby SaaS.

1. Před provedením požadované změny na straně vydavatele musí kód vydavatele volat rozhraní API plánu změn, rozhraní API pro změnu množství nebo obojí.
2. Microsoft použije změnu u předplatného a pak vydavatele upozorní prostřednictvím webhooku Připojení, aby použil stejnou změnu.
3. Teprve potom by vydavatel měl provést požadovanou změnu předplatného SaaS a upozornit Microsoftu, když se tato změna provede voláním rozhraní API pro aktualizaci stavu operace.

Posloupnost volání rozhraní API pro scénář aktualizace iniciovaný ze strany vydavatele je znázorněna v následujícím diagramu.

E-mail s oznámením o změně plánu se pošle jak zákazníkovi, tak vlastníkovi fakturačního účtu.

E-mail s oznámením o změně množství se pošle kupujícímu i vlastníkovi fakturačního účtu.

Pozastaveno (pozastaveno)

Tento stav označuje, že platba zákazníka za službu SaaS nebyla přijata. Společnost Microsoft oznámí vydavateli tuto změnu ve stavu předplatného SaaS. Oznámení se provádí prostřednictvím volání webhooku s parametrem akce nastaveným na Pozastaveno.

Vydavatel může nebo nemusí provádět změny služby SaaS na straně vydavatele. Doporučujeme, aby vydavatel tyto informace zpřístupňuje pozastaveným zákazníkům a omezením nebo blokuje přístup zákazníka ke službě SaaS. Existuje pravděpodobnost, že platba nebude nikdy přijata.

Pokud je předplatné v pozastaveném stavu:

• Partner nebo isV musí udržovat účet SaaS v obnovitelném stavu, aby bylo možné obnovit plnou funkčnost bez ztráty dat nebo nastavení.
• Partner nebo isV by měli očekávat, že žádost o obnovení předplatného, pokud se platba obdrží během období odkladu, nebo žádost o zrušení zřízení předplatného na konci období odkladu. Oba požadavky se odešlou prostřednictvím mechanismu webhooku.

Stav předplatného se před provedením jakékoli akce změní na Pozastaveno na straně Microsoftu. Pozastavit je možné jenom aktivní předplatná.

E-mail s oznámením o změně stavu "pozastaveno" se pošle jak zákazníkovi, tak vlastníkovi fakturačního účtu.

Po uplynutí 30denní lhůty pozastavení se zákazníkovi i vlastníkovi fakturačního účtu odešle e-mail týkající se zrušení po pozastavení.

Obnoveno (pozastaveno)

Tato akce označuje, že platební nástroj zákazníka je znovu platný, provede se platba za předplatné SaaS a předplatné se obnoví. V tomto případě:

1. Microsoft volá webhook s parametrem akce nastaveným na hodnotu Reinstate.
2. Vydavatel zajistí, aby předplatné znovu fungovalo na straně vydavatele.
3. Proces obnovení proběhne úspěšně a zákazník se znovu fakturuje za předplatné SaaS.

Znovu je možné obnovit pouze pozastavené předplatné. Pozastavené předplatné SaaS zůstane v pozastaveném stavu, zatímco se obnoví. Po dokončení této operace se stav předplatného změní na Aktivní.

Po přechodu z pozastaveného stavu na obnovený stav se odešle e-mail kupujícímu i vlastníkovi fakturace.

Obnoveno (přihlášeno k odběru)

Předplatné SaaS automaticky prodloužil Microsoft na konci období předplatného měsíce nebo roku. Výchozí nastavení automatického prodlužování platnosti platí pro všechna předplatná SaaS. Aktivní předplatná SaaS se budou dál obnovovat s pravidelným tempem. Společnost Microsoft poskytuje oznámení webhooku jen pro informace o událostech obnovení. Zákazník může vypnout automatické prodlužování předplatného SaaS prostřednictvím portálu Správa Microsoftu 365. V takovém případě se předplatné SaaS automaticky zruší na konci aktuálního fakturačního období. Zákazníci také můžou předplatné SaaS kdykoli zrušit.

Automaticky se prodloužila pouze aktivní předplatná. Předplatná zůstanou aktivní během procesu prodloužení a pokud automatické prodlužování proběhne úspěšně. Po prodloužení se počáteční a koncové datum období předplatného aktualizují na data nového období.

Pokud automatické prodlužování selže kvůli problému s platbou, předplatné se pozastaví a vydavatel bude upozorněn.

E-maily s připomenutím pro prodloužení se pošlou jak kupujícímu, tak vlastníkovi fakturačního účtu, 30 dní před ročním nebo víceletkovým datem prodloužení platnosti.

Zrušeno (odhlášené)

Předplatná dosáhnou tohoto stavu v reakci na explicitní akci zákazníka nebo poskytovatele CSP zrušením předplatného z webu vydavatele, webu Azure Portal nebo webu Správa Microsoftu 365 Center. Předplatné lze také implicitně zrušit v důsledku neplacení splatnosti po dobu 30 dnů v pozastaveném stavu.

Jakmile vydavatel obdrží volání webhooku zrušení, měli by uchovávat zákaznická data pro obnovení na žádost nejméně sedm dní. Pouze pak je možné odstranit zákaznická data.

Předplatné SaaS je možné kdykoliv v jeho životním cyklu zrušit. Po zrušení předplatného se nedá znovu aktivovat.

E-mail o zrušení se pošle kupujícímu i vlastníkovi fakturačního účtu.

Související obsah

• Rozhraní API předplatného plnění SaaS v2
• Rozhraní API pro operace plnění SaaS v2

Videonávody

• Vytvoření jednoduchého portálu vydavatele SaaS v .NET
• Použití rozhraní REST Fulfillment API nabídky SaaS