Mercado Libre 接口与数据合规

带货牛 ERP 正在准备通过 Mercado Libre 官方开放平台接入店铺数据。本页为 Mercado Libre 官方审核提供开发者接入、权限 scope 用途、功能与 API 能力对照、OAuth 授权步骤、撤销授权与数据删除的完整说明。本页内容描述规划中的接口架构与合规设计,具体权限范围与实现以平台最终审批与上线实施为准。

Global Selling 接入准备中,尚未开放生产服务

独立第三方声明

带货牛 ERP 为独立第三方软件,不是 Mercado Libre 官方产品,不代表 Mercado Libre 所有、运营、推荐或背书。除非获得明确书面授权,我们不暗示与 Mercado Libre 存在合作关系。连接时跳转 Mercado Libre 官方授权页面,不要求您向带货牛提供 Mercado Libre 登录密码。

开发者接入

带货牛 Mercado Libre 开发者接入说明

接入 Mercado Libre 开放平台需注册开发者、创建应用并完成 KYC。以下为带货牛的开发者接入规划与前置工作,供 Mercado Libre 官方审核核对;具体权限范围以平台最终审批结果为准。

开发者接入清单

由郑州优豚网络科技有限公司完成
  1. 注册跨境账号

    通过 Global Selling 官方注册流程建立账号,核对账号主体与跨境业务模式。

  2. 完成 KYC 验证

    先完成主体身份验证,再在 Global Selling 开发者中心创建应用。

  3. 创建应用(Application)

    按 Global Selling 官方创建应用流程完成账号 KYC,提交名称、简介与 Logo,并核验权限及通知配置。HTTPS 回调地址须与后台登记值完全一致;应用密钥仅保存在服务端受控配置中。创建应用不等于获得合作伙伴认证。

  4. 申请接口权限范围(Scope)

    按后台当前权限选项和业务用途申请最小权限;商品、订单和用户是资源类别,不直接代替后台权限名称。

  5. 应用素材规范

    应用提供 Logo(400×400 PNG、100KB 以下)、唯一应用名称、Short Name 与 150 字符内描述,与官网一致;回调地址(Redirect URI)以 https:// 开头并与后台登记值逐字符一致。

权限与数据

读取 / 写入 / 离线访问权限的用途

带货牛仅申请当前功能所需的最小权限(scope),并说明每种权限的用途。

权限用途对照

最小必要原则
权限类型(scope 示例)用途对应功能
读取(read)读取商品、订单、用户信息以展示与处理商品管理、订单处理、经营报表
写入(write)在您授权范围内更新商品或订单状态商品管理、订单处理
离线访问(offline_access)获取可刷新的 Refresh Token,维持授权期内的同步全部授权店铺的周期性同步
最小权限:读取、写入与离线访问的授权范围需与后台配置和返回值核对,不将资源名当作已获批权限。跨境账号及关联市场必须经过身份和归属校验后才允许同步。
功能与接口能力

带货牛功能如何对应 Mercado Libre API

下表说明各功能模块依赖 Mercado Libre 官方开放平台的哪些接口与权限(scope)。

功能 — 数据 — API 能力 对照表

权限(scope)需在应用中逐项说明业务用途
带货牛功能使用的 Mercado Libre 数据对应 API / 权限
店铺连接授权凭据、用户标识OAuth 2.0 授权码;PKCE 按应用配置启用并验证
商品管理商品、类目、图片、价格、库存字段、上架状态、变体items(产品制作 / 上架 / 编辑,read / write)
订单接入规划业务必需的订单标识、商品、数量与状态按 Global Selling 订单操作及权限核对;不包含消息或完整履约承诺
库存管理商品库存数量、变体items 库存字段 / 新版 Listings 库存
采购协同ERP 内部采购与补货数据非平台接口(带货牛内部能力)
经营报表规划已授权订单的汇总数据仅基于实际可用数据;Mercado Pago 不在本次接入范围内
团队权限店铺用户与权限配置非平台接口(带货牛内部能力)
用途说明:按实际业务操作在应用中说明权限用途,不将 items / orders / users 等资源名代替后台权限。商品发布与订单同步仍在开发,未作为当前可用功能开放。消息(messages)、问答(questions)、索赔(claims)及 Mercado Pago 不在首批接入范围内。
授权流程

店铺连接与 OAuth 授权步骤

建议使用具备管理员权限的账号完成授权,以确保所需权限可正常申请。

授权步骤

由您主动授权,不索取平台密码
  1. 准备开发者应用

    以与郑州优豚网络科技有限公司对应的主体账号创建 Mercado Libre 应用,完成 KYC 验证,应用名称使用"带货牛 ERP / Daihuoniu ERP",与官网一致。

  2. 在带货牛发起连接

    在带货牛"店铺管理"中点击"连接 Mercado Libre 店铺",系统跳转至 Mercado Libre 官方授权页面。

  3. 登录并授权

    使用具备管理员权限的 Mercado Libre 账号登录,确认授权范围后同意授权。

  4. 回调与令牌交换

    Mercado Libre 将用户重定向至带货牛登记的 HTTPS 回调地址;带货牛服务端用授权码换取 Access Token 与 Refresh Token(加密存储,不写入前端、URL 或普通日志)。

  5. 开始同步

    授权成功后,带货牛在授权范围内同步店铺数据,供对应功能使用。

安全设计目标:回调地址使用 HTTPS,与后台登记值逐字符一致;授权使用唯一 state 参数并校验,计划启用 PKCE(S256)防护授权码;Refresh Token 计划加密存储并采用原子轮换。通知接收、异步处理和幂等机制仍需按平台实际通知协议完成适配与验收。具体实现、时延和上线状态以正式部署与平台验收为准。
撤销与删除

取消授权、停止同步与数据删除

您可随时停止授权并要求删除数据。详细说明见 数据删除说明。

撤销授权

由您主动操作
  1. 在 Mercado Libre 开发者后台停用

    进入应用设置撤销带货牛的应用授权,即刻停止令牌可用。

  2. 或在带货牛后台解绑

    在带货牛"店铺管理"中移除对应店铺,断开本地连接;平台侧授权需另行撤销。

  3. 联系我们确认

    发送邮件至 3168836411@qq.com 或通过 联系我们 提交,确认授权已撤销并触发数据删除流程。

数据删除

遵循 Mercado Libre 开发者条款

用户停止使用后,带货牛停止数据访问;请求删除时,建立不可逆删除流程,覆盖中间副本与可访问存储。

  • 提交删除请求

    通过 数据删除说明 中的邮箱提出请求。

  • 身份验证

    提供企业管理权限与店铺归属的验证材料。

  • 安全删除与通知

    在约定周期内永久、安全删除相关数据,并通知完成。

说明:本页仅适用于 Mercado Libre Global Selling。删除范围、期限及保留例外按美客多适用政策和法律分别核验,不套用 Amazon 的期限。

需要补充审核材料或确认权限范围?

我们的团队可协助完成开发者注册、应用素材与 scope 用途说明的填写,并说明数据存储与删除机制。