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 或明确新请求。