Plánování změn nového komerčního předplatného pomocí rozhraní API Partnerského centra

se vztahuje na: Partnerské centrum

Tento článek popisuje, jak můžete pomocí rozhraní API Partnerského centra naplánovat změny nového komerčního předplatného, které probíhají pouze při prodloužení. Toto rozhraní API podporuje nová komerční licencovaná a softwarová předplatná.

Poznámka

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v tématu přehled nových obchodních prostředí.

Vytváření plánovaných změn umožňuje automaticky upravit předplatné, když dojde k dalšímu prodlužování platnosti. Plánováním změn můžete zvýšit nebo snížit počet licencí, upravit fakturační období a frekvenci a dokonce i upgradovat skladovou položku. Plánování změn umožňuje provádět změny předplatného při prodloužení, a ne okamžitě během aktuálního období.

Důležitý

Pokud provedete střednědobou (okamžitou) změnu před datem obnovení, odstraní se všechny plánované změny, které byly dříve naplánovány na obnovení.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru. Tento scénář podporuje ověřování jak samostatnými přihlašovacími údaji aplikace, tak přihlašovacími údaji aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v partnerském centru tak, že vyberete pracovní prostor Zákazníci, pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka, vyhledejte ID Microsoftu v části Informace o zákaznickém účtu. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného.
Automatické prodlužování je v předplatném povolené.

Metoda Partnerského centra

Naplánování změn předplatného v Partnerském centru:

Vyberte zákazníka.
Vyberte předplatné, pro které chcete naplánovat změny.
Povolit automatické prodlužování.
Vyberte Spravovat obnovení.
Proveďte změny předplatného, které vstoupí v platnost při obnově.
Pokud chcete boční panel zavřít, vyberte Okay.
Pro uložení změn zvolte Odeslat.

Poznámka

Prodloužení se zpracuje po posledním dni termínu počínaje 12:00 UTC následující den. Prodloužení se zpracovávají ve frontě a zpracování může trvat až 24 hodin.

jazyk C#

Naplánování změn pro předplatné zákazníka:

Získejte předplatné podle ID.
Získání způsobilosti pro naplánovaný typ přechodu.
Vytvořte ScheduledNextTermInstructions objekt a nastavte ho na vlastnost předplatného.
Zavolejte metodu Patch(), která aktualizuje předplatné plánovanými změnami.

var selectedSubscription = subscriptionOperations.Get();
selectedSubscription.ScheduledNextTermInstructions = new ScheduledNextTermInstructions
{
    Product = new ProductTerm
    {
        ProductId = changeToProductId,
        SkuId = changeToSkuId,
        AvailabilityId = changeToAvailabilityId,
        BillingCycle = changeToBillingCycle,
        TermDuration = changeToTermDuration,
    },
    Quantity = changeToQuantity,
    customTermEndDate = DateTime,
};
var updatedSubscription = subscriptionOperations.Patch(selectedSubscription);

Pokud chcete naplánovat změny předplatného zákazníka, kde je plánovaná změna na jiný produkt:

Získejte předplatné podle ID.
Získání způsobilosti pro naplánovaný typ přechodu.
Zavolejte metodu Patch(), která aktualizuje předplatné plánovanými změnami.

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI požadavku
ZÁPLATA	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id} HTTP/1.1

Parametr identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro volání rozhraní API.

Jméno	Typ	Požadovaný	Popis
id tenanta zákazníka	GUID	Й	Identifikátor GUID (globálně unikátní identifikátor) odpovídající zákazníkovi.
id předplatného	GUID	Й	Identifikátor GUID odpovídající předplatnému.

Hlavičky požadavku

Další informace najdete v tématu hlavičky REST Partnerského centra.

Text požadavku

V textu požadavku se vyžaduje úplný prostředek předplatného s definovanou vlastností scheduledNextTermInstructions. Pokud chcete naplánovat změny předplatného, ujistěte se, že je vlastnost AutoRenewEnabled nastavená na true.

Pro ID dostupnosti při ukončení prodeje s převody (EndofSaleWithConversions) nabídky:

Metoda GetTransitionEligibility pro návrat hodnoty CatalogItemID.

a. Ujistěte se, že jste nastavili naplánovaný typ způsobilosti, jinak je výchozí nastavení okamžité.
K extrahování ID dostupnosti použijte CatalogItemID.

Pokud k určení dostupnosti pro plánované pokynyNextTerm používáte příkaz GET a pokud jsou všechny podmínky ve stavu EOS, obdržíte prázdný seznam. Nejlepší způsob, jak určit platné cesty, je zavolat API GetTransitionEligibility, aby se zobrazily platné možnosti.

