API开放平台

TIP

查询价格方案接口
新增修改价格方案接口
删除价格方案接口
启用停用价格方案接口

# 查询价格方案接口

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

{
	"page_number":1,
	"page_length":1000,
	"start_create_date":"2018-08-11 00:00:00",
	"end_create_date":"2018-08-13 00:00:00",
	"start_modify_date":"2018-08-11 00:00:00",
	"end_modify_date":"2018-08-13 00:00:00",
    "strategy_type":"1"
}

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

参数说明：

参数	类型	必填	说明
page_number	INT	是	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
start_create_date	TIMESTAMP	否	创建时间开始。格式：yyyy-MM-dd HH:mm:ss
end_create_date	TIMESTAMP	否	创建时间结束。格式：yyyy-MM-dd HH:mm:ss
start_modify_date	TIMESTAMP	否	修改时间开始。格式：yyyy-MM-dd HH:mm:ss
end_modify_date	TIMESTAMP	否	修改时间结束。格式：yyyy-MM-dd HH:mm:ss
strategy_type	VARCHAR(2)	否	价格方案类型编码。内置价格方案类型：1：商品售价，2：商品牌价。默认商品售价

响应示例：

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

数据DATA示例:

[
    {
        "basPdPriceStrategyCusFields":
        [
             {
                "create_time":"2018-08-21 08:33:12",
                "creator_id":"4993053750015187044",
                "cus_field_id":"4979556103081514064",
                "field_code":"dept_id",
                "field_name":"部门",
                "id":"",
                "modify_time":"",
                "modifyier_id":"",
                "selected_item":"5413971904313689661,5954366674468213302",
                "selected_item_text":"12qqq,11qqq",
                "status":"1",
                "strategy_id":"",
                "table_name":""
             }
        ],
        "basPdPriceStrategyCuss":[
          
         ],
        "basPdPriceStrategyProducts":
        [
             {
                   "base_unit":"5815325918493502423",
                   "create_time":"2018-08-21 08:33:12",
                   "creator_id":"4993053750015187044",
                   "id":"",
                   "input_unit":"7658328476828204462",
                   "max_base_unit_num":"0.00000000",
                   "max_num":"0.00000000",
                   "min_base_unit_num":"0.00000000",
                   "min_num":"0.00000000",
                   "modify_time":"",
                   "modifyier_id":"",
                   "pd_code":"10004",
                   "pd_id":"8886153687546478293",
                   "pd_name":"冰绿茶",
                   "price_down":"",
                   "price_strategy_product_id":"9002288385045669146",
                   "price_up":"",
                   "sale_price":"54.00000000",
                   "sequ":"",
                   "status":"1",
                   "strategy_id":"",
                   "exts": [
                     {
                       "ext_key": "级别",
                       "ext_value": "四星"
                     },
                     {
                       "ext_key": "主营商品",
                       "ext_value": "食品,电器,日化用品"
                     }
                   ]
              }
         ],
         "basPdPriceStrategySameCodes":
         [

         ],
         "create_time":"2018-08-21 08:33:12",
         "creator_id":"4993053750015187044",
         "end_time":"2020-08-15 00:00:00",
         "id":"",
         "is_enable":"1",
         "modify_time":"",
         "modifyier_id":"",
         "price_strategy_id":"5248497830880571426",
         "prod_num":"5",
         "product_type":"1",
         "start_time":"2018-08-21 00:00:00",
         "status":"1",
         "title":"ssz测试",
         "trade_range":"1",
         "trade_type":"2",
         "strategy_type":"1"
    }
]

参数说明：

