Prostředky košíku

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Partner umístí objednávku, když zákazník chce koupit předplatné ze seznamu nabídek.

Košík

Popisuje košík.

Vlastnost Typ Popis
ID řetězec Identifikátor košíku zadaný při úspěšném vytvoření košíku.
creationTimeStamp DateTime Datum vytvoření košíku ve formátu data a času. Použito při úspěšném vytvoření košíku.
lastModifiedTimeStamp DateTime Datum poslední aktualizace košíku ve formátu data a času. Použito při úspěšném vytvoření košíku.
expirationTimeStamp DateTime Datum vypršení platnosti košíku ve formátu data a času. Použito při úspěšném vytvoření košíku.
lastModifiedUser řetězec Uživatel, který naposledy aktualizoval košík. Použito při úspěšném vytvoření košíku.
lineItems Pole objektů Pole prostředků CartLineItem .
status řetězec Stav košíku. Možné hodnoty jsou Aktivní (lze aktualizovat/odeslat) a "Objednáno" (již bylo odesláno).

CartLineItem

Představuje jednu položku obsaženou v košíku.

Vlastnost Typ Popis
ID řetězec Jedinečný identifikátor položky řádku košíku. Použito při úspěšném vytvoření košíku.
catalogItemId řetězec Identifikátor položky katalogu.
Friendlyname řetězec Nepovinné. Popisný název položky definované partnerem, který pomáhá nejednoznačný.
quantity int Počet licencí nebo instancí.
currencyCode řetězec Kód měny.
billingCycle Objekt Typ fakturačního cyklu nastavený pro aktuální období.
termDuration řetězec Reprezentace doby trvání období iso 8601. Aktuální podporované hodnoty jsou P1M (jeden měsíc), P1Y (jeden rok) a P3Y (tři roky).
Účastníci Seznam párů řetězců objektů Kolekce ID partnera v záznamu o nákupu.
provisioningContext Řetězec slovníku<, řetězec> Další kontext použitý při zřizování zakoupené položky Chcete-li zjistit, které hodnoty jsou potřeba pro určitou položku, projděte si vlastnost provisioningVariables skladové položky.
orderGroup řetězec Skupina označující, které položky lze odeslat společně ve stejném pořadí.
doplňky Seznam objektů CartLineItem Kolekce položek řádku košíku pro doplňky. Tyto položky budou zakoupeny v rámci základního předplatného, které je výsledkem nákupu položky řádku kořenového košíku.
chyba Objekt Použije se po vytvoření košíku, pokud došlo k chybě.
prodlužuje platnost Pole objektů Pole prostředků RenewsTo
AttestationAccepted bool Označuje smlouvu o nabídce nebo podmínkách skladové položky. Vyžaduje se pouze pro nabídky nebo skladové položky, u kterých je SkuAttestationProperties nebo OfferAttestationProperties enforceAttestation true.
promotionId řetězec ID povýšení, které se chystá použít pro položku řádku košíku.
customTermEndDate DateTime Koncové datum prvního fakturačního období nového předplatného.

Ocenění

Představuje podrobnosti o ceně. Částky cen jsou poskytovány před zdaněním.

Vlastnost Type Požaduje se Popis
Listprice double No Cena uvedená v katalogu bez použití modifikátorů cen.
discountedPrice double No Cena po použití všech použitelných modifikátoru cen
poměrná cena double No Zvýhodněná cena po provedení poměru.
price double No Cena v příslušné fakturační měně po uplatnění všech slev a provedení poměru.
extendedPrice double No Cena řádkové položky s množstvím, slevami a použitým poměrem v příslušné fakturační měně.

Prodlužuje platnost

Představuje jednu položku obsaženou v položce řádku košíku.

Vlastnost Type Požaduje se Popis
termDuration řetězec No Vyjádření doby trvání období prodloužení iso 8601. Aktuální podporované hodnoty jsou P1M (jeden měsíc) a P1Y (jeden rok).

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

Každá odpověď obsahuje stavový kód 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 v Partnerském centru.

CartError

Představuje chybu, která nastane po vytvoření košíku.

Vlastnost Typ Popis
Errorcode CartErrorCode Typ chyby košíku.
errorDescription řetězec Popis chyby, včetně poznámek k podporovaným hodnotám, výchozím hodnotám nebo limitům.
additionalInformation Další informace Další informace o chybě

Další informace

Další informace o chybě

Vlastnost Typ Popis
availableQuantity int Počet zbývajících licencí, které je možné zakoupit pro danou skladovou položku produktu.
purchasedQuantity int Počet zakoupených licencí.

CartErrorCode

Typy chyb košíku

Název ErrorCode Popis
CurrencyIsNotSupported 10000 Měna není pro daný trh podporovaná.
CatalogItemIdIsNotValid 10001 ID položky katalogu není platné.
QuotaNotAvailable 10002 Nedostatek dostupné kvóty
InventoryNotAvailable 10003 Inventář není pro vybranou nabídku k dispozici.
ÚčastníciIsNotSupportedForPartner 10004 Nastavení účastníků není pro partnera podporované.
UnableToProcessCartLineItem 10006 Nelze zpracovat položku řádku košíku.
SubscriptionIsNotValid 10007 Předplatné není platné.
SubscriptionIsNotEnabledForRI 10008 Předplatné není povolené pro nákupy rezervací.
SandboxLimitExceeded 10009 Byl překročen limit sandboxu.
InvalidInput 10010 Obecný vstup není platný.
SubscriptionNotRegistered 10011 Předplatné není platné.
AttestationNotAccepted 10012 Ověření identity nebylo přijato.
MaxAllowedSeatsPerSubscriptionExceed 10015 Požadovaný počet licencí překračuje limit.
Neznámý 0 Default value

CartCheckoutResult

Představuje výsledek rezervace košíku.

Vlastnost Typ Popis
objednávky Seznam objektů Order Kolekce objednávek.
orderErrors Seznam objektů OrderError Kolekce chyb objednávek.

OrderError

Představuje chybu, ke které dochází při rezervaci košíku při vytvoření objednávky.

Vlastnost Typ Popis
orderGroupId řetězec ID skupiny objednávek objednávky s chybou.
code int Kód chyby
description řetězec Popis chyby.