摘要
Skroutz 市场 (智能购物车) API 适用于希腊和塞浦路斯市场的卖家:读取、接受和安排订单,标记为准备就绪,跟踪,发票上传,退货,由 Skroutz 完成的库存,采购订单和供应商,大宗价格和库存更新以及 CPS 订单。来自商家面板的 API 令牌。
引导式设置
2 分钟将 Skroutz 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Skroutz,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Skroutz 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Skroutz,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Skroutz
Skroutz 市场 (智能购物车) API 适用于希腊和塞浦路斯市场的卖家:读取、接受和安排订单,标记为准备就绪,跟踪,发票上传,退货,由 Skroutz 完成的库存,采购订单和供应商,大宗价格和库存更新以及 CPS 订单。来自商家面板的 API 令牌。
设置
设置大约需要 3 分钟。
- 登录到 Skroutz 商家面板,打开 Services, Skroutz Marketplace(智能购物车设置页面)。
- 生成 API 令牌,并将其粘贴到
SKROUTZ_API_TOKEN中。每个商店只有一个活动令牌:生成新令牌会结束之前的令牌,因此被其他集成使用的令牌将停止工作。 - 可选,进行大宗价格和库存更新:在 Products, Feed Updates 中生成产品 API 令牌,并将其粘贴到
SKROUTZ_PRODUCTS_TOKEN中。 - 可选,针对你自己网店的 CPS 订单:在 Παραγγελίες καταστήματος, Αυτόματη διαχείριση(商店订单,自动处理)中生成 CPS 令牌,并将其粘贴到
SKROUTZ_CPS_TOKEN中。
每次调用都会将令牌作为 Authorization: Bearer 发送,媒体类型为 application/vnd.skroutz+json; version=3.0。安装检查读取演示订单 DEMO-OPEN,这证明了市场令牌而不接触真实数据。
从哪里开始:API 没有订单列表。订单通过订单 webhook、商家面板和订单电子邮件到达商店,因此请询问用户订单代码(如 191128-1234567),并使用 skroutz_get_order 读取它。演示代码 DEMO-OPEN、DEMO-ACCEPTED、DEMO-REJECTED、DEMO-INVOICE、DEMO-FBS、DEMO-STORE-PICKUP 和 DEMO-RETURN 可以安全读取、接受和拒绝进行测试:没有任何数据被存储。
订单:开放订单携带 accept_options 和 reject_options,必须在 expires_at 之前处理。使用 skroutz_accept_order 接受它,发送取货地点 ID 和该地点的一个取货窗口的 ID(窗口因地点而异)。然后 Skroutz 会预定快递员,凭证 PDF 会出现在 courier_voucher 中。快递订单会被 Skroutz 自动接受。skroutz_reject_order 默认关闭:拒绝无法撤销,并且会计入商店。要更改已接受订单的取货,请在之前读取它并使用 action_options 1,然后使用 skroutz_reschedule_order_pickup(来自 reschedule_options 的日期)或 skroutz_relocate_order_pickup(来自 relocate_options 的 ID);列表会随着时间缩小。skroutz_request_preorder_voucher 提前创建已接受预购的凭证。
标记为准备就绪:当订单显示 set_as_ready_required 为真时,Skroutz Last Mile 仅在 skroutz_set_order_ready 之后取货;下载凭证不再标记为准备就绪(自 2026 年 3 月 30 日起)。提前标记可以将取货移动到更早的窗口。skroutz_set_order_not_ready 在取货前撤销此操作。对于 set_as_ready_required 为假的商店则不需要。
运输和文档:skroutz_update_tracking_details 仅发送由商家完成 (FBM) 订单的快递和跟踪代码。skroutz_upload_invoice 和 skroutz_upload_credit_invoice 接受指向 PDF、PNG 或 JPG 的公共链接(最大 7 MB);连接器下载并上传文件,每个订单一个,替换之前的上传。
退货:skroutz_get_return 通过其代码读取退货(如 R-111111-1111111,来自退货 webhook 或商家面板;订单的 returns 仅提供 uuid 和跟踪 ID)。skroutz_handle_return(决定等待审核的退货,直到 review.expires_at,包括在商店费用下发送缺失部分)和 skroutz_submit_service_inspection(关于故障物品的技术报告,作为文件链接)默认关闭,因为它们会导致退款、替换或付费运输。skroutz_file_compensation_request 也关闭:它向 Skroutz 索赔退货商品的费用,并且通过此连接器仅针对不需要照片的原因。
由 Skroutz 完成:skroutz_list_fbs_products(Skroutz 仓库中的库存)、skroutz_list_fbs_purchase_orders、skroutz_list_fbs_purchase_order_items、skroutz_list_fbs_suppliers、skroutz_create_fbs_supplier 和 skroutz_update_fbs_supplier。skroutz_create_fbs_purchase_order 默认关闭,因为仓库费用由此产生。列表分页,使用 page,并附带 meta.pagination(每页 100 行)。没有 FBS 的商店在这里会收到 401。
产品 API(需要 SKROUTZ_PRODUCTS_TOKEN):skroutz_validate_product_updates 检查一批而不更改任何内容;skroutz_update_products(默认关闭)更新多达 500 个现有产品及其变体的可用性、价格和数量,异步;skroutz_get_product_update_status 报告每个产品的成功、无变化或失败。这里的价格为 整数欧元分(1050 是 10.50 欧元),而订单金额为十进制欧元。它不创建产品:这些来自 XML 供稿。422 表示 XML 正在扫描,意味着稍后再试。
CPS 订单(需要 SKROUTZ_CPS_TOKEN):skroutz_get_cps_order 通过你自己订单号读取你自己网店的销售,包含收入和佣金;skroutz_reject_cps_order(默认关闭)拒绝它,以便不收取佣金。
字段说明:时间为 ISO 8601 格式,带有雅典时区偏移(冬季 +02:00,夏季 +03:00)。取货窗口、拒绝原因和 CPS 状态等标签为希腊语。行项目 ID 为短字符串(l39vKqxqwe);shop_uid 是你自己的产品 ID。错误包含一个 errors 数组,带有 code 和 messages:422 order_status 意味着订单不在可进行该操作的状态。错误或替换的市场令牌会返回 403。连接器从不移动资金:拒绝、退货决定、赔偿请求、采购订单和大宗产品更新默认关闭,供管理员故意开启。
先决条件:SKROUTZ_API_TOKEN
本地安装连接器
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,选择 Skroutz 并粘贴先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
skroutz_get_order | 通过其代码读取一个 Skroutz 市场 (智能购物车) 订单:状态(开放、已接受、已拒绝、已取消、已过期、已发货、已交付… |
skroutz_accept_order | 接受一个开放订单:Skroutz 然后预定快递员并发放凭证(凭证会作为 courier_voucher 到达订单上)。发送一个… |
skroutz_reject_order | 拒绝一个开放订单,可以通过行项目和拒绝选项中的原因 ID(当原因有… |
skroutz_reschedule_order_pickup | 将已接受订单的快递取货移动到另一个日期。在之前读取订单并发送其… |
skroutz_relocate_order_pickup | 将已接受订单的快递取货移动到商店的另一个取货地点,保持取货日期和时段。快递员会… |
skroutz_set_order_ready | 将已接受的订单标记为已打包并准备发货(标记为准备就绪)。对于订单显示 set_as_ready_required 为真的商店是必需的… |
skroutz_set_order_not_ready | 撤销已接受订单的标记为准备就绪,前提是快递员尚未取货。Skroutz 尝试将取货移回原始日期… |
skroutz_update_tracking_details | 发送每个由商家完成 (FBM) 订单的快递和跟踪代码,以便客户可以跟踪。仅适用于 FBM… |
skroutz_request_preorder_voucher | 请求已接受预购的快递凭证,当产品在计划发货日期之前到达时(面板的创建… |
skroutz_upload_invoice | 从文件链接上传订单的收据或发票(PDF、PNG 或 JPG,最大 7 MB)。每个订单一个文件:新的上传… |
skroutz_upload_credit_invoice | 上传已取消、退货、部分退货或在收据或发票后退回发件人的订单的信用发票… |
skroutz_file_compensation_request | 请求 Skroutz 为退货行项目赔偿商店,作为 JSON 发送,不带照片,因此仅针对不需要照片的原因… |
skroutz_get_return | 通过其代码读取一个退货:状态(待商家审核、退货、待物理审核、待服务检查、已退货… |
skroutz_handle_return | 决定状态为待商家审核的退货,使用其 handle_options 之一:批准、拒绝,例如 not_faulty(当… |
skroutz_submit_service_inspection | 提交故障退货物品的技术检查结果(状态为待服务检查的退货):物品 ID、其… |
skroutz_list_fbs_products | 列出商店的由 Skroutz 完成 (FBS) 产品,这些产品存储在 Skroutz 仓库中:ID、shop_uid(你的产品 ID)、活动(可购买的… |
skroutz_list_fbs_purchase_orders | 列出商店的由 Skroutz 完成的采购订单(发送到 Skroutz 仓库的库存):代码、创建时间、预期日期和收到时间… |
skroutz_list_fbs_purchase_order_items | 列出一个由 Skroutz 完成的采购订单的行项目:product_id、shop_uid、活动、预期数量和实际数量… |
skroutz_create_fbs_purchase_order | 宣布一个新的由 Skroutz 完成的采购订单:你将交付给 Skroutz 仓库的库存,预期日期、供应商… |
skroutz_list_fbs_suppliers | 列出商店的由 Skroutz 完成的供应商:ID(用于采购订单)、代码、名称、地址、城市、地区、邮政编码、电话… |
skroutz_create_fbs_supplier | 添加一个由 Skroutz 完成的供应商(为你向 Skroutz 仓库发货的供应商),具有唯一代码、名称、地址、城市、地区、邮政编码… |
skroutz_update_fbs_supplier | 更改由 Skroutz 完成的供应商的字段;仅发送的字段会更改。返回 success: true |
skroutz_validate_product_updates | 检查一批产品更新(可用性、价格(以分为单位)、数量、变体)而不更改任何内容:Skroutz 运行每个检查… |
skroutz_update_products | 更新多达 500 个现有产品及其变体的可用性、价格(以欧元分为单位)和数量;它不创建… |
skroutz_get_product_update_status | 读取产品批量更新的结果:状态(在任何产品待处理时为 in_progress,然后为 completed)、created_at,以及每个产品… |
skroutz_get_cps_order | 通过你商店提供的订单代码读取一个 CPS 订单(来自 Skroutz 的你自己网店的销售,由佣金支付):日期… |
skroutz_reject_cps_order | 拒绝一个 CPS 订单,以便 Skroutz 不收取佣金,使用其拒绝选项之一(用户取消、用户退货、未送达… |
示例提示
- "显示订单 251114-3920517 及其项目、取货选项和过期时间。"
- "接受订单 251114-3920517,选择我雅典仓库的第一个取货窗口。"
- "订单 251112-1187340 需要标记为准备就绪:它准备好标记了吗,取货时间是什么时候?"
- "退货 R-251110-2045318 说了什么,我必须在什么时候审核?"
- "我在 Skroutz 仓库中每种产品有多少单位?"
下一步
这份指南对你有帮助吗?