Kosár létrehozása vevői megrendeléssel

A következővonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont az Amerikai Kormányzat Microsoft Cloud-ja számára

Egy ügyfél megrendelését kosárba helyezheti. További információ a jelenleg elérhető értékesítésről: Partnerajánlatok a felhőszolgáltatói programban.

Jegyzet

A kosarak a kezdeti létrehozástól számított hét nap után lejárnak.

Előfeltételek

  • Hitelesítő adatok, ahogyan a Partnerközponti hitelesítés leírja. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti azt a Partnerközpont segítségével úgy, hogy kiválasztja a Ügyfelek munkaterületet, majd az ügyféllistából az ügyfelet, és végül a Fióklehetőséget. Az ügyfél fiókjának oldalán keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

C#

Rendelés létrehozása egy ügyfél számára:

  1. Példányosíts egy Cart objektumot.

  2. Hozzon létre egy listát CartLineItem objektumokról, és rendelje hozzá a listát a kosár LineItems tulajdonságához. Minden egyes kosársorelem egy termék vásárlási adatait tartalmazza. Legalább egy tételnek kell lennie a kosárban.

  3. A IAggregatePartner.Customers.ById metódus meghívásával, az ügyfél azonosítójának segítségével azonosítsa az ügyfelet, majd szerezze be a felületet a kosárműveletekhez a Cart tulajdonságból.

  4. A kosár létrehozásához hívja meg a Create vagy CreateAsync metódust.

  5. Az igazolás befejezéséhez és más viszonteladókhoz való hozzáadásához tekintse meg a következő mintakérési és válaszmintákat:

Minta kérése


{
    "PartnerOnRecordAttestationAccepted":true,     "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "quantity": 1,
            "billingCycle": "monthly",
            "termDuration": "P1M",
            "renewsTo": null,
            "provisioningContext": {},
            "customTermEndDate": "2022-02-19T00:00:00Z"
        },
        {
            "id": 1,
            "catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
            "quantity": 2,
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "participants": [
                {
                    "key": "transaction_reseller",
                    "value": "5357564"
                },
                 {
                    "key": "additional_transaction_reseller",                     
                    "value": "517285"
                },
                 {
                    "key": "additional_transaction_reseller", 
                    "value": "5357563"
                }
            ]
        }
    ]
}

Válaszminta


{
    "id": "3e22b548-647d-4223-9675-1fcb6cb57665",
    "creationTimestamp": "2021-08-18T17:29:52.3517492Z",
    "lastModifiedTimestamp": "2021-08-18T17:29:52.3517553Z",
    "expirationTimestamp": "2021-08-25T17:30:11.2406416Z",
    "lastModifiedUser": "da62a0dc-35e9-4601-b48e-a047bd3ec7c1",
    "status": "Active",
    "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "quantity": 1,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1M",
	    "customTermEndDate": "2022-02-19T00:00:00Z";
            "provisioningContext": {},
            "orderGroup": "0"
        },
        {
            "id": 1,
            "catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
            "quantity": 2,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "participants": [
                {
                    "key": "transaction_reseller",
                    "value": "5357564"
                },
                {
                    "key": "additional_transaction_reseller", 
                    "value": "517285"
                },
                {
                    "key": "additional_transaction_reseller", 
                    "value": "5357563"
                }
            ],
            "provisioningContext": {},
            "orderGroup": "0"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/carts/3e22b548-647d-4223-9675-1fcb6cb57665",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Cart"
    }
}

C# példa

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

