# 客製化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) 超級保濕」的類別。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ezorderly.com/guide/importly/integration/ke-zhi-hua-api-chuan-jie-chang-jian-wen-ti.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.