購買目錄商品

下列情境示範使用合作夥伴中心 API 從目錄購買商品的一般流程。

發現

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

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

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

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

   • 取得產品清單
   • 使用產品標識碼取得產品
   • 取得產品 的 SKU 清單
   • 使用 SKU 識別碼取得商品資訊

2. 檢查 SKU 的庫存。 只有在已使用 purchasePrerequisites 属性中 InventoryCheck 標記的 SKU 值時，才需要此步驟。

   • 檢查庫存

3. 擷取 SKU的 可用性。 在下單時，您需要提供該項目 CatalogItemId 的可用性。 若要取得此值，請使用下列其中一個 API：

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

訂單提交

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

1. 建立 Cart，來存放您想要購買的商品目錄項目集合。 當您建立購物車時，購物車項目 會自動依據可以在相同 訂單中一起購買的項目進行分組。

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

2. 查看購物車。 結帳購物車會產生 訂單。

   • 查看購物車

取得訂單詳細數據

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

• 請參閱 透過 ID 取得訂單，使用訂單 ID 獲得個別訂單的詳細資訊。

• 請參閱 取得所有客戶訂單，以便透過客戶 ID 獲取客戶的訂單列表。

• 請參閱 依客戶和計費週期類型取得訂單清單，以便您可以根據 計費週期類型取得客戶的訂單清單， 這樣您就可以將目錄項目訂單（一次性費用）和年度或每月計費訂單分別列出。

生命週期管理

在合作夥伴中心管理目錄項目的生命週期中，您可以擷取目錄項目的相關資訊 權益，並使用預訂訂單標識碼獲取預訂詳細資訊。 如需如何執行這項作業的範例，請參閱 取得使用權。 ​

發票和對帳

下列案例示範如何透過程式化的方式檢視客戶的 發票，並取得帳戶餘額和摘要，其中包含商品目錄的一次性費用。

餘額和付款

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

多貨幣餘額和付款

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

發票

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

單一發票

若要使用發票ID擷取特定發票，請參閱 透過ID取得發票。 ​

和解

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

以 PDF 形式下載發票

若要使用發票標識碼以 PDF 格式擷取發票明細，請參閱 取得發票明細。