Pole	Typ	Požadovaný	Popis
plánované pokyny pro další termín	objekt	Й	Definuje další pokyny pro období předplatného. Vlastnost obsahuje objekt `product` a pole `quantity`.

Použití scheduledActions k nastavení pokynů pro další období (plánované změny)

Rozšířené podmínky služeb představují nový způsob nastavení pokynů ke konci období. Nová konstrukce scheduledActions umožňuje partnerům jednotným způsobem definovat aktualizace pro další období, včetně zrušení, obnovení na prodloužené období služby nebo obnovení na jiné cíle na konci období. Partneři mohou nastavit pokyny RenewToNewTerm v scheduledActions namísto předchozích scheduledNextTermInstructions. Další informace o použití scheduledActions k nastavení pokynů pro příští období služby najdete v dokumentaci k prodlouženému období služby.

Partneři, kteří používají scheduledActions, by se měli vyhnout také předávání scheduledNextTermInstructions při provádění aktualizací pro předplatná, která mají nárok na podmínky rozšířených služeb. Partneři se mohou rozhodnout obojí předat, ale měli by si uvědomit, že se berou v úvahu pouze scheduledActions. Partneři mohou nadále předávat pouze scheduledNextTermInstructions pro nastavení pokynů pro příští období.

Důležitý

Nepředávejte pokyny pro další období současně v scheduledActions i nextTermInstructions. Použijte jednu nebo druhou. Pokud jsou zadány oba, jako výchozí se použijí pokyny scheduledActions.

Žádost s využitím plánovaných akcí

{
  "autoRenewEnabled": true,
  "scheduledActions": [
    {
      "scheduledType": "TermEnd",
      "actionType": "RenewToNewTerm",
      "instructions": {
        "product": {
          "productId": "CFQ7TTC0LHXH",
          "skuId": "0001",
          "availabilityId": "CFQ7TTC0LHXH",
          "billingCycle": "annual",
          "termDuration": "P1Y",
          "promotionId": "39NFJQT20KJ2:0001:39NFJQT1Q5KK"
        },
        "quantity": 25,
        "customTermEndDate": "2027-11-31T23:59:59.000Z"
      }
    }
  ]
}

Odpověď s využitím plánovaných akcí

{
  "autoRenewEnabled": true,
  "scheduledNextTermInstructions" : {
     "product": {
        "productId": "CFQ7TTC0LHXH",
        "skuId": "0001",
        "availabilityId": "CFQ7TTC0LHXH",
        "billingCycle": "annual",
        "termDuration": "P1Y",
        "promotionId": "39NFJQT20KJ2:0001:39NFJQT1Q5KK"
      },
      "quantity": 25,
      "customTermEndDate": "2027-11-31T23:59:59.000Z"
  },
  "scheduledActions":   "scheduledActions": [
    {
      "scheduledType": "TermEnd",
      "actionType": "RenewToNewTerm",
      "instructions": {
        "product": {
          "productId": "CFQ7TTC0LHXH",
          "skuId": "0001",
          "availabilityId": "CFQ7TTC0LHXH",
          "billingCycle": "annual",
          "termDuration": "P1Y",
          "promotionId": "39NFJQT20KJ2:0001:39NFJQT1Q5KK"
        },
        "quantity": 25,
        "customTermEndDate": "2027-11-31T23:59:59.000Z"
      }
    }
  ]
}

Použití scheduledActions k nastavení přechodů při výročí

U vybraných tříletých SKU zahrnujících Microsoft Teams lze naplánovat přechod k výročí začátku daného období.

Žádost s využitím plánovaných akcí

{ 
    "id": "c10138d2-083b-4330-cf0d-6565dfaf22be", 
    "offerId": "CFQ7TTC0ZSXT:0001:CFQ7TTC0K85Z", 
    … 
    "scheduledActions": [ 
        { 
            "scheduleType": "CustomDate", // currently supported - EndOfTerm
            "actionType": "Transition", // currently supported - RenewToNewTerm, RenewToExtendedServiceTerm, Cancel 
            "effectiveDate": "2026-08-01", 
            "instructions": { 
                "product": { 
                    "productId": "CFQ7TTC0ZSXT", 
                    "skuId": "0001", 
                    "availabilityId": "CFQ7TTC0K8B0", 
                    "billingCycle": "monthly", 
                    "termDuration": "P1M" 
                }, 
            } 
        } 
    ] 
}

Požadavek používající naplánované pokyny pro příští období

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscription-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
If-Match: <etag>
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

