有品开放接口 套装商品升级指南

为优化购物体验，本次升级增加套装商品（套装pid）。订单明细会按照套装商品映射规则拆分成对应的单品商品（单品pid）。

详细说明：

以下套装商品（每物筋膜枪+充电底座套装(pid: 232556) https://www.xiaomiyoupin.com/detail?gid=129725 ）见下图：

该套装商品（pid: 232556）对应的两个单品（单品pid）分别为 pid:220133 和 pid: 220134：

当用户下单购买 1件 套装商品：每物筋膜枪+充电底座套装（pid:232556）时，升级前订单中记录为：

在升级后，订单会把套装商品切分成与其对应的单品商品，订单记录如下：

接口调整

A. 商品列表接口

增加 套装商品标识 "isPackage"：1-套装,0-非套装

升级前：

{
    "productList": [{
        "gid": 129725,                
        "pid": 232556,
        "pidName": "每物筋膜枪+充电底座套装",
        "skuList": [
            {
                "skuName": "每物智能双模筋膜枪 1件/盒",
                "skuPrice": 0,
                "code69": "",
                "skuId": 3114120,
                "skuCount": 1
            },
            {
                "skuName": "每物智能双模筋膜枪 充电底座 1件/盒",
                "skuPrice": 0,
                "code69": "",
                "skuId": 3114121,
                "skuCount": 1
            }
        ]
    }]
}

升级后：

{
    "productList": [
        {
            "gid": 129725,
            "pid": 232556,
            "pidName": "每物筋膜枪+充电底座套装",
            "isPackage": 1, // 是否为套装商品标识：1-套装,0-非套装
            "skuList": [
                {
                    "skuName": "每物智能双模筋膜枪 1件/盒",
                    "skuPrice": 0,
                    "code69": "",
                    "skuId": 3114120,
                    "skuCount": 1
                },
                {
                    "skuName": "每物智能双模筋膜枪 充电底座 1件/盒",
                    "skuPrice": 0,
                    "code69": "",
                    "skuId": 3114121,
                    "skuCount": 1
                }
            ]
        },
        {
            "gid": 129725,
            "pid": 220133,
            "pidName": "每物智能双模筋膜枪 深空灰",
            "isPackage": 0, // 是否为套装商品标识：1-套装,0-非套装
            "skuList": [
                {
                    "skuName": "每物智能双模筋膜枪 1件/盒",
                    "skuPrice": 0,
                    "code69": "",
                    "skuId": 3114120,
                    "skuCount": 1
                }
            ]
        },
        {
            "gid": 129725,
            "pid": 220134,
            "pidName": "每物筋膜枪充电底座 深空灰",
            "isPackage": 0, // 是否为套装商品标识：1-套装,0-非套装
            "skuList": [
                {
                    "skuName": "每物智能双模筋膜枪 充电底座 1件/盒",
                    "skuPrice": 0,
                    "code69": "",
                    "skuId": 3114121,
                    "skuCount": 1
                }
            ]
        }
    ]
}

B. 订单列表接口

拆分套装商品，并增加套装商品信息

• packagePid: 套装pid
• packageCount: 套装购买数量
• packageName: 套装名称

升级前：

{
    "productList": [
        {
            "gid": 129725,
            "pid": 232556,
            "name": "每物筋膜枪+充电底座套装",
            "count": 1,
            "status": 4,
            "skuInfoList": [
                {
                    "skuId": 3114120,
                    "count": 1
                },
                {
                    "skuId": 3114121,
                    "count": 1
                }
            ]
        }
    ]
}

升级后：

{
    "productList": [
        {
            "gid": 129725,
            "pid": 220133,
            "packagePid": 232556, // 套装pid
            "packageCount": 1,  // 套装购买数量
            "packageName": "每物筋膜枪+充电底座套装",  // 套装名称
            "name": "每物智能双模筋膜枪 深空灰",
            "count": 1,
            "status": 4,
            "skuInfoList": [
                {
                    "skuId": 3114120,
                    "count": 1
                }
            ]
        },
        {
            "gid": 129725,
            "pid": 220134,
            "packagePid": 232556, // 套装pid
            "packageCount": 1,  // 套装购买数量
            "packageName": "每物筋膜枪+充电底座套装",  // 套装名称
            "name": "每物筋膜枪充电底座 深空灰",
            "count": 1,
            "status": 4,
            "skuInfoList": [
                {
                    "skuId": 3114121,
                    "count": 1
                }
            ]
        }
    ]
}

C. 发货接口

仅支持单品商品维度发货，不支持套装商品发货

D. 订单推送接口

同订单商品列表接口

我不是技术，我需要做什么

如果贵司使用的是自研ERP，请联系贵司技术进行开发。如果是三方ERP，请联系ERP供应商升级。

技术支持

邮件：

切换对接问题请邮件 youpin-openapi@xiaomi.com

邮件主题： 有品开放接口v2切换技术支持

邮件内容包含：

1. 有品商家id，使用 商家主账号 登录 有品商家工作台 查看
2. 商家公司名称
3. 具体问题描述

微信群（二维码如失效，请邮件沟通）：