摘要
通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场的店铺:列出商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。
引导式设置
2 分钟将 Grupo Éxito Marketplace 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Grupo Éxito Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Grupo Éxito Marketplace 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → Grupo Éxito Marketplace,粘贴你的凭据,生成 MCP API 密钥即可完成。无需 Docker,无需
git clone,无需本地服务器。
Grupo Éxito Marketplace
通过 Grupo Éxito 的卖家 API,让你的 AI 管理你在哥伦比亚 exito.com 市场的店铺:列出商品及其审核状态,创建带图片、描述和属性的商品,设置价格和库存,并读取订单和结算单。
设置
在 Éxito 授予你 API 访问权限后,设置大约需要 10 分钟。获得访问权限后,Éxito 会发送认证说明:用户名、密码、API 密钥以及签发令牌的地址。你还需要你的数字卖家 ID。
没有沙盒环境:Éxito 没有提供沙盒,因此每次调用(包括写入操作)都会作用于你的正式店铺。
- 将 API 用户(一个电子邮件地址)粘贴到
EXITO_USERNAME,将 API 密码粘贴到EXITO_PASSWORD,两者都来自 Éxito 的说明。 - 将同一说明中的
x-api-key粘贴到EXITO_API_KEY。 - 将令牌请求的完整
https://地址粘贴到EXITO_LOGIN_URL。该地址未在 developers.exito.com 上公布,请从 Éxito 发给你的文档中复制。 - 将你的数字卖家 ID(idSeller,例如
11795)填入EXITO_SELLER_ID。exito_marketplace_get_bulk_upload_status也会以data.idSeller的形式显示它。 - 安装连接器。运行
exito_marketplace_list_categories以检查连接。
登录方式:连接器使用你的用户名、密码和 API 密钥向令牌地址请求令牌,并在每次调用时连同 API 密钥一起发送。令牌会自动续期,最长每小时一次。密码和密钥经加密存储,绝不会展示给 AI。
云端和自托管的工作方式相同:凭据相同,也无需设置重定向 URL。
在 Éxito 上销售是异步的:
- 使用
exito_marketplace_list_categories选择最具体的类别,并用exito_marketplace_get_category_features读取其规格。必填规格必须提交;带有值列表的规格只接受列表中的值。 - 使用
exito_marketplace_create_products创建商品,每次调用最多 400 个 EAN。图片为公开 URL,尺寸 1000x1000 px(服装为 733x1000 px)。品牌必须已存在于 Éxito;如缺少品牌,请联系你的 Éxito 客户经理创建。 - 使用
exito_marketplace_get_bulk_upload_status跟踪批次。在有批次正在启动或处理时,不会接受新的批次。 - Éxito 的内容团队会审核每个商品。
exito_marketplace_get_products_waiting列出审核中的商品,exito_marketplace_get_products_rejected列出被拒绝的商品及原因,exito_marketplace_get_products_pending_seller_approval列出与市场中已有的同一商品存在差异的商品。商品获批后,最多需要一小时才能创建报价。 - 使用
exito_marketplace_upsert_offers为已获批的商品设置价格和库存;若只针对单个 EAN,则使用exito_marketplace_update_offer_price_stock。exito_marketplace_load_products_and_offers可在一次请求中同时发送商品和报价。报价大约在 4 小时内同步到各站点。
价格和库存:价格为大于 8000 的哥伦比亚比索整数,不带分隔符(45000)。促销价必须低于原价。若只想修改价格,请发送当前库存,并将 IsUpdatedStock 设为 0。价格变动超过 30% 时会返回代码 PEX,需要附带价格批准重新发送:执行前 AI 会先询问你。若要停止销售某个商品,请将其库存设为 0:该 API 不提供删除功能。
订单和结算:exito_marketplace_get_orders 列出来自 exito.com、carulla.com 及 Éxito 其他站点的订单,包含状态、总额、佣金和配送类型。exito_marketplace_get_bills 列出结算单。列表使用 paginationToken 分页。
安装时默认关闭:exito_marketplace_set_order_tracking(将订单中的商品标记为已发货,附承运商和运单号)和 exito_marketplace_upload_order_invoice(将发票附加到订单)。当你希望 AI 处理订单时,请在连接器页面中启用它们;AI 会要求你确认每一次调用。创建商品以及设置价格和库存的工具默认已启用(exito_marketplace_create_products、exito_marketplace_load_products_and_offers、exito_marketplace_upsert_offers、exito_marketplace_update_offer_price_stock)。
务必查看每个响应:批量写入会返回 HTTP 200,并为每个被拒绝的 EAN 附一条消息,因此 200 并不代表所有商品或报价都已被接受。请求和响应均为西班牙语。
未覆盖的内容:运单标签、Éxito 的审核和报价通知,以及 Seller Center 网页应用中 API 未提供的任何功能。
常见错误:如果没有签发令牌,请对照 Éxito 的说明检查用户名、密码和 API 密钥,并确认 EXITO_LOGIN_URL 是该文档中的令牌地址。401 表示令牌被拒绝。403 通常表示 API 密钥缺失或错误,或者你的用户未启用该 API:请向 Éxito 询问你的访问权限涵盖哪些 API。
前置条件:EXITO_USERNAME、EXITO_PASSWORD、EXITO_API_KEY、EXITO_LOGIN_URL、EXITO_SELLER_ID
在本地安装连接器
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,选择 Grupo Éxito Marketplace,并粘贴“前置条件”中列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
exito_marketplace_get_products | 列出卖家在 Éxito 市场中的商品,包含名称、EAN、VTEX PLU、图片、创建和更新日期、价格、促销价、库存…… |
exito_marketplace_get_products_waiting | 等待 Éxito 内容团队审核(审查)的商品,包含 EAN、名称、图片、处理日期和父级引用 |
exito_marketplace_get_products_rejected | 被 Éxito 内容团队拒绝且必须修正的商品,包含 EAN、名称、图片、拒绝的 Reason 和 Comment |
exito_marketplace_get_products_pending_seller_approval | 因与市场中已有的同一商品存在差异而需要你决定的商品:每一行包含 oldProduct 和…… |
exito_marketplace_get_bulk_upload_status | 你最近一次商品创建批次(exito_marketplace_create_products)的状态。data.status:4 启动中,1 处理中,2 已完成…… |
exito_marketplace_list_categories | Éxito 市场的所有类别,包含 Id、IdParent、Name 和 ProductType(Technology 或 Clothing) |
exito_marketplace_get_category | 按 id 获取单个类别:Id、IdParent、Name 和 ProductType |
exito_marketplace_get_category_features | 类别的规格组:每个规格的 specName、label、是否必填及其允许的值(values[].label;一个…… |
exito_marketplace_get_orders | 通过 Éxito 站点(exito.com、carulla.com 等)收到的订单,包含订单号、渠道、日期、状态、总额、佣金…… |
exito_marketplace_get_bills | 卖家的结算单(账单):账单号、订单号、付款单、项目、付款日期、佣金、总额、IVA 和…… |
exito_marketplace_create_products | 创建商品(或修改现有商品:再次发送相同的 EAN;ModifyImage "1" 会替换图片),包含标题、HTML 描述…… |
exito_marketplace_load_products_and_offers | 在一次请求中同时发送商品及其报价:每个条目包含一个 Product(exito_marketplace_create_products 的字段)和一个…… |
exito_marketplace_upsert_offers | 为 Éxito 已批准的 EAN 创建或更新报价(价格、促销价、库存、运输和配送承诺),适用于所有 Éxito 站点…… |
exito_marketplace_update_offer_price_stock | 修改单个现有报价(一个 EAN)的价格和/或库存。Éxito 每次更新都需要 EAN、Stock 和 Price:若只修改价格…… |
exito_marketplace_set_order_tracking | 将订单中的商品标记为已发货,并附承运商和运单号(适用于标准配送订单) |
exito_marketplace_upload_order_invoice | 以 base64 编码的 PDF 或 ZIP 形式将订单发票附加到订单 |
示例提示词
- "Éxito 拒绝了我的哪些商品?原因是什么?"
- "显示本周分配给我、仍需发货的订单。"
- "EAN 7701234567890 在 exito.com 上的价格和库存是多少?"
- "将 EAN 7701234567890 的库存设为 25 件,价格保持不变。"
- "汇总我 10 月份结算单中的佣金总额。"
后续步骤
这份指南对你有帮助吗?