帮助中心
进入EZR

1206-上传积分流水

2021-03-31

接口编号 1206

接口说明

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

2.更新会员可用积分

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

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

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

6.1206积分会触发1211，推送中心会过滤相同来源积分（appsystem）

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：api/cvip/vipbonusset

请求参数



字段类型为空长度描述
OldCodestring否1~20客户线下卡号，客户线下卡号、电子卡号、OpenId三填一
Codestring否1~20客户电子卡号，客户线下卡号、电子卡号、OpenId三填一
WxOpenIDstring否1~32微信OpenId，客户线下卡号、电子卡号、OpenId三填一
TransBonusint否
积分变动值：正数=赠送积分，负数=使用积分，不支持小数点，若传递小数点将当做0，并报错返回
TradeNostring否1~32变动凭证：调用方的追朔日志记录代码（需保证唯一）
ChangeTimestring否
变动时间（yyyy-MM-dd HH:mm:ss格式）
ShopCodeString是1-16门店编号(归属门店)
EffectDateint是
积分生效日期，yyyyMMdd格式，为0表示立即生效（此字段只有在增加积分时有效）
ValidityDateint否
积分有效期,yyyyMMdd格式，为0表示永久有效（此字段只有在增加积分时有效）
TransOriginint是
积分变更来源：文档底部有详细说明
DataOriginint是
数据来源：0=线下门店消费；1=品牌自有商城；2=品牌线上官网；3=PC销售买单；4=APP销售买单；6=EZR微商城；7=EZR微信小程序；10=淘宝；11=京东
Remarkstring否1~32描述
IgnoreMsgint是1默认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,
   

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

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



10567