帮助中心

1206-上传积分流水

2020-10-23

接口编号 1206

接口说明

1.应用于添加用户积分流水(重复添加将跳过不做变化)

2.更新会员可用积分

3.分销负责订单消费积分计算并发放(优先考虑分销积分发放)

4.分销负责积分抵现(和EZR积分扣减二选一)

5.IgnoreMsg=1不触发模板消息

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:api/cvip/vipbonusset

请求参数


字段类型为空长度描述
OldCodestring1~20客户线下卡号,客户线下卡号、电子卡号、OpenId三填一
Codestring1~20客户电子卡号,客户线下卡号、电子卡号、OpenId三填一
WxOpenIDstring1~32微信OpenId,客户线下卡号、电子卡号、OpenId三填一
TransBonusint
积分变动值:正数=赠送积分,负数=使用积分,不支持小数点,若传递小数点将当做0,并报错返回
TradeNostring1~32变动凭证:调用方的追朔日志记录代码(需保证唯一)
ChangeTimestring
变动时间(yyyy-MM-dd HH:mm:ss格式)
ShopCodeString1-16门店编号(归属门店)
EffectDateint
积分生效日期,yyyyMMdd格式,为0表示立即生效(此字段只有在增加积分时有效)
ValidityDateint
积分有效期,yyyyMMdd格式,为0表示永久有效(此字段只有在增加积分时有效)
TransOriginint
积分变更来源:1=初始积分;2=交易送积分-线下;5=积分兑换(使用积分换东西,例如换券);7=交易退积分-线下;9=调整积分;13=接口赠送;15=接口消耗;50=交易送积分-线上商城;51=交易退积分-线上商城;52=交易送积分-三方商城,京东天猫等;53=交易退积分-三方商城,京东天猫等;备注:接口不传此字段或者传入值为0,系统会采用默认逻辑,即:积分值>0 记为 接口赠送(13) ,积分值<0 记为 接口消耗(15)
Remarkstring1~32描述
IgnoreMsgint1默认0=发送模板消息;1=不发送模板消息



请求参数示例代码(json对象)

{
 "OldCode": "EZ00001230",
 "Bonus": 100,
 "BonusTotal": 1000,
 "TransBonus": -100,
 "ShopCode":"shopcode001",
 "TradeNo": "T00001",
 "ChangeTime": "2015-11-01 12:30:01",
 "Remark": "积分换券",
 "EffectDate": 20100101,
 "ValidityDate ": 20100105,
}


系统级返回结果示例(json)

{
 "Status": true,
 "StatusCode": 200,
 "Msg": "成功",
 "Timestamp": "20150622093101",
 "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
 "Result": 见业务返回结果示例,
}

业务返回结果示例(json对象):

内容1,代表所影响行数

TransOrigin:

  初始积分
 Init = 1,  

 交易送积分-线下
 Trade = 2,

 活动赠送
 Give = 3,

 N倍积分
 NRate = 4,

 积分兑换
 Exchange = 5,

 积分抵现
 UseCash = 6,    

 交易退积分-线下
 Return = 7,

 旧卡积分
 OldBind = 8,

 调整积分
 Manual = 9,

 抽奖
 Prize = 10,

 邀请有礼
 InviteGive = 11,

 积分兑礼
 ExchangeGift = 12,

 接口赠送
 ThirdGive = 13,  

 接口消耗
 ThirdExchange = 15,

 分享活动送积分
 ActShare = 16,

 活动浏览送积分
 ActShareView = 17,

 批量赠送积分
 BatchSend=18,

 商城商品兑换
 ExchangeMallProd = 20

 会员特权赠送
 Privilege = 30,

 交易送积分-线上商城
 TradeOnline = 50,

 交易退积分-线上商城
 ReturnOnline = 51,  

 交易送积分-三方商城,京东天猫等
 TradeOnlineOth = 52,

 交易退积分-三方商城,京东天猫等
 ReturnOnlineOth = 53,      

 积分兑礼退积分
 BackExchangeGift = 54,

 线下积分抵扣
 OfflineBonusExchange = 56,

 交易送积分-小程序
 WxAppTrade = 57,      

 交易评论赠送积分
 SaleComtGive = 100,        

 会员异常调整积分
 Abnormal = 101,


6069