追蹤文件站台與 API 的異動
2026 年 11 月 4 日
客戶可以寫入結帳條件與付款方式
POST /v1/companies、PUT /v1/companies/{id} 與 POST /v1/companies/batch 新增三個欄位:settlementType(Cash 現結/Monthly 月結)、paymentMethodMode(Inherit/Specify)與 paymentMethods。這三個欄位原本只能讀取,現在可以由 ERP 直接維護,規則與後台客戶維護相同:
- 省略時,新增的客戶為
Monthly、Inherit、空清單;更新時保留現有值。 paymentMethodMode與paymentMethods須成對寫入:Inherit會清空清單,Specify必須在同一個請求帶非空清單。Specify實際生效的是清單與租戶目前已啟用付款方式的交集。- 驗證失敗回傳 400 加上對應的錯誤字串,整筆不寫入;批次寫入則是那一筆回報
failed。
欄位規則見「API 規格」的「客戶」,錯誤字串見「錯誤碼」。
新增付款方式清單
新增 GET /v1/payment-methods,列出貴租戶可以指派給客戶的付款方式,包含租戶在後台自訂、key 由 OrderUp 產生的線下付款方式。寫入客戶的 paymentMethods 之前,先從這裡取得合法的 key。清單不分頁,建議查一次後在你端快取。端點說明見「API 規格」的「付款方式」。
新增客戶總部 API
新增 /v1/company-groups 共五支端點,可以查詢、建立、更新與刪除客戶總部,也就是一家總部客戶加上它底下的子客戶。成員以客戶序號或 ERP 端的客戶代碼指定。客戶回應(GET /v1/companies 與 GET /v1/companies/{id})同時新增唯讀的 companyGroupId,標示客戶所屬的群組。
- ⚠️ 群組決定資料可見範圍:總部客戶的 Boss 角色使用者看得到群組內所有成員的資料。把客戶加進群組,總部的人就看得到這家客戶的資料;移出客戶或刪除群組則會立即收回。
- 更新時只給
subCompanyIds: []會移除所有子客戶;兩個子客戶欄位都省略才是不動。 - 同一租戶的群組寫入請一次送一筆,避免並行請求把同一家子客戶加進兩個群組;也不要與該租戶的客戶寫入同時進行。
端點說明見「API 規格」的「客戶總部」,新增的錯誤字串見「錯誤碼」。