参数	类型	必填	说明
price_strategy_id	VARCHAR(32)	是	规则id
status	VARCHAR(1)	是	0：已删除，1：正常
creator_id	VARCHAR(32)	是	创建人
create_time	TIMESTAMP	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
modifyier_id	VARCHAR(32)	否	修改人
modify_time	TIMESTAMP	否	修改时间。格式：yyyy-MM-dd HH:mm:ss
title	VARCHAR(200)	是	标题
start_time	TIMESTAMP	是	有效期开始时间。格式：yyyy-MM-dd HH:mm:ss
end_time	TIMESTAMP	是	有效期结束时间。格式：yyyy-MM-dd HH:mm:ss
trade_type	VARCHAR(2)	是	销售对象。1：客户，2：经销商，3：门店
trade_range	VARCHAR(2)	是	销售范围。1：指定客户范围，2：指定具体客户
is_enable	VARCHAR(2)	是	是否可用
product_type	VARCHAR(2)	是	1：按商品，2：按同价码
strategy_type	VARCHAR(2)	是	价格方案类型编码。内置价格方案类型：1：商品售价，2：商品牌价
strategy_type_name	VARCHAR(2)	是	价格方案类型名称
basPdPriceStrategyCusFields（按范围设置）	List		列表
basPdPriceStrategyCusFields.cus_field_id	VARCHAR(32)	是	id
basPdPriceStrategyCusFields.status	VARCHAR(1)	是	0：已删除，1：正常
basPdPriceStrategyCusFields.creator_id	VARCHAR(32)	是	创建人
basPdPriceStrategyCusFields.create_time	TIMESTAMP	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyCusFields.modifyier_id	VARCHAR(32)	否	修改人
basPdPriceStrategyCusFields.modify_time	TIMESTAMP	否	修改时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyCusFields.field_code	VARCHAR(200)	是	范围类型编码
basPdPriceStrategyCusFields.field_name	VARCHAR(200)	是	范围类型编码名称
basPdPriceStrategyCusFields.selected_item	text	是	选择的范围类型对应的id（勤策id）
basPdPriceStrategyCusFields.selected_code	text	否	选择的范围类型对应的code（勤策code）
basPdPriceStrategyCusFields.selected_item_text	text	是	选择的范围类型对应的名称
basPdPriceStrategyProducts（按商品设置）	List		列表
basPdPriceStrategyProducts.price_strategy_product_id	VARCHAR(32)	是	id
basPdPriceStrategyProducts.status	VARCHAR(1)	是	0：已删除，1：正常
basPdPriceStrategyProducts.creator_id	VARCHAR(32)	是	创建人
basPdPriceStrategyProducts.create_time	TIMESTAMP	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyProducts.modifyier_id	VARCHAR(32)	否	修改人
basPdPriceStrategyProducts.modify_time	TIMESTAMP	否	修改时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyProducts.pd_id	VARCHAR(32)	是	商品id
basPdPriceStrategyProducts.pd_code	VARCHAR(100)	是	商品code
basPdPriceStrategyProducts.pd_name	VARCHAR(256)	是	商品name
basPdPriceStrategyProducts.input_unit	VARCHAR(32)	是	录入单位id
basPdPriceStrategyProducts.input_unit_name	VARCHAR(100)	是	录入单位name
basPdPriceStrategyProducts.sale_price	numeric(15,8)	是	销售策略价
basPdPriceStrategyProducts.base_unit	VARCHAR(32)	是	基本单位id
basPdPriceStrategyProducts.base_unit_name	VARCHAR(100)	是	基本单位name
basPdPriceStrategyProducts.min_base_unit_num	numeric(28,8)	否	起订量，即录入数量转化成基本单位的数量
basPdPriceStrategyProducts.min_num	numeric(28,8)	否	起订量
basPdPriceStrategyProducts.max_base_unit_num	numeric(28,8)	否	限订量，即录入数量转化成基本单位的数量
basPdPriceStrategyProducts.max_num	numeric(28,8)	否	限订量
basPdPriceStrategyProducts.price_up	numeric(28,8)	否	策略价上浮动
basPdPriceStrategyProducts.price_down	numeric(28,8)	否	策略价下浮动
basPdPriceStrategyProducts.start_time	TIMESTAMP	是	有效期开始日期。格式：yyyy-MM-dd
basPdPriceStrategyProducts.end_time	TIMESTAMP	是	有效期结束日期。格式：yyyy-MM-dd
basPdPriceStrategyProducts.exts	List	否	商品行扩展字段列表
basPdPriceStrategyProducts.exts.ext_key	varchar(4000)	否	商品行扩展字段key值扩展字段需先在我方系统中创建
basPdPriceStrategyProducts.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
basPdPriceStrategySameCodes（按同价码设置）	List		列表
basPdPriceStrategySameCodes.price_strategy_same_code_id	VARCHAR(32)	是	id
basPdPriceStrategySameCodes.status	VARCHAR(1)	是	0：已删除，1：正常
basPdPriceStrategySameCodes.creator_id	VARCHAR(32)	是	创建人
basPdPriceStrategySameCodes.create_time	TIMESTAMP	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategySameCodes.modifyier_id	VARCHAR(32)	否	修改人
basPdPriceStrategySameCodes.modify_time	TIMESTAMP	否	修改时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategySameCodes.same_price_code	varchar(32)	是	同价码
basPdPriceStrategySameCodes.input_unit_name	VARCHAR(100)	是	录入单位name
basPdPriceStrategySameCodes.sale_price	numeric(28,8)	是	销售策略价
basPdPriceStrategySameCodes.min_base_unit_num	numeric(28,8)	否	起订量，即录入数量转化成基本单位的数量
basPdPriceStrategySameCodes.min_num	numeric(28,8)	否	起订量
basPdPriceStrategySameCodes.max_base_unit_num	numeric(28,8)	否	限订量，即录入数量转化成基本单位的数量
basPdPriceStrategySameCodes.max_num	numeric(28,8)	否	限订量
basPdPriceStrategySameCodes.price_up	numeric(28,8)	否	策略价上浮动
basPdPriceStrategySameCodes.price_down	numeric(28,8)	否	策略价下浮动
basPdPriceStrategySameCodes.exts	List	否	商品行扩展字段列表
basPdPriceStrategySameCodes.exts.ext_key	varchar(4000)	否	商品行扩展字段key值扩展字段需先在我方系统中创建
basPdPriceStrategySameCodes.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
basPdPriceStrategySameCodes.start_time	TIMESTAMP	是	有效期开始日期。格式：yyyy-MM-dd
basPdPriceStrategySameCodes.end_time	TIMESTAMP	是	有效期结束日期。格式：yyyy-MM-dd
basPdPriceStrategyCuss（按客户设置）
basPdPriceStrategyCuss.price_strategy_cus_id	VARCHAR(32)	是	id
basPdPriceStrategyCuss.status	VARCHAR(1)	是	0：已删除，1：正常
basPdPriceStrategyCuss.creator_id	VARCHAR(32)	是	创建人
basPdPriceStrategyCuss.create_time	TIMESTAMP	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyCuss.modifyier_id	VARCHAR(32)	否	修改人
basPdPriceStrategyCuss.modify_time	VARCHAR(32)	否	修改时间。格式：yyyy-MM-dd HH:mm:ss
basPdPriceStrategyCuss.cm_id	VARCHAR(32)	是	客户id
basPdPriceStrategyCuss.cm_code	VARCHAR(32)	是	客户code
basPdPriceStrategyCuss.cm_name	VARCHAR(100)	是	客户name

