中国移动通信有限公司
一级BOSS枢纽系统接口规范农信通业务单行本
(V1.5.4)
中国移动通信集团公司
二○○八年十一月
文档变更记录
目录
1.综述
1.1.一级BOSS总体架构
农信通平台接入一级BOSS枢纽系统须遵循一级BOSS的技术规范和系统管理要求,详情见1.3参考文档的《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5.doc》。
1.2.系统管理
农信通平台需要实现的系统管理交易见下表:
1.3.机构系统编码
农信通平台的机构系统编码表如下:
DOMAIN 点
0026 RINP 0000 农信通平台
1.4.参考文档
《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5.doc》
2.农信通平台与一级BOSS枢纽实时接口
2.1.农信通业务简介
中国移动通信农村信息网整合移动网络、数据网络和互联网等资源,通过IVR电话语音服务、手机短信、WEB网站、农村信息机等多种方式,将政府农业部门、农业科研机构、农业院校、涉农企业、信息服务站提供的农业信息及时传递到农民的手中,彻底解决农村信息来源和信息传输的“最后一公里”问题,促进农业信息有效传播。通过农信通平台,能够让农村政策、农业法律法规、市场信息及科技信息及时送达农民,为现代化农业管理提供农政、农商、农技、农贸、市场供求、农业气象、病虫害预警等方面信息,为发展农副产品基地化、多种经营规模化、优质农产品市场化的现代农业模式提供优质信息服务。通过农信通平台,联合需求部门,提供劳动力、务工等相关信息供用户查询、点播和定制。通过农村信息平台的服务热线对农民进行一对一信息查询和专家咨询服务。
目前现网将会将业务受理过程进行改造,全国农信通平台将会直接连接一级BOSS,然后由一级BOSS连接各省BOSS,短信通道平台直接连接有限公司行业网关A模块,然后由有限公司行业网关A模块连接各省行业网关A模块。
12582农信通百事易产品依托现有农村信息网平台实现,由重庆物联网基地建设并运维,一点建设服务全网。12582农信通百事易产品通过短信方式计费,由农信通平台通过北京梦网网关下发的短信、彩信服务信息,用户通过短信、彩信接收和查看。12582农信通百事易产品平台和总部一级业务支撑系统(一级BOSS、内容计费系统、总部BBOSS系统)连接,实现用户管理和计费结算功能。
农信通平台:China Mobile Rural Information Network,简称:RINP
A省行业网关
有限公司行业网关
B省行业网关
农信通平台
A省业务
支撑系统
B省业务支
撑系统
现有产品短信通道
管理通道
话单
A省梦网网关
北京梦网网关
B省梦网网关
话单
百事易产品短信通道
一级业务支撑系统
2.2.农信通业务的订购、退订
2.2.1.业务功能
农信通业务订购、退订接口是由农信通平台业务向业务归属省BOSS发起的订购、退订请求,旨在请求省BOSS在BOSS侧为用户完成与农信通业务相关的订购产品/退订产品等业务操作。适用于单个用户主动发起的订购、退订操作。
2.2.2.业务约束
1、业务受理渠道
农信通平台侧的业务受理渠道目前为:12582、STK、WAP、IVR、WEB
2、业务开放范围
本业务在全国31个省范围内面向中国移动手机用户开放。
3、开通模式
本业务开通模式为同步模式,即客户申请后农信通平台根据交易应答立即告知客户受理结果。
4、订购关系说明
本业务(包月业务)在首次订购后的72小时之内免费。
5、其它说明
本规范仅描述省BOSS与一级BOSS交换枢纽、农信通平台间的接口操作,包括其功能、流程和相关交易的接口报文定义。
2.2.
3.业务流程
省BOSS流程:
退订无需短信二次确认流程。
2.2.
3.1.农信通平台业务流程
订购流程:
●短信订购:
?用户发送业务代码到农村信息网(经过行业网关转/百事易产品经过北京梦网网关转);
?农村信息网根据用户的地域属性和业务代码,转换为产品代码,向一级BOSS转发订购请求;
?一级BOSS根据用户的归属地,向省BOSS转发订购请求;
?省BOSS收到业务申请后首先进行用户状态检查、订购关系检查并通过订购渠道判断需要向用户下发二次确认短信,省BOSS答复需要二次确认(应答报文二级应答码BizOrderResult的值为80),一级BOSS转发应答消息给农村信息网;农信通平台生成临时订购关系,根据省BOSS订购关系同步报文中的平台操作流水号最终生成正式订购关系。
在数据一致性比对时,可以使用省BOSS应答消息报文头中的处理时间作为比对时间。
●网站、语音订购:不需要短信确认
?用户、话务员选择区域和该区域下的产品名称;
?农村信息网根据地域属性和产品名称,转换为产品代码,向一级BOSS转发订购请求;
?一级BOSS根据用户的归属地,转发各省BOSS订购请求;
?各省BOSS根据产品代码订购业务后,返回应答消息给一级BOSS,一级BOSS转发应答消息给农村信息网;
?农村信息网根据应答下发订购短信给用户。
退订流程:同网站和语音订购流程,不需要短信确认下面是农信通平台对业务受理的处理方式:
2.2.4.业务属性
2.2.5.交易单元
2.2.5.1.交易属性
农信通平台业务受理
交易编码:T2001019
2.2.5.2.交易报文
报文分为报文头(Message Header)和报文体(Service Content)两部分,关于报文头的内容及格式参见接口规范1.4.4中公共报文头的描述。在此只描述报文体部分。
(1)请求SvcCont:
A)农信通平台的编码规则-4位平台机构编码+8位业务编码(BIPCode)+14位组包时间YYYYMMDDHH24MMSS+3位订购渠道标识(SMS、WEB、IVR)+3位流水号(定长),序号从001开始,增量步长为1。省BOSS在客服需要时可以从编码中获取平台侧该操作订购渠道B)省BOSS的编码规则-3位省代码+8位业务编码(BIPCode)+14位组包时间YYYYMMDDHH24MMSS+6位流水号(定长),序号从000001开始,增量步长为1。
(2)应答SvcCont:
业务受理的二级应答编码表
2.3.农信通业务订购关系同步
2.3.1.业务功能
农信通业务订购关系同步是由省BOSS发起的,省BOSS通过该接口实现省BOSS向农信通平台实时同步用户订购关系数据,满足农信通平台经营需要。
由于实时性要求不高,对用户订购关系变化,省BOSS通过此接口准实时批量的向一级BOSS发送相关用户的订购信息,一级BOSS枢纽将该信息转发给农信通平台,农信通平台收到同步的用户数据后做相应处理。
1)当用户通过省BOSS侧的受理渠道订购/退订农信通产品时,省BOSS的相关业务管理员选择区域和该区域下的产品名称,BOSS根据区域和产品名称,查找到产品代码,生成订购关系,并同步到农村信息网。
2)通过农信通平台短信渠道(需短信二次确认)发起的业务订购,省BOSS应及时将订购关系通过本接口发送给农信通平台。
3)当用户状态发生变更时,省BOSS定时轮询用户状态,一旦发现订购了农信通平台业务的用户状态发生变化后(在用户状态发生变化的逻辑交易日内),省BOOS通过本接口,告知农信通平台:
a) 当用户状态从正常变为“销户/预销户”、“过户”、“改号”时,省BOSS向农信通平台发送注销请求,此时操作代码为“销户”;
在数据一致性比对时,可以使用省BOSS消息报文体中的OprT(操作时间)字段的值作为比对时间。
交易异常时,省BOSS和农信通平台的处理方式:
1)由于订购关系同步是通知类交易,省BOSS收到来自一级BOSS枢纽的应答即可认为发送成功。
2)农信通平台需确保订购关系同步成功,可以通过一级BOSS枢纽的日对帐知悉某笔交易没有成功。
注:
1)省BOSS发送请求消息后,如果超时没有收到一级BOSS的确认应答消息,会进行重发,在重发指定的次数后一级BOSS还没有返回确认应答,则写错误日志,并结束本次发送,对没有成功同步的变更信息,在下一次同步的时候还会再次同步。
2) 鉴于各平台需同步的数据量很大,为保障下游系统能够均衡地支撑所有跨区业务,省BOSS发送报文时需遵循下述约定:报文最大不能超过128k,连续两个报文的间隔时间不能小于2秒。