张伟杰
shopify上传图片文件流程优化
2025-06-25 上线发布计划
2025-07-02 上线发布计划
2025-07-09 上线发布计划
2025-07-21 ozon 广告管理新版接口调研分析
2025-07-23 上线计划
ozon & 美客多广告 工单调研
shopify 刊登流程优化
2025-07-30 上线计划
2025-08-06 上线发布计划
ebay 代码review
2025-08-13 上线发布计划
ebay 服务cpu 持续不减
2025-08-19 代码review
2025-08-20 上线计划
2025-08-27 上线计划
沃尔玛处理中
2025-09-03 上线计划
美客多up 模式刊登
2025-09-10 上线计划
2025-09-17 上线计划
2025-09-24 上线计划
2025-10-15 上线计划
2025-10-22 上线计划
2025-10-29 上线计划
2025-11-05 上线计划
2025-11-12 上线计划
美客多本地刷新es
ebay cpu 持续被拉高
2025-11-26 上线计划
2025-11-27 上线计划
tiktok 在线活动分站点拉取技术方案
2025-12-03 上线计划
2025-12-04 上线计划
2025-12-10 上线计划
2025-12-17 上线计划
2025-12-24 上线计划
target 平台商品刊登设计
美客多全球刊登支持up 模式调研
美客多全球up 模式刊登技术方案整理
2026-01-14 上线计划
2025-01-16 临时上线计划
2025-01-21 上线计划
2026-01-22 上线计划
2026-01-28 上线计划
2026-02-02 上线计划
2026-02-04 上线计划
2026-02-10 上线计划
2026-03-04 上线计划
2026-03-10 上线计划
2026-03-18 上线计划
2026-03-27 临时上线计划
2026-04-01 上线计划
2026-04-08 上线计划
2026-04-09 上线计划
2026-04-10 临时上线计划
本文档使用 MrDoc 发布
-
+
首页
美客多全球刊登支持up 模式调研
#### 1. 核心端点 (Endpoint) - https://api.mercadolibre.com/global/user-products - 带有 /global/ 前缀的端点是 UP 模式的专属标志。与之相对的是旧版的站点级(Site-level)刊登接口(如 /items)。 #### 2. 关键参数分析 - sites_to_sell: 这是 UP 模式最显著的特征。它允许你在一次请求中指定多个目标站点(如示例中的 MCO 哥伦比亚、MLC 智利、MLB 巴西)。 - family_name: 在 UP 模式中,系统会根据这个字段创建一个“产品族”。这在旧版模式中是不存在的,旧版通常直接由 title 驱动。 - logistic_type": "remote": 这代表了全球售的跨境物流模式(通常指从中国或其他境外仓库发货,即官方的“远程”物流)。 - category_id": "CBT416197": 以 CBT 开头的类目 ID 是全球售专用类目,确保产品能够进入跨境贸易流程。 - **上传刊登描述 & 发布到各个站点接口合并到统一的刊登接口中**- - 刊登商品不存在变体,类似于本土模式数据平铺 | 特性 | UP 模式 | 传统模式 (Legacy) | | --- | --- | --- | | 操作逻辑 |以产品为中心。发布一个 Global Product,映射到多个 Site。 | 以站点为中心。每个站点需要单独调用一次接口发布 Item。| | 库存管理 |多个站点可以共享同一个 available_quantity | 每个 Item 的库存是独立的,容易产生超卖或库存堆积。 | | API 端点 | /global/user-products |/items | | 核心字段 | item_id|item_id | | 核心字段 | parent_user_product_id|无 | | 核心字段 | siteless_user_product_id(修改商品属性均根据该字段)|无 | | 核心字段 | siteless_family_id(美客多全球up 模式刊登标识)|无 | | 核心字段 | site_items.item_id(美客多全球up 模式具体站点下的itemId)|site_items.item_id | | 核心字段 | site_items.user_product_id(美客多全球up 模式具体站点下的up_product_id,用于同步单个商品使用)|无 | #### 全球up 模式刊登接口 #### 请求入参 ```json curl -X POST 'https://api.mercadolibre.com/global/user-products' \ --header 'Authorization: Bearer APP_USR-xxxxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ --data '{ "sites_to_sell": [ { "site_id": "MCO", "logistic_type": "remote", "user_id": 1305628788 }, { "site_id": "MLC", "logistic_type": "remote", "user_id": 1305628788 }, { "site_id": "MLB", "logistic_type": "remote", "user_id": 1305628788 } ], "family_name": "Red T-shirt M logo", "title": "T-shirt M logo", "category_id": "CBT416197", "price": 25, "available_quantity": 100, "description": { "plain_text": "Sample item for E2E flow in MLM." }, "pictures": [ { "id": "655219-CBT82943741035_032025" } ], "attributes": [ { "id": "ITEM_CONDITION", "values": [ { "id": "2230284", "name": "New" } ] }, { "id": "BRAND", "value_name": "FlowBrand" }, { "id": "MODEL", "value_name": "FlowModel" }, { "id": "PACKAGE_HEIGHT", "value_name": "10 cm" }, { "id": "PACKAGE_LENGTH", "value_name": "20 cm" }, { "id": "PACKAGE_WIDTH", "value_name": "15 cm" }, { "id": "PACKAGE_WEIGHT", "value_name": "500 g" } ], "sale_terms": [ { "id": "WARRANTY_TYPE", "value_id": "6150835", "value_name": "No warranty" } ] }' ``` 返回结果 ```json { "item_id": "CBT2826958659", "seller_id": 1305628788, "site_id": "CBT", "parent_user_product_id": "CBTU3687816070", "siteless_user_product_id": "U3687816070", "siteless_family_id": 4919667263731854, "site_items": [ { "item_id": "MCO3419064200", "seller_id": 1305630918, "site_id": "MCO", "user_product_id": "MCOU3687816070", "logistic_type": "remote" }, { "item_id": "MLB6068255422", "seller_id": 1305627900, "site_id": "MLB", "user_product_id": "MLBU3687816070", "logistic_type": "remote" }, { "item_id": "MLC3437222586", "seller_id": 1305631715, "site_id": "MLC", "user_product_id": "MLCU3687816070", "logistic_type": "remote" } ] } ``` #### 全球商品添加到站点 请求入参 https://api.mercadolibre.com/global/user-products/{siteless_user_product_id} ```java curl -X POST 'https://api.mercadolibre.com/global/user-products/U3687816070' \ --header 'Authorization: Bearer APP_USR-xxxxxxxxxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ --data '{ "sites_to_sell": [ { "site_id": "MLM", "logistic_type": "remote", "listing_type_id": "gold_pro", "price": 200 } ] }' ``` 返回参数 ```java { "item_id": "CBT2827162121", "seller_id": 1305628788, "site_id": "CBT", "parent_user_product_id": "CBTU3689227954", "siteless_user_product_id": "U3689227954", "site_items": [ { "item_id": "MLM4537463738", "seller_id": 1305634202, "site_id": "MLM", "user_product_id": "MLMU3689227954", "logistic_type": "remote" } ] } ``` #### 修改价格 请求入参(/user-products/{siteless_user_product_id}) ```json curl -X PUT -H 'https://api.mercadolibre.com/global/user-products/U3687816074' \ --header 'Authorization: Bearer APP_USR-xxxxxxxxxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ --data '{ "listing_sites": [ { "listing_id": "MLM4529604428", "price": 55.50 } ] }' ``` 返回参数 ```json { "id": "U3685216136", "errors": null, "listing_sites": [ { "id": "MLM4529604428", "success": true, "errors": null } ] } ``` #### 新增/修改属性 请求入参(/user-products/{siteless_user_product_id}) ```json curl -X PUT 'https://api.mercadolibre.com/global/user-products/{siteless_user_product_id}' \ --header 'Authorization: Bearer $TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "attributes": [ { "id": "PACKAGE_LENGTH", "values": [ { "name": "25 cm" } ] }, { "id": "PACKAGE_HEIGHT", "values": [ { "name": "12 cm" } ] }, { "id": "PACKAGE_WEIGHT", "values": [ { "name": "550 g" } ] }, { "id": "PACKAGE_WIDTH", "values": [ { "name": "18 cm" } ] } ] }' ``` 返回参数 ```json { "id": "U3687816070", "success": true, "errors": null } ``` #### 修改商品图片 请求入参:https://api.mercadolibre.com/user-products/{siteless_user_product_id} ```json { "pictures": [ { "id": "790745-CBT77271594694_072024" } ] } ``` 返回参数 ```json { "id": "U3685216136", "success": true, "errors": null } ``` #### 同步店铺商品(复用) 请求入参: /users/$SELLER_ID/items/search ```json curl -X GET 'https://api.mercadolibre.com/global/users/45145154/items/search' \ --header 'Authorization: Bearer APP_USR-xxxxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ ``` #### 同步单个商品(复用) 请求入参:/users/$SELLER_ID/items/search?user_product_id=$USER_PRODUCT_ID ```json curl -X GET 'https://api.mercadolibre.com/global/users/45145154/items/search?user_product_id=U3687816070 \ --header 'Authorization: Bearer APP_USR-xxxxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ ``` #### 美客多全球刊登之前都是php 直调香港中台,此次美客多全球up 模式广州部分数据边界在php 还是java?
zhangweijie
2026年1月12日 14:44
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码