购买目录项

以下方案演示了使用合作伙伴中心 API 从目录中购买项目的通用过程。

发现

使用以下合作伙伴中心 API 模型选择产品和库存单位（SKU），并检查其可用性：

• 产品 - 可购买商品或服务的分组构造。 产品本身不是可购买的项。
• SKU - 产品下的可购买 SKU。 这些表示产品的不同形状。
• 可用性 - SKU 可供购买的配置（例如国家/地区、货币和行业细分市场）。

若要从目录中购买项目，请完成以下步骤：

1. 标识并检索要购买的产品和 SKU。

   • 获取产品列表
   • 使用产品 ID 获取产品
   • 获取产品的 SKU 列表
   • 使用 SKU ID 获取 SKU

2. 检查 SKU 的清单。 对于在 purchasePrerequisites 属性中使用 InventoryCheck 值标记的 SKU，只需执行 此步骤。

   • 检查库存

3. 检索 SKU 的可用性。 下订单时，需要 可用性的 CatalogItemId 。 若要获取此值，请使用以下 API 之一：

   • 获取 SKU 的可用性列表
   • 使用可用性 ID 获取可用性

订单提交

若要提交目录项订单，请执行以下操作：

1. 创建一个 Cart 来保存要购买的目录项的集合。 创建购物车时， 购物车行项 将根据同一 订单中可以一起购买的内容自动分组。

   • 创建购物车
   • 更新购物车

2. 查看购物车。 签出购物车会导致创建 订单。

   • 结帐购物车

获取订单详细信息

可以使用订单 ID 检索单个订单的详细信息，或获取客户的订单列表。 在提交订单的时间和客户订单列表中显示订单的时间之间，延迟长达 15 分钟。

• 请参阅 “按 ID 获取订单”，以使用订单 ID 获取单个订单的详细信息。

• 请参阅 获取客户的所有订单 ，以使用客户 ID 获取客户的订单列表。

• 请参阅“按客户和计费周期类型获取订单列表”，以便按计费周期类型获取客户的订单列表，以便单独列出目录项订单（一次性费用）和按年或每月计费的订单。

生命周期管理

作为在合作伙伴中心管理目录项生命周期的一部分，你可以检索有关目录项 权利的信息，并使用预留订单 ID 获取预留详细信息。 有关如何执行此操作的示例，请参阅 “获取权利”。 ​

发票和对帐

以下方案演示如何以编程方式查看客户的 发票，并获取帐户余额和摘要，其中包括目录项的一次性费用。

余额和付款

若要以默认货币类型获取当前帐户余额，这是定期和一次性（目录项）费用的余额，请参阅 “获取当前帐户余额”。

多货币余额和付款

若要获取当前帐户余额和包含每个客户货币类型的定期和一次性费用的发票摘要的发票摘要集合，请参阅 “获取发票摘要”。

发票

若要获取同时显示定期和一次性费用的发票集合，请参阅 获取发票集合。 ​

单个发票

若要使用发票 ID 检索特定发票，请参阅 按 ID 获取发票。 ​

和解

若要获取特定发票 ID 的发票行项详细信息（对帐行项）的集合，请参阅 “获取发票行项”。 ​

以 PDF 形式下载发票

若要使用发票 ID 以 PDF 格式检索发票帐单，请参阅 “获取发票单”。