var cart = new Cart()
{
    LineItems = new List<CartLineItem>()
    {
        new CartLineItem()
        {
      /* Microsoft Azure Subscription */
            Id = 0,
            CatalogItemId = "MS-AZR-0145P",
            Quantity = 1,
            BillingCycle = BillingCycleType.Monthly,
            TermDuration = "P1Y"
        },
        new CartLineItem()
        {
      /* Azure Reserved Instance */
            Id = 1,
            CatalogItemId = "DZH318Z0BQ36:004G:DZH318Z08C0S",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime,
            TermDuration = "P1Y",
            ProvisioningContext = new Dictionary<string, string>
            {
                { "subscriptionId", subscriptionId },
                { "scope", "shared" }
            }
        },
        new CartLineItem()
        {
      /* Azure Reserved Instance */
            Id = 2,
            CatalogItemId = "DZH318Z0BQ36:004J:DZH318Z08B8X",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime,
            TermDuration = "P3Y",
            ProvisioningContext = new Dictionary<string, string>
            {
                { "subscriptionId", subscriptionId },
                { "scope", "shared" }
            }
        },
        new CartLineItem()
        {
      /* Perpetual Software */
            Id = 3,
            CatalogItemId = "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime
        },
        new CartLineItem()
        {
      /* SaaS */
            Id = 4,
            CatalogItemId = "DZH318Z0BXWC:0002:DZH318Z0BMRV",
            Quantity = 1,
            BillingCycle = BillingCycleType.Monthly,
            TermDuration = "P1M"
        },
        new CartLineItem()
        {
      /* SaaS Free Trial */
            Id = 5,
            CatalogItemId = "DZH318Z0C0WF:0001:DZH318Z0BP69",
            Quantity = 10,
            BillingCycle = BillingCycleType.None,
            TermDuration = "P1M",
            RenewsTo = new RenewsTo
            {
                TermDuration = "P1Y"
            }
        }
    }
};

cart = partnerOperations.Customers.ById(customerId).Carts.Create(cart);

Java

A Partnerközpont Java SDK használható a Partnerközpont erőforrásainak kezelésére. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, kérhet segítséget a közösségtől, vagy jelenthet egy hibát a GitHubon.

Rendelés létrehozása egy ügyfél számára:

  1. Példányosíts egy Cart objektumot.

  2. Hozzon létre egy listát CartLineItem objektumokról, és rendelje hozzá a listát a kosár sorelemeihez. Minden egyes kosársorelem egy termék vásárlási adatait tartalmazza. Legalább egy tételnek kell lennie a kosárban.

  3. A IAggregatePartner.getCustomers().byId függvény és az ügyfélazonosító meghívásával szerezze be a kosár műveleteihez szükséges felületet az ügyfél azonosításához, majd kérje le a felületet a getCart függvényből.

  4. A kosár létrehozásához hívja meg a create függvényt.

Java-példa

// IAggregatePartner partnerOperations;
// String customerId;
// String subscriptionId;
// String catalogItemId;

CartLineItem lineItem = new CartLineItem();

lineItem.setBillingCycle(BillingCycleType.OneTime);
lineItem.setCatalogItemId(catalogItemId);
lineItem.setFriendlyName("Sample RI Purchase");
lineItem.setQuantity(1);

Map<String, String> provisioningContext = new HashMap<String,String>();

provisioningContext.put("duration", "3Years");
provisioningContext.put("scope", "shared");
provisioningContext.put("subscriptionId", subscriptionId);

lineItem.setProvisioningContext(provisioningContext);

List<CartLineItem> lineItemList = new ArrayList<CartLineItem>();
lineItemList.add(lineItem);

Cart cart = new Cart();
cart.setLineItems(lineItemList);

Cart cartCreated = partnerOperations.getCustomers().byId(customerId).getCarts().create(cart);

PowerShell

A Partnerközpont PowerShell-modulja használható a Partnerközpont erőforrásainak kezelésére. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, kérhet segítséget a közösségtől, vagy jelenthet egy hibát a GitHubon.

Rendelés létrehozása egy ügyfél számára:

  1. Példányosíts egy Cart objektumot.

  2. Hozzon létre egy listát CartLineItem objektumokról, és rendelje hozzá a listát a kosár sorelemeihez. Minden egyes kosársorelem egy termék vásárlási adatait tartalmazza. Legalább egy tételnek kell lennie a kosárban.

  3. Hajtsa végre a New-PartnerCustomerCart parancsot a kosár létrehozásához.

