《电子渠道综合业务分册v11_XXXX0427(正式下发稿).docx》由会员分享,可在线阅读,更多相关《电子渠道综合业务分册v11_XXXX0427(正式下发稿).docx(101页珍藏版)》请在三一办公上搜索。
1、 中国联通枢纽系统与省分BSS接口规范(综合业务分册)目录1.总体概述71.1.编制背景71.2.方案适用范围71.3.方案起草单位71.4.方案的解释权71.5.名词解释72.电子渠道业务支撑总体方案简介92.1.架构和功能说明92.2.枢纽与电子渠道接口112.3.枢纽与省分BSS112.4.省分功能描述113.枢纽平台基本概念介绍113.1.一级汇接枢纽逻辑体系结构113.2.联机交易参与方143.2.1.一级汇接枢纽143.2.2.机构143.3.业务143.3.1.业务属性153.3.2.编码规则163.3.3.业务与交易163.3.4.差错调整173.4.交易173.4.1.交易属
2、性173.4.2.编码规则193.4.3.交易流程203.5.消息结构213.5.1.Message Header223.5.2.Service Content263.6.接口实现机制263.6.1.通讯方式263.6.2.通信协议273.7.详单压缩机制274.系统流程控制描述274.1.正常流程274.2.异常处理流程294.2.1.发起方发送交易失败304.2.2.发起方报文格式错误304.2.3.枢纽无法路由314.2.4.报文未送达归属方334.2.5.归属方应答超时334.2.6.枢纽应答超时355.综合查询类联机接口365.1.综合客户资料查询365.1.1.业务描述365.1.
3、2.业务属性375.1.3.交易属性375.1.4.流程图375.1.5.请求报文385.1.6.应答报文395.2.综合帐户资料查询395.2.1.业务描述395.2.2.业务属性405.2.3.交易属性405.2.4.请求报文405.2.5.应答报文415.3.综合用户信息查询415.3.1.业务描述415.3.2.业务属性415.3.3.交易属性425.3.4.请求报文425.3.5.应答报文435.4.综合用户身份验证445.4.1.接口描述445.4.2.业务属性445.4.3.交易属性455.4.4.请求报文455.4.5.应答报文465.5.综合帐单查询465.5.1.业务描述4
4、65.5.2.业务属性465.5.3.交易属性465.5.4.请求报文475.5.5.应答报文475.6.综合账本查询485.6.1.业务描述485.6.2.业务属性485.6.3.交易属性495.6.4.请求报文495.6.5.应答报文505.7.综合通话费详单查询505.7.1.业务描述505.7.2.业务属性505.7.3.交易属性505.7.4.请求报文515.7.5.应答报文525.8.宽带上网详单查询535.8.1.业务描述535.8.2.业务属性535.8.3.交易属性535.8.4.请求报文535.8.5.应答报文545.9.综合当月实时话费查询545.9.1.业务描述555.
5、9.2.业务属性555.9.3.交易属性555.9.4.请求报文555.9.5.返回报文565.10.综合历史欠费查询565.10.1.业务描述565.10.2.业务属性565.10.3.交易属性565.10.4.请求报文575.10.5.应答报文576.综合缴费类联机接口586.1.固网缴费账号验证586.1.1.接口描述586.1.2.账号验证流程图596.1.3.业务属性606.1.4.交易属性606.1.5.请求报文606.1.6.应答报文616.2.固网缴费626.2.1.接口描述626.2.2.业务属性626.2.3.交易属性636.2.4.缴费流程636.2.5.请求报文656.
6、2.6.应答报文666.3.日对账676.3.1.业务描述676.3.2.省分对账处理676.3.3.对账文件格式687.综合受理类联机接口707.1.服务密码修改717.1.1.接口描述717.1.2.业务属性717.1.3.交易属性717.1.4.请求报文727.1.5.应答报文737.2.服务密码重置737.2.1.接口描述737.2.2.业务属性737.2.3.交易属性737.2.4.请求报文747.2.5.应答报文758.报文示例758.1.请求消息报文758.2.应答消息报文769.附录1779.1.渠道类型编码779.2.省分代码789.3.地市代码809.4.证件类型919.5
7、.系统应答类型以及应答代码9110.附录29710.1.详单压缩97文档信息 项目名称:电子渠道系统起草人:信息化部 文档版本编号:职位: 文档版本日期:2010-4-23复审人 复审日期:文档变更记录序号变更内容说明版本号版本日期执笔人0征求意见稿下发0.32010/4/201综合用户信息查询返回报文,可用积分、可用余额、客户名称、Vip级别名称四个字段对于未实现融合的北六省(北京、河北、河南、黑龙江、山东、辽宁),本期工程可以暂不返回。1.02010/4/222综合查询类联机接口修改接口业务和交易编码.综合客户资料查询修改为:BIP2J001、T2000901综合帐户资料查询修改为:BIP
8、2J002、T2000902综合用户信息查询修改为:BIP2J003、T2000903综合用户身份验证修改为:BIP2J004、T2000904综合账单查询修改为:BIP2J005、T2000905综合帐本查询修改为:BIP2J006、T2000906综合通话费详单查询修改为:BIP2J007、T2000907宽带上网详单查询修改为:BIP2J008、T2000908综合当月实时话费查询修改为:BIP2J009、T2000909综合历史欠费查询修改为:BIP2J010、T20009101.02010/4/223宽带上网详单返回报文中Fee改为非必填1.02010/4/224修改日对账文字描述1
9、.02010/4/225删除业务代码及交易代码表1.02010/4/226修改5.2帐户资料查询接口返回报文的AccRecordQueryReq为AccRecordQueryRsp1.02010/4/237删除5.4综合用户身份验证返回报文中的RespCode和RespDesc1.02010/4/2385.9当月实时话费查询请求报文AccProvince、AccCity、Code改为选填项1.12010/4/2795.10综合历史欠费查询应答报文将Para对应父节点由ArrearageRecordQueryRsp修改为ArrearageRecordQueryRsp1.12010/4/27106
10、.1固网缴费账号验证请求报文增加AccProvince、AccCity、Code项1.12010/4/27116.1固网缴费账号验证 缴费服务号码CustID修改为UserNumber1.12010/4/27126.1固网缴费账号验证业务属性修改为不对帐1.12010/4/27136.2固网缴费接口请求报文增加AccProvince、AccCity、Code项1.12010/4/27146.2固网缴费接口应答报文父节点名称PaymentRsq 为PaymentRsp1.12010/4/27157.2服务密码重置将AccProvince、AccCity、Code位置移动至NetType之后1.1
11、2010/4/27165.3综合用户信息查询应答报文根节点UserRsp约束为11.12010/4/27175.6综合账本查询应答报文根节点AcctBookRsp约束为11.12010/4/271. 总体概述1.1. 编制背景为了指导并规范中国联通电子渠道系统的建设,实现联通用户能够在电子渠道进行固网、移动业务的自助办理。1.2. 方案适用范围1.3. 方案起草单位1.4. 方案的解释权1.5. 名词解释名词与术语解释与说明一级枢纽在总部建设的实时交易平台,在本方案中,负责转发电子渠道系统和省分BSS/营帐系统之间的缴费请求及应答。机构连接到枢纽的各应用系统(也称为应用域接入系统),称为接入机
12、构,可以是各省分BSS、各种业务平台、全国性合作伙伴的应用系统等。发起端机构发出某交易请求的机构; 落地端机构执行交易请求的机构,它执行某交易的请求并给出应答; 交易一次由发起方机构发起,由交换中心转接,并由落地方机构接受并处理的业务操作。交换中心也可以作为某些交易的发起方和落地方。联机交易交易的请求与应答采用联机消息的方式在交换中心与机构之间传递,实时性强。联机交互类交易此类交易由发起方发起,交换中心收到后转发给落地方,由落地方机构给出应答,交换中心收到该应答后再转发给发起方。联机交互类交易又叫做“大圈类”交易。冲正由交易发起方或SC发送给落地端机构,旨在要求落地端机构对某原交易执行逆操作的
13、联机交易;冲正是一种特殊的交易;落地端机构处理冲正请求后,可以应答成功或失败。冲正是指由应用软件系统自动发起的交易。中心逻辑交易日期交换中心对每一笔其经手的交易都赋予一个逻辑交易日期,用于在对帐或清算时圈定要处理的交易的范围。日期切换(日切)交换中心在每天的规定时刻进行逻辑交易日期的更新,使逻辑交易日期切换到下一天。对帐交换中心和与其发生交易关系的每个机构,对特定时间范围内(一个逻辑交易日)发生的,每一种需要对帐的交易类型进行笔数和金额(本金总额)的核对的过程称为对帐。对帐操作是交换中心和机构之间发生的,各个机构之间不直接进行对帐。签到/签退接入机构在初次接入的时候发出签到请求进行注册,表明开
14、始正式接入一级汇接枢纽。接入机构有计划的切断与一级汇接枢纽的连接时,应发出签退请求,表明暂不能受理各类业务。待再次接入时,重新进行签到注册。路由、路由类型、路由关键字交换中心判断交易的落地方是谁的过程。路由类型是指以什么标准来判断落地方。路由关键值是指用来判断落地方的数据。业务流水号是指对一项业务处理过程的统一序号。一个业务中的多个交易具有相同的业务流水号。交易流水号是指一个交易的序号。一个业务中如果有多个交易,则各个交易的流水号不同。2. 电子渠道业务支撑总体方案简介2.1. 架构和功能说明 电子渠道业务支撑建设方案如上图所示。电子渠道系统通过一级汇接枢纽与各省分BSS系统进行电子渠道交易类
15、业务交互。交易类业务通过枢纽实现,采用HTTP+XML协议。电子渠道业务支撑体系中涉及到的系统定位如下:1总部电子渠道系统:作为电子渠道业务的受理方与发起方,向一级汇接枢纽分别发起业务查询和业务受理请求,并由枢纽接收来自省分BSS系统业务查询和业务受理结果。端到端整体系统业务流程逻辑控制由电子渠道系统负责。电子渠道系统负责佣金结算、分省结算。2总部一级汇接枢纽:一级汇接枢纽和总部电子渠道系统、省分BSS系统通过HTTP协议通信,总部电子渠道系统向一级汇接枢纽提交业务查询和受理请求,一级汇接枢纽将相应的请求路由到省分BSS系统。一级汇接枢纽与省分BSS系统通过冲正、重发等机制,保证电子渠道业务交
16、易的完整性。电子渠道业务交易成功后,一级汇接枢纽自动保存交易记录。3省分BSS系统:与一级汇接枢纽相连,从一级汇接枢纽接收来自总部电子渠道系统的业务查询与业务受理请求,并进行业务查询与业务处理,向一级汇接枢纽返回查询与处理结果。2.2. 枢纽与电子渠道接口1. 枢纽为电子渠道单独部署一个节点来处理其业务请求。2. 枢纽与电子渠道采用webservice/HTTP接口同步连接方式,由电子渠道发起请求,枢纽将请求转发给归属省处理,并将归属省分的应答在原web servic俄/HTTP 连接上返回给电子渠道系统。2.3. 枢纽与省分BSS1省分BSS接入到枢纽省分物理节点,枢纽系统向省分BSS PO
17、ST HTTP请求。2. 枢纽与省分BSS之间采用HTTPXML协议方式。3. 枢纽与省分BSS间的接口格式见下文章节。2.4. 省分功能描述省分BSS通过开发接口和改造后台功能实现对电子渠道业务的支撑3. 枢纽平台基本概念介绍3.1. 一级汇接枢纽逻辑体系结构图表 31 一级汇接枢纽逻辑体系结构一级汇接枢纽包括交换中心、交换节点两级体系结构。交换节点与交换中心相连接,组成了以交换中心为核心的星型拓扑网络。交换中心交换中心部署在总部,是一级汇接枢纽的核心部分,它完成了枢纽负责的主要工作。包括联机交易处理系统、文件传输与处理系统、清算系统、系统管理与监控四大应用子系统。联机交易处理系统是整个交换
18、中心的核心,处理来自接入层的交易请求,对交易进行实时转接。文件传输与处理系统提供对业务数据文件采集、分析、校验、下发等功能。清算系统负责对各接入系统之间的交易进行清分、对帐等。 管理与监控系统提供接入机构管理、权限管理、系统参数管理、运行状态监控及告警等功能。l 交换节点交换节点负责接入各个机构,进行报文格式转换、校验和必要的协议转换工作。根据部署的位置和接入机构的不同,可划分为两类。总部交换节点部署在总部,负责总部相关系统(CRM、PRM、VASP、电子渠道等)的接入。省分物理交换节点部署在省分,负责省分BSS系统的接入。交换节点具备如下功能:l 联机处理转接交换节点提供与接入系统的连接功能
19、,完成接入系统与一级汇接枢纽系统之间的通信。包括:接入系统做为发起方,接入系统做为落地方两种联机处理类型。l 屏蔽省内部系统的复杂性格式转换: 通过适配器框架将省BSS发出的格式消息转换成为交换系统内部格式消息。接入系统配置变化不对交换中心产生影响。交换中心的变化不对接入系统产生影响。l 格式校验负责对接入系统上发的请求消息和应答消息做格式校验。l 流量控制能够根据交换节点自身的交易处理情况,进行流量检测和控制。防止交易风暴对交换中心的冲击。l 执行预处理(或后处理)逻辑按照配置执行相应的预处理逻辑(在上发交换中心之前)或后处理(在转发落地方之前)3.2. 联机交易参与方3.2.1. 一级汇接
20、枢纽一级汇接枢纽,负责请求和应答报文的转发(分为直接转发和存储转发两种方式)以及交易处理的核对、统计等工作。枢纽在实现上包括交换中心(SC)和交换节点(SN)两个部分。交换中心是枢纽的核心部分,它完成了上述枢纽负责的主要工作;交换节点负责接入各个机构,进行格式转换、校验和必要的预处理/后处理工作。机构在接入枢纽时需要明确自己要接入的交换节点,在整个交换系统内每个交换节点具有自己的唯一标识(称为DUNS)。3.2.2. 机构机构作为交易的发起方和落地方与枢纽相连进行交易和对帐操作,即机构作为交易和对帐的单位实体与一级汇接枢纽进行交互。机构需要经过交换节点进行连接,一级汇接枢纽需要靠机构所接入的交
21、换节点来定位机构。机构在整个交换系统中根据运行时刻所扮演的角色不同,可以分为发起方机构和落地方机构,这是一个逻辑概念。交换中心在某些交易中既可以作为发起方、也可以作为落地方。3.3. 业务业务是指中国联通在运营过程中向客户以及外部系统提供的功能,如“一卡充充值业务”、“绿色通道服务业务”等。一级汇接枢纽的目的是通过连接漫游地以及归属地系统的方式建立起异地业务处理平台,为了保证技术实现和业务处理的一致性,在联机处理中“业务”作为参与处理各方的处理单位,每个业务在实际处理过程中可能会包括多次的联机交互处理过程,这些过程按照规定的顺序组织起来完成特定的业务功能。以“一卡充充值”业务为例,完成此业务功
22、能可能会包含:卡鉴权、号码验证、卡扣款、缴费四个操作。3.3.1. 业务属性在对业务进行定义时,需要有属性以保证参与业务处理的各方在处理上保持一致性和完整性。业务属性的定义是从全网异地业务的角度出发,进行统筹考虑,业务属性的定义如下:1. 手续费:是指向客户收取的办理某项业务的人工费用。当收取手续费时,一般是在客户归属地帐户上作为一次性费用记帐;属性值为收取规则。2. 冲正处理:是由系统在处理超时情况下自动发起的差错处理手段,用于保证受理方、全国中心、归属方之间业务的完整性、准确性;属性值为是否需要枢纽发起冲正(指由枢纽自动发起的存储转发类冲正);不允许冲正前一个逻辑交易日的交易。3. 人工冲
23、正处理:人工冲正处理是指应客户要求或者人工操作失误而对该客户已经受理成功的某项业务的复原交易。人工冲正处理是一笔新的交易,相当于对原办理业务的逆操作;人工冲正处理有时限约束,一般在一个交易日内的交易才允许作人工冲正,否则只能以其逆操作进行另一笔新业务。属性值为是否支持人工冲正。4. 安全性要求:是指对于客户密码、缴费卡密码等客户私有信息以及交易报文或者报文中的关键信息项在传输过程中的保密要求;取值为是否加密;另外为保证在传输过程中关键数据如金额和缴费卡号码、客户身份数据的防篡改,可以对这些数据进行摘要,属性取值为报文中需要进行摘要的字段。5. 清分结算:是指对业务受理过程中产生的、需要在业务发
24、起方、落地方及全国中心之间进行转移或分配的费用的核对,内容包括手续费、客户办理业务的本金(如缴纳的手机话费)、押金和交易笔数;取值为是否参与清分结算。6. 对帐:是指对业务受理过程中涉及到用户费用、用户状态等关键数据变更的交易的核对。取值为是否参与对帐。7. 发起方DOMAIN:是指允许发起此业务的应用域,如UCRM,UPAY,VASP;取值为应用域列表。8. 落地方DOMAIN:是指允许接收此业务的应用域,如UCRM,UPAY,VASP;取值为应用域列表。3.3.2. 编码规则业务编码组成格式为:BIP【CLUSTER】【SEGMENT】【CODE】包含四个部分:1、固定头“BIP”表示BS
25、S交互流程(Bss Interaction Process);2、一位簇代码【CLUSTER】表示业务功能类型;3、一位段代码【SEGMENT】表示业务操作类型;4、三位业务代码【CODE】标识业务。业务代码取值以及含义如下,随着业务的不断开展,编码取值将随之增加:簇代码簇代码描述段代码段代码描述0系统以及管理类业务A差错处理类B密钥管理类C机构管理类1一卡充业务A查询类B缴费类C数据同步类1电子渠道缴费类C缴费类例如,异地卡信息查询,属于一卡充查询类业务,为其指定顺序号为001,则异地卡信息查询为:BIP1A0013.3.3. 业务与交易业务在执行时,被拆成一个或多个交易。以 “一卡充充值”
26、业务为例,包含“缴费卡鉴权”、“号码验证”、“缴费卡扣款”、“缴费”几个步骤,每个步骤都是一次请求/应答的过程,即一个交易。同一个交易可以在不同的业务中与其他交易一起共同完成特定的业务功能。在运行时刻属于同一个业务的交易使用相同的“业务流水号”关联起来形成一次业务处理,因此,在处理过程中对业务的处理实际都体现在了处理其所包含的交易上,即业务属性包括交易的属性。3.3.4. 差错调整业务的属性中有两个属性用于表示如何解决在此业务联机处理过程中产生的问题和差错,即冲正、对帐。实际上这两个属性是分别由两个与其同名的业务过程(冲正、对帐)完成处理。3.4. 交易交易是一次处理请求和应答的交互过程,一次
27、由发起方机构发起,由枢纽转接,并由落地方机构接受并处理后产生应答再次经由枢纽返回给发起方的过程,在交换系统中支持两种类型的交易流程,大圈类型和存储转发类型,具体参见下文中对交易流程的描述。3.4.1. 交易属性交易属性指导交易处理的参与方对交易的处理方式,见下表:名称描述取值备注交易类型交易的处理流程类型0009:大圈类流程1019:通知类流程20:存储转发类冲正类流程21:大圈类冲正流程总超时时间发起方机构在发出交易请求后,最长等待枢纽应答的时间间隔;所有交易使用共同取值整数以秒为单位, 对于大圈类交易总超时时间为枢纽超时时间加上一个特定的值发起方机构在超时后对于大圈类型交易如果有需要冲正属
28、性,则发起冲正并向用户告知超时错误,若没有需要冲正属性则向用户告知超时错误,不发起冲正。重试间隔时间通知和存储转发类冲正交易的重试的时间间隔以秒为单位,枢纽系统当前为300秒所有交易使用共同取值需要冲正对于大圈类交易,为避免交易参与三方不一致的情况发生,在超时后,上游节点向下游节点需要发起冲正交易的标志0:不需要冲正1:需要冲正,不允许枢纽自动发起冲正2:需要冲正,允许枢纽自动发起冲正一般来讲,对于在超时后不会造成不一致情况的交易,如查询等则不需要冲正。对于取值为1、2的情况,落地方必须实现冲正处理对帐标记标识此类交易在日终后是否参与核对0:不参与对帐1:参与对帐需要对交易涉及的金额和发生笔数
29、进行对帐。本金方向交易中的本金的流动方向0:没有本金1:发起方落地方(存现金类型交易)2:落地方发起方(支取现金类交易)3:落地方落地方(本地转帐类型交易)有些交易在定义时已经明确,有些是在交易时决定,此时标记将出现在请求报文的Service Content中。手续费清分方法在发生交易手续费时,手续费的摊分算法,在对帐时使用当前手续费不进行摊分手续费总额由发起方计算并告知客户,金额从用户在落地方的帐户中扣除。安全性密码加密交易请求报文中的密码是否需要进行加密操作0:不需要1:需要安全性字段级防篡改对于交易请求报文的某些字段是否需要进行防篡改处理,即进行校验在报文中字段的XPATH列表校验码生成
30、时使将各个字段合并,进行SHA摘要发起方机构DOMAIN可以作为发起方机构的应用域类型列表UCRMUPAYVASP 对应于报文中的OrigDomain字段落地方机构DOMAIN可以作为落地方机构的应用域类型列表UCRMUPAYVASP 对应于报文中的HomeDomain字段路由类型此交易可以使用的路由类型列表,路由数据是指枢纽用于找到落地方交换节点的数据,包括类型和值两部分00:落地方代码01:手机号02:卡号发起方可根据自己的需要在需要处理交易允许的路由类型列表中进行动态选择图表 32 交易属性3.4.2. 编码规则交易编码格式为:T【CLUSTER】【PROC TYPE】【RECON TY
31、PE】【CODE】包含五个部分:1、固定头“T”表示交易(Transaction);2、一位簇代码【CLUSTER】在此表示业务功能类型,与业务编码相同;3、两位处理类型代码【PROC TYPE】,表示交易流程类型;4、一位对帐类型代码【RECON TYPE】表示此交易是否参与对帐;5、三位业务代码【CODE】标识交易。当前交易的代码取值以及含义如下,随业务的不断的开展编码取值将随之增加:代码名称取值描述备注处理类型0009大圈类交易根据处理过程不同,会细分大圈类流程,当前对于在中心落地为“01”,由中心发起的标识为“02”,支持重发的大圈交易标识为“03”1019通知类交易根据处理过程不同,
32、会细分通知类流程,对于中心落地的为“11”;对于中心发起的为“12”20存储转发类冲正交易枢纽接收到此类交易后,先存贮在本地的存储转发表中,同时直接给发起方应答。稍后由后台处理进程从存贮转发表提取冲正任务再向落地方转发。此操作为异步冲正操作21大圈类冲正交易枢纽接收到此类交易后,直接转发到落地方,并将落地方应答转发给发起方。此操作为同步冲正操作。一卡充卡扣款的冲正操作使用此类交易对帐类型0不参与对帐1参与对帐例如,“一卡充充值卡扣款”交易属于一卡充业务,是可重发的大圈类交易,并且参与对帐,为其指定顺序号为005,则交易的编码为:T1031005。3.4.3. 交易流程为了方便地描述各种交易的特
33、点及其处理过程,我们将所有交易进行分类,有助于准确把握各种交易的处理过程。按照给出交易初始应答的节点来分,可以把交易分成“大圈类”和“存储转发类”交易。大圈类交易的含义是:落地方在接到请求处理完成后给予处理结果作为应答,返回给发起方,而发起方则需要等待处理结果,对于需要冲正的交易超时后需要冲正处理;存储转发类交易的含义是:发起方将请求发给下游节点,下游节点接到后只是给予其确认应答,处理结果不返回,上游节点认为处理结果必须成功,如果发起方没有接到下游接点的确认应答,则重发请求。1.1.1.1 大圈类流程大圈类交易具有如下特性: 大圈类交易的初始应答由交易的落地方机构给出,只有落地方机构才能确定该
34、交易是否执行成功;通常情况下,交换中心只是在交易的发起方和落地方之间转发请求和应答; 在传递本类交易的请求时,上游节点(发起端机构/交换中心)必须进行超时控制。若发起端机构或交换中心发现一笔大圈类交易超时,则向上游节点返回超时的应答。对于支持使用原交易流水号重发的交易(如:卡扣款、缴费、组合充值交易)上游节点重发该请求(重发请求的业务流水和交易流水必须和原交易保持一致)。1.1.1.2 存储转发类流程由于参与交易各方之间为广域网联接,而且各参与方系统是独立管理,交易是否可以正常送达有一定的不可预见性。为了保证请求消息能够到达,我们采用存储转发方式。存储转发是指当下游节点不可及或者未正常应答时,
35、上游节点将消息报文存储起来,定时发送,直到下游节点返回确认应答的机制。因此,作为上游节点的发起方机构或一级汇接枢纽都要实现存储转发功能。存储转发类流程和大圈类流程的区别是,发起交易时只是将请求消息记录进入存储转发库,由另外的进程异步向下游节点转发消息,不等待应答消息;而大圈类交易则必须等待应答。3.5. 消息结构交易在机构和枢纽之间的消息(包括请求和应答)是以XML格式表达的。消息包括两个部分:Message Header(消息头)与Service Content(交易业务内容);其中Message Header用于存储交易请求以及应答的公共部分和消息的控制数据,而Service Conten
36、t作为Message Header的最后一个Element(元素),包含交易请求和应答的业务数据。在本文档中以表格的形式表示XML格式;以下为表格中对元素约束(出现次数)的表示方法的描述:符号含义?0.1,可选项*0.n,可以没有,也可以有多项+1.n,至少有1项,也可以有多项1数字1,代表必须且只能填1项表格中关于数据长度的描述: Fx表示数据是指定x位长的。Vx表示数据是变长的,最长为x位长。3.5.1. Message Header根据XML的定义,每个XML文件需要有特定的Root Tag (根标记),在一级汇接枢纽 Header的Root Tag为“UniBSS”.各个字段解释如下表
37、,各机构在实现时可使用枢纽定义下发的XSD文件:序号父元素名称元素名称约束类型长度描述取值说明1UniBSSOrigDomain1StringF4发起方应用域代码参见应用域编码表2UniBSSHomeDomain1StringF4归属方应用域代码参见应用域编码表,发起方填写3UniBSSBIPCode1StringF8业务功能代码参见业务交易代码表4UniBSSBIPVer1StringF4业务流程版本号0100;对于同一交易应答与请求版本号始终一致5UniBSSActivityCode1StringF8交易代码参见业务交易代码编码表6UniBSSActionCode1StringF1交易动作
38、代码0:请求,1:应答7UniBSSActionRelation1StringF1交易关联性与其他交易关联;0:无关联;1:有关联。例如:在一卡充系统中对于异地卡充异地用户且卡和帐号归属不同省时接入省分缴费卡系统发送的扣款请求和缴费请求交易需要设置此标记为18UniBSSRouting1路由信息8.1RoutingRouteType1StringF2路由类型参见路由类型编码,如按手机号码路由等8.2RoutingRouteValue1StringV60路由关键值路由类型对应的关键值,参见路由类型说明。如路由类型为手机号码则此字段应填写手机号码;若路由类型为充值卡号码则此字段应填写充值卡号码9U
39、niBSSProcID1StringV30发起方业务流水号发起方填写的包含此交易业务的流水号10UniBSSTransIDO1StringV30发起方交易流水号在发起方唯一标识一个交易的流水号,系统内唯一11UniBSSTransIDH?StringV30归属方交易流水号请求中不填,由落地方在应答中填,系统内唯一12UniBSSProcessTime1StringF14处理时间YYYYMMDDHHMISS请求中此字段由发起方填写,内容为发起方处理时间应答中此字段由落地方填写,内容为落地方处理时间13UniBSSResponse?应答/错误信息请求中不填,应答中填13.1ResponseRspT
40、ype1StringF1应答/错误类型应答或错误类型,参见应答/错误类型表13.2ResponseRspCode1StringF4应答/错误代码应答或错误代码,参见应答/错误代码表13.3ResponseRspDesc1StringV128应答/错误描述应答或错误描述14UniBSSSPReserve?一级枢纽保留信息落地方在接到请求时、发起方在接到应答时读取14.1SPReserveTransIDC1StringV60一级枢纽交易流水号由交换中心填写14.2SPReserveCutOffDay1StringF8逻辑交易日格式:yyyymmdd,清分对帐用,由交换中心填写。14.3SPRese
41、rveOSNDUNS1StringF4发起方交换节点代码参见全国交换节点编码表,由交换中心填写14.4SPReserveHSNDUNS1StringF4归属方交换节点代码参见全国交换节点编码表,由交换中心填写14.5SPReserveConvID1StringV60交换中心处理标识最后的17位为枢纽的处理时间,YYYYMMDDHHMISSsss精确到毫秒15UniBSSTestFlag1StringF1测试标记发起方填写,0:非测试交易,1:测试交易;需要注意的是测试必须是业务级别,即在同一个业务流水中所有交易必须具有相同的测试标记16UniBSSMsgSender1StringF4消息发送方
42、代码发起消息的应用系统代码,参见系统代码表17UniBSSMsgReceiver1StringF4消息直接接收方代码该消息送往的下一方代码,一般是交换节点代码18UniBSSSvcContVer1StringF4业务内容报文的版本号0100,对于同一交易应答与请求版本号始终一致19UniBSSSvcCont1String请求/应答内容XML格式的字符串,以CDATA区表达图表 33 UniBSS报文格式发起方业务流水与发起方交易流水的关系如下:交易流水必须唯一,业务流水可以重复。例如:客户使用异地卡充值本地号码业务时,卡鉴权交易流水和卡扣款交易流水为两个不同的交易流水号,而由于这两笔交易属于同一个业务操作,所以他们的业务流水是一致的。【各种情况流水字段的填写说明】l 正常交易流水类型填写说明备注发起方业务流水每个业务操作用唯一的流水标识。流水号由发起方自行定义并填写发起方交易流水每笔交易使用唯一的流水标识。流水号由发起方自行定义并填写交易流水号不能重复落地方交易流水流水号由落地方自行定义并填写交易流水号不能重复枢纽流水流水号由枢纽系统自行定义并填写交易流水号不能重复举例:以异地卡充值为例本地客户A使用异地卡给本机充值