购物车资源

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

当客户想要从产品/服务列表中购买订阅时，合作伙伴会下订单。

购物车

描述购物车。

properties	类型	描述
id	string	成功创建购物车时提供的购物车标识符。
creationTimeStamp	日期时间	以日期时间格式创建购物车的日期。成功创建购物车时应用。
lastModifiedTimeStamp	日期时间	上次更新购物车的日期，采用日期时间格式。成功创建购物车时应用。
expirationTimeStamp	DateTime	购物车将过期的日期，采用日期时间格式。成功创建购物车时应用。
lastModifiedUser	string	上次更新购物车的用户。成功创建购物车时应用。
lineItems	对象数组	CartLineItem 资源的数组。
状态	string	购物车的状态。可能的值是“活动”（可以更新/提交）和“已订购”（已提交）。

表示购物车中包含的一个项目。

properties	类型	描述
id	string	购物车行项的唯一标识符。成功创建购物车时应用。
catalogItemId	string	目录项标识符。
friendlyName	string	可选。合作伙伴定义的项的友好名称，以帮助消除歧义。
quantity	int	许可证或实例数。
currencyCode	string	货币代码。
billingCycle	对象	为当前时间段设置的计费周期类型。
termDuration	string	术语持续时间的 ISO 8601 表示形式。当前支持的值为 P1M（一个月）、P1Y（一年）和 P3Y（三年）。
participants	对象字符串对列表	购买时记录的 PartnerID 集合。
provisioningContext	字典<字符串，字符串>	预配已购买商品时使用的其他上下文。若要确定特定项所需的值，请参阅 SKU 的 provisioningVariables 属性。
orderGroup	string	一个组，用于指示哪些项目可以按相同顺序一起提交。
addonItems	CartLineItem 对象列表	加载项的购物车行项的集合。将从根购物车行项目的购买结果的基订阅购买这些项目。
error	Object	在创建购物车后应用（如果发生错误）。
renewsTo	对象数组	RenewsTo 资源的数组。
AttestationAccepted	bool	指示提供或 SKU 条件的协议。仅适用于 SkuAttestationProperties 或 OfferAttestationProperties 强制实施Attestation 的套餐或 SKU。
promotionId	string	即将应用于购物车行项的促销 ID。
customTermEndDate	DateTime	新订阅的第一个计费期限的结束日期。

表示价格详细信息。价格金额在税收前提供。

properties	类型	需要	说明
listPrice	Double	否	目录中列出的价格没有应用任何定价修饰符。
discountedPrice	Double	否	应用所有适用的定价修饰符后的价格。
proratedPrice	double	否	执行比例后折扣价格。
price	double	否	应用所有折扣并按比例执行后，适用计费货币的价格。
extendedPrice	Double	否	应用数量、折扣和比例的行项的价格，采用适用的计费货币。

表示购物车行项中包含的一项。

properties	类型	需要	说明
termDuration	string	否	续订期限持续时间的 ISO 8601 表示形式。当前支持的值是 P1M （一个月）和 P1Y （一年）。

每个响应都带有一个 HTTP 状态代码，用于指示成功或失败以及其他调试信息。请使用网络跟踪工具来读取此代码、错误类型和其他参数。有关完整列表，请参阅合作伙伴中心错误代码。

表示创建购物车后发生的错误。

有关错误的其他信息。

properties	类型	描述
availableQuantity	int	可为给定产品 SKU 购买的剩余许可证数。
purchasedQuantity	int	要购买的许可证数。

购物车错误的类型。

名称	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	默认值

表示购物车检查输出的结果。

properties	类型	描述
订单	Order 对象列表。	订单集合。
orderErrors	OrderError 对象列表。	订单错误的集合。

表示创建订单时购物车检查出车期间发生的错误。