> 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 月 3 日

## 後台使用者支援批次更新

新增 `PUT /v1/internal-users/batch`，可以用 ERP 端的使用者代碼（`outerSysCode`）或使用者序號（`id`）一次更新多位後台使用者，不必先存下 OrderUp 的序號：

* 每一筆有 `id` 就用 `id` 找出要更新的使用者，沒有 `id` 才用 `outerSysCode`；其餘欄位的部分合併規則與 `PUT /v1/internal-users/{id}` 相同。
* 同時帶 `id` 與 `outerSysCode` 時，`outerSysCode` 會被寫入成這位使用者的新代碼，可以順便把 ERP 代碼綁上既有使用者。
* 只更新、不新增；只帶 `outerSysCode` 時，代碼只是用來找人的鍵，不會被改寫。
* 同租戶內有兩位以上的使用者用同一個代碼時，該筆回報 `ambiguous_outer_sys_code` 且不寫入，其他筆照常處理。

逐筆結果的形狀與錯誤字串見「批次 API」與「錯誤碼」。

## 後台使用者清單支援 outerSysCode 篩選

`GET /v1/internal-users` 新增 `outerSysCode` 查詢參數，大小寫不敏感的子字串比對，用法與 `name`、`email` 篩選相同。