最新BSS积分兑换接口文档.docx
Four short words sum up what has lifted most successful individuals above the crowd: a little bit more.-author-dateBSS积分兑换接口文档BSS积分兑换接口文档1.1.1 积分扣减（查询受理分册）1.1.1.1 业务描述该接口用于电子渠道或合作伙伴发起的对用户消费积分的扣减或回退操作。积分消费方式有兑换、抽奖、互换和消费四种。积分回退是指当用户取消兑换或投诉时将用户积分返还的一种操作，将已扣减积分返还；积分回退只适用于管理员处理用户投诉的情况。1.1.1.2 业务流程1) 客户登录电子渠道网站，查看可消费产品列表；2) 客户进行积分消费；3) 电子渠道系统检验用户手机号码，进行消费确认；4) 电子渠道系统发送积分扣减请求；5) 枢纽系统根据手机号码路由转发用户归属省BSS；6) 用户归属省BSS进行号码检验、可用积分值验证和积分扣减操作；7) 用户归属省BSS返回积分扣减应答；8) 枢纽系统返回积分扣减应答；9) 电子渠道给客户返回积分消费结果；在交易过程中，如果归属方BSS系统超时无应答，则认为该交易失败。发起方可以用原交易流水重发请求，归属方应做查重，发现重复流水号的交易请求，直接返回原交易处理结果。发起方连续重发失败，即认为交易失败，通过对账来调整，见对账接口描述。1.1.1.3 业务属性编码BIP2B001冲正处理不冲正对帐对账1.1.1.4 交易属性名称取值编码T2001107需要冲正0：不需要冲正对帐标记1：参与对帐是否允许用原交易流水号重发0: 不允许发起方机构DOMAINECIP落地方机构DOMAINUCRM路由类型01：按照手机号码路由1.1.1.5 请求报文节点名称父接口名称约束类型长度说明PointsConsumeReqSvcCont1-ProcTimePointsConsumeReq1StringF17yyyyMMDDHH24MISSsssUserNumberPointsConsumeReq1StringV20现阶段是手机号码OperTypePointsConsumeReq1StringF201- 扣减，02-回退PointsPointsConsumeReq1StringV10扣减、回退的积分数，正整数扣减交易，省分应扣减用户积分；回退交易，省分应增加用户积分；ChanTypePointsConsumeReq1StringF4积分消费渠道0XXX电子渠道0001电子渠道网站0002 WAP1XXX合作伙伴的编码ConsumeTypePointsConsumeReq1StringF2积分用途01 积分兑换02 积分抽奖03 积分互换04 积分消费GoodsTypePointsConsumeReq1StringF2物品类型的编码01 通信类02 非通信类03 联盟类GoodsCodePointsConsumeReq?StringV20物品编码（兑换、消费类）(用于无订单方式，有订单时不用填写此字段)GoodsNamePointsConsumeReq?StringV64物品名称(用于无订单方式，有订单时不用填写此字段)GoodsNumPointsConsumeReq?StringV10物品数量(用于无订单方式，有订单时不用填写此字段)OrderSeqPointsConsumeReq?StringV30订单号（大订单号；无订单时不用填写）Para1PointsConsumeReq?StringV128备注，可不填现阶段扣减交易中，订单号为保留字段，可为空；回退交易中，订单号填写原交易流水号。目前积分扣减接口中产品描述不采用订单方式，产品信息直接填写在报文相应字段；未来对于复杂业务将采用订单方式，即将积分扣减与订单明细分开，本接口只用于积分扣减，订单详细信息通过订单发送。1.1.1.6 应答报文节点名称父接口名称约束类型长度说明PointsConsumeRspSvcCont1-EffectTimePointsConsumeRsp1String F14生效时间yyyyMMDDHH24MISSRespCodePointsConsumeRsp1StringF2应答码00 成功01客户积分值不够02 客户无积分03 用户不存在99其他原因，见结果描述当应答码为00，Head中的应答码填0000，表示交易完成，业务成功。当应答码非00，Head中应答码填2990，表示交易完成但是业务失败RespDesc PointsConsumeRsp?StringV256结果描述.给用户的提示信息，要简单明了ComsumePointsPointsConsumeRsp1StringV10实际扣减、回退积分RemainPointsPointsConsumeRsp1StringV10剩余积分1.1 总部H2接口方式1.1.1 包头数据包头格式：内容为一定长ASCII字符串（102位），具体内容如下：字段名称长度说明A0版本号信息（2位）标识当前使用的协议版本号（默认值：11）A1数据包大小（5位）以字节为单位，不足右补空格A2流水号（20位）业务流水号，标志每笔具体交易。数据校验包可以无流水号（发起方随机生成）A3标志（1位）1表示成功 0表示失败，仅适用于响应包A4服务类型（12位）（对应每个接口功能点的 服务类型）A5业务号码（20位）设备号码 (固话加区号,移网11位号码) (没有业务号码的时候A5设定一个定值 1300000000A, A6设定为G)A6业务号码类型（1位）G-GSM, D-宽带, F-固话, V- VPN集团, I-IP(VOIP),P-长途(193), Z-其他 (根据实际参数调整) 小灵通- LA7营业点（10位）业务受理地点根据4A生成规则受理部门编码A8营业员（20位）业务受理人根据4A生成规则员工编码A9包编号（5位）标志该笔流水的第几包数据（例如：第一个包 则传00001）A10最后一包标志（1位）在进行多包发送的情况下，该标志用以标明是否为最后一数据包。1最后一包数据，无后续包；0非最后一包数据，有后续包，连接错误，I/O错误等A11错误码（5位）在标志为失败时需要检查该错误码。错误码包括系统操作错误和业务处理错误（请求时：传 00000应答时：返回00000表示成功, 其他为失败,编码和描述参考每个功能点错误编码和错误描述）注：除A3标志是响应包必填项外，其它字段都是必填项，是定长1.1.2 包体定义一个数据包总长度不可大于4K。对存在多条返回记录的业务，一数据包可含多条记录。长度如超过4K，就以多包数据发送。每字段之间用“TAB键0x09”分隔，每记录之间用“回车键0x0d,0x0a”分隔，包结束用“0x1a”。对于不同的服务类型，其请求包和应答包的包体具有不同的内容。无论数据有无包体返回，一定需要添加包结束符。对于任何非正常返回的数据包应该没有包体，只有包头与包结束符。补空格原则：凡字段的数据表示的是金额的，既其字段类型是Number(10)的，这样的字段是左补空格，其它字段都是右补空格。简单产品变更【辽宁、山东、河南、河北、北京、黑龙江】接口描述简单产品变更。统一接口数据定义服务类型SSIMPLESERV请求包体：名称长度参数类型是否必填备注渠道接入密码10CharM此密码由BSS制定，接入渠道必填0123456789标志1CharMO开通C关闭特服代码/优惠代码/产品代码（20）CharM数据字典数据迁移后提供生效模式10CharNOW-立即生效NEXTMONTH-下月生效DELAY延迟生效延迟生效天数10Char暂不支持，默认填0预留50Char可空备注40Char可空应答无包体-
