# 新增商品

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

{
    "prd_id": "PRE009",
    "prd_name": "优酸乳",
    "prd_code": "0YYSR09",
    "prd_short_code": "YSR",
    "prd_barcode": "201603101119",
    "class_name": "乳品,常温奶",
    "prd_spec": "100ml",
    "prd_brand": "卫岗",
    "prd_valid_period": "60",
    "prd_remarks": "特供商品",
    "prd_sequ": 1200,
    "with_tag_new": "true",
    "with_tag_hot": "false",
    "with_tag_gift": "false",
    "with_tag_sale": "true",
    "prd_suggest_price": 32.5,
    "prd_cost_price": 15,
    "prd_price": 32.6,
    "prd_sale_status": "1",
    "prd_status": "1",
    "short_name": "",
    "teu_coefficient": "",
    "same_price_code": "",
    "sale_unit_name":"袋",
    "units":
    [
        {
            "name":"瓶",
            "is_base":"1",
            "ratio":1.00000000,
            "bar_code":"20170000000",
            "prd_weight":"500",
            "weight_unit":"g"
            
        },
        {
            "name":"袋",
            "is_base":"0",
            "ratio":12.00000000,
            "bar_code":"20141212121",
            "prd_weight":"200",
            "weight_unit":"g"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
prd_id VARCHAR(32) 商品唯一标识,来源第三方系统的唯一ID
prd_code VARCHAR(100) 商品编码,不允许重复
prd_short_code VARCHAR(32) 助记码
prd_name VARCHAR(100) 商品名称,不允许重复
class_name VARCHAR(100) 商品类型,多层级时使用“,”分割,如:”商品大类,商品中类,商品小类”
prd_spec VARCHAR (4000) 商品规格
prd_brand VARCHAR (100) 品牌
prd_valid_period INT 保质期天数
prd_sequ INT 排序号,默认值1000
prd_remarks VARCHAR(4000) 备注
with_tag_new VARCHAR(32) 是否新品,true/false。默认值为false
with_tag_hot VARCHAR(32) 是否重点,true/false。默认值为false
with_tag_gift VARCHAR(32) 是否赠品,true/false。默认值为false
with_tag_sale VARCHAR(32) 是否促销,true/false。默认值为false
store_sale_status VARCHAR(32) 是否商城上架,true/false。
prd_suggest_price NUMERIC(20,2) 建议零售价,单位:元
prd_price NUMERIC(20,2) 单价,单位:元
prd_sale_status CHAR(1) 销售状态。0:停售,1:在售
prd_status CHAR(1) 商品状态。1:正常,0:失效
short_name VARCHAR(255) 商品简称
teu_coefficient NUMERIC(20,8) 标箱系数
same_price_code VARCHAR(255) 同价码
use_stock VARCHAR(32) 启用库存管理。1:启用,0:不启用。不传默认启用
use_batch VARCHAR(32) 启用批次管理。1:启用,0:不启用。不传默认不启用
use_valid_period VARCHAR(32) 启用保质期管理。1:启用,0:不启用。不传默认不启用
use_serial_number VARCHAR(32) 启用序列号管理。1:启用,0:不启用。不传默认不启用
sale_unit_name VARCHAR(100) 销售常用单位。不传默认为基本单位(units列表中is_base=1的单位)。该值须与units列表中name值对应。例如:需要将商品的销售常用单位设"瓶",如果“瓶”不是基本单位,则入参须设置:sale_unit_name="瓶",units[{name="瓶",is_base="0"}]
purchase_unit_name VARCHAR(100) 采购常用单位
units List 注:2021年后接入OPENAPI接口的企业在新增商品时,units列表必传。当is_base=1时,该json对象的值是商品基本单位的相关信息。每个商品新增并选用自己的单位,各商品的单位不共用
units.name VARCHAR(32) 单位名称
units.is_base VARCHAR(32) 是否基本单位。0:否,1:是
units.ratio VARCHAR(32) 换算比,基本单位的换算比固定为1
units.bar_code VARCHAR(32) 条形码
units.length VARCHAR(32) 长必须为数字,最多可以精确到小数点后三位
units.width VARCHAR(32) 宽必须为数字,最多可以精确到小数点后三位
units.height VARCHAR(32) 高必须为数字,最多可以精确到小数点后三位
units.weight VARCHAR(32) 重量小数位不能大于4位
units.weight_unit VARCHAR(32) 重量单位:克/千克/吨
prd_exts List 自定义字段列表
prd_exts.prd_ext_key VARCHAR(4000) 自定义字段key
prd_exts.prd_ext_value VARCHAR(4000) 自定义字段value,多个值用“,”分隔

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "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/modifyProduct/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "prd_id": "PRD001",
    "prd_name": "优酸乳01",
    "prd_code": "0YYSR001",
    "prd_short_code": "YSR011",
    "prd_barcode": "201603101116",
    "class_name": "乳品,常温奶",
    "prd_spec": "120ml",
    "prd_brand": "光明",
    "prd_valid_period": "60",
    "prd_remarks": "特供品",
    "prd_sequ": 1201,
    "with_tag_new": "false",
    "with_tag_hot": "true",
    "with_tag_gift": "true",
    "with_tag_sale": "false",
    "prd_suggest_price": 12.5,
    "prd_cost_price": 11,
    "prd_price": 12.6,
    "prd_sale_status": "0",
    "prd_status": "1",
    "short_name": "",
    "teu_coefficient": "",
    "same_price_code": "",
    "sale_unit_name":"袋",
    "units":
    [
        {
            "name":"瓶",
            "is_base":"1",
            "ratio":1.00000000,
            "bar_code":"20170000000",
            "prd_weight":"500",
            "weight_unit":"g"
            
        },
        {
            "name":"袋",
            "is_base":"0",
            "ratio":12.00000000,
            "bar_code":"20141212121",
            "prd_weight":"200",
            "weight_unit":"g"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
prd_id VARCHAR(32) 来源第三方系统的商品唯一标识,prd_id,id如果同时存在优先取id
id VARCHAR(32) 外勤商品唯一id
prd_code VARCHAR(100) 商品编码
prd_short_code VARCHAR(32) 助记码
prd_name VARCHAR(100) 商品名称
class_name VARCHAR(100) 商品类型,多层级时使用“,”分割,如:”商品大类,商品中类,商品小类”
prd_spec VARCHAR(4000) 商品规格
prd_brand VARCHAR (100) 品牌
prd_valid_period INT 保质期天数
prd_sequ INT 排序号
prd_remarks VARCHAR(4000) 备注
with_tag_new VARCHAR(32) 是否新品,true/false。默认值为false
with_tag_hot VARCHAR(32) 是否重点,true/false。默认值为false
with_tag_gift CHAR(1) 是否赠品,true/false。默认值为false
with_tag_sale VARCHAR(32) 是否促销,true/false。默认值为false
store_sale_status VARCHAR(32) 是否商城上架,true/false。
prd_suggest_price NUMERIC(20,2) 建议零售价,单位:元
prd_price NUMERIC(20,2) 单价,单位:元
prd_sale_status CHAR(1) 销售状态。0:停售,1:在售
prd_status CHAR(1) 商品状态。1:正常,0:删除
short_name VARCHAR(255) 商品简称
teu_coefficient NUMERIC(20,8) 标箱系数,只能是数字
same_price_code VARCHAR(255) 同价码
sale_unit_name VARCHAR(100) 销售常用单位。该值须与units列表中的name值对应。例如:需要将商品的销售常用单位修改为“瓶”,如果“瓶”不是基本单位,则入参须设置:sale_unit_name="瓶",units[{name="瓶",is_base="0"}]
purchase_unit_name VARCHAR(100) 采购常用单位
prd_unit VARCHAR(100) 单位(该字段已废弃)
prd_pkg_unit VARCHAR(100) 大包装单位(该字段已废弃)
prd_pkg_num INT 大包装数量(该字段已废弃)
units List 列表
units.name VARCHAR(32) 单位名称
units.is_base VARCHAR(32) 是否基本单位。0:否,1:是。基本单位名称不能修改,不传默认是0
units.ratio VARCHAR(32) 换算比,基本单位的换算比固定为1
units.bar_code VARCHAR(32) 条形码
units.length VARCHAR(32) 长必须为数字,最多可以精确到小数点后三位
units.width VARCHAR(32) 宽必须为数字,最多可以精确到小数点后三位
units.height VARCHAR(32) 高必须为数字,最多可以精确到小数点后三位
units.weight VARCHAR(32) 重量小数位不能大于4位
units.weight_unit VARCHAR(32) 重量单位。克/千克/吨
prd_exts.prd_ext_key VARCHAR(4000) 自定义字段key
prd_exts.prd_ext_value VARCHAR(4000) 自定义字段value,多个值用","分隔

响应示例:

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

{
    "msg_id": "PRD00001",
    "return_code": 100605,
    "return_msg": "商品ID不存在!值为:空"
}
{
    "msg_id": "PRD00001",
    "return_code": 100602,
    "return_msg": "商品编码已经存在!值为:0YYSR001"
}

参数说明:

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

# 删除商品

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


{
    "prd_id": "PRD001"
}

说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
prd_id VARCHAR(32) 商品唯一标识

响应示例:

{
    "msg_id": "PRD00001",
    "return_code": 100605,
    "return_msg": "商品ID不存在!值为:空"
}

参数说明:

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

# 查询商品

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

{
    "prd_id": "0001A1100000000CUJWR"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页最大1000条
prd_id VARCHAR(32) 商品唯一标识,来源第三方系统的唯一ID
prd_code VARCHAR(100) 商品编码
after_create_time CHAR(15) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
before_create_time CHAR(15) 创建时间之前。格式:yyyy-MM-dd HH:mm:ss
after_modify_time CHAR(15) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
before_modify_time CHAR(15) 修改时间之前。格式:yyyy-MM-dd HH:mm:ss

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "prd_spec":"1*5[水蜜桃,高糖,500ML]",
        "class_name":"饮料",
        "prd_waiqin365_id":5746956808669247685,
        "prd_name":"20170728003name",
        "with_tag_gift":"赠品",
        "with_tag_sale":"促销",
        "with_tag_hot":"重点",
        "with_tag_ex1":"热卖",
        "with_tag_new":"新品",
        "prd_short_code":"thinkabout",
        "prd_unit":"袋",
        "prd_barcode":"20170000000",
        "prd_code":"20170728003",
        "prd_sale_status":"在售",
        "source_code":"5746956808669247685",
        "prd_price":22.00000000,
        "prd_name_py":"20170728003name 20170728003name",
        "prd_suggest_price":999.00000000,
        "create_time":"2017-07-28 08:57:35",
        "prd_brand":"javascriptyyy",
        "prd_valid_period":800,
        "prd_short_name":"",
        "prd_teu_coefficient":"",
        "prd_same_price_code":"",
        "creator_id":"5280123597799111087",
        "create_name":"hf老板aaa",
        "modifier_time":"2018-03-15 19:06:06",
        "modifyier_name":"jinhao1",
        "modifyier_id":"5918189314149391033",
        "prd_tax_rate": "13.12",
    "prd_units":[
    {
        "prd_is_base":"1",
        "prd_ratio":1.00000000,
        "prd_barcode":"20170000000",
        "prd_unit_name":"瓶",
        "prd_unit_waiqin365_id":4889802966711221998,
        "prd_waiqin365_id ":5746956808669247685,
        "prd_weight":"500",
        "prd_weight_unit":"g"
    },
    {
        "prd_is_base":"0",
        "prd_ratio":12.00000000,
        "prd_barcode":"20141212121",
        "prd_unit_name":"袋",
        "prd_unit_waiqin365_id":5538415640268400439,
        "prd_waiqin365_id ":5746956808669247685,
        "prd_weight":"200",
        "prd_weight_unit":"g"
    }],
    "prd_exts":[
        {"prd_ext_value":"怎么啥都没有啊","prd_ext_key":"商品质量输入"},
        {"prd_ext_value":"1000","prd_ext_key":"期望价格"},
        {"prd_ext_value":"好吃","prd_ext_key":"单选"},
        {"prd_ext_value":"AAA,SSS,DDD,FFF","prd_ext_key":"多选"},
        {"prd_ext_value":"7688628547624343020","prd_ext_key":"商品单选框"}
        ]
    }
]

异常示例:

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

参数说明:

参数 类型 必填 说明
prd_id VARCHAR(100) 商品唯一标识,来源第三方系统的唯一ID
status VARCHAR(32) 删除标志。1:正常,0:删除
prd_waiqin365_id VARCHAR(32) 外勤商品id
prd_code VARCHAR(100) 商品编码
prd_short_code VARCHAR(200) 助记码
prd_barcode VARCHAR(32) 基本单位条形码
prd_name VARCHAR (100) 商品名称
class_id VARCHAR (100) 商品类型唯一ID
class_name VARCHAR (100) 商品类型
class_source_code VARCHAR (100) 第三方系统商品类型唯一标识
class_full_path VARCHAR (100) 商品类型全路径
prd_spec VARCHAR(4000) 商品规格
prd_brand VARCHAR(100) 品牌
prd_unit VARCHAR(100) 单位
prd_valid_period numeric(15) 保质期天数
prd_sequ numeric(20,2) 排序号
prd_remarks VARCHAR(4000) 备注
create_time VARCHAR(32) 创建时间。格式:yyyy-MM-dd HH:mm:ss
with_tag_new VARCHAR(32) "新品"
with_tag_hot VARCHAR(32) "重点"
with_tag_gift VARCHAR(32) "赠品"
with_tag_sale VARCHAR(32) "促销"
with_tag_ex1 VARCHAR(32) "热卖"
prd_suggest_price numeric(28,8) 建议零售价,单位:元
prd_cost_price numeric(28,8) 成本价,单位:元
prd_price numeric(28,8) 单价,单位:元
sale_status CHAR(32) 销售状态。0:停售,1:在售
prd_short_name varchar(4000) 商品简称
prd_teu_coefficient numeric(28,8) 商品标箱系数,只能是数字
prd_same_price_code VARCHAR(100) 商品同价码
creator_id VARCHAR(32) 创建人ID
create_name VARCHAR(32) 创建人姓名
modifyier_id VARCHAR(32) 修改人ID
modifyier_name VARCHAR(32) 修改人姓名
modifier_time VARCHAR(32) 修改时间。格式:yyyy-MM-dd HH:mm:ss
prd_tax_rate numeric(20,2) 销项税率
prd_exts List 自定义字段列表
prd_exts.prd_ext_key VARCHAR(4000) 自定义字段key
prd_exts.prd_ext_value VARCHAR(4000) 自定义字段value
prd_units List 单位列表
prd_units.prd_is_base VARCHAR(1) 是否基本单位。1:基本单位,0:辅助单位
prd_units.prd_ratio NUMERIC(28,8) 换算比,基本单位的换算比固定为1
prd_units.prd_barcode VARCHAR(100) 单位条码
prd_units.prd_unit_name VARCHAR(32) 单位名称
prd_units.prd_unit_waiqin365_id VARCHAR(32) 外勤单位id
prd_units.prd_weight VARCHAR(32) 商品单位中的重量,小数位不能大于4位
prd_units.prd_weight_unit VARCHAR(32) 商品单位中的重量单位名称
prd_report_unit_id VARCHAR(32) 销售常用单位ID
prd_purchase_unit_id VARCHAR(32) 采购常用单位ID
prd_report_unit_name VARCHAR(32) 销售常用单位名称
prd_purchase_unit_name VARCHAR(32) 采购常用单位名称