# 新增客户费用池增加流水

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/v1/addExportAmountFlow/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "bas_cm_customer": "5950706195173244407",
    "rebate_account": "7097038094955291930",
    "rebate_amount_in": 0,
    "remark": "是的",
    "rebate_period": "2020-10-16"
}

请求信息

参数 类型 必填 说明
cm_id int8 客户id
rebate_account_id int8 返利账户id
rebate_amount_in NUMERIC(20,2) 返利增加金额
remark varchar(4000) 备注
rebate_period date 返利有效期, 格式是yyyy-mm-dd

返回结果:

{
    "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/rebate/v1/queryCmFlowOrderUpByMap/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
   "page_number": 1,
    "page_length": 1000,
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-09",
    "start_modify_date": "2016-12-09",
    "end_modify_date": "2016-12-09",
    "start_period_date": "2016-12-09",
    "end_period_date": "2016-12-09"
}

请求信息

参数 类型 必填 说明
page_numbe INT 当前页数,不传默认为1
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
start_period_date TIMESTAMP 有效期至时间开始,格式:“yyyy-MM-dd”
end_period_date TIMESTAMP 有效期至时间结束,格式:“yyyy-MM-dd”

返回结果:

{
	"return_code":0,
	"return_msg":"",
	"msg_id":"X0000000001",
	"response_data":[
        {"flow_no":"SR20200918000009",
        "cm_id":5950706195173244407,
         "rebate_account_id":7097038094955291930,
         "rebate_amount_in":0.30,
         "rebate_type":999,
         "remark":"",
         "rebate_period":"2020-10-16 00:00:00",
         "create_time":"2020-09-18 13:34:18",
         "creator_id":998
         },
         .......
	]

}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data VARCHAR(32) 响应数据
flow_no VARCHAR(32) 增加流水号
cm_id VARCHAR(32) 客户id
rebate_account_id VARCHAR(32) 返利账户id
rebate_amount_in NUMERIC(20,2) 返利增加金额
rebate_type VARCHAR(32) 返利类型
remark VARCHAR(32) 备注
rebate_period VARCHAR(32) 返利有效期
create_time VARCHAR(32) 创建时间
creator_id VARCHAR(32) 创建人

# 客户费用池减少流水查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/v1/queryCmFlowOrderReduceByMap/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
   "page_number": 1,
    "page_length": 1000,
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-09",
    "start_modify_date": "2016-12-09",
    "end_modify_date": "2016-12-09",
    "start_period_date": "2016-12-09",
    "end_period_date": "2016-12-09"
}

请求信息

参数 类型 必填 说明
page_numbe INT 当前页数,不传默认为1
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
start_period_date TIMESTAMP 有效期至时间开始,格式:“yyyy-MM-dd”
end_period_date TIMESTAMP 有效期至时间结束,格式:“yyyy-MM-dd”

返回结果:

{
	"return_code":0,
	"return_msg":"",
	"msg_id":"X0000000001",
	"response_data":[
        {"oflow_no":"SR20200918000009",
        "cm_id":5950706195173244407,
         "rebate_account_id":7097038094955291930,
         "rebate_amount_in":0.30,
         "rebate_type":999,
         "remark":"",
         "iflow_no":"SR20200918000019"},
         "create_time":"2020-09-18 13:34:18",
         "creator_id":998,
         .......
	]

}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data VARCHAR(32) 响应数据
oflow_no VARCHAR(32) 减少流水号
cm_id VARCHAR(32) 客户id
rebate_account_id VARCHAR(32) 返利账户id
rebate_amount_in NUMERIC(20,2) 返利增加金额
rebate_type VARCHAR(32) 返利类型
remark VARCHAR(32) 备注
iflow_no VARCHAR(32) 对应增加流水号
create_time VARCHAR(32) 创建时间
creator_id VARCHAR(32) 创建人

# 代金券扣减流水查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/giftCard/v1/reducequery/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "id": "",
    "card_no": "",
    "cm_id": "",
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-09",
    "start_modify_date": "2016-12-09",
    "end_modify_date": "2016-12-09"
}

请求信息

参数 类型 必填 说明
id varchar id
card_no varchar 卡号
cm_id TIMESTAMP 客户ID
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”

返回结果:

