BSS积分兑换接口文档

1、积分扣减（查询受理分册）业务描述该接口用于电子渠道或合作伙伴发起的对用户消费积分的扣减或回退操作。积分消费方式有兑换、抽奖、互换和消费四种。积分回退是指当用户取消兑换或投诉时将用户积分返还的一种操作，将已扣减积分返还；积分回退只适用于管理员处理用户投诉的情况。业务流程客户电子渠道系统枢纽系统用户归属省 BSS手机号码校验、积客户登录分查询和消费确认进行积分消费判断号码归属发送扣减请求地号码校验发送扣减请求积分值验证发送扣减应答进行积分扣减操作发送扣减应答发送扣减应答1)2)3)4)5)6)7)8)9)客户登录电子渠道网站，查看可消费产品列表；客户进行积分消费；电子渠道系统检验用户手机号码，进行

2、消费确认；电子渠道系统发送积分扣减请求；枢纽系统根据手机号码路由转发用户归属省BSS ；用户归属省 BSS 进行号码检验、可用积分值验证和积分扣减操作；用户归属省 BSS 返回积分扣减应答；枢纽系统返回积分扣减应答；电子渠道给客户返回积分消费结果；在交易过程中，如果归属方BSS系统超时无应答，则认为该交易失败。发起方可以用原交易流水重发请求，归属方应做查重，发现重复流水号的交易请求，直接返回原交易处理结果。发起方连续重发失败，即认为交易失败，通过对账来调整，见对账接口描述。业务属性编码BIP2B001冲正处理不冲正对帐对账交易属性名称取值编码T2001107需要冲正0：不需要冲正对帐标记1：参

3、与对帐是否允许用原交易流水号重发0: 不允许发起方机构 DOMAINECIP落地方机构 DOMAINUCRM路由类型01 ：按照手机号码路由请求报文节点名称父接口名称约束类型长度PointsConsumeReqSvcCont1-ProcTimePointsConsumeReq1StringF17UserNumberPointsConsumeReq1StringV20OperTypePointsConsumeReq1StringF2PointsConsumeReqStringV10Points1说明yyyyMMDDHH24MISSsss现阶段是手机号码01-扣减， 02- 回退扣减、回退的积分数

4、，正整数扣减交易，省分应扣减用户积分；回退交易，省分应增加用户积分；现ChanType阶段扣减ConsumeType交易中，GoodsType订单GoodsCode号为GoodsName保留GoodsNum字OrderSeq段，Para1可PointsConsumeReqStringF4积分消费渠道0XXX 电子渠道10001 电子渠道网站0002 WAP1XXX 合作伙伴的编码PointsConsumeReqStringF2积分用途01积分兑换102积分抽奖03积分互换04积分消费PointsConsumeReqStringF2物品类型的编码101通信类02非通信类03联盟类PointsCo

5、nsumeReq?StringV20物品编码（兑换、消费类）(用于无订单方式，有订单时不用填写此字段 )PointsConsumeReq?StringV64物品名称 (用于无订单方式，有订单时不用填写此字段)PointsConsumeReq?StringV10物品数量 (用于无订单方式，有订单时不用填写此字段)PointsConsumeReq?StringV30订单号（大订单号；无订单时不用填写）PointsConsumeReq?StringV128备注，可不填为空；回退交易中，订单号填写原交易流水号。目前积分扣减接口中产品描述不采用订单方式，产品信息直接填写在报文相应字段；未来对于复杂业务将

6、采用订单方式，即将积分扣减与订单明细分开，本接口只用于积分扣减，订单详细信息通过订单发送。应答报文节点名称父接口名称约束类型长度说明PointsConsumeRspSvcCont1-EffectTimePointsConsumeRsp1StringF14生效时间yyyyMMDDHH24MISSPointsConsumeRspStringF2应答码RespCode100成功01客户积分值不够02客户无积分03 用户不存在99 其他原因，见结果描述当应答码为00 ， Head 中的应答码填 0000 ，表示交易完成，业务成功。1当应答码非00 ， Head 中应答码填 2990，表示交易完成但.是

7、业务失败1RespDescPointsConsumeRsp?StringV256结果描述 .给用户的提示信息，要简单明了ComsumePointsPointsConsumeRsp1StringV10实际扣减、回退积分总RemainPointsPointsConsumeRsp1StringV10剩余积分部H2 接口方式包头数据包头格式：内容为一定长ASCII 字符串（ 86102位），具体内容如下：字段名称长度说明A0版本号信息（ 2位）标识当前使用的协议版本号（默认值： 11 ）A1数据包大小（ 5位）以字节为单位，不足右补空格A2流水号（ 20位）业务流水号，标志每笔具体交易。数据校验包可以

8、无流水号（发起方随机生成）A3标志（ 1位）1 表示成功 0 表示失败，仅适用于响应包A4服务类型（ 12位）编码规则参见 （对应每个接口功能点的 服务类型）A5业务号码（ 20位）移动电话号码，固话加区号设备号码(固话加区号 ,移网 11 位号码 )A6 业务号码类型（1 位）A7营业点（ 106位）A8营业员（ 208位）A9包编号（ 5位）A10 最后一包标志（ 1位）A11 错误码（5 位）(没有业务号码的时候A5 设定一个定值1300000000A,A6 设定为 G)G-GSM,D- 宽带 , F- 固话 , V- VPN 集团 , I-IP(VOIP),P-长途 (193), Z-

9、 其他(根据实际参数调整) 小灵通-L业务受理地点根据 4A 生成规则受理部门编码业务受理人根据 4A 生成规则员工编码标志该笔流水的第几包数据（例如：第一个包则传 00001 ）在进行多包发送的情况下，该标志用以标明是否为最后一数据包。1 最后一包数据，无后续包； 0 非最后一包数据，有后续包，连接错误， I/O 错误等在标志为失败时需要检查该错误码。错误码包括系统操作错误和业务处理错误（请求时：传00000应答时：返回00000 表示成功 ,其他为失败 ,编码和描述参考每个功能点错误编码和错误描述）注：除 A3 标志是响应包必填项外，其它字段都是必填项，是定长包体定义一个数据包总长度不可大

10、于4K 。对存在多条返回记录的业务，一数据包可含多条记录。长度如超过4K ，就以多包数据发送。每字段之间用“TAB键 0x09”分隔，每记录之间用“回车键0x0d,0x0a ”分隔，包结束用“ 0x1a。”对于不同的服务类型，其请求包和应答包的包体具有不同的内容。无论数据有无包体返回，一定需要添加包结束符。对于任何非正常返回的数据包应该没有包体，只有包头与包结束符。包体字段为定长字符串，非变长字符串，字段内容不应该出现不可打印字符串。补空格原则 ：凡字段的数据表示的是金额的，既其字段类型是Number(10) 的，这样的字段是左补空格，其它字段都是右补空格。注：如果省分是按分隔符处理数据，此规则无效。如果省分按定长处理数据，则遵循些规则补空格。简单产品变更【辽宁、山东、河南、河北、北京、黑龙江】接口描述简单产品变更。统一接口数据定义服务类型 SSIMPLESERV请求包体：名称长度参数类型渠道接入密码10Char标志1Char特服代码 / 优惠代（ 20 ）Char码/ 产品代码生效模式10Char延迟生效天数10Char预留5