Kundvagnsresurser
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
En partner gör en beställning när en kund vill köpa en prenumeration från en lista med erbjudanden.
Vagn
Beskriver en kundvagn.
| Egenskap | Type | Beskrivning |
|---|---|---|
| id | sträng | En kundvagnsidentifierare som tillhandahålls när kundvagnen har skapats. |
| creationTimeStamp | Datum/tid | Det datum då kundvagnen skapades i datum-tid-format. Tillämpas när kundvagnen har skapats. |
| lastModifiedTimeStamp | Datum/tid | Datumet då kundvagnen senast uppdaterades, i datum-tid-format. Tillämpas när kundvagnen har skapats. |
| expirationTimeStamp | Datum/tid | Datumet då kundvagnen upphör att gälla, i datum-tid-format. Tillämpas när kundvagnen har skapats. |
| lastModifiedUser | sträng | Användaren som senast uppdaterade kundvagnen. Tillämpas när kundvagnen har skapats. |
| lineItems | Matris med objekt | En matris med CartLineItem-resurser . |
| status | sträng | Status för kundvagnen. Möjliga värden är "Active" (kan uppdateras/skickas) och "Ordered" (har redan skickats). |
CartLineItem
Representerar ett objekt som finns i en kundvagn.
| Egenskap | Type | Beskrivning |
|---|---|---|
| id | sträng | En unik identifierare för ett kundvagnsradobjekt. Tillämpas när kundvagnen har skapats. |
| catalogItemId | sträng | Katalogobjektidentifieraren. |
| friendlyName | sträng | Valfritt. Det egna namnet på det objekt som definierats av partnern för att underlätta tvetydigheten. |
| quantity | heltal | Antalet licenser eller instanser. |
| currencyCode | sträng | Valutakod. |
| billingCycle | Objekt | Typ av faktureringsperiod som angetts för den aktuella perioden. |
| termDuration | sträng | En ISO 8601-representation av termens varaktighet. De aktuella värdena som stöds är P1M (en månad), P1Y (ett år) och P3Y (tre år). |
| Deltagare | Lista över objektsträngspar | En samling PartnerID på Posten vid köpet. |
| provisioningContext | Ordlistesträng<, sträng> | Ytterligare kontext som används vid etablering av det köpta objektet. Information om vilka värden som behövs för ett visst objekt finns i SKU:ns provisioningVariables-egenskap. |
| orderGroup | sträng | En grupp som anger vilka objekt som kan skickas tillsammans i samma ordning. |
| addonItems | Lista över CartLineItem-objekt | En samling kundvagnsradsobjekt för tillägg. Dessa objekt kommer att köpas mot den basprenumeration som är resultatet av rotvagnsradsartikelns köp. |
| fel | Objekt | Tillämpas efter att kundvagnen har skapats om ett fel uppstod. |
| renewsTo | Matris med objekt | En matris med RenewsTo-resurser . |
| AttestationAccepted | bool | Anger avtal om att erbjuda eller sku villkor. Krävs endast för erbjudanden eller skuus där SkuAttestationProperties eller OfferAttestationProperties enforceAttestation är Sant. |
| promotionId | sträng | Det kampanj-ID som ska tillämpas på kundvagnsradsobjektet. |
| customTermEndDate | Datum/tid | Slutdatumet för den första faktureringsperioden för den nya prenumerationen. |
Prissättning
Representerar prisinformationen. Prisbelopp anges före beskattning.
| Egenskap | Type | Obligatoriskt | Beskrivning |
|---|---|---|---|
| listPrice | dubbel | Inga | Pris som anges i katalogen utan att några prismodifierare tillämpas. |
| discountedPrice | dubbel | Inga | Pris efter tillämpning av alla tillämpliga prismodifierare. |
| proratedPrice | dubbel | Inga | Rabatterat pris efter att prorationen har utförts. |
| price | dubbel | Inga | Pris i den tillämpliga faktureringsvalutan efter att alla rabatter har tillämpats och prorationen har utförts. |
| extendedPrice | dubbel | Inga | Pris för radartikeln med kvantitet, rabatter och proration som tillämpas i den tillämpliga faktureringsvalutan. |
RenewsTo
Representerar ett objekt som finns i ett kundvagnsradobjekt.
| Egenskap | Type | Obligatoriskt | Beskrivning |
|---|---|---|---|
| termDuration | sträng | Inga | En ISO 8601-representation av förnyelseperiodens varaktighet. De aktuella värdena som stöds är P1M (en månad) och P1Y (ett år). |
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder för Partnercenter.
CartError
Representerar ett fel som uppstår när en kundvagn har skapats.
| Egenskap | Type | Description |
|---|---|---|
| errorCode | CartErrorCode | Typ av kundvagnsfel. |
| errorDescription | sträng | Felbeskrivningen, inklusive eventuella anteckningar om värden som stöds, standardvärden eller gränser. |
| additionalInformation | Ytterligare information | Ytterligare information om felet. |
Ytterligare information
Ytterligare information om felet.
| Egenskap | Type | Description |
|---|---|---|
| availableQuantity | heltal | Antalet återstående licenser som kan köpas för den angivna produkt-SKU:n. |
| purchasedQuantity | heltal | Antalet licenser som köps. |
CartErrorCode
Typer av kundvagnsfel.
| Name | Felkod | Description |
|---|---|---|
| CurrencyIsNotSupported | 10000 | Valuta stöds inte för en viss marknad |
| CatalogItemIdIsNotValid | 10001 | Katalogobjekt-ID är inte giltigt |
| QuotaNotAvailable | 10002 | Inte tillräckligt med tillgänglig kvot |
| InventoryNotAvailable | 10003 | Inventering är inte tillgänglig för valt erbjudande |
| ParticipantsIsNotSupportedForPartner | 10004 | Det går inte att ställa in deltagare för Partner |
| UnableToProcessCartLineItem | 10006 | Det går inte att bearbeta kundvagnsradobjektet. |
| SubscriptionIsNotValid | 10007 | Prenumerationen är inte giltig. |
| SubscriptionIsNotEnabledForRI | 10008 | Prenumerationen är inte aktiverad för reservationsköp. |
| SandboxLimitExceededed | 10009 | Sandbox-gränsen har överskridits. |
| InvalidInput | 10010 | Allmänna indata är inte giltiga. |
| SubscriptionNotRegistered | 10011 | Prenumerationen är inte giltig. |
| AttestationNotAccepted | 10012 | Attestering har inte godkänts. |
| MaxAllowedSeatsPerSubscriptionExceededed | 10015 | Det begärda antalet platser överskrider gränsen. |
| Okänt | 0 | Default value |
CartCheckoutResult
Representerar resultatet av en kundvagnsutcheckning.
| Egenskap | Type | Description |
|---|---|---|
| beställningar | Lista över orderobjekt. | Samlingen med beställningar. |
| orderErrors | Lista över OrderError-objekt. | Samlingen med orderfel. |
OrderError
Representerar ett fel som uppstår under en kundvagnsutcheckning när en order skapas.
| Egenskap | Type | Description |
|---|---|---|
| orderGroupId | sträng | Ordergruppens ID för ordern med felet . |
| kod | heltal | Felkoden. |
| beskrivning | sträng | Beskrivningen av felet. |