{
	"return_code":0,
	"return_msg":"",
	"msg_id":"X0000000001",
	"response_data":[
        {
            "id":"",
            "card_no":,
            "reduce_amount":"",
            "reduce_type":"",
            "remark":"",
            "bill_date":"2020-09-18 13:34:18",
            "bill_no":""
         },
         .......
	]

}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data VARCHAR(32) 响应数据
id VARCHAR(32) 明细id
card_no VARCHAR(32) 卡号
reduce_amount VARCHAR(32) 扣减金额
reduce_type NUMERIC(20,2) 扣减类型 1、手工扣减,2、下单扣减,3、接口扣减,4、过期扣减
remark VARCHAR(32) 备注
bill_date VARCHAR(32) 扣减时间 'yyyy-MM-dd hh:mm:ss'
bill_no VARCHAR(32) 关联单号(对应发货单号)

# 代金券新增接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/giftCard/v1/add/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
	"card_no": "20201027092845000008",
	"amount": "3000",
	"cm_id": "",
	"cm_code": "CUS010036",
	"pd_codes": "10002,668_pd_001",
	"pd_ids": "",
	"period_start": "2020-02-20",
	"period_date": "2021-02-20",
	"remark": "ssss",
	"pd_range": "1",
	"card_type": ""
}

请求信息

参数 类型 必填 说明
card_no varchar(20) 代金券号,长度不超过20位
amount NUMERIC(20,2) 面额,要大于0
cm_id int8 客户id,此字段非必填,第三方可能没有此字段
cm_code varchar(100) 客户编码
pd_ids varchar(1000) 商品id,多个逗号分隔,此字段非必填,第三方可能没有此字段
pd_codes varchar(1000) 商品编码,多个逗号分隔,当商品范围是0时,此字段可为空
period_start date 使用开始日期,为空时会取系统日期
period_date date 使用截止日期, 格式是yyyy-mm-dd,不能小于今天
remark varchar(300) 备注
pd_range varchar(2) 商品范围,0、全部商品,1、指定商品
card_type varchar(50) 代金券类型

返回结果:

{
	"msg_id": "X000001",
	"return_code": 0,
	"return_msg": "",
	"response_data": {
		"card_no": "20201027092845000048",
		"id": "5676765698890926253"
	}
}

# 代金券发放接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/giftCard/v1/release/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
	"card_no": "20201027092845000008",
	"modifyier_id": "5626758037400368455"
}

请求信息

参数 类型 必填 说明
card_no varchar(32) 代金券号,多个逗号分隔
modifyier_id int8 发放人id

返回结果:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

# 客户赠品池查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/addpdpool/v1/query/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{	
    "page_number": 1,
    "page_length": 1000,
    "pool_type":"7781114128642380050",
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-09",
    "start_modify_date": "2016-12-09",
    "end_modify_date": "2016-12-09",
    "start_period_date": "2016-12-09",
    "end_period_date": "2016-12-09"
}

请求信息:

参数 类型 必填 说明
page_numbe INT 当前页数,不传默认为1
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
pool_type VARCHAR(32) 赠品类型id
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
start_period_date TIMESTAMP 有效期至时间开始,格式:“yyyy-MM-dd”
end_period_date TIMESTAMP 有效期至时间结束,格式:“yyyy-MM-dd”

返回结果:

{
	"return_code": 0,
	"return_msg": "",
	"msg_id": "X0000000001",
	"response_data": [{
		"flow_no": "RG20201125000005",
		"cm_id": 5950706195173244407,
		"pd_id": 7097038094955291930,
		"unit_id": 7097038094955291930,
		"total_num": 999,
		"leave_num": 999,
		"price": 0.30,
		"remark": "",
		"period_start": "2020-11-25",
		"period_date": "2020-11-25",
		"pool_type": "7781114128642380050",
		"sourcecode": "",
		"create_time": "2020-09-18 13:34:18",
		"modify_time": "2020-09-18 13:34:18"
	},....]
}

响应信息:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
flow_no VARCHAR(32) 流水号
cm_id VARCHAR(32) 客户id
pd_id VARCHAR(32) 赠品id
unit_id VARCHAR(32) 赠品单位id
total_num NUMERIC(20,2) 赠品总量
leave_num NUMERIC(20,2) 可用数量
price NUMERIC(20,2) 赠品单价
remark VARCHAR(32) 备注
period_start VARCHAR(32) 使用开始日期,"yyyy-MM-dd"
period_date VARCHAR(32) 使用截止日期,"yyyy-MM-dd"
pool_type VARCHAR(32) 赠品类型id
sourcecode VARCHAR(32) 促销案号+客户编码+赠品编码
modify_time VARCHAR(32) 更新时间,格式"yyyy-MM-dd HH:mm:ss"
create_time VARCHAR(32) 创建时间,格式"yyyy-MM-dd HH:mm:ss"

