externalId 作為與您系統中對應紀錄的穩定映射。
個人客戶
個人客戶僅需type。請一併提供您已知的個人資料欄位,並僅在當前能力或任務需要時再新增其他欄位。
使用 POST /v3/customers 建立客戶:
data.id 儲存為 CUSTOMER_ID。政策背景請參閱個人入駐。
企業客戶
企業客戶需要提供business.legalName。使用相同的操作建立企業:
data.id 儲存為 CUSTOMER_ID。政策與文件相關內容請參閱企業入駐。
新增企業關係人
當董事、股東等其他企業參與者已知或被要求時,請將其新增。此範例使用POST /v3/customers/{customerId}/related-parties 建立一位董事:
data.id 儲存為 RELATED_PARTY_ID。
從能力讀取就緒狀態
客戶在 API 中並不具備驗證或就緒狀態。請使用GET /v3/customers/{customerId} 讀取當前的個人資料,然後利用能力及其 openTaskIds 來判斷該客戶接下來可以做什麼。