> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.orderupb2b.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.orderupb2b.com/_mcp/server.

# 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 規格」的「客戶總部」，新增的錯誤字串見「錯誤碼」。