美客多全球刊登支持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?