# 新增修改价格方案接口

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

{
	"title": "测试1111111",
	"start_date": "2019-03-18",
	"end_date": "2019-03-31",
	"channel_type": "3",
	"cm_code": "KH1Q1019576A",
	"client_range": "2",
	"product_type": "2",
	"source_code": "aaassss",
	"operate_type": "1",
	"dept_id": "5027924547848612557,7243837410903640238",
	"gradation_code": "KH1Q1008146A",
	"kasys_name": "家乐福",
	"exts": [{
		"cm_ext_key": "需要配送",
		"cm_ext_value": "是"
	}],
	"products": [{
		"code": "10002",
		"price_code": "B111",
		"unit_name": "箱",
		"price": "100",
		"price_up": "120",
        "exts": [
            {
              "ext_key": "级别",
              "ext_value": "四星"
            },
            {
              "ext_key": "主营商品",
              "ext_value": "食品,电器,日化用品"
            }
        ]
	}]
}

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

参数说明：

参数	类型	必填	说明
strategy_type	VARCHAR(2)	否	价格方案类型编码。1：商品售价，2：商品牌价（其他价格方案类型编码需要在我方系统中创建并启用）
title	VARCHAR(100)	是	价格方案名称
start_date	VARCHAR(32)	是	开始日期。格式：yyyy-MM-dd
end_date	VARCHAR(32)	是	结束日期。格式：yyyy-MM-dd
channel_type	VARCHAR(32)	是	销售对象。1：标准客户，2：经销商，3：终端门店
client_range	VARCHAR(32)	是	客户范围。1：按客户属性设置范围，2：指定具体客户
product_type	VARCHAR(32)	是	商品范围。1：商品，2：同价码
source_code	VARCHAR(100)	否	价格方案第三方系统的唯一标识，source_code和price_id不能同时为空，如果同时存在优先取price_id
price_id	VARCHAR(32)	否	价格方案id，source_code和price_id不能同时为空，如果同时存在优先取price_id
dept_id	VARCHAR(32)	否	部门id，多个值以“,”分隔
dept_name	VARCHAR(100)	否	部门名称，多个值以“,”分隔
dept_code	VARCHAR(100)	否	部门编码，多个值以“,”分隔
dept_source_code	VARCHAR(100)	否	部门第三方系统的唯一标识，多个值以“,”分隔
customer_level_id	VARCHAR(32)	否	客户级别id，多个值以“,”分隔
customer_level_source_code	VARCHAR(100)	否	客户级别第三方系统的唯一标识，多个值以“,”分隔
customer_level_name	VARCHAR(100)	否	客户级别名称，多个值以“,”分隔
district_level_id	VARCHAR(32)	否	销售区域级别id，多个值以“,”分隔
district_level_code	VARCHAR(100)	否	销售区域级别编码，多个值以“,”分隔
district_level_name	VARCHAR(100)	否	销售区域级别名称，多个值以“,”分隔
type_id	VARCHAR(32)	否	类型id，多个值以“,”分隔
type_code	VARCHAR(100)	否	类型编码，多个值以“,”分隔
type_name	VARCHAR(100)	否	类型名称，多个值以“,”分隔
type_source_code	VARCHAR(100)	否	类型第三方系统的唯一标识，多个值以“,”分隔
district_id	VARCHAR(32)	否	销售区域id，多个值以“,”分隔
district_code	VARCHAR(100)	否	销售区域编码，多个值以“,”分隔
district_name	VARCHAR(100)	否	销售区域名称，多个值以“,”分隔
district_source_code	VARCHAR(100)	否	销售区域第三方系统的唯一标识，多个值以“,”分隔
uperCus_id	VARCHAR(32)	否	上级客户id，多个值以“,”分隔
uperCus_code	VARCHAR(100)	否	上级客户编码，多个值以“,”分隔
uperCus_source_code	VARCHAR(100)	否	上级客户第三方系统的唯一标识，多个值以“,”分隔
uperCus_name	VARCHAR(100)	否	上级客户名称，多个值以“,”分隔
kasys_id	VARCHAR(32)	否	ka系统id，多个值以“,”分隔
kasys_name	VARCHAR(100)	否	ka系统名称，多个值以“,”分隔
dealer_id	VARCHAR(32)	否	经销商id，多个值以“,”分隔
dealer_code	VARCHAR(100)	否	经销商编码，多个值以“,”分隔
dealer_name	VARCHAR(100)	否	经销商名称，多个值以“,”分隔
dealer_source_code	VARCHAR(100)	否	经销商第三方系统的唯一标识，多个值以“,”分隔
gradation_id	VARCHAR(32)	否	客户层次id，多个值以“,”分隔
gradation_code	VARCHAR(100)	否	客户层次编码，多个值以“,”分隔
gradation_name	VARCHAR(100)	否	客户层次名称，多个值以“,”分隔
cm_id	VARCHAR(2000)	否	经销商或客户id 多个逗号分隔 client_range为2，cm_id、cm_source_code、cm_code、cm_name不能同时为空。如果同时存在，优先级依次降低
cm_code	VARCHAR(4000)	否	经销商或客户编码多个逗号分隔 client_range 为2，cm_id、cm_source_code、cm_code、cm_name不能同时为空。如果同时存在，优先级依次降低
cm_name	VARCHAR(4000)	否	经销商或客户名称多个逗号分隔 client_range 为2，cm_id、cm_source_code、cm_code、cm_name不能同时为空。如果同时存在，优先级依次降低
cm_source_code	VARCHAR(4000)	否	经销商或客户第三方系统的唯一标识，多个值以“,”分隔。client_range 为2，cm_id、cm_source_code、cm_code、cm_name不能同时为空。如果同时存在，优先级依次降低
exts	List		列表
exts.cm_ext_key	VARCHAR(100)	否	客户信息扩展字段key值，客户信息扩展字段需先在勤策系统客户管理中创建自定义字段
exts.cm_ext_value	VARCHAR(4000)	否	客户信息扩展字段value值对多个选项值，以“,”分隔拼接
products	List		列表
products.id	VARCHAR(32)	否	商品id。id，source_code，code不能同时为空，如果同时存在，优先级依次降低
products.code	VARCHAR(100)	否	商品编码。id，source_code，code不能同时为空，如果同时存在，优先级依次降低
products.source_code	VARCHAR(100)	否	商品第三方系统的唯一标识。id，source_code，code不能同时为空，如果同时存在，优先级依次降低
products.unit_id	VARCHAR(32)	否	单位id，unit_id、unit_name不能同时为空，如果同时存在优先取unit_id
products.unit_name	VARCHAR(100)	否	单位名称，unit_id、unit_name不能同时为空，如果同时存在优先取unit_id
products.price	VARCHAR(32)	是	价格
products.price_up	VARCHAR(32)	否	价格上浮动，整数位不大于7位
products.price_down	VARCHAR(32)	否	价格下浮动，整数位不大于7位
products.price_code	VARCHAR(32)	否	product_type=2的时候此值必传，表示同价码
products.start_time	TIMESTAMP	是	有效期开始日期。格式：yyyy-MM-dd
products.end_time	TIMESTAMP	是	有效期结束日期。格式：yyyy-MM-dd
products.exts	List	否	商品行扩展字段列表
products.exts.ext_key	varchar(4000)	否	商品行扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
ownerDeptId	VARCHAR(32)	否	所属部门id。ownerDeptId、ownerDeptSourceCode、ownerDeptCode、ownerDeptName不能同时为空。如果同时存在，优先级依次降低
ownerDeptName	VARCHAR(100)	否	所属部门名称。ownerDeptId、ownerDeptSourceCode、ownerDeptCode、ownerDeptName不能同时为空。如果同时存在，优先级依次降低
ownerDeptCode	VARCHAR(100)	否	所属部门编码。ownerDeptId、ownerDeptSourceCode、ownerDeptCode、ownerDeptName不能同时为空。如果同时存在，优先级依次降低
ownerDeptSourceCode	VARCHAR(100)	否	所属部门第三方系统的唯一标识。ownerDeptId、ownerDeptSourceCode、ownerDeptCode、ownerDeptName不能同时为空。如果同时存在，优先级依次降低

响应示例：

{
    "msg_id": "PRD00001",
    "return_code": "1",
    "return_msg": "新增成功！"
}

异常示例：

{
    "msg_id": "PRD00001",
    "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/removePriceStrategy/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

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

参数说明：

参数	类型	必填	说明
price_id	VARCHAR(32)	否	价格方案id。price_id和source_code不能同时为空，如果同时存在优先取price_id
source_code	VARCHAR(100)	否	价格方案第三方系统的唯一标识。price_id和source_code不能同时为空，如果同时存在优先取price_id

响应示例：

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

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

参数说明：

参数	类型	必填	说明
price_id	VARCHAR(32)	否	价格方案id，price_id和source_code不能同时为空，如果同时存在优先取price_id
source_code	VARCHAR(100)	否	价格方案第三方系统的唯一标识，price_id和source_code不能同时为空，如果同时存在优先取price_id
enable	VARCHAR(32)	是	启用停用。1启用 0停用

响应示例：

{
    "msg_id": "PRD00001",
    "return_code":"0",
    "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	是	响应说明

← 商品可售范围接口产品组接口 →