購買目錄項目

下列案例示範使用合作夥伴中心 API 從類別目錄購買專案的一般程式。

探索

選取產品和庫存單位（SKU），並使用下列合作夥伴中心 API 模型檢查其可用性：

• 產品 - 可購買商品或服務的分組建構。 產品本身不是可購買的專案。
• SKU - 產品下的可購買 SKU。 這些代表產品的不同形狀。
• 可用性 - 可供購買 SKU 的設定（例如國家/地區、貨幣和產業區段）。

若要從目錄購買專案，請完成下列步驟：

1. 識別並擷取您想要購買的產品和 SKU。

   • 取得產品清單
   • 使用產品識別碼取得產品
   • 取得產品的 SKU 清單
   • 使用 SKU 識別碼取得 SKU

2. 檢查 SKU 的清查。 只有以 purchasePrerequisites 屬性中 InventoryCheck 值標記 的 SKU 才需要此步驟。

   • 確認存貨

3. 擷取 SKU 的可用性 。 當您下訂單時，您將需要 可用性的 CatalogItemId 。 若要取得此值，請使用下列其中一個 API：

   • 取得 SKU 的可用性清單
   • 使用可用性識別碼取得可用性

訂單提交

若要提交您的目錄專案訂單，請執行下列動作：

1. 建立 購物車 來保存您想要購買的目錄專案集合。 當您建立購物車時， 購物車明細專案 會根據可在相同 訂單 中一起購買的專案自動分組。

   • 建立購物車
   • 更新購物車

2. 查看購物車。 取出購物車會導致建立 訂單 。

   • 結帳購物車

取得訂單詳細資料

您可以使用訂單識別碼擷取個別訂單的詳細資料，或取得客戶的訂單清單。 在提交訂單的時間和客戶訂單清單中出現的時間之間，延遲最多 15 分鐘。

• 請參閱 依識別碼 取得訂單，以使用訂單識別碼取得個別訂單的詳細資料。

• 請參閱 取得客戶的所有訂單 ，以使用客戶識別碼取得客戶的訂單清單。

• 請參閱 依客戶和計費週期類型取得訂單清單，以依 計費週期類型 取得客戶的訂單清單，讓您分別列出目錄專案訂單（一次性費用）和年度或每月計費訂單。

生命週期管理

在合作夥伴中心管理目錄專案的生命週期中，您可以擷取目錄專案 權利 的相關資訊，並使用保留訂單識別碼取得保留詳細資料。 如需如何執行這項操作的範例，請參閱 取得權利 。 ​

發票和對帳

下列案例示範如何以程式設計方式檢視客戶的 發票 ，以及取得帳戶餘額和摘要，其中包含目錄專案的一次性費用。

餘額和付款

若要以預設貨幣類型取得目前帳戶餘額，這是週期性費用和一次性（目錄專案）費用的餘額，請參閱 取得目前的帳戶餘額 。

多貨幣餘額和付款

若要取得目前的帳戶餘額和發票摘要集合，其中包含每個客戶貨幣類型的週期性費用和一次性費用的發票摘要，請參閱 取得發票摘要 。

發票

若要取得同時顯示週期性費用和一次性費用的發票集合，請參閱 取得發票 集合。 ​

單一發票

若要使用發票識別碼擷取特定發票，請參閱 依 識別碼取得發票。 ​

和解

若要取得特定發票識別碼的發票明細專案詳細資料集合（對帳明細專案），請參閱 取得發票明細專案 。 ​

以 PDF 形式下載發票

若要使用發票識別碼以 PDF 形式擷取發票明細，請參閱 取得發票語句 。