一级BOSS与业务平台接口规范
2.2.1. 编码规则
业务编码格式为:
BIP【CLUSTER】【SEGMENT】【CODE】
包含四个部分:
1、 “BIP”是前缀,固定;
2、一位簇代码【CLUSTER】表示业务功能类型; 3、一位段代码【SEGMENT】表示业务操作类型; 4、三位业务代码【CODE】标识序号。
业务代码取值以及含义如下,随着业务的不断开展,编码取值将随之增加:
簇代码 0 簇代码描述 段代码 A B C 段代码描述 差错处理类 密钥管理类 机构管理类 查询类 状态更新类 查询类 状态更新类 系统以及管理类业务 2 3 4 客服枢纽业务 鉴权枢纽业务 业务数据管理业务 A B A B 2.3. 交易
交易是一次处理请求和应答的交互过程,分为大圈和存储转发两种类型,其中存储转发类流程包括通知类流程和冲正流程。
2.3.1. 交易属性
交易属性指导交易处理的参与方对交易的处理方式,见下表: 名称 交易类型 描述 交易的处理流程类型 发起方机构在发出交易请求后,最长等待一级BOSS应答的时间间隔;所有交易使用共同取值 00-09:大圈类流程 10-19:通知类流程 20:冲正类流程 整数以秒为单位,对于大圈类交易总超时时间为一级BOSS超时时间加上一个特定的值,当 备注 总超时时间 发起方机构在超时后对于大圈类型交易如果需要冲正,则发起冲正并向用户告知超时错误,若不需要冲正则向用户告知超时错误,不发起中国移动通信公司 5
一级BOSS与业务平台接口规范 名称 取值 描述 取值 前所有交易一致定义为180秒 以秒为单位,当前为300秒 备注 冲正。对于冲正或通知类交易则再次发起同一交易给一级BOSS。 所有交易使用共同取值 重试间隔时间 通知和冲正交易的重试的时间间隔 冲正 对于大圈类交易,为避免交易参与三方不一致0:不需要冲正 的情况发生,在超时后,1:需要冲正 上游节点向下游节点需要发起冲正交易的标志 一般来讲,对于在超时后不会造成不一致情况的交易,如查询等则不需要冲正。 金额类交易需要对金额和发生笔数进行对帐,对状态更新类需要对笔数进行对帐,对于大圈类交易对帐和冲正标志一般是一致的,即参与对帐就需要冲正,反之亦然。 校验码生成时使将各个字段合并,进行SHA摘要 对帐标记 标识此类交易在日终后是否参与核对 0:不参与对帐 1:参与对帐 安全性 密码加密 安全性 字段级防篡改 发起方机构DOMAIN 落地方机构DOMAIN 交易请求报文中的密码0:不需要 是否需要进行加密操作 1:需要 对于交易请求报文的某在报文中字段的些字段是否需要进行防XPATH列表 篡改处理,即进行校验 可以作为发起方机构的应用域类型列表 可以作为落地方机构的应用域类型列表 此交易可以使用的路由类型列表,路由数据是用于找到落地方的数据,包括类型和值两部分 BOSS,RADIUS,DSMP BOSS,RADIUS,DSMP 00:落地方省或业务管理平台(业务平台)、一级BOSS代码 01:手机号 路由类型 发起方可根据自己的需要在需要处理交易允许的路由类型列表中进行动态选择 2.3.2. 编码规则
交易的编码格式为:
T【CLUSTER】【PROC TYPE】【RECON TYPE】【CODE】
包含五个部分:
1、固定头“T”表示交易(Transaction);
2、一位簇代码【CLUSTER】在此表示业务功能类型,与业务编码相同; 3、两位处理类型代码【PROC TYPE】,表示交易流程类型; 4、一位对帐类型代码【RECON TYPE】表示此交易是否参与对帐; 5、三位业务代码【CODE】标识交易。
中国移动通信公司 6
一级BOSS与业务平台接口规范
当前交易的代码取值以及含义如下,随业务的不断的开展编码取值将随之增加:
代码名称 取值 00-09 处理类型 10-19 20 对帐类型 0 1 通知类交易 冲正交易 不参与对帐 参与对帐 描述 大圈类交易 备注 根据处理过程不同,会细分大圈类流程,当前对于在一级BOSS落地为“01”,由一级BOSS发起的标识为“02” 根据处理过程不同,会细分通知类流程,对于一级BOSS落地的为“11”;对于一级BOSS发起的为“12” 2.3.3. 交易流程分类
为了方便地描述各种交易的特点及其处理过程,我们将交易分成“大圈类”和“存储转发类”交易。
2.3.3.1. 大圈类交易流程
大圈类交易具有如下特性:
? 大圈类交易的初始应答由交易的落地方机构给出,只有落地方机构才能确定该
交易是否执行成功;
? 本类交易可以有相应的冲正;
? 在传递本类交易的请求时,如果该交易涉及数据异动,则上游节点需要进行超
时控制,在交易超时时,向上游节点返回失败的应答,同时向下游节点发起冲正。
2.3.3.2. 存储转发类流程
存储转发是指上游节点将消息报文存储起来,定时发送,直到下游节点返回确认应答的机制。存储转发类流程包括通知和冲正流程两类。
由于发起方无法得到落地方机构的执行应答,在进入存储转发库时已经认为此交易为成功,因此通知类交易是必须被落地方执行成功的交易。
中国移动通信公司 7
一级BOSS与业务平台接口规范
2.4. 消息结构
交易消息(包括请求和应答)是以XML格式表达的,包括两个部分:Message Header(消息头)与Service Content(交易业务内容)。其中,Message Header用于存储交易请求以及应答的公共部分和消息的控制数据,而Service Content作为Message Header的最后一个Element(元素),包含交易请求和应答的业务数据。在本文档中以表格的形式表示XML格式,以下为表格中对元素约束(出现次数)的表示方法的描述:
符号 ? * + 1 0..1,可选项 0..n,可以没有,也可以有多项 1..n,至少有1项,也可以有多项 数字1,代表必须且只能填1项 含义 另外,报文格式中“F”指固定长度,“V”表示变长。
本规范中所规定的报文数据格式,除了在取值说明栏中有特殊说明的外,均适用于DSMP、RADIUS等业务管理平台(业务平台)。
2.4.1. Message Header
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在Message Header的Root Tag为“InterBOSS”。
各个字段解释如下表。
中国移动通信公司 8
一级BOSS与业务平台接口规范 序号 1 2 3 4 5 6 7 7.1 7.2 8 9 10 11 12 12.1 12.2 12.3 13 13.1 13.2 13.3 13.4 13.5 14 15 父元素名称 InterBOSS InterBOSS InterBOSS InterBOSS InterBOSS InterBOSS InterBOSS Routing Routing InterBOSS InterBOSS InterBOSS InterBOSS InterBOSS Response Response Response InterBOSS SPReserve SPReserve SPReserve SPReserve SPReserve InterBOSS InterBOSS 元素名称 OrigDomain HomeDomain BIPCode BIPVer ActivityCode ActionCode Routing RouteType RouteValue ProcID TransIDO TransIDH ProcessTime Response RspType RspCode RspDesc SPReserve TransIDC CutOffDay OSNDUNS HSNDUNS ConvID TestFlag MsgSender 约束 1 1 1 1 1 1 1 1 1 1 1 ? 1 ? 1 1 1 ? 类型 String String String String String String — String String String String String String — String String String — String String String String String String String 长度 4 4 8 4 8 1 - 2 20 V30 V30 V30 14 - 1 4 V60 8 4 4 V60 1 4 描述 发起方应用域代码 归属方应用域代码 业务功能代码 业务流程版本号 交易代码 交易动作代码 路由信息 路由类型 路由关键值 业务流水号 发起方交易流水号 归属方交易流水号 处理时间 应答/错误信息 应答/错误类型 应答/错误代码 一级BOSS保留信息 一级BOSS交易流水号 日切点 发起方交换节点代码 归属方交换节点代码 一级BOSS处理标识 测试标记 消息发送方代码 参见应用域编码表 参见应用域编码表 参见业务交易代码表 0100;对于同一交易应答与请求版本号始终一致 参见业务交易代码编码表 0:请求,1:应答 参见路由类型编码,如按手机号码路由等 路由类型对应的关键值,参见路由类型说明 发起方填写的包含此交易业务的流水号 在发起方唯一标识一个交易的流水号,系统内唯一 请求中不填,由落地方在应答中填,系统内唯一 发起方发起请求的时间/应答方处理请求的时间 YYYYMMDDHHMMSS 请求中不填,应答中填 应答或错误类型,参见应答/错误类型表 应答或错误代码,参见应答/错误代码表 应答或错误描述 落地方在接到请求时、发起方在接到应答时读取 格式:yyyymmdd,清分对帐用 参见全国交换节点编码表 参见全国交换节点编码表 只有一级BOSS使用 发起方填写,0:非测试交易,1:测试交易;测试必须是业务级别,即在同一个业务流水中所有交易必须具有相同的测试标记 发起消息的应用系统代码,参见系统代码表 取值说明 V128 应答/错误描述 1 1 1 1 1 1 1 中国移动通信公司 9