API开放平台

TIP

# 商品类型2.0接口

# 新增商品类型

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/pd/v2/addProductType/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "pd_type_id": "PT0001",
    "pd_type_name": "商品类型1",
    "pd_type_code": "商品类型编码1",
    "pd_type_parent_id": "PT0002",
    "prd_type_exts":[
      {
        "prd_type_ext_key":"自定义文本框",
        "prd_type_ext_value":"测试用"
      },{
        "prd_type_ext_key":"自定义",
        "prd_type_ext_value":"测试用"
      }]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
pd_type_id VARCHAR(32) 是 商品类型唯一标识，来源第三方系统的唯一ID
pd_type_name VARCHAR(100) 是 商品类型名称
pd_type_code VARCHAR(100) 否 商品类型编码
pd_type_parent_id VARCHAR(32) 是 有上级的必须传,没有上级的可以不传，商品类型上级的id
seq VARCHAR(32) 否 排序号

响应示例：

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

异常示例：

{
    "msg_id": "PRD00001",
    "return_code": 100606,
    "return_msg": "商品类型名称或者唯一标示已经存在"
}

参数说明：

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

# 修改商品类型

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/pd/v2/modifyProductType/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    
    "pd_type_id": "PT0001",
    "pd_type_name": "商品类型1",
    "pd_type_code": "商品类型编码1",
    "pd_type_parent_id": "PT0002",
    "prd_type_exts":[
      {
        "prd_type_ext_key":"自定义文本框",
        "prd_type_ext_value":"测试用"
      },{
        "prd_type_ext_key":"自定义",
        "prd_type_ext_value":"测试用"
      }]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
pd_type_id VARCHAR(32) 是 商品类型唯一标识，来源第三方系统的唯一ID
pd_type_name VARCHAR(100) 是 商品类型名称
pd_type_code VARCHAR(100) 否 商品类型编码
pd_type_parent_id VARCHAR(32) 是 有上级的必须传,没有上级的可以不传，商品类型上级的id
seq VARCHAR(32) 否 排序号

响应示例：

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

异常示例：

{
    "msg_id": "PRD00001",
    "return_code": 100606,
    "return_msg": "商品类型名称或者唯一标示已经存在"
}

参数说明：

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

# 查询商品类型

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/pd/v2/queryProductType/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "type_name": "方便面",
      "sorts": [
        {
          "field_key": "create_time",
          "type": "desc"
        }
      ],
  "page": "1",
  "rows": "100",
  "type_id": "111",
  "type_name": "111",
  "after_create_time": "2025-09-01 17:57:00",
  "before_create_time": "2025-09-01 17:57:00",
  "after_modify_time": "2025-09-01 17:57:00",
  "before_modify_time": "2025-09-01 17:57:00"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
type_name VARCHAR(32) 否 类型名称
type_id VARCHAR(32) 否 商品类型唯一标识，来源第三方系统的唯一ID
after_create_time VARCHAR(32) 否 创建时间之后。格式：yyyy-MM-dd HH:mm:ss
before_create_time VARCHAR(32) 否 创建时间之前。格式：yyyy-MM-dd HH:mm:ss
after_modify_time VARCHAR(32) 否 修改时间之后。格式：yyyy-MM-dd HH:mm:ss
before_modify_time VARCHAR(32) 否 修改时间之前。格式：yyyy-MM-dd HH:mm:ss

响应示例：

{
"msg_id":"ORG00001",
"return_code":0,
"response_data":"<<DATA>>"
}

数据DATA示例:

[
  {
	"prd_waiqin365_id":"7628813591021350683",
	"status":"1",
	"parent_id":"7619998326460522079",
	"name":"方便面",
	"descrip":"",
	"sqeu":"1",
	"line_id":"",
	"prd_id":"",
	"creator_id":"5280123597799111087",
	"create_name":"hf老板aaa",
	"modifier_time":"2018-03-15 19:06:06",
	"modifyier_id":"5918189314149391033",
    "apaas_cuz_data": {
      "field_QxaDA__c": {
        "format": "YYYY-MM-DD",
        "value": "2025-03-13"
      },
      "field_T08db__c": "222",
      "field_dWPHL__c": [
        {
          "code": "91CIFbjO",
          "label": "选项1",
          "status": "1"
        }
      ]
    }
  }
]

异常示例：

{
    "msg_id": "PRD00001",
    "return_code": 1,
    "return_msg": "查询日期格式不合法！"
}

参数说明：

参数 类型 必填 说明
prd_id VARCHAR(100) 否 商品类型唯一标识，来源第三方系统的唯一ID
status VARCHAR(32) 是 删除标志。1：正常，0：删除
prd_waiqin365_id VARCHAR(32) 是 勤策的商品类型id
parent_id VARCHAR(32) 否 勤策的商品父类型id
code VARCHAR (100) 否 商品类型编码
name VARCHAR (100) 否 商品类型名称
descrip VARCHAR (100) 否 说明
sqeu VARCHAR (32) 否 排序
line_id VARCHAR (32) 否 产品线id
creator_id VARCHAR(32) 否 创建人ID
create_time VARCHAR(32) 否 创建时间。格式：yyyy-MM-dd HH:mm:ss
modifyier_id VARCHAR(32) 否 修改人ID
modifier_time VARCHAR(32) 否 修改时间。格式：yyyy-MM-dd HH:mm:ss
parent_prd_id VARCHAR(32) 否 第三方系统的商品父类型id

← 商品信息接口 →