API开放平台

TIP

# 新增商品类型

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

{
    "pd_type_id": "PT0001",
    "pd_type_name": "商品类型1",
    "pd_type_parent_id": "PT0002"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
pd_type_id VARCHAR(32) 是 商品唯一标识，来源第三方系统的唯一ID
pd_type_name 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": "PRD00001",
    "return_code": 100607,
    "return_msg": "商品类型父节点不存在"
}

{
    "msg_id": "PRD00001",
    "return_code": 1,
    "return_msg": "其他错误"
}

参数说明：

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

# 修改商品类型

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

{
    "pd_type_id": "PT0001",
    "pd_type_name": "商品类型1",
    "pd_type|_parent_id": "PT0002"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

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

响应示例：

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

异常示例：

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

{
    "msg_id": "PRD00001",
    "return_code": 100607,
    "return_msg": "商品类型父节点不存在"
}

{
    "msg_id": "PRD00001",
    "return_code": 1,
    "return_msg": "其他错误"
}

参数说明：

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

# 删除商品类型

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

{
    "pd_type_id": "PD0001"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
pd_type_id VARCHAR(32) 是 商品类型唯一标识(第三方id)

响应示例：

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

异常示例：

{
    "msg_id": "PRD00001",
    "return_code": 100608,
    "return_msg": "商品类型ID不存在！值为：空"
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码。0：成功，1：失败
return_msg VARCHAR(100) 是 响应说明

# 查询商品类型

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

{
    "type_name": "方便面"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
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"
  }
]

异常示例：

{
    "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
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

← 商品信息接口 →