API开放平台

TIP

# 产品组新增修改接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/product/group/v1/saveProductGroup/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "id": "6729740754530270632",
    "source_code": "PT0001",
    "code": "PT0002",
    "name": "PT0002",
    "is_enable": "1",
    "brands": [
      {
          "id": "",
          "name": ""
      }
    ],
    "types": [
        {
            "id": "",
            "name": ""
        }
    ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 产品组ID。产品组ID不为空时，校验产品组是否存在，存在时则修改
source_code VARCHAR(100) 否 外部系统ID。当产品组ID为空，外部系统ID存在时则修改，否则新增
name VARCHAR(200) 是 产品组名称
code VARCHAR(100) 是 产品组编码
is_enable VARCHAR(32) 否 启用停用状态：1:已启用、0:已停用
sales_org_code VARCHAR(100) 否 销售组织编码。销售组织编码、销售组织第三方唯一标识如果同时存在，优先级依次递减
sales_org_source_code VARCHAR(100) 否 销售组织第三方唯一标识。销售组织编码、销售组织第三方唯一标识如果同时存在，优先级依次递减
brands LIST 否 品牌数据。品牌数据跟商品类型数据不能都为空，也不支持同时存在
brands.id VARCHAR(32) 否 品牌ID。品牌ID与名称不能同时为空
brands.name VARCHAR(100) 否 品牌名称。品牌ID与名称不能同时为空
types LIST 否 商品类型数据。品牌数据跟商品类型数据不能都为空，也不支持同时存在
types.id VARCHAR(32) 否 类型ID。类型ID与名称不能同时为空
types.name VARCHAR(100) 否 类型名称。类型ID与名称不能同时为空

响应示例：

{
    "msg_id": "PRD00001",
    "return_code": 0
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 产品组查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/product/group/v1/queryProductGroupInfos/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "page_number": 1,
    "page_length": 1000,
    "status": "1",
    "name": "",
    "code": "",
    "after_create_date": "2017-05-01 00:00:00",
    "after_modify_date": "2017-05-31 00:00:00"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number INT 否 页码默认1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
is_enable VARCHAR(1) 否 启用停用状态：1:已启用、2:已停用
status VARCHAR(1) 否 删除状态：0：已删除，1：正常
id VARCHAR(32) 否 产品组ID
source_code VARCHAR(100) 否 外部系统ID
name VARCHAR(200) 否 产品组名称
code VARCHAR(100) 否 产品组编码
after_create_date TIMESTAMP 否 创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 否 修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd

响应示例：

{
    "msg_id": "PD00001",
    "return_code": 0
}

数据DATA示例:

[
    {
        "id": "",
        "code": "",
        "name": "",
        "status": 0,
        "is_enable": "",
        "source_code": "",
        "brands":[
            {
                "id": "",
                "name": ""
            }
        ],
        "types":[
            {
                "id": "",
                "name": ""
            }
        ]
    }
]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 是 产品组ID
code VARCHAR(100) 是 产品组编码
name VARCHAR(100) 是 产品组名称
status VARCHAR(1) 是 删除状态：0：已删除，1：正常
is_enable VARCHAR(32) 是 启用停用状态：1:已启用、2:已停用
source_code VARCHAR(32) 否 外部系统ID
sales_org_id VARCHAR(100) 否 销售组织id
sales_org_code VARCHAR(100) 否 销售组织编码
sales_org_name VARCHAR(100) 否 销售组织名称
sales_org_source_code VARCHAR(100) 否 销售组织第三方唯一标识
brands LIST 否 品牌数据。
brands.id VARCHAR(32) 否 品牌ID
brands.name VARCHAR(100) 否 品牌名称
types LIST 否 商品类型数据
types.id VARCHAR(32) 否 类型ID
types.name VARCHAR(100) 否 类型名称

# 产品组推送接口

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求示例：

{
    "id": "",
    "code": "",
    "name": "",
    "status": 0,
    "is_enable": "",
    "source_code": "",
    "brandList":[
        {
            "id": "",
            "name": ""
        }
    ],
    "typeList":[
        {
            "id": "",
            "name": ""
        }
    ]
}

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 是 产品组ID
code VARCHAR(100) 是 产品组编码
name VARCHAR(100) 是 产品组名称
status VARCHAR(1) 是 删除状态：0：已删除，1：正常
is_enable VARCHAR(32) 是 启用停用状态：1:已启用、2:已停用
source_code VARCHAR(32) 否 外部系统ID
sales_org_id VARCHAR(100) 否 销售组织id
sales_org_code VARCHAR(100) 否 销售组织编码
sales_org_name VARCHAR(100) 否 销售组织名称
sales_org_source_code VARCHAR(100) 否 销售组织第三方唯一标识
brandList LIST 否 品牌数据。
brandList.id VARCHAR(32) 否 品牌ID
brandList.name VARCHAR(100) 否 品牌名称
typeList LIST 否 商品类型数据
typeList.id VARCHAR(32) 否 类型ID
typeList.name VARCHAR(100) 否 类型名称

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

← 产品经销权接口 →