会员积分同步 Member Bonus Sync.
| 公共参数名称 | 公共参数值 |
|---|---|
| method | fzapi.crm.member_bonus_sync |
| content | 请求参数集合，详见下面请求参数说明 |
请求参数说明
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| member_code | String | 是 | 20 | 会员卡号 | 0201000000012101 |
| bonus_date | String | 是 | 10 | 积分日期，格式yyyy-MM-dd | 2017-06-01 |
| bonus_time | String | 是 | 8 | 积分时间，格式HH:mm:ss | 10:10:10 |
| bonus_type | String | 是 | 2 | 积分类型，01=消费积分，02=兑换礼品，03=积分调整，04=销售积分兑换KD，06=积分抵现 | 01 |
| bonus_description | String | 否 | 256 | 积分说明/备注/调整原因 | 统一调整 |
| bonus_point | String | 是 | 32 | 积分分值，整数数字 | 1000 |
| sales_amount | Stirng | 否 | 32 | 消费金额，带2位小数点数字 | 2000.00 |
| doc_no | String | 否 | 30 | 单据号，兑换礼品或积分调整可以不传，不传时由系统产生单据号并返回 | S100000001 |
| record_id | String | 否 | 150 | 单据号，KP唯一识别码 | |
| store_code | String | 是 | 30 | 积分地点（店铺号），如果是购物中心柜台兑换礼品或者积分调整，此处传入商场编码 | SH01000001 |
| store_name_sc | String | 否 | 128 | 积分地点（店铺名称-简体中文） | 肯德基 |
| store_name_tc | String | 否 | 128 | 积分地点（店铺名称-繁体中文） | 肯德基 |
| store_name_en | String | 否 | 128 | 积分地点（店铺名称-英文） | KFC |
| bonus_promotion_content | Json | 否 | - | 促销积分内容（预留，仅当积分类型为消费积分时使用），详细参数参考下方说明 | [{"promotion_id":"P0000001","promotion_description":"生日双倍积分","free_bonus":"1000"}] |
| gift_list_content | Json | 否 | - | 兑换礼品详细信息（仅当积分类型为兑换礼品时使用），详细参数参考下方说明 | [{"item_no":"G001","item_name_sc":"礼品卡","item_name_tc":"禮品卡","item_name_en":"Gift Card","rule_id":"R001","Qty":"1","bonus":"500","add_price":"10.00"}] |
| vipgrade | String | 否 | 50 | 会员等级代码 | 01 |
| voidstatus | String | 否 | 2 | 销售单状态0为销售,1为退货 | 0 |
| oradocno | String | 否 | 60 | 退货单原单号 | S00600010 |
| bonusource | String | 否 | 10 | 交易来源 | 05 |
| gvamount | String | 否 | 5 | 不积分金额 | 50 |
促销积分内容参数说明
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| promotion_id | String | 是 | 30 | 促销编号 | P0000001 |
| promotion_description | String | 是 | 128 | 促销描述 | 生日双倍积分 |
| free_bonus | String | 是 | 32 | 额外赠送积分，整数数字 | 1000 |
兑换礼品详细信息参数说明
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| item_no | String | 是 | 30 | 礼品编号 | G001 |
| item_name_sc | String | 否 | 128 | 礼品名称（简体中文） | 礼品卡 |
| item_name_tc | String | 否 | 128 | 礼品名称（繁体中文） | 禮品卡 |
| item_name_en | String | 否 | 128 | 礼品名称（英文） | Gift Card |
| rule_id | String | 是 | 30 | 兑换礼品规则ID | R001 |
| qty | String | 是 | 30 | 兑换数量（整数数字） | 1 |
| bonus | String | 是 | 30 | 单件礼品所需积分（整数数字） | 500 |
| add_price | String | 是 | 30 | 兑换礼品单件加价价格（带2位小数点数字，默认0.00） | 10.00 |
响应数据说明
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| doc_no | String | 是 | - | 返回单据号 | S100000001 |
请求数据示例：
timestamp=2013-01-01 08:08:08&method=fzapi.crm.member_bonus_sync&app_id=FZ20071001&charset=utf-8&sign_type=RSA&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0.0&content={
"member_code":"0201000000012101",
"bonus_date":"2017-06-01",
"bonus_type":"01",
"bonus_description":"",
"bonus_point":"1000",
"sales_amount":"2000.00",
"doc_no":"S100000001",
"store_code":"SH01000001",
"store_name_sc":"肯德基",
"store_name_tc":"肯德基",
"store_name_en":"KFC",
"vipgrade":"01",
"bonus_promotion_content":[{"promotion_id":"P0000001","promotion_description":"生日双倍积分","free_bonus":"1000"}],
"gift_list_content":
}
响应数据示例：
{
"success":true,
"code":"1000",
"msg":"Success",
"data":{"doc_no":"S100000001"}
}