摘要
Spartoo 市场卖家的网络服务:带有客户和交付详情的订单,接受和运输带有跟踪号码的订单,退货,网站上产品的状态和按尺码的库存更新。合作伙伴代码作为表单字段,XML 答复以 JSON 格式读取。
引导式设置
2 分钟将 Spartoo Marketplace 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Spartoo Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Spartoo Marketplace 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不想安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Spartoo Marketplace,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Spartoo 市场
Spartoo 市场卖家的网络服务:带有客户和交付详情的订单,接受和运输带有跟踪号码的订单,退货,网站上产品的状态和按尺码的库存更新。合作伙伴代码作为表单字段,XML 答复以 JSON 格式读取。
设置
设置大约需要 3 分钟。
- 登录 Spartoo 市场后台,打开 Documentation,然后 Webservices 和任何服务页面,例如 Exporting orders。
- 行 Webservice URL 指定了你的 Spartoo 网站的网络服务地址,例如
https://sws.spartoo.eu或https://sws.spartoo.it。将/mp/之前的部分放入SPARTOO_HOST。 - 在同一页面,行
partner显示你登录时的唯一代码。将其放入SPARTOO_PARTNER_KEY。如果页面没有显示代码,请向你的 Spartoo 市场联系人询问你账户的网络服务代码。
从哪里开始:spartoo_list_orders 以开始日期为参数。spartoo_get_order 通过其 ID 读取一个订单。
订单:订单的状态为 11(已验证)。spartoo_accept_order 将其状态更改为 2(准备中):之后其名称、地址和承运人将无法更改。spartoo_ship_order 将其从 2 更改为 3(已发货),并附上承运人的跟踪号码,Spartoo 会将跟踪链接通过电子邮件发送给客户。spartoo_cancel_order(状态 41)默认关闭:客户会获得退款,且无法撤销。状态 45(包裹丢失)和 47(包裹未送达)由 Spartoo 设置。
退货:spartoo_list_returns 和 spartoo_get_return。一个退货包含一个产品。退货状态:2 等待接收,3 拒绝,4 包裹已接收且退货被接受,5 已付款,7 退款,14 等待商家的预付退货标签。此连接器不接受或拒绝退货。
产品和库存:spartoo_check_product_status 指示产品是否在网站上(OK)、缺货(OS)、已创建但尚未上线(EC)或未知(KO),并给出原因。spartoo_update_stock 设置某一尺码的库存。两者都使用你自己的引用:reference_partenaire 是一种颜色的产品,size_reference 是其一种尺码。库存为 0 会将该尺码从网站上移除。
字段说明
- 订单 ID 和退货 ID 是短代码,例如
90D813EA1A2365A8。 - 订单日期过滤器的格式为
YYYY-MM-DD:hh:mm:ss,日期和小时之间用冒号分隔。退货日期过滤器为 Unix 时间戳(秒)。Spartoo 不记录时区。 - 价格为订单网站货币中的十进制数字;
products_final_price是折扣后的单价乘以数量。 - 针对取件点的订单有
relay_info代替交付地址。 - 文本值以字符串形式到达,包括数字。列表中的一个订单或产品以对象形式到达,多个则以数组形式到达。
错误:每个答复都带有一个代码。1 表示没有错误。-1 和 -2:缺少或未知的合作伙伴代码。-3:缺少日期或 ID。-4:日期格式错误。-6 和 -28:未找到订单或退货。-8:跟踪号码被拒绝。-9:订单已经具有该状态。-19:状态顺序错误(2 只能从 11,3 只能从 2)。-14:未找到产品。-16、-18 和 -20:库存未更改(不可能,已经是该值,或尺码不再有效)。-30:订单太旧无法发货,请联系 Spartoo。-428:账户已停用。-429:一小时内请求过多。连接器报告负代码作为调用失败。
未涵盖:创建和编辑产品、价格和折扣(它们通过 XML 目录文件进行处理)、装箱单和退货决定。
先决条件:SPARTOO_HOST,SPARTOO_PARTNER_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 Spartoo Marketplace 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
spartoo_list_orders | 列出自某个日期以来下的订单,可选择仅列出某一状态的订单。每个订单在 root.orders.order 下:orders_id,customers… |
spartoo_get_order | 通过其 ID 读取一个订单:客户和交付详情(或取件点在 relay_info 中)、支付方式、运输名称和价格、订单… |
spartoo_accept_order | 接受一个新订单:将其状态从 11(已验证)更改为 2(准备中)。之后订单的名称、交付地址和承运人将… |
spartoo_ship_order | 将已接受的订单标记为已发货,并附上承运人的跟踪号码:将其状态从 2 更改为 3,Spartoo 会将跟踪链接通过电子邮件发送给… |
spartoo_cancel_order | 取消尚未发货的订单(状态 41)。客户不会收到订单,Spartoo 会退款;此操作无法撤销… |
spartoo_list_returns | 列出自某个时刻以来登记的退货,可选择仅列出某一状态的退货。每个退货在 root.returns.return 下:return_id… |
spartoo_get_return | 读取一个订单的退货,或通过其 ID 读取一个退货:退货 ID 和日期、状态 ID 和名称、原因、订单 ID 和退货产品… |
spartoo_check_product_status | 检查你的某个产品是否在 Spartoo 网站上。返回在 root.products.product 下你的引用、状态(网站上的 OK… |
spartoo_update_stock | 实时设置某一产品某一尺码的库存。库存为 0 会将该尺码从网站上移除;所有尺码库存为 0 的产品将下线… |
示例提示
- "自周一以来有哪些 Spartoo 订单尚未被接受?"
- "接受订单 90D813EA1A2365A8,并使用皇家邮政跟踪 AB123456789GB 发货。"
- "哪些退货正在等待接收?"
- "我的产品 REF-BOOT-221 在线吗?如果没有,为什么?"
- "将 REF-BOOT-221 的尺码 38 的库存设置为 6。"
下一步
这份指南对你有帮助吗?