導購串接-美安SHOP.COM
美安 SHOP.COM 導購串接｜設定與對帳
一、應用情境
美安 SHOP.COM 是美安台灣旗下的網路導購平台。完成串接後，LiteShop 會將您的商品同步到美安 SHOP.COM 展示，並自動記錄來自美安導購連結的訂單、計算佣金，方便您每月與美安對帳。
| 情境 | 說明 |
|---|---|
| 擴大商品曝光 | 將商品上架到美安 SHOP.COM，借助美安會員社群帶來新客流量。 |
| 導購訂單自動追蹤 | 當顧客透過美安連結進入您的官網下單，系統會自動記錄此筆訂單為美安導購來源。 |
| 佣金自動計算 | 依您與美安約定的佣金百分比，自動計算每筆導購訂單應撥付的佣金。 |
| 退貨自動沖銷 | 當美安導購訂單發生取消或整筆退貨時，系統會自動回傳沖銷紀錄給美安，避免重複計算佣金（部分退貨不會自動沖銷，請見下方說明）。 |
| 每月對帳匯出 | 一鍵匯出指定區間的美安導購訂單明細，作為與美安每月結算佣金的依據。 |
二、前置準備
在 LiteShop 後台開啟美安串接之前，請先完成下列準備事項：
- 已加入美安網路夥伴商店並完成簽約：尚未申請者請洽 LiteShop 客服協助，或前往美安申請夥伴商店。
- 取得 Offer ID 與 Advertiser ID：簽約完成後美安會提供這兩組參數，這是串接時必須填入的識別碼。
- 確認約定的佣金百分比：依合約上載明的佣金比例（例如 5%、10%）。
- 於美安後台加入 LiteShop 伺服器 IP 白名單：LiteShop 會以指定的伺服器 IP 向美安回傳訂單成立、取消等狀態，未加入白名單會導致回傳失敗。完整 IP 清單請至 LiteShop 後台 → 系統外掛 → 導購串接 → 美安 SHOP.COM 區塊的「注意事項」中取得，以後台公告為準（若 LiteShop 未來調整伺服器，會於後台同步更新）。
- 準備好商品銷售資料表的 XML 連結：LiteShop 會自動產生此連結，格式為 https://您的自訂官網網址/products/shopdotcom.xml，需提供給美安以便將商品匯入美安 SHOP.COM 展示。
❌ 重要提醒：尚未加入美安 IP 白名單前請不要啟用美安串接。一旦啟用，LiteShop 會立即開始向美安回傳訂單資料，未開白名單將導致所有回傳失敗，後續對帳將出現落差。
三、設定步驟
步驟一：進入導購串接設定頁
登入 LiteShop 後台後，從左側選單前往 系統外掛 → 導購串接，找到頁面最上方的 美安 SHOP.COM 區塊。
圖：導購串接頁面，最上方為美安 SHOP.COM 設定區塊
步驟二：填入美安提供的識別參數
依據美安提供的資料，依序填入下列三個欄位：
- Offer ID：美安提供的方案識別碼。必填。
- Advertiser ID：美安提供的廣告主識別碼。必填。
- 佣金百分比(%)：依合約約定的佣金比例，請輸入 0 至 99 之間的整數。例如約定 5%，請填入 5。必填。
圖：填寫美安提供的識別參數與佣金百分比
⚠️ 注意：請務必再次核對 Offer ID 與 Advertiser ID 是否與美安提供的完全一致，填錯會導致美安端無法收到您回傳的訂單紀錄。
步驟三：設定「並用促銷活動」
這個開關決定來自美安導購的訂單是否可以同時使用您官網上的促銷碼與滿額活動。
- 是：美安顧客結帳時仍可套用您官網的促銷碼、滿額折扣等行銷活動。
- 否：美安顧客的訂單將不適用任何促銷碼與滿額活動，僅以原價結帳。
💡 小技巧：如果您與美安的合約中有「不得疊加其他優惠」的條款，建議將此項設為否，避免因疊加折扣使佣金計算基準與美安對不上。
步驟四：啟用美安串接
確認以上設定都正確後，將 啟用 / 停用 開關切換為 啟用中，最後點擊 儲存設定 按鈕。
圖：啟用美安串接並儲存設定
⚠️ 注意：在啟用之前，請務必先確認美安後台已加入 LiteShop 的伺服器 IP 白名單（見前置準備），否則訂單回傳會全數失敗。
步驟五：將商品銷售資料表連結提供給美安
設定啟用後，請將下列商品 XML 連結交給美安窗口：
- 連結格式：https://您的自訂官網網址/products/shopdotcom.xml
- 例如您的官網網址是 https://www.example.com，則連結為 https://www.example.com/products/shopdotcom.xml。
美安會透過這個連結定期抓取您的商品資料（包含商品名稱、描述、價格、圖片、SKU 編號等），並匯入美安 SHOP.COM 展示給美安會員。
💡 小技巧：此連結會自動納入您後台所有上架中的商品；若有商品下架，下次美安抓取時就會自動移除，您不需手動維護。
四、運作流程與計算範例
導購流程
- 美安會員在美安 SHOP.COM 看到您的商品。
- 會員點擊商品連結後，會帶著美安的追蹤參數（RID、Click_ID）跳轉到您的官網商品頁。
- 系統會把這組追蹤參數記在顧客的瀏覽器 Cookie 中，有效期為 1 天。
- 顧客在這 1 天內完成下單，LiteShop 會自動把訂單標記為「美安導購訂單」，並將訂單金額與佣金回傳給美安。
- 後續若訂單被取消或整筆退貨，LiteShop 會自動回傳負數金額給美安沖銷該筆紀錄；部分退貨則不會自動沖銷。
⚠️ 注意：如果顧客先點了美安連結但沒馬上下單，過了 1 天後才回來下單，這筆訂單就不會計入美安導購。這是平台間共通的追蹤機制，請知悉。
佣金計算公式
對帳報表底部會自動計算當期應付給美安的佣金總數，公式如下：
⚠️ 注意：
每筆訂單總計 = 訂單金額 − 運費
銷售總額 = 當期所有訂單「總計」加總
佣金 = 銷售總額 × 佣金百分比
營業稅 = 佣金 × 5%
應付佣金總數 = 佣金 + 營業稅
銷售總額 = 當期所有訂單「總計」加總
佣金 = 銷售總額 × 佣金百分比
營業稅 = 佣金 × 5%
應付佣金總數 = 佣金 + 營業稅
計算範例
假設您與美安約定的佣金百分比為 10%，當期僅有一筆美安導購訂單，情況如下：
| 項目 | 金額 |
|---|---|
| 商品小計 | NT$ 1,500 |
| 運費 | NT$ 100 |
| 訂單總額 | NT$ 1,600 |
| 每筆訂單總計（訂單總額 − 運費） | NT$ 1,500 |
| 銷售總額 | NT$ 1,500 |
| 佣金（1,500 × 10%） | NT$ 150 |
| 營業稅（150 × 5%） | NT$ 7.5 |
| 應付佣金總數（150 + 7.5） | NT$ 157.5 |
💡 小技巧：運費不列入佣金計算基準。若顧客後續整筆退貨，系統會自動回傳 −150 元的沖銷紀錄給美安；若為部分退貨則不會自動沖銷，需自行與美安協議。
後台辨識美安訂單
來自美安導購的訂單，會在 訂單管理 列表、會員資料 等頁面上，於訂單編號旁顯示一個 美安 標籤，方便您快速辨識訂單來源。
五、每月對帳：產生銷售報表
每月與美安結算佣金時，您可以使用 LiteShop 提供的銷售報表功能，匯出指定期間內所有美安導購訂單的明細。
步驟一：開啟銷售報表頁面
進入 系統外掛 → 導購串接，於美安 SHOP.COM 區塊右上方點擊 產生銷售報表 按鈕。
圖：產生銷售報表按鈕位於美安區塊的右上角
步驟二：選擇匯出日期區間
在 選擇匯出日期 欄位輸入起訖日期，預設值為本月 1 日到隔日。
- 日期區間不能超過 90 天，建議以月為單位匯出。
- 選好日期後，點 篩選日期 按鈕，下方表格會即時顯示符合條件的訂單筆數，方便您先預覽。
圖：選擇日期區間後可即時預覽訂單清單
步驟三：匯出報表
確認預覽資料無誤後，點擊 匯出報表 按鈕，系統會下載一份 Excel 檔案，檔名格式為 美安{起日}到{訖日}銷售報表.xlsx。
報表包含以下欄位：
| 欄位 | 說明 |
|---|---|
| 訂購日期 | 顧客下單的日期 |
| 訂單編號 | LiteShop 訂單編號 |
| 購買人 | 下單會員的姓名 |
| Market Taiwan RID number | 美安回傳的會員 RID，用於識別此筆訂單是哪位美安會員導購而來，對帳關鍵欄位 |
| Click_ID | 美安回傳的點擊 ID，用於識別此筆訂單來自哪一次美安連結點擊，對帳關鍵欄位 |
| 商品編號 | 該筆訂單所有品項的 SKU，多項以冒號分隔 |
| 購買商品 | 該筆訂單所有品項的名稱，多項以冒號分隔 |
| 數量 | 各品項的購買數量 |
| 網路銷售價 | 各品項的單價；若有折扣會在後方加註折抵金額 |
| 總計 | 訂單總額扣除運費後的金額（即佣金計算基準） |
💡 小技巧：建議將此 Excel 檔附在每月寄給美安窗口的對帳信中，作為佣金結算的依據。
⚠️ 注意：報表會包含已成立、可認列營收的訂單，包括：
・已付款的訂單
・貨到付款的訂單（即使尚未實際收款，只要尚未退回都會列入）
・部分退貨的訂單（顧客只退了部分品項、其餘品項仍正常出貨給顧客的情況，剩餘品項仍視為有效營收）
已取消、整筆退貨的訂單則會被排除，避免重複計算佣金。
・已付款的訂單
・貨到付款的訂單（即使尚未實際收款，只要尚未退回都會列入）
・部分退貨的訂單（顧客只退了部分品項、其餘品項仍正常出貨給顧客的情況，剩餘品項仍視為有效營收）
已取消、整筆退貨的訂單則會被排除，避免重複計算佣金。
❌ 重要提醒：部分退貨訂單在報表中是以原始訂單全額認列，系統不會自動扣除已退貨品項的金額；同樣地，LiteShop 也不會主動回傳沖銷紀錄給美安。如果您希望針對退貨的部分扣回對美安的佣金，請自行與美安窗口協議調整，或在月底寄出對帳信時附上備註說明。