Lưu ý
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử thay đổi thư mục.
Applies to: Partner Center | Partner Center operated by 21Vianet | Partner Center for Microsoft Cloud for US Government
A partner places an order when a customer wants to buy a subscription from a list of offers.
Cart
Describes a cart.
| Property | Type | Description |
|---|---|---|
| id | string | A cart identifier that is supplied upon successful creation of the cart. |
| creationTimeStamp | DateTime | The date the cart was created, in date-time format. Applied upon successful creation of the cart. |
| lastModifiedTimeStamp | DateTime | The date the cart was last updated, in date-time format. Applied upon successful creation of the cart. |
| expirationTimeStamp | DateTime | The date the cart expires, in date-time format. Applied upon successful creation of cart. |
| lastModifiedUser | string | The user who last updated the cart. Applied upon successful creation of cart. |
| lineItems | Array of objects | An Array of CartLineItem resources. |
| status | string | The status of the cart. Possible values are "Active" (can be updated/submitted) and "Ordered" (was already submitted). |
CartLineItem
Represents one item contained in a cart.
| Property | Type | Description |
|---|---|---|
| id | string | A unique identifier for a cart line item. Applied upon successful creation of cart. |
| catalogItemId | string | The catalog item identifier. |
| friendlyName | string | Optional. The friendly name for the item defined by the partner to help disambiguate. |
| quantity | int | The number of licenses or instances. |
| currencyCode | string | The currency code. |
| billingCycle | Object | The type of billing cycle set for the current period. |
| termDuration | string | An ISO 8601 representation of the term's duration. The current supported values are P1M (one month), P1Y (one year) and P3Y (three years). |
| participants | List of Object String pairs | A collection of strings for the PartnerID on Record on the purchase. |
| provisioningContext | Dictionary<string, string> | Extra context used when provisioning the purchased item. To determine which values are needed for a particular item, refer to the SKU's provisioningVariables property. |
| orderGroup | string | A group to indicate which items can be submitted together in the same order. |
| addonItems | List of CartLineItem objects | A collection of cart line items for addons. These items are purchased towards the base subscription that results from the root cart line item's purchase. |
| error | Object | Applied after cart is created if an error occurred. |
| renewsTo | Array of objects | An array of RenewsTo resources. |
| AttestationAccepted | bool | Indicates agreement to offer or sku conditions. Required only for offers or skus where SkuAttestationProperties or OfferAttestationProperties enforceAttestation is True. |
| promotionId | string | The promotion ID that is about to be applied to the cart line item. |
| customTermEndDate | DateTime | The end date of the first billing term of the new subscription. |
Participants
Represents the distributor's resellers managing the customer's subscription.
| Property | Type | Description |
|---|---|---|
| transaction_reseller | string | The partner ID of the reseller managing the customer. |
| additional_transaction_reseller | string | Additoinal partner IDs of other partners involved in the transaction or managing the customer. This property is only applicable to distributors operating in the EU/EFTA markets. |
Pricing
Represents the price details. Price amounts are provided before taxation.
| Property | Type | Required | Description |
|---|---|---|---|
| listPrice | double | No | Price listed in the catalog without any pricing modifiers applied. |
| discountedPrice | double | No | Price after applying all applicable pricing modifier. |
| proratedPrice | double | No | Discounted price after proration is performed. |
| price | double | No | Price in the applicable billing currency after all discounts are applied and proration performed. |
| extendedPrice | double | No | Price of the line item with quantity, discounts, and proration applied, in the applicable billing currency. |
RenewsTo
Represents one item contained in a cart line item.
| Property | Type | Required | Description |
|---|---|---|---|
| termDuration | string | No | An ISO 8601 representation of the renewal term's duration. The current supported values are P1M (one month) and P1Y (one year). |
ScheduledNextTermInstructions
This table describes the scheduledNextTermInstructions properties for new commerce experiences (NCE) license-based trial offer renewal. If no values are specified, trials renew into paid subscriptions and renew to an annual term, monthly billing, and 25 licenses.
| Property | Type | Required | Description |
|---|---|---|---|
| product | array | No | An array that specifies the offer a trial subscription renews into and the term and billing frequency that the paid subscription has. |
| quantity | int | No | The license quantity that the corresponding paid subscription has once the trial offer renews. |
Product
This table describes the productTerm properties for NCE license-based trial offer renewal. If no values are specified in this array, trials renew into paid subscriptions with annual term and monthly billing.
| Property | Type | Required | Description |
|---|---|---|---|
| productId | string | No | A GUID formatted to represent the product of the paid subscription that the trial renews into. |
| skuId | string | No | A GUID formatted to represent the SKU of the paid subscription that the trial renews into. |
| availabilityId | string | No | A GUID formatted to represent the availability of the paid subscription that the trial renews into. |
| billingCycle | string | No | The billing frequency that the corresponding paid subscription has once the trial offer renews. |
| termDuration | string | No | The term duration that the corresponding paid subscription has once the trial offer renews. |
Response success and error codes
Each response comes with an HTTP status code that indicates success or failure and more debugging information. Use a network trace tool to read this code, error type, and extra parameters. For the full list, see Partner Center error codes.
CartError
Represents an error that occurs after a cart is created.
| Property | Type | Description |
|---|---|---|
| errorCode | CartErrorCode | The type of cart error. |
| errorDescription | string | The error description, including any notes about supported values, default values, or limits. |
| additionalInformation | AdditionalInformation | More information for the error. |
AdditionalInformation
Additional information about the error.
| Property | Type | Description |
|---|---|---|
| availableQuantity | int | The number of remaining licenses that can be purchased for the given product SKU. |
| purchasedQuantity | int | The number of licenses being purchased. |
CartErrorCode
Types of cart errors.
| Name | ErrorCode | Description |
|---|---|---|
| CurrencyIsNotSupported | 10000 | Currency isn't supported for given market |
| CatalogItemIdIsNotValid | 10001 | Catalog item ID isn't valid |
| QuotaNotAvailable | 10002 | Not enough quota available |
| InventoryNotAvailable | 10003 | Inventory isn't available for selected offer |
| ParticipantsIsNotSupportedForPartner | 10004 | Setting participants isn't supported for Partner |
| UnableToProcessCartLineItem | 10006 | Unable to process cart line item. |
| SubscriptionIsNotValid | 10007 | Subscription isn't valid. |
| SubscriptionIsNotEnabledForRI | 10008 | Subscription isn't enabled for reservation purchases. |
| SandboxLimitExceeded | 10009 | The sandbox limit is exceeded. |
| InvalidInput | 10010 | Generic input isn't valid. |
| SubscriptionNotRegistered | 10011 | Subscription isn't valid. |
| AttestationNotAccepted | 10012 | Attestation wasn't accepted. |
| MaxAllowedSeatsPerSubscriptionExceeded | 10015 | Requested number of seats exceeds the limit. |
| Unknown | 0 | Default value |
CartCheckoutResult
Represents the result of a cart checkout.
| Property | Type | Description |
|---|---|---|
| orders | List of Order objects. | The collection of orders. |
| orderErrors | List of OrderError objects. | The collection of order errors. |
OrderError
Represents an error that occurs during a cart checkout when an order is created.
| Property | Type | Description |
|---|---|---|
| orderGroupId | string | The order group ID of the order with the error. |
| code | int | The error code. |
| description | string | The description of the error. |