# $customerId
# $subscriptionId
# $catalogItemId

$lineItem = New-Object -TypeName Microsoft.Store.PartnerCenter.PowerShell.Models.Carts.PSCartLineItem

$lineItem.BillingCycle = 'OneTime'
$lineItem.CatalogItemId = $catalogItemId
$lineItem.FriendlyName = 'Sample RI Purchase'
$lineItem.ProvisioningContext.Add('duration', '1Year')
$lineItem.ProvisioningContext.Add('scope', 'shared')
$lineItem.ProvisioningContext.Add('subscriptionId', $subsciptionId)
$lineItem.Quantity = 10

New-PartnerCustomerCart -CustomerId $customerId -LineItems $lineItem

REST-kérés

Kérés szintaxisa

Módszer URI kérése
BEJEGYZÉS {baseURL}/v1/customers/{customer-id}/carts HTTP/1.1

URI-paraméter

Az ügyfél azonosításához használja az alábbi elérési út paramétert.

Név Típus Szükséges Leírás
ügyfél-azonosító karakterlánc Igen Guid formátumú ügyfél-azonosító, amely azonosítja az ügyfelet.

Kérelemfejlécek

További információért tekintse meg a Partnerközpont REST-fejléceket.

Kérési szöveg

Ez a táblázat a kérelem törzsében található Kosár tulajdonságait ismerteti.

Ingatlan Típus Szükséges Leírás
azonosító karakterlánc Nem A kosár sikeres létrehozásakor megadott kosárazonosító.
létrehozásiIdőbélyeg DátumIdő Nem A kosár létrehozásának dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor.
utolsó módosítás időbélyege DátumIdő Nem A kosár utolsó frissítésének dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor.
lejáratiIdőbélyeg DátumIdő Nem A kosár lejáratának dátuma dátum-idő formátumban. Alkalmazva a kosár sikeres létrehozásakor.
utoljára módosító felhasználó karakterlánc Nem A felhasználó, aki legutóbb frissítette a kosárt. Alkalmazva a kosár sikeres létrehozásakor.
lineItems Objektumok tömbje Igen CartLineItem-erőforrások tömbje.
Partner nyilvántartás hitelesítés elfogadva logikai Igen Igazolja az igazolás befejezését

Ez a táblázat a kérelem törzsében található CartLineItem tulajdonságait ismerteti.

Jegyzet

Amikor az API-n keresztül kivesszük a kosarat, a sorelemek feldolgozása a kosárba helyezett sorrendben történik. A megrendelés hatással lehet az Új ajánlat korlátozásokkal rendelkező promóciókra való jogosultságra, ha két azonos típusú termék található a kosárban, az egyik a promóció azonosítójával, a másik pedig anélkül (például különböző feltételekkel). Ha több tételt szeretne vásárolni, először helyezze a promócióra jogosult sorelemeket a kosárba.

