购物车资源
适用于:合作伙伴中心|由世纪互联运营的合作伙伴中心|Microsoft Cloud for US Government合作伙伴中心
当客户想要从产品/服务列表中购买订阅时,合作伙伴会下订单。
购物车
描述购物车。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | 字符串 | 成功创建购物车时提供的购物车标识符。 |
| creationTimeStamp | DateTime | 创建购物车的日期,采用日期时间格式。 成功创建购物车时应用。 |
| lastModifiedTimeStamp | DateTime | 上次更新购物车的日期,采用日期时间格式。 成功创建购物车时应用。 |
| expirationTimeStamp | DateTime | 购物车将过期的日期,采用日期时间格式。 成功创建购物车时应用。 |
| lastModifiedUser | 字符串 | 上次更新购物车的用户。 成功创建购物车时应用。 |
| lineItems | 对象数组 | CartLineItem 资源的数组。 |
| 状态 | 字符串 | 购物车的状态。 可能的值为“Active” (可以更新/提交) ,并且已) 提交“已订购” (。 |
CartLineItem
表示购物车中包含的一个项目。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | 字符串 | 购物车行项的唯一标识符。 成功创建购物车时应用。 |
| catalogItemId | 字符串 | 目录项标识符。 |
| friendlyName | 字符串 | 可选。 合作伙伴定义的项的友好名称,以帮助消除歧义。 |
| quantity | int | 许可证或实例数。 |
| currencyCode | string | 货币代码。 |
| billingCycle | Object | 为当前周期设置的计费周期类型。 |
| termDuration | 字符串 | 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M (一个月) 、P1Y (一年) 和 P3Y (三年) 。 |
| participants | 对象字符串对列表 | 在购买时) 记录 (MPN ID 上的 PartnerId 集合。 |
| provisioningContext | <字典字符串,字符串> | 预配已购买项时使用的其他上下文。 若要确定特定项需要哪些值,请参阅 SKU 的 provisioningVariables 属性。 |
| orderGroup | 字符串 | 一个组,用于指示哪些项目可以按相同顺序一起提交。 |
| addonItems | CartLineItem 对象列表 | 加载项的购物车行项的集合。 将从根购物车行项的购买结果的基订阅购买这些项目。 |
| error | Object | 在创建购物车后应用(如果发生错误)。 |
| renewsTo | 对象数组 | RenewsTo 资源的数组。 |
| 证明Accepted | bool | 指示产品/服务或 SKU 条件的协议。 仅适用于 SkuAttestationProperties 或 OfferAttestationProperties 强制实施Attestation 的套餐或 SKU。 |
| promotionId | 字符串 | 即将应用于购物车行项的促销 ID。 |
| customTermEndDate | DateTime | 新订阅的第一个计费期限的结束日期。 |
RenewsTo
表示购物车行项中包含的一项。
| 属性 | 类型 | 必需 | 说明 |
|---|---|---|---|
| termDuration | 字符串 | 否 | 续订期限持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M (一个月) 和 P1Y (一年) 。 |
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表,请参阅 合作伙伴中心错误代码。
CartError
表示创建购物车后发生的错误。
| 属性 | 类型 | 说明 |
|---|---|---|
| errorCode | CartErrorCode | 购物车错误的类型。 |
| errorDescription | 字符串 | 错误说明,包括有关支持值、默认值或限制的任何说明。 |
| additionalInformation | AdditionalInformation | 错误的其他信息。 |
AdditionalInformation
有关错误的其他信息。
| 属性 | 类型 | 说明 |
|---|---|---|
| availableQuantity | int | 可以为给定产品 SKU 购买的剩余许可证数。 |
| purchasedQuantity | int | 要购买的许可证数。 |
CartErrorCode
购物车错误的类型。
| 名称 | ErrorCode | 说明 |
|---|---|---|
| CurrencyIsNotSupported | 10000 | 给定市场不支持货币 |
| CatalogItemIdIsNotValid | 10001 | 目录项 ID 无效 |
| QuotaNotAvailable | 10002 | 没有足够的可用配额 |
| InventoryNotAvailable | 10003 | 清单不适用于所选产品/服务 |
| ParticipantsIsNotSupportedForPartner | 10004 | 合作伙伴不支持设置参与者 |
| UnableToProcessCartLineItem | 10006 | 无法处理购物车行项。 |
| SubscriptionIsNotValid | 10007 | 订阅无效。 |
| SubscriptionIsNotEnabledForRI | 10008 | 未为预留购买启用订阅。 |
| SandboxLimitExceeded | 10009 | 已超出沙盒限制。 |
| InvalidInput | 10010 | 泛型输入无效。 |
| SubscriptionNotRegistered | 10011 | 订阅无效。 |
| AttestationNotAccepted | 10012 | 证明尚未接受。 |
| MaxAllowedSeatsPerSubscriptionExceeded | 10015 | 请求的席位数超过限制。 |
| Unknown | 0 | 默认值 |
CartCheckoutResult
表示购物车签出的结果。
| 属性 | 类型 | 说明 |
|---|---|---|
| 订单 | Order 对象列表。 | 订单集合。 |
| orderErrors | OrderError 对象列表。 | 订单错误的集合。 |
OrderError
表示在创建订单时购物车签出期间发生的错误。
| 属性 | 类型 | 说明 |
|---|---|---|
| orderGroupId | 字符串 | 订单的订单组 ID,出现错误。 |
| code | int | 错误代码。 |
| description | 字符串 | 对错误的说明。 |