# 客户赠品池新增接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/rebate/addpdpool/v1/add/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
	"flow_no": "RG20201125000005",
	"cm_id": "5950706195173244407",
	"pd_id": "7097038094955291930",
	"unit_id": "7097038094955291930",
	"total_num": "999",
	"leave_num": "999",
	"price":" 0.30",
	"remark": "",
	"period_start": "2020-11-25",
	"period_date": "2020-11-25",
	"pool_type": "7781114128642380050",
	"sourcecode": ""
}

请求信息:

参数 类型 必填 说明
flow_no VARCHAR(32) 流水号
cm_id VARCHAR(32) 客户id
pd_id VARCHAR(32) 赠品id
unit_id VARCHAR(32) 赠品单位id,必须为商品对应单位
total_num NUMERIC(20,2) 赠品总量,≥0
leave_num NUMERIC(20,2) 可用数量,≥0
price NUMERIC(20,2) 赠品单价,不传则为0
remark VARCHAR(32) 备注,
period_start VARCHAR(32) 使用开始日期,格式"yyyy-MM-dd",为空则填写系统日期
period_date VARCHAR(32) 使用截止日期,"yyyy-MM-dd",为空时存“9999-12-31”
pool_type VARCHAR(32) 赠品类型id,不传则取默认类型
sourcecode VARCHAR(32) 促销案号+客户编码+赠品编码

返回结果:

{
    "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/rebate/addpdpool/v1/update/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
	"id": "7097038094955291930",
	"unit_id": "5950706195173244407",
	"leave_num": "999",
	"pd_id": "7097038094955291930",
}

请求信息:

参数 类型 必填 说明
flow_no VARCHAR(32) 赠品池流水号
pd_id VARCHAR(32) 赠品id
unit_id VARCHAR(32) 赠品单位id,必须为商品对应单位
leave_num NUMERIC(20,2) 可用数量,≥0

返回结果:

{
    "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/rebate/giftCard/v1/giftCardList/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
	"page_number": 1,
	"page_length": 1000,
	"start_create_date": "2020-12-09",
	"end_create_date": "2021-12-09",
	"start_modify_date": "2020-12-09",
	"end_modify_date": "2021-12-09",
	"start_period_date": "2020-12-09",
	"end_period_date": "2021-12-09"
}

请求信息:

参数 类型 必填 说明
page_numbe INT 当前页数,不传默认为1
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
start_period_date TIMESTAMP 有效期至时间开始,格式:“yyyy-MM-dd”
end_period_date TIMESTAMP 有效期至时间结束,格式:“yyyy-MM-dd”

返回结果:

{
	"return_code": 0,
	"return_msg": "查询客户代金券成功",
	"msg_id": "X0000000001",
	"response_data": [{
		"amount": 22.0,
		"creator": "杜洪鑫",
		"create_time": "2020-12-01 16:51",
		"modify_time": "2020-12-01 16:52",
		"remark": "",
		"leave_amount": 0.0,
		"card_id": "5004185925240396944",
		"card_type_name": "默认类型",
		"add_type": "手工录入",
		"period_date_start": "2020-12-01",
		"cm_code": "CUS000003",
		"card_status": "已用完",
		"pd_range": "全部商品",
		"card_no": "20201201165148000029",
		"cm_id": "5257998258449137162",
		"cm_name": "老杜的下级经销商",
		"used_amount": 22.0,
		"can_applied": "Y",
		"period_date_end": "2020-12-01"
	},....]
}

响应信息:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
amount NUMERIC(20,2) 发放金额
used_amount NUMERIC(20,2) 已用金额
leave_amount NUMERIC(20,2) 剩余金额
creator VARCHAR(32) 创建人
create_time VARCHAR(32) 创建时间,格式"yyyy-MM-dd HH:mm"
modify_time VARCHAR(32) 更新时间,格式"yyyy-MM-dd HH:mm"
card_id VARCHAR(32) 代金券id
card_no VARCHAR(32) 代金券号
card_type_name VARCHAR(32) 代金券类型
period_date_start VARCHAR(32) 使用开始日期,"yyyy-MM-dd"
period_date_end VARCHAR(32) 使用截止日期,"yyyy-MM-dd"
cm_code VARCHAR(32) 客户编码
cm_id VARCHAR(32) 客户id
cm_name VARCHAR(32) 客户名称
can_applied VARCHAR(32) 是否允许核销,Y:可以,N:不可以
card_status VARCHAR(32) 状态:待发放 | 已发放 | 使用中 | 已完成
pd_range VARCHAR(32) 商品范围:全部商品 | 指定商品
add_type VARCHAR(32) 增加类型:手工录入 | 接口写入
remark VARCHAR(32) 备注