Ingatlan Típus Szükséges Leírás
azonosító karakterlánc Nem Egy kosársorelem egyedi azonosítója. Alkalmazva a kosár sikeres létrehozásakor.
catalogId karakterlánc Igen A katalóguselem azonosítója. Győződjön meg arról, hogy a katalóguselem rendelkezésre állása a megfelelő szegmenshez tartozik.
barátságos név karakterlánc Nem Szabadon választható. A partner által meghatározott elem barátságos neve, amely segít a tisztázásban.
promotionId karakterlánc Nem Szabadon választható. A legtöbb új kereskedelmi promóció automatikusan érvényes, azonban ha az opcionális promóciók (például a Bridge to the Cloud 2) egy kosársorra vonatkoznak, a partnereknek tartalmazniuk kell az előléptetés azonosítóját a kosárhoz való hozzáadáskor.
mennyiség Int Igen A licenceek vagy példányok száma.
pénznemkód karakterlánc Nem A pénznem kódja.
számlázási ciklus Tárgy Igen Az aktuális időszakhoz beállított számlázási ciklus típusa.
egyediIdőszakVégeDátum DátumIdő Nem Annak a meglévő előfizetésnek a záró dátuma, amelyhez az új előfizetést össze szeretné fűzni.
Résztvevők Objektumsztring-párok listája Nem PartnerId rekordon (PartnerID) gyűjteménye a vásárlás során.
Ellátási környezet Szótár<string, string> Nem A katalógus egyes elemeinek ellátásához szükséges információk. A termékváltozatban található ProvisioningVariables tulajdonság azt jelzi, hogy mely tulajdonságok szükségesek a katalógus egyes elemeihez.
rendeléscsoport karakterlánc Nem Egy csoport, amely jelzi, hogy mely elemek helyezhetők el együtt.
hiba Tárgy Nem A kosár létrehozása után alkalmazva, ha hiba történt.
renewsTo Objektumok tömbje Nem RenewsTo erőforrások tömbje.
IgazolásElfogadva logikai Nem Az ajánlatra vagy termékváltozatra vonatkozó feltételeket jelzi. Csak olyan ajánlatokhoz vagy termékváltozatokhoz szükséges, ahol a SkuAttestationProperties vagy az OfferAttestationProperties enforceAttestation igaz.
transaction_reseller Sztring Nem Ha egy közvetett szolgáltató megrendelést ad egy közvetett viszonteladó nevében, töltse ki ezt a mezőt a közvetett viszonteladó partnerazonosítójával csak (a közvetett szolgáltató azonosítója soha nem). Ez biztosítja az ösztönzők megfelelő nyilvántartását.
további tranzakciós viszonteladó Sztring Nem Ha egy közvetett szolgáltató megrendelést ad egy közvetett viszonteladó nevében, ezt a mezőt csak az Extra közvetett viszonteladó PartnerID azonosítójával töltse fel (a közvetett szolgáltató azonosítója soha nem). Az ösztönzők nem alkalmazhatók más viszonteladókra. Legfeljebb öt közvetett viszonteladó adható meg. Ez a követelmény kizárólag az európai országokban/régiókban üzleti tevékenységet folytató partnerekre vonatkozik.
ütemezettNextTermInstructions Tárgy Nem Meghatározza a próbaverziós előfizetés következő kifejezési utasításait. A partnerek megadhatják a megfelelő fizetős előfizetés időtartamát, számlázási gyakoriságát és mennyiségét megújításkor.

Ez a táblázat a Microsoft Marketplace-ajánlatok kérelemtörzsében található RenewsTo tulajdonságokat ismerteti.

Ingatlan Típus Szükséges Leírás
futamidő karakterlánc Nem A megújítási időszak időtartamának ISO 8601-es ábrázolása. Az aktuális támogatott értékek P1M (1 hónap) és P1Y (1 év).
ScheduledNextTermInstructions

Ez a táblázat az NCE licencalapú próbaverziós ajánlatok kérelem törzsében található scheduledNextTermInstructions tulajdonságokat ismerteti. Ha nincsenek megadva értékek, a próbaverziók fizetős előfizetésekké újulnak meg éves időtartammal, havi számlázással és 25 licenccel.

Ingatlan Típus Szükséges Leírás
termék tömb Nem Egy tömb, amely meghatározza, hogy a próba-előfizetés mely ajánlatra vált át, továbbá a fizetős előfizetés időtartamát és számlázási gyakoriságát tartalmazza.
mennyiség Int Nem A próbaajánlat megújítása után a megfelelő fizetős előfizetés licencmennyisége.
Termék

Ez a táblázat az NCE licencalapú próbaverziós ajánlatokra vonatkozó kérelem törzsében található productTerm tulajdonságokat ismerteti. Ha ebben a tömbben nincsenek megadva értékek, a próbaverziók fizetős előfizetésekké újulnak meg éves, havi számlázással.

