ecommerce.config.get
read讀取網店基本設定，包括啟用功能、語言、時區、貨幣、付款方式、稅務設定、庫存扣減規則及治理政策。
建議先讀取
無需前置工具。
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續寫入必須以此工具回傳的設定為準；不得自行假設貨幣、稅率、付款狀態或庫存扣減時點。
網店平台 MCP 工具
本頁列出網店平台規劃中的 MCP 工具，涵蓋店舖設定、銷售渠道、商品與分類、圖片上載、價格與促銷、庫存、客戶、棄單、訂單、付款、退款、配送、退貨、營運分析及受治理的批量匯入流程。
ecommerce.sales_channels.list
read列出可用銷售渠道，例如網店、門市 POS、B2B 入口、社交落單或 marketplace 同步渠道。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立或篩選訂單、商品及價格時必須使用回傳 channel_id；不得以顯示名稱推斷識別碼。
ecommerce.locations.list
read列出可用倉庫、門市、取貨點及其可售庫存、出貨和退貨用途。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
庫存、出貨或退貨寫入必須指定有效 location_id；不得把已停用地點用於新操作。
ecommerce.categories.list
read列出商品分類、父子層級、排序、顯示狀態、URL slug 及可用於上架的分類限制。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立或更新商品時只能使用回傳分類；未知分類應標記待確認，不應新造分類名稱。
ecommerce.fulfilment_profiles.list
read列出配送方式、取貨方式、運費規則、服務地區、免運門檻、物流商及退貨處理設定。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立配送、計算運費或建立退貨時必須使用有效 profile_id；不得自行估算服務範圍或運費。
ecommerce.owners.list
read列出可分派的營運、客服、倉務及管理員帳戶，供商品草稿、棄單跟進、訂單異常和退貨任務使用。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
不得將任務或審批分派給回傳清單以外、已停用或無相關權限的帳戶。
ecommerce.products.search
read按商品名稱、SKU、條碼、分類、品牌、上架狀態、銷售渠道或庫存狀態搜尋商品。
建議先讀取
ecommerce.config.get、ecommerce.categories.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立新商品前必須先搜尋重複 SKU、條碼及相似商品名稱，避免重複上架。
ecommerce.products.get
read讀取單一商品詳情，包括內容、圖片、分類、SKU、規格、價格、庫存摘要、SEO 欄位及版本資料。
建議先讀取
ecommerce.products.search 或已知 product_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳 product_id、variant_id 及 base_version_token；不得覆蓋未讀取欄位。
ecommerce.products.create
write建立商品草稿，包含名稱、描述、分類、SKU、規格、售價、稅務類別、初始庫存及上架前檢查狀態。
建議先讀取
ecommerce.config.get、ecommerce.categories.list、ecommerce.products.search、ecommerce.locations.list
治理與審批
寫入工具；通常建立草稿，是否直接執行或審批由租戶政策決定。
安全說明
不得自行補作 SKU、售價、成本、庫存或稅務類別；資料不足時應建立待補資料草稿。
ecommerce.products.update
write更新商品內容、圖片排序、分類、SEO、規格顯示、商品屬性或銷售渠道設定。
建議先讀取
ecommerce.products.get、ecommerce.categories.list
治理與審批
寫入工具；已上架商品的公開內容變更可要求審批。
安全說明
只更新明確指定欄位；不得同時改價、改庫存或改上架狀態，除非使用者清楚要求。
ecommerce.products.publish_state.update
write切換商品草稿、上架、下架、預約上架或售罄隱藏狀態。
建議先讀取
ecommerce.products.get、ecommerce.inventory_levels.list
治理與審批
高風險公開變更；建議建立審批請求或要求明確確認。
安全說明
上架前必須確認價格、分類、圖片、庫存和付款/配送條件；不得把資料不足商品直接公開。
ecommerce.product_media.create_upload_session
upload為商品圖片、規格圖片或下載附件建立媒體上載 session，供上載後綁定到商品或變體。
建議先讀取
ecommerce.products.get 或 ecommerce.products.create 草稿結果
治理與審批
上載準備工具；只建立 session，不會改變公開商品，最終綁定仍需寫入工具。
安全說明
只接受允許格式及大小；上載結果必須以 media_get_upload_session_result 為準，不能使用本地臨時路徑。
ecommerce.variants.update
write更新商品規格，例如尺寸、顏色、包裝、SKU、條碼、重量、成本、可售狀態及排序。
建議先讀取
ecommerce.products.get
治理與審批
寫入工具；涉及 SKU、成本或已上架規格可要求審批。
安全說明
不得刪除已有銷售紀錄的規格；停用或合併規格前必須保留歷史訂單可追溯性。
ecommerce.products.import_preview
preview預覽批量商品匯入，檢查欄位映射、SKU 重複、分類、圖片連結、價格、庫存及格式錯誤。
建議先讀取
ecommerce.config.get、ecommerce.categories.list、ecommerce.locations.list、ecommerce.products.search
治理與審批
預覽工具；不會寫入資料。
安全說明
匯入前必須展示錯誤、重複及將會建立/更新的數量；不得直接提交未預覽清單。
ecommerce.products.import_commit
write在匯入預覽通過後提交批量商品建立或更新。
建議先讀取
ecommerce.products.import_preview
治理與審批
高風險批量寫入；建議建立審批請求。
安全說明
必須使用預覽批次 import_id；不得繞過重複 SKU、分類及圖片驗證。
ecommerce.price_rules.list
read列出固定售價、會員價、促銷價、優惠碼、組合優惠、滿額免運及生效時間。
建議先讀取
ecommerce.config.get、ecommerce.sales_channels.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
價格與促銷規則可能受渠道、會員等級及時間影響；不得只讀單一售價就判定最終成交價。
ecommerce.price_rules.preview
preview預覽新價格、優惠碼、組合優惠或滿額免運規則對指定商品、渠道及客戶分群的影響。
建議先讀取
ecommerce.price_rules.list、ecommerce.products.get、ecommerce.sales_channels.list
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須列出衝突規則、毛利風險及生效時間；不得將預覽結果當成已發布促銷。
ecommerce.price_rules.upsert
write建立或更新價格、優惠碼、會員價、組合優惠、滿額免運或限時促銷規則。
建議先讀取
ecommerce.price_rules.preview、ecommerce.price_rules.list
治理與審批
高風險商業寫入；建議建立審批請求或要求明確確認。
安全說明
不得自行估算折扣、成本或生效時間；必須保留規則原因及適用範圍。
ecommerce.inventory_levels.list
read按商品、規格、地點、渠道或安全庫存門檻讀取可售、預留、損耗及待補貨數量。
建議先讀取
ecommerce.products.get、ecommerce.locations.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
庫存數字必須連同地點及最後更新時間解讀；不得將不同倉庫庫存混合為單一可售量。
ecommerce.inventory.adjust
write按指定原因調整庫存，例如盤點差異、損耗、退貨入庫、補貨入庫或安全庫存修正。
建議先讀取
ecommerce.inventory_levels.list、ecommerce.locations.list
治理與審批
高風險寫入；影響可售數量，建議要求審批或明確確認。
安全說明
必須提供 location_id、variant_id、數量差異及原因；不得用此工具修正訂單流程錯誤而不保留稽核紀錄。
ecommerce.customers.search
read按姓名、電話、電郵、會員等級、標籤、最近訂單或總消費搜尋網店客戶。
建議先讀取
ecommerce.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
搜尋結果可能含個人資料；只回傳完成任務所需欄位，並遵守租戶可見性。
ecommerce.customers.get
read讀取單一客戶的會員資料、訂單摘要、地址、偏好、同意狀態、客服備註及版本資料。
建議先讀取
ecommerce.customers.search 或已知 customer_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續寫入必須使用回傳 customer_id 及 base_version_token；不得自行推斷同意狀態。
ecommerce.customers.note.create
write在客戶或訂單檔案新增客服跟進備註，例如投訴、特殊配送要求、VIP 偏好或售後跟進。
建議先讀取
ecommerce.customers.get 或 ecommerce.orders.get
治理與審批
寫入工具；一般可直接執行，敏感備註可按政策審批。
安全說明
只記錄已確認事實或清楚標示為內部備註；不得加入歧視性、未核實或任務無關內容。
ecommerce.carts.list_abandoned
read列出可跟進的棄單購物車，包括商品、金額、最後活動時間、客戶、同意狀態及跟進狀態。
建議先讀取
ecommerce.config.get、ecommerce.customers.search
治理與審批
只讀工具；不會建立審批請求。
安全說明
不得把無通訊同意或已退訂客戶列入可自動發送名單；只可建立內部跟進建議。
ecommerce.carts.recovery_task.create
write為棄單建立內部跟進任務或訊息草稿，供客服或營運人員覆核後處理。
建議先讀取
ecommerce.carts.list_abandoned、ecommerce.owners.list、ecommerce.customers.get
治理與審批
寫入工具；建立內部任務通常可直接執行，外部訊息發送必須另行審批。
安全說明
此工具不得直接發送 WhatsApp、SMS 或 Email；必須保留人工覆核和同意狀態。
ecommerce.orders.list
read按訂單狀態、付款狀態、配送狀態、日期、客戶、銷售渠道、地點或異常標記列出訂單。
建議先讀取
ecommerce.config.get、ecommerce.sales_channels.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
訂單列表應按使用者權限及地點可見性過濾；不要暴露任務無關個人資料。
ecommerce.orders.get
read讀取單一訂單的商品明細、價格拆解、客戶、收貨資料、付款、配送、退款、備註、稽核紀錄及版本資料。
建議先讀取
ecommerce.orders.list 或已知 order_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳 order_id 及 base_version_token；不得覆蓋付款、配送或退款紀錄。
ecommerce.orders.create_draft
write建立人工訂單草稿，適合電話、WhatsApp、B2B 或客服代客落單，並先保留價格及庫存檢查結果。
建議先讀取
ecommerce.customers.get、ecommerce.products.get、ecommerce.price_rules.list、ecommerce.inventory_levels.list
治理與審批
寫入工具；建立草稿通常可直接執行，確認訂單或扣庫存需按政策審批。
安全說明
不得自行填寫收貨地址、折扣或付款狀態；缺少資料時應保持草稿待確認。
ecommerce.orders.update_status
write更新訂單狀態，例如已確認、處理中、待補資料、已完成、暫停或等待付款核對。
建議先讀取
ecommerce.orders.get、ecommerce.config.get
治理與審批
寫入工具；會影響付款、庫存或客服流程的狀態變更可要求審批。
安全說明
只能移動至設定允許的狀態；不得跳過付款核對、庫存扣減或出貨必要條件。
ecommerce.orders.cancel
write取消訂單並記錄取消原因、是否回補庫存、是否需要退款及客服跟進。
建議先讀取
ecommerce.orders.get、ecommerce.payments.list、ecommerce.fulfilment.list
治理與審批
高風險寫入；建議建立審批請求或要求明確確認。
安全說明
已付款、已出貨或部分出貨訂單不得直接取消而不處理退款、退貨或庫存回補。
ecommerce.orders.note.create
write新增訂單內部備註，例如付款截圖核對、包裝要求、客戶更改要求、異常原因或主管指示。
建議先讀取
ecommerce.orders.get
治理與審批
寫入工具；一般可直接執行。
安全說明
備註不得改變訂單狀態；涉及退款、取消或出貨仍須使用專用工具。
ecommerce.payments.list
read查詢付款紀錄、交易渠道、付款狀態、對帳狀態、手動付款憑證及關聯訂單。
建議先讀取
ecommerce.orders.get 或訂單範圍查詢條件
治理與審批
只讀工具；不會建立審批請求。
安全說明
付款狀態必須以支付渠道或已核對憑證為準；不得只憑客戶訊息判定已付款。
ecommerce.payments.reconcile_preview
preview預覽付款對帳結果，對比訂單金額、手續費、退款、支付渠道交易及手動付款憑證。
建議先讀取
ecommerce.payments.list、ecommerce.orders.get
治理與審批
預覽工具；不會寫入資料。
安全說明
預覽必須列出差額、未匹配交易及證據來源；不得自動更改付款狀態。
ecommerce.payments.mark_manual_paid
write在人工核對後將銀行轉帳、FPS、PayMe 或其他手動付款標記為已收款，並保存核對證據。
建議先讀取
ecommerce.payments.reconcile_preview、ecommerce.orders.get
治理與審批
高風險財務寫入；建議建立審批請求或要求明確確認。
安全說明
必須保存付款憑證、核對人及時間；不得由代理程式自行確認未核實付款。
ecommerce.refunds.preview
preview預覽退款或部分退款，計算可退款金額、已出貨狀態、退貨要求、手續費及庫存回補影響。
建議先讀取
ecommerce.orders.get、ecommerce.payments.list、ecommerce.fulfilment.list
治理與審批
預覽工具；不會寫入資料。
安全說明
不得把預覽結果當成已退款；必須清楚列出不可退款項目及退貨條件。
ecommerce.refunds.request
write提交全額或部分退款請求，保留原因、金額、付款交易、退貨要求、審批及稽核紀錄。
建議先讀取
ecommerce.refunds.preview
治理與審批
高風險財務寫入；建議建立審批請求。
安全說明
必須使用預覽結果及已確認金額；不得退款超過實收金額或繞過退貨政策。
ecommerce.fulfilment.list
read列出待執貨、待出貨、已出貨、已送達、配送異常、門市自取及退貨中的履約紀錄。
建議先讀取
ecommerce.orders.list 或 ecommerce.orders.get、ecommerce.fulfilment_profiles.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
履約資料必須按訂單和地點可見性限制；不要暴露其他客戶地址或電話。
ecommerce.fulfilment.create_shipment
write為訂單建立配送紀錄、執貨清單、物流商、追蹤號碼、送貨地址、取貨點或門市自取安排。
建議先讀取
ecommerce.orders.get、ecommerce.inventory_levels.list、ecommerce.fulfilment_profiles.list
治理與審批
寫入工具；會通知物流或扣減庫存時可要求審批。
安全說明
建立出貨前必須確認付款要求、可用庫存、收貨資料及配送方式；不得對已取消訂單出貨。
ecommerce.fulfilment.update_tracking
write更新物流追蹤號碼、配送狀態、簽收時間、配送異常或重新派送安排。
建議先讀取
ecommerce.fulfilment.list、ecommerce.orders.get
治理與審批
寫入工具；一般可直接執行，若會觸發客戶通知則按政策審批。
安全說明
不得把未送達訂單標記為已送達；狀態必須來自物流商、簽收證據或人工確認。
ecommerce.returns.create_request
write建立退貨或換貨請求，記錄原因、商品狀態、照片證據、是否回補庫存、是否連動退款。
建議先讀取
ecommerce.orders.get、ecommerce.fulfilment.list、ecommerce.refunds.preview
治理與審批
高風險售後寫入；建議建立審批請求或要求明確確認。
安全說明
退貨不等於退款；必須分開記錄收貨、檢查、庫存回補及退款決定。
ecommerce.analytics.sales_summary
read讀取指定日期、渠道、分類或商品範圍的銷售額、訂單數、轉換、客單價、退款、熱賣商品及庫存風險摘要。
建議先讀取
ecommerce.config.get、ecommerce.sales_channels.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
分析結果應標明日期範圍、時區、渠道及資料延遲；不得將未完成付款當成實收收入。
ecommerce.action_request.status
status查詢網店寫入、上載、退款、批量匯入或高風險操作的審批、執行、拒絕或失敗狀態。
建議先讀取
已知 action_request_id
治理與審批
狀態查詢工具；不會建立新的審批請求。
安全說明
狀態結果只代表治理流程進度；不得重試非冪等寫入，除非使用相同 idempotency_key 或明確新請求。