Skip to navigation

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