客製化API串接常見問題

API 文件：https://app.swaggerhub.com/apis-docs/ezorderly/api/v1

訂單相關

若想要在 ORDERLY 詳細資料清單中，能夠呈現出運費、折扣等項目內容要如何處理？

建議直接新增一個商品叫做運費、折扣即可，讓系統去做加總計算，若不需要於詳細資料清單中列出，shipping cost、bonus used 就保持原始數字即可。

系統內所顯示的訂單金額（包含數據計算）是對應哪一個欄位？

系統內所顯示的 訂單金額，請對應放入到 total_price 。

會員相關

確認歸戶碼要以手機號碼為主，那要怎麼處理？需要把手機號碼打到歸戶碼（purchaser_id）上嗎？

不用，若統一用手機歸戶的話，請通知 ORDERLY 工程師，由工程師調整。

會員的資料，例如：會員等級、膚質、紅利點數等個人資訊，如果需要更新該如何執行？

由於該資料都是打在會員身上，故可以透過 會員API 的 「tags 」更新進來即可，未來更新資料，也僅需要更新會員資料進來即可。

商品相關

若有商品折扣金額（例如：折扣 50），API 是不是要打 50 在 bouns point used 這個欄位上？

建議直接新增一個商品叫做折扣即可，讓系統去做扣除計算

若有商品類別也想要打進來，API 的欄位是要打什麼呢？

商品類別的名稱欄位是 Category name，商品類別的 ID 是 Category ID。請注意若是一個產品有多個分類請用 , 隔開。

若商品類別更新了 同樣類別 ID 但不同名稱 的類別，會怎麼呈現？

建立了類別後，就算之後更新資料時，上傳了與之前建立的類別 「同樣類別 ID 但不同名稱」的類別，新類別名稱也不會覆蓋舊有名稱，系統會自動新建立一個類別。

不過雖然「(1) 超級保濕」這個類別看起來是獨立出來的，實際上商品類別 ID 為同樣的緣故 ORDERLY 系統內會判斷這兩個是同一個類別，所以點進去類別詳細頁會發現兩者會是同樣的，所以也不會有重複運算的問題。

舉例來說：「(1)保濕」這個商品類別在 2019 年進入系統，2022 年後修改名稱為「(1) 超級保濕」，就算是類別 ID 設為一樣，ORDERLY 系統也不會將原本的名稱「(1)保濕」」改為「(1) 超級保濕」，但在商品類別頁中，會新增一個「(1) 超級保濕」的類別。