中国移动一级BOSS接口规范-农信通业务单行本

中国移动通信有限公司一级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，简称：RINPA省行业网关有限公司行业网关B省行业网关农信通平台A省业务支撑系统B省业务支撑系统现有产品短信通道管理通道话单A省梦网网关北京梦网网关B省梦网网关话单百事易产品短信通道一级业务支撑系统2.2.农信通业务的订购、退订2.2.1.业务功能农信通业务订购、退订接口是由农信通平台业务向业务归属省BOSS发起的订购、退订请求，旨在请求省BOSS在BOSS侧为用户完成与农信通业务相关的订购产品/退订产品等业务操作。

适用于单个用户主动发起的订购、退订操作。

2.2.2.业务约束1、业务受理渠道农信通平台侧的业务受理渠道目前为：12582、STK、WAP、IVR、WEB2、业务开放范围本业务在全国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.交易属性农信通平台业务受理交易编码：T20010192.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枢纽将该信息转发给农信通平台，农信通平台收到同步的用户数据后做相应处理。

2.3.2.业务流程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秒。

2.3.3.业务属性业务编码：2.3.4.交易单元2.3.4.1.交易属性1、农信通业务订购关系同步交易编码：T21012292.3.4.2.交易报文报文分为报文头(Message Header)和报文体(Service Content)两部分，关于报文头的内容及格式参见接口规范1.4.4中公共报文头的描述。

在此只描述报文体部分。

1、省BOSS订购关系同步(1)请求SvcCont：注1：省BOSS交易包流水号的编码规则－3位省代码+8位业务编码（BIPCode）+14位组包时间YYYYMMDDHH24MMSS+6位流水号（定长），序号从000001开始，增量步长为1。

注2：对每个用户的操作编号的编码规则－3位省代码+8位业务编码（BIPCode）+14位组包时间YYYYMMDDHH24MMSS+2位订购来源标识（01,02,03等）+4位流水号（定长），序号从0001开始，增量步长为1。

(2)应答SvcCont：空3.文件接口3.1.文件接口的功能农信通与省BOSS的文件接口，使用FTP协议发送和接受文件。

由1.2.1以及1.2.2的接口说明归纳如下：文件名发送方接受方农信通业务信息同步文件农信通平台省BOSS 订购关系同步文件省BOSS 农信通平台日对帐文件省BOSS 农信通平台3.2.1.文件命名规则文件命名遵循以下规则：●凡是农信通发给省BOSS的文件，均以RINP开头，3位省代码结尾●省BOSS给农信通的文件，均以BOSS＋3位省代码开头，RINP结尾3.2.2.文件格式说明文件是以XML格式表达的。

在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述：元素的约束条件使用以下符号表示农信通、省BOSS应按固定频率（15分钟/次）到文件服务器的相应目录下，检查是否有新文件到达。

农信通应在每日凌晨3点后，到文件服务器的相应目录下，检查是否有省BOSS的日对帐文件到达。

3.4.文件校验文件接受方应对文件进行校验。

一级BOSS枢纽文件服务器不对文件格式进行校验。

3.5.文件传输流程农信通生成文件后，通过FTP put到文件服务器的下面目录中：ftp目录：$HOME/incoming/file_interface, FTP服务器IP地址218.206.191.171）省BOSS从一级BOSS FTP服务器的get路径：ftp目录：$HOME/outgoing/file_interface, FTP服务器IP地址10.1.140.123）4.区域信息文件从省到平台各省BOSS通过该接口向农信通平台发送与该省相关的区域定义全量信息。