Ingatlan Típus Szükséges Leírás
Termékazonosító karakterlánc Nem A próbaverzió által megújított fizetős előfizetés termékét ábrázoló GUID-azonosító.
skuId karakterlánc Nem A próbaverzió által megújított fizetős előfizetés termékváltozatát jelképező GUID.
availabilityId karakterlánc Nem A próbaverzió által megújuló fizetős előfizetés rendelkezésre állását szemléltető GUID.
számlázási ciklus karakterlánc Nem A megfelelő fizetős előfizetés számlázási gyakorisága a próbaajánlat megújítása után.
futamidő karakterlánc Nem Az az időtartam, amelyet a megfelelő fizetős előfizetés a próbaajánlat megújítása után érvényes lesz.

Példa kérése

POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 496
Expect: 100-continue

{
  "lineItems": [
    {
    /* Microsoft Azure Subscription */
      "id": 0,
      "catalogItemId": "MS-AZR-0145P",
      "quantity": 1,
      "billingCycle": "monthly",
      "termDuration": "P1Y"
    },
    {
    /* Azure Reserved Instance */
      "id": 1,
      "catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
      "quantity": 1,
      "billingCycle": "one_time",
      "termDuration": "P1Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      }
    },
    {
    /* Azure Reserved Instance */
      "id": 2,
      "catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
      "quantity": 1,
      "billingCycle": "one_time",
      "termDuration": "P3Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "single"
      }
    },
    {
    /* Perpetual Software */
      "id": 3,
      "catalogItemId": "DG7GMGF0DWTL:0001:DG7GMGF0DSFM",
      "quantity": 1,
      "billingCycle": "one_time"
    },
    {
    /* SaaS */
      "id": 4,
      "catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
      "quantity": 1,
      "billingCycle": "monthly",
      "termDuration": "P1M"
    },
  {
    /* SaaS Free Trial */
       "id": 5,
       "catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
       "quantity": 10,
       "billingCycle": "none",
       "termDuration": "P1M",
       "renewsTo": {
         "termDuration": "P1Y"
       }
    }
  ]
}

Fontos

2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. A GitHubról letöltheted az SDK-kiadást, valamint egy hasznos információkat tartalmazó readme fájlt.

A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

REST-válasz

Ez a metódus, ha sikeres, a válasz törzsében lévő kitöltött Kosár erőforrást adja vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát és a hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes lista, lásd a hibakódok.

Példa válaszra

HTTP/1.1 201 Created
Content-Length: 764
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
X-Locale: en-US,en-US
MS-CV: sF/wRa2ih0CzbABc.0
MS-ServerId: 000001
Date: Thu, 15 Mar 2018 17:15:01 GMT
{
  "id": "3655b1a0-b1c9-4268-9824-577fdbc4d0be",
  "creationTimestamp": "2019-01-16T00:45:41.6062996Z",
  "lastModifiedTimestamp": "2019-01-16T00:45:41.6062996Z",
  "expirationTimestamp": "2019-01-16T01:00:54.4188497Z",
  "lastModifiedUser": "1824b7fc-2fac-4478-b177-66823c40ab75",
  "status": "Active",
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "MS-AZR-0145P",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "monthly",
      "termDuration": "P1Y",
      "orderGroup": "OMS-0"
    },
    {
      "id": 1,
      "catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "termDuration": "P1Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      },
      "orderGroup": "0"
    },
    {
      "id": 2,
      "catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "termDuration": "P3Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      },
      "orderGroup": "0"
    },
    {
      "id": 3,
      "catalogItemId": "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "orderGroup": "0"
    },
    {
      "id": 4,
      "catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "monthly",
      "termDuration": "P1M",
      "orderGroup": "1"
    },
  {
      "id": 5,
      "catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
      "quantity": 10,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "renewsTo": {
  "termDuration": "P1Y"
      },
    "orderGroup": "2"
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/28045616-f6b9-462f-9701-0d89b5e65c44/carts/3655b1a0-b1c9-4268-9824-577fdbc4d0be",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Cart"
  }
}

