更新客戶總部
⚠️ 調整子客戶清單會立即改變資料可見範圍:新加入的客戶,總部的 Boss 角色使用者隨即看得到它的資料;被移出的客戶,其所屬群組歸零,總部的人隨即看不到。
依 id 更新客戶總部,成功回傳 200 與群組的 id。更新是部分合併,只能改 name 與子客戶清單:
name:省略保留現有名稱;有給時規則同新增(去掉前後空白後 1 至 50 字元)subCompanyIds與subCompanyCodes都省略:子客戶清單不動- 兩者任一有給(包含空陣列):兩者的聯集會取代整份子客戶清單。只給
subCompanyIds: []代表移除所有子客戶,群組只剩總部
總部客戶不能更換。 請求帶了 parentCompanyId 或 parentCompanyCode 會被忽略;要換總部請刪除群組後重建。
成員的指定方式與新增相同(id 或 outerSysCode,代碼為大小寫敏感的完全比對)。群組不存在或屬於其他租戶時回傳 404 not_found;成員規則不符時整筆拒絕、不寫入任何資料,錯誤字串見「錯誤碼」。同一租戶的群組寫入請一次送一筆,也不要與該租戶的客戶寫入(POST/PUT /v1/companies、批次)同時進行。
Authentication
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。
canonical string 的組成、可複製的簽章範例與 401 排查步驟,請參閱「驗證與簽章」。
Path parameters
要更新的群組序號。不存在或屬於其他租戶時,一律回傳 404 not_found。
Request
群組名稱。省略保留現有名稱;有給時規則同新增,去掉前後空白後 1 至 50 字元,空白回傳 400 name_required,超過回傳 400 name_too_long。
子客戶的序號清單。subCompanyIds 與 subCompanyCodes 都省略時,子客戶清單不動;任一有給(包含空陣列)時,兩者的聯集會取代整份子客戶清單。被移出的客戶其所屬群組歸零,總部的 Boss 角色使用者隨即看不到它們的資料。
子客戶的 ERP 端代碼清單,大小寫敏感的完全比對,取代規則同 subCompanyIds。對不到客戶回傳 400 company_not_found;對到兩家以上回傳 400 company_code_ambiguous。
Response
新增或更新成功後,該筆資料的 id。