# 新增商品类型

请求方式: 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) 勤策(原外勤365)的商品类型id
parent_id VARCHAR(32) 勤策(原外勤365)的商品父类型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