導購串接-美安SHOP.COM

美安 SHOP.COM 導購串接｜設定與對帳

目錄
一、應用情境二、前置準備三、設定步驟四、運作流程與計算範例五、每月對帳：產生銷售報表六、常見問題 FAQ

一、應用情境

美安 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%
應付佣金總數 = 佣金 + 營業稅

計算範例

假設您與美安約定的佣金百分比為 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 也不會主動回傳沖銷紀錄給美安。如果您希望針對退貨的部分扣回對美安的佣金，請自行與美安窗口協議調整，或在月底寄出對帳信時附上備註說明。

六、常見問題 FAQ

Q：啟用美安串接後，所有訂單都會被列為美安訂單嗎？

A：不會。只有顧客透過美安導購連結進入您官網，並在 1 天內完成下單，這筆訂單才會被標記為美安導購訂單。顧客直接到您官網下單、或從其他通路進來的訂單，都不會被計入。

Q：佣金百分比可以隨時修改嗎？修改後對舊訂單會有影響嗎？

A：可以隨時修改並儲存，但修改後的影響範圍要分兩部分看：
1. 已回傳給美安的佣金紀錄：每筆訂單成立當下就會用「當時」的佣金百分比計算並回傳給美安，後續調整佣金百分比不會改動已回傳的紀錄。
2. LiteShop 匯出的對帳 Excel 報表：每次匯出時都是抓「當下」設定的佣金百分比重新計算，所以如果中途調整過佣金百分比，再匯出舊期間報表，舊訂單會用新的百分比計算，與當初回傳給美安的金額會不一致。
若您與美安重新議定了佣金比例，建議在約定的生效日當天修改設定，並把生效前的對帳報表先匯出存檔，避免後續對帳混淆。

Q：美安顧客可以使用我官網的折價券或促銷碼嗎？

A：取決於您在設定頁的 並用促銷活動 開關。設為 是，美安顧客可以正常使用促銷碼、滿額活動；設為 否，這些行銷功能對美安顧客全部停用。請依您與美安合約上的約定來設定。

Q：商品銷售資料表 XML 需要我自己維護嗎？多久更新一次？

A：不需要自己維護，也沒有固定的更新時間或排程。XML 連結是系統自動產生的，美安每次抓取這個連結時，LiteShop 都會即時從資料庫撈出當下所有上架中的商品，產生最新的 XML 資料回應給美安。所以您只要正常在後台上下架商品、調整價格、更新圖片，美安下次來抓取時就會看到最新內容，不需要手動觸發任何同步動作，連結也只需提供給美安一次即可。

Q：顧客退貨後，需要手動通知美安沖銷佣金嗎？

A：分情況：
・取消訂單 或 整筆退貨：不需要。系統會自動回傳一筆負數金額給美安沖銷該筆紀錄，美安端會對應扣除佣金。
・部分退貨（顧客只退部分品項）：系統不會自動沖銷，銷售報表也會以原始訂單全額認列。若您希望扣回退貨部分的佣金，請自行與美安窗口協議，或在月底寄出對帳信時附上說明。

Q：銷售報表日期區間為什麼不能超過 90 天？

A：為了避免單次匯出資料量過大造成系統負擔，報表設有 90 天的區間上限。若您需要更長期的紀錄，建議分多次匯出（例如每季匯出一次）並合併到您自己的 Excel 中。

Q：我暫時不想接美安訂單，要怎麼暫停串接？

A：進入美安 SHOP.COM 設定區塊，將 啟用 / 停用 開關切換為 已停用，並點擊 儲存設定 即可。停用後，新訂單就不會再回傳給美安，但已經回傳的舊訂單紀錄不會被影響。日後若要恢復，再切回 啟用中 即可。

Q：我想申請美安夥伴商店，要從哪裡開始？

A：請自行聯繫美安，或於 LiteShop 後台美安 SHOP.COM 設定區塊的注意事項欄位中，點擊 申請美安夥伴商店 按鈕，會直接帶您到美安官方申請頁面。