400 | invalid_page | page 小於 1,或換算出的位移量超出可表示範圍 |
400 | invalid_page_size | pageSize 不在 1–100 之間 |
400 | invalid_updated_since | updatedSince 不是合法的 ISO-8601,或沒有帶明確時區位移/Z |
400 | invalid_parameter | 查詢參數無法繫結成正確型別(例如 page=abc),或是各端點寫入邏輯裡沒有更具體對應代碼的失敗原因 |
400 | empty_batch | 批次 API收到空陣列或沒有 body |
400 | internalUserId required: no default 負責業務 available | 建立客戶未帶 internalUserId,且該租戶沒有設定預設負責業務(這句英文本身就是代碼,不是 snake_case) |
400 | internal_user_not_found | 建立或更新客戶時只送了 internalUserOuterSysCode(沒有 internalUserId),而貴租戶底下沒有未刪除的內部使用者使用這個代碼——不會退回預設負責業務,整筆不寫入。批次只有該筆失敗,字串出現在該筆的 errors 欄位,外層仍是 200 |
400 | internal_user_code_ambiguous | 同上,但有兩位以上的內部使用者使用同一個代碼——OrderUp 絕不會替你挑一位,請改送 internalUserId。整筆不寫入 |
400 | product_category_id_required | 建立商品未帶 productCategoryId(組合品沒有分類,不會回這個代碼) |
400 | invalid_product_category_id | 分類不存在、不可指派(根分類),或屬於其他租戶——三種情況統一回同一個代碼 |
400 | outerSysCode is required to create a SKU | 建立規格未帶 outerSysCode(這句英文本身就是代碼,不是 snake_case) |
400 | bundle SKU cannot be updated through this API | /v1/skus 要更新的是組合 SKU(依 id 指定,或在指定商品下以料號命中),請改用 /v1/bundles(同樣不是 snake_case) |
400 | outerSysCode belongs to a bundle SKU; use /v1/bundles | /v1/skus 只帶料號,而這個料號只屬於組合 SKU——不會新增一般規格(同樣不是 snake_case) |
400 | productId 0 cannot detach a SKU; omit productId to keep its product | 依 id 指定的規格或組合品更新(PUT /v1/skus/{id}、PUT /v1/bundles/{id},或批次項目帶 id)帶了 "productId": 0——更新不會把規格移出商品,要保留所屬商品就不要送這個欄位。沒有 id 的項目帶 0 與省略相同,不是錯誤(同樣不是 snake_case) |
400 | invalid_status | 規格或組合品的 status 不是 Active、Inactive 或 GiftOnly(不分大小寫);批次只有該筆失敗 |
400 | bundle SKU stock must be set through /v1/bundles/stock/batch | POST /v1/skus/stock/batch 逐筆:skuId 指向組合 SKU。組合品的庫存請改用 POST /v1/bundles/stock/batch(同樣不是 snake_case,只出現在該列的 error 欄位,外層仍是 200) |
400 | inventoryQuantity or isNegativeStockAllowed is required | POST /v1/skus/stock/batch 與 POST /v1/bundles/stock/batch 逐筆:inventoryQuantity 與 isNegativeStockAllowed 都沒帶,這一筆沒有任何要寫入的內容(同樣不是 snake_case,只出現在該列的 error 欄位,外層仍是 200) |
400 | bundle not found | POST /v1/bundles/stock/batch 逐筆:bundleId 查無對應組合品、屬於其他租戶,或指向一般規格,一律回這個字串(同樣不是 snake_case,只出現在該列的 error 欄位,外層仍是 200) |
400 | SKU not found | POST /v1/skus/stock/batch 逐筆:skuId 查無對應規格、屬於其他租戶,或 outerSysCode 沒有對到任何一般規格,一律回這個字串(同樣不是 snake_case,只出現在該列的 error 欄位,外層仍是 200) |
400 | skuId or outerSysCode is required | POST /v1/skus/stock/batch 逐筆:沒有正整數的 skuId,也沒有料號(同樣不是 snake_case,只出現在該列的 error 欄位) |
400 | bundle_components_required | 建立組合品未帶 components,或帶了空陣列 |
400 | component_identifier_required | 配方元件未帶 componentSkuId 也未帶 componentSkuOuterSysCode |
400 | component_sku_code_ambiguous | 用 componentSkuOuterSysCode 反查元件規格,命中一筆以上——絕不會替你挑一筆 |
400 | component_not_found | 元件規格不存在,或屬於其他租戶——兩種情況統一回同一個代碼,不區分是「查無此規格」還是「規格屬於別的租戶」,避免洩漏元件序號屬於別的租戶 |
400 | component_cannot_be_a_bundle | 元件規格本身是組合品型別,不允許巢狀組合 |
400 | component_duplicated | 同一份配方裡出現重複的元件規格 |
400 | invalid_component_quantity | 元件用量(quantity)不是正數、超出可表示的數值範圍,或四捨五入到小數 4 位後不大於 0 |
400 | component_self_reference | 更新組合品的配方時,元件指向這個組合品自己 |
400 | product_type_conflict | /v1/bundles 的料號屬於一般規格(只帶料號時比對整個租戶,帶 productId 時比對該商品底下)——不會被視為更新,也不會新增,整筆失敗。一般規格請改用 /v1/skus |
400 | invalid_price | 規格或組合品的 price/sellPrice 超出 0 至 9999999.99 的範圍 |
400 | invalid_quantity_precision | 組合品的 quantityPrecision 不在 0 至 4 之間 |
400 | missing_key | 點數/合約額度批次同步:companyId 與 companyCode 皆未提供,或 companyCode 為空字串 |
400 | missing_balance | 點數額度批次同步未帶 balance——這是必填的絕對值欄位,省略不會保留原值,也不會被序列化預設值 0 悄悄歸零 |
400 | invalid_balance | 點數額度批次同步的 balance 為負值 |
400 | missing_credit_limit | 合約額度批次同步未帶 creditLimit,規則鏡像 missing_balance |
400 | invalid_credit_limit | 合約額度批次同步的 creditLimit 為負值 |
400 | invalid_memo | 點數/合約額度的 memo 超過 200 字元——用的是這個代碼,不是 memo_too_long |
400 | company_code_ambiguous | 用 companyCode 反查客戶,命中一筆以上——點數/合約額度批次同步共用,OrderUp 絕不會替你挑一筆。客戶總部的總部或子客戶代碼(parentCompanyCode、subCompanyCodes)命中一家以上時也是這個字串,且在客戶總部端點是 400 |
400 | company_not_found | 客戶總部的總部或子客戶(以 id 或代碼指定)不存在、已刪除,或屬於其他租戶——因為出問題的是 body 裡的成員而不是網址上的資源,這裡是 400,不是額度端點的 404。錯誤不會指出是哪一個 id 或代碼有問題 |
400 | sync_failed | 點數/合約額度批次同步逐筆寫入時發生非預期例外,是這兩支端點自己的逐筆版「未分類錯誤」——只出現在該筆的 error 欄位,不會反映在外層 HTTP 狀態碼(外層仍是 200) |
400 | {field}_too_long | 有送出的欄位超過長度上限;每個欄位各自的上限與這個代碼,見該欄位在 API 規格裡的說明 |
400 | account_required/name_required/email_required/password_required | 建立後台使用者缺少對應的必填欄位;建立客戶帳號時 account_required/name_required/password_required 同樣適用(客戶帳號的 email 選填);name_required 也用於客戶總部的群組名稱空白(建立,或更新時有給 name 但為空白) |
400 | account_already_used | 建立後台使用者或客戶帳號,account 在同租戶內已被使用(不分大小寫)——客戶帳號同樣以整個租戶為範圍,另一家客戶用過的帳號也算重複 |
400 | invalid_account_format | 建立客戶帳號,account 不是 3–50 個英文字母、數字或連字號(-),也不是有效的電子郵件格式 |
400 | role_id_required | 建立客戶帳號未帶 roleId(或帶 0) |
400 | invalid_role_id | roleId 不存在或屬於其他租戶;建立後台使用者時省略 roleId 也是這個代碼(建立客戶帳號時省略則是 role_id_required) |
400 | invalid_status | 更新後台使用者,或建立/更新客戶帳號,status 不是 Active 或 Inactive(規格與組合品的 status 見上方同名代碼) |
400 | key_required | PUT /v1/internal-users/batch 逐筆:id 與 outerSysCode 都沒給(沒有 id 時,outerSysCode 只有空白也算沒給)。只出現在該筆的 errors 欄位,外層仍是 200 |
400 | ambiguous_outer_sys_code | PUT /v1/internal-users/batch 逐筆:同租戶內有兩位以上的使用者用同一個 outerSysCode,OrderUp 絕不會替你挑一位,該筆不會寫入。只出現在該筆的 errors 欄位,外層仍是 200 |
400 | invalid_settlement_type | 建立或更新客戶時,settlementType 不是 Cash 或 Monthly(大小寫敏感) |
400 | invalid_payment_method_mode | 建立或更新客戶時,paymentMethodMode 不是 Inherit 或 Specify(大小寫敏感) |
400 | payment_method_mode_required | 建立或更新客戶時,送了 paymentMethods(包含空陣列)卻沒送 paymentMethodMode——兩個欄位須成對寫入 |
400 | payment_methods_required | paymentMethodMode 為 Specify,但 paymentMethods 省略、空陣列,或去掉空白元素後為空——Specify 必須在同一個請求帶非空清單 |
400 | payment_methods_not_allowed | paymentMethodMode 為 Inherit,但 paymentMethods 帶了非空清單 |
400 | invalid_payment_method | paymentMethods 含不合法的元素:None、字面的 CustomOffline、其他租戶或已刪除的自訂 key、格式不符的字串等。可用的 key 見 GET /v1/payment-methods |
400 | monthly_settlement_not_allowed | paymentMethods 含 MonthlySettlement——月結是結帳條件,請改用 settlementType |
400 | name_too_long | 客戶總部的群組名稱去掉前後空白後超過 50 字元(其他資源的 name 超長同樣是這個字串,見 {field}_too_long) |
400 | parent_company_required | 建立客戶總部時,parentCompanyId 與 parentCompanyCode 都沒給 |
400 | parent_already_headquarters | 客戶總部的總部客戶已經是另一個群組的總部 |
400 | company_already_in_group | 客戶總部的總部客戶或任一子客戶,已經屬於另一個群組 |
400 | sub_company_is_headquarters | 客戶總部的任一子客戶,是另一個群組的總部客戶 |
401 | unauthorized | 簽章、時間戳記或 nonce 其中一項驗證沒有通過 |
403 | forbidden | 簽章驗證通過,但你的憑證未開通此項操作 |
404 | not_found | id 不存在、屬於其他租戶,或指向錯誤的資源型別(例如一般規格端點查到組合 SKU、組合品端點查到一般規格)——這幾種情況無法從回應內容區分;組合品寫入的 productId 不是租戶內既有的商品時也是這個代碼 |
404 | 查無客戶資料 | PUT /v1/companies/{id} 找不到對應客戶時的 404 body;POST /v1/companies/batch 逐筆依 id 更新卻查無這筆客戶時,同一句話也會原樣出現在該筆的 errors[](此時外層 HTTP 狀態碼仍是 200,不是 404) |
404 | 商品不存在 | 同上,對應 PUT /v1/products/{id}/POST /v1/products/batch |
404 | SKU 不存在 | 同上,對應 PUT /v1/skus/{id}/POST /v1/skus/batch;建立或更新規格時 productId 指向不存在的商品也是這句話 |
404 | company_not_found | 點數/合約額度的查詢或批次同步找不到對應客戶,或客戶帳號端點(/v1/companies/{id}/users)找不到網址上的客戶——這些掛在客戶底下的端點用的是獨立的第二套 404 代碼,見下方「404」一節 |
409 | last_active_admin | 這個後台使用者是租戶目前唯一還能登入的系統管理員,這次寫入會讓租戶失去所有可登入的系統管理員,因此被拒絕 |
409 | last_active_boss | 這個客戶帳號是客戶目前唯一生效中的 Boss,這次寫入(改成其他角色或設為 Inactive)會讓客戶失去所有生效中的 Boss,因此被拒絕 |