{
    "id": "6e7aa601-629e-461b-8933-0898c3cc3c7c",
    "offerId": "DZH318Z0BXWC:0001:DZH318Z0BMJX",
    "offerName": "offer Name",
    "friendlyName": "friendly Name",
    "quantity": 1,
    "customTermEndDate": "2019-01-09T00:21:45.9263727",
    "unitType": "License(s)",
    "hasPurchasableAddons": false,
    "creationDate": "2019-01-04T01:00:12.6647304Z",
    "effectiveStartDate": "2019-01-09T00:21:45.9263727+00:00",
    "commitmentEndDate": "2019-02-08T00:21:45.9263727+00:00",
    "status": "active",
    "autoRenewEnabled": true,
    "scheduledNextTermInstructions": { 
      "product": { 
         "productId":  "DG7GMGF0DVSV", 
         "skuId":  "000P", 
         "availabilityId":  "DG7GMGF0F3Q9", 
         "billingCycle":  "Annual", 
         "termDuration":  "P3Y",
         "promotionId": "39NFJQT1PFPJ:000H:39NFJQT1Q5DK"
        }, 
      "quantity":  1 
      "customTermEndDate" : "2019-01-09T00:21:45.9263727",
     },  // original value = null 
    "isTrial": false,
    "billingType": "license",
    "billingCycle": "monthly",
    "termDuration": "P1M",
    "refundOptions": [{
        "type": "Full",
        "expiresAt": "2019-01-10T00:21:45.9263727+00:00"
    }],
    "isMicrosoftProduct": false,
    "partnerId": "",
    "contractType": "subscription",
    "publisherName": "publisher Name",
    "orderId": "ImxjLNL4_fOc-2KoyOxGTZcrlIquzls11",
    "attributes": {"objectType": "Subscription"},
}

Odpověď REST

Pokud je požadavek úspěšný, tato metoda vrátí v textu odpovědi aktualizované vlastnosti prostředku Předplatné.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď se dodává se stavovým kódem HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Odpověď pomocí naplánovaných pokynů pro příští období

HTTP/1.1 200 OK
Content-Length: 1322
Content-Type: application/json; charset=utf-8
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "id": "6e7aa601-629e-461b-8933-0898c3cc3c7c",
    "offerId": "DZH318Z0BXWC:0001:DZH318Z0BMJX",
    "offerName": "offer Name",
    "friendlyName": "friendly Name",
    "quantity": 1,
    "customTermEndDate": "2019-01-09T00:21:45.9263727",
    "unitType": "License(s)",
    "hasPurchasableAddons": false,
    "creationDate": "2019-01-04T01:00:12.6647304Z",
    "effectiveStartDate": "2019-01-09T00:21:45.9263727+00:00",
    "commitmentEndDate": "2019-02-08T00:21:45.9263727+00:00",
    "status": "active",
    "autoRenewEnabled": true,
    "scheduledNextTermInstructions": { 
      "product": { 
         "productId":  "DG7GMGF0DVSV", 
         "skuId":  "000P", 
         "availabilityId":  "DG7GMGF0F3Q9", 
         "billingCycle":  "Annual", 
         "termDuration":  "P3Y",
         "promotionId": "39NFJQT1PFPJ:000H:39NFJQT1Q5DK"
        }, 
      "quantity":  1 
      "customTermEndDate": "2019-01-09T00:21:45.9263727",
     },  // original value = null 
    "isTrial": false,
    "billingType": "license",
    "billingCycle": "monthly",
    "termDuration": "P1M",
    "refundOptions": [{
        "type": "Full",
        "expiresAt": "2019-01-10T00:21:45.9263727+00:00"
    }],
    "isMicrosoftProduct": false,
    "partnerId": "",
    "contractType": "subscription",
    "publisherName": "publisher Name",
    "orderId": "ImxjLNL4_fOc-2KoyOxGTZcrlIquzls11",
    "attributes": {"objectType": "Subscription"},
}

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-06-29

Plánování změn nového komerčního předplatného pomocí rozhraní API Partnerského centra

Požadavky

Metoda Partnerského centra

jazyk C#

Požadavek REST

Syntaxe požadavku

Parametr identifikátoru URI

Hlavičky požadavku

Text požadavku

Použití scheduledActions k nastavení pokynů pro další období (plánované změny)

Žádost s využitím plánovaných akcí

Odpověď s využitím plánovaných akcí

Použití scheduledActions k nastavení přechodů při výročí

Žádost s využitím plánovaných akcí

Požadavek používající naplánované pokyny pro příští období

Odpověď REST

Kódy úspěšnosti a chyb odpovědi

Odpověď pomocí naplánovaných pokynů pro příští období

Váš názor

Další materiály