追蹤文件站台與 API 的異動
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 篩選相同。