Példa új kereskedelmi licencalapú szolgáltatásokra

Jegyzet

A licencalapú szolgáltatások új kereskedelmi felületei számos új képességet tartalmaznak, és minden felhőszolgáltató (CSP) számára elérhetők. További információ: új kereskedelmi szolgáltatások áttekintése.

Példa kérése

POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165

{
	"LineItems": [
		{
			"CatalogItemId":"CFQ7TTC0LFLZ:0002:CFQ7TTC0K4TS",
			"Quantity": 1,
			"TermDuration": "P1M",
			"BillingCycle": "Monthly"
		}
	]
}

Fontos

Az Azure-terv és az állandó szoftversorelemek nem támogatják a termDuration tulajdonságot. Kerülje el, hogy ezt magába foglalja, miközben az ilyen típusú elemeket szerzi be.

// request example where several renewal values for an NCE license-based trial are specified
http
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
      "quantity": 25,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "promotionId": null,
      "provisioningContext": {},
      "customTermEndDate": null,
      "scheduledNextTermInstructions": {
        "product": {
          "billingCycle": "monthly",
          "termDuration": "P1M" 
        }
      }
    }
  ],
  "partnerOnRecordAttestationAccepted": true
}

REST-válasz

Ez a metódus, ha sikeres, a válasz törzsében lévő kitöltött Kosár erőforrást adja vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes lista, lásd a hibakódok.

Példa válaszra


{
    "id": "2517c51b-58cd-4abe-87ed-3ab812401ab4",
    "creationTimestamp": "2023-07-11T21:16:11.55149Z",
    "lastModifiedTimestamp": "2023-07-11T21:16:11.5515713Z",
    "expirationTimestamp": "2023-07-18T21:16:17.2480482Z",
    "lastModifiedUser": "9db12087-fbc3-481c-8965-73d44ff88e27",
    "status": "Active",
    "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0VZW5",
            "quantity": 1,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "provisioningContext": {},
            "orderGroup": "0",
            "pricing": {
                "listPrice": 30.4,
                "discountedPrice": 30.4,
                "proratedPrice": 30.4,
                "price": 30.4,
                "extendedPrice": 364.8
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/ebd8b4c2-4069-46a8-bd70-123d6dec3e39/carts/2517c51b-58cd-4abe-87ed-3ab812401ab4",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Cart"
    }
}

// response content for an order containing an NCE license-based trial
{
  "id": "99d3777b-61da-4c95-aefa-203c248c4180",
  "creationTimestamp": "2025-02-04T22:22:36.7924103Z",
  "lastModifiedTimestamp": "2025-02-04T22:22:36.7924109Z",
  "expirationTimestamp": "2025-02-11T22:23:34.5190698Z",
  "lastModifiedUser": "b5109661-56c5-45ed-9447-f67463458a97",
  "status": "Active",
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
      "quantity": 25,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "provisioningContext": {},
      "orderGroup": "0",
      "pricing": {
        "listPrice": 0.0,
        "discountedPrice": 0.0,
        "proratedPrice": 0.0,
        "price": 0.0,
        "extendedPrice": 0.0
      },
      "scheduledNextTermInstructions": {
        "product": {
          "productId": "CFQ7TTC0LCHC",
          "skuId": "0002",
          "availabilityId": "CFQ7TTC0XL82",
          "billingCycle": "monthly",
          "termDuration": "P1M"
        },
        "quantity": 25
      }
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/81e78b53-9aa8-44e7-a041-3b15272d8f84/carts/99d3777b-61da-4c95-aefa-203c248c4180",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Cart"
  }
}
  • Last updated on