> For the complete documentation index, see [llms.txt](https://docs.ezorderly.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ezorderly.com/guide/importly/integration/ke-zhi-hua-api-chuan-jie-chang-jian-wen-ti.md).

# 客製化API串接常見問題

## 訂單相關

#### 若想要在 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) 超級保濕」的類別。