中国移动一级BOSS接口规范农信通业务单行本154Word格式文档下载.docx
- 文档编号:7790672
- 上传时间:2023-05-09
- 格式:DOCX
- 页数:63
- 大小:99.77KB
中国移动一级BOSS接口规范农信通业务单行本154Word格式文档下载.docx
《中国移动一级BOSS接口规范农信通业务单行本154Word格式文档下载.docx》由会员分享,可在线阅读,更多相关《中国移动一级BOSS接口规范农信通业务单行本154Word格式文档下载.docx(63页珍藏版)》请在冰点文库上搜索。
2007-9-8
11
4订购关系同步接口中增加了农信通向内容计费系统同步订购关系文件的描述
1.3.5
2008-2-3
12
4订购关系同步接口中增加了内容计费向农信通系统同步订购关系确认文件的描述
1.3.6
13
增加2.3农信通业务订购关系同步实时接口;
4订购关系同步接口中去掉了关于内容计费系统与农信通平体同步订购关系文件的描述
1.3.7
2008-5-12
盛英辉
14
增加区域信息文件从省到平台章节;
新增相关产品包内容
1.3.8
2008-8-19
15
修订文件接口应答部分等
1.3.8.1
16
修订部分章节内容
1.3.9
2008-8-27
17
对产品包信息进行修改
1.4.0
2008-8-28
王颖
18
针对全文档的修订
1.4.1
2008-9-2
19
2.3.4.2章节中对18.1.4.6.1做修改,删除18.1.4.6.2
1.4.2
20
章节2.2.5.2中操作代码字段增加用户暂停和用户恢复;
对填空的字段增加取值说明明;
章节6.1.2产品包需要增加服务区域信息;
满足一个产品服务多区域要求;
1.4.3
2008-9-9
21
区域信息文件全量区域信息同步格式中,把TownInfo和VillageInfo的约束由“+”改为“*”;
修订4.4.2中StartT字段长度从F10改为F14;
增加区域信息文件举例。
1.4.4
2008-11-3
修订全量区域信息同步确认文件格式内容
2008-11-6
22
业务受理的业务编码改为T2001019;
把给内容计费的订购关系报文恢复。
1.4.4.1
2008-11-10
23
修订农信通CP信息同步确认文件格式内容。
2008-11-11
24
农信通业务信息文件章节农信通业务信息同步格式中,ProPackAreaInfo的约束改为*;
产品包服务区域代码从V12改为V30;
产品服务区域代码从V12改为V30;
增加附录1产品、产品包和区域说明章节。
1.4.4.2
2008-11-20
25
按包月产品需要短信二次确认的要求修改接口
1.5.0
2010-4-24
26
修订:
2.2.5.2订购/退订报文中新增“来源”字段,并新增“A1-业务管理员”来源;
移除2.3.4.1“订购关系同步”T2101206中同步到MCAS说明,该通道合并到“与内容计费接口(BOSS3.0)单行本v1.3.7”中
1.5.1
2010-5-31
龚正
27
修订2.3订购关系同步接口描述:
省BOSS->
平台,并重新对bip_id,activity_id编码
1.5.2
2010-7-19
28
2.3订购关系同步接口字段注释;
以及退订失败时的处理流程,不再使用预退订文件;
补充“R1-语音IVR”订购来源
1.5.3
2010-7-23
29
根据“百事易”业务新的需求修订:
a)修订2.1节组网图,增加百事易产品描述
b)2.2.5.2请求报文18.1.4.6SPID约束改为1(必填)
c)补充2.3.2流程第2点的说明
d)补充数据一致性比对对操作时间的说明
e)补充3.5文件传输目录
1.5.4
2011-2-18
目录
文档变更记录ii
1.综述8
1.1.一级BOSS总体架构8
1.2.系统管理8
1.3.机构系统编码8
1.4.参考文档9
2.农信通平台与一级BOSS枢纽实时接口10
2.1.农信通业务简介10
2.2.农信通业务的订购、退订12
2.2.1.业务功能12
2.2.2.业务约束12
2.2.3.业务流程13
2.2.3.1.农信通平台业务流程13
2.2.4.业务属性14
2.2.5.交易单元15
2.2.5.1.交易属性15
2.2.5.2.交易报文16
2.3.农信通业务订购关系同步19
2.3.1.业务功能19
2.3.2.业务流程20
2.3.3.业务属性21
2.3.4.交易单元22
2.3.4.1.交易属性22
2.3.4.2.交易报文23
3.文件接口25
3.1.文件接口的功能25
3.2.文件格式26
3.2.1.文件命名规则26
3.2.2.文件格式说明26
3.3.文件的获取27
3.4.文件校验27
3.5.文件传输流程27
4.区域信息文件从省到平台28
4.1.文件格式28
4.1.1.文件名28
4.1.2.文件格式说明28
4.2.文件的传输30
5.农信通业务信息文件31
5.1.文件格式31
5.1.1.文件名31
5.1.2.文件格式说明31
5.2.文件的传输34
6.农信通CP信息文件35
6.1.文件格式35
6.1.1.文件名35
6.1.2.文件格式说明35
6.2.文件的传输37
7.农信通CP结算信息文件38
7.1.文件格式38
7.1.1.文件名38
7.1.2.文件格式说明38
7.2.文件的传输40
8.日对帐41
8.1.文件格式41
8.1.1.文件名41
8.1.2.文件格式说明41
8.2.文件的传输43
8.3.对帐文件的比对44
9.订购关系月对帐(同步)文件接口45
9.1.功能概述45
9.2.文件传输流程45
9.2.1.省BOSS流程45
9.2.2.农信通平台流程46
9.3.月增量定购关系明细文件46
9.3.1.文件命名规则46
9.3.2.文件格式47
9.3.2.1.头记录格式47
9.3.2.2.记录格式48
9.4.对帐文件的比对48
附录1:
产品、产品包和区域的说明49
附录1.1产品、产品包互斥原则49
附录1.2产品区域信息同步原则49
1.综述
1.1.一级BOSS总体架构
农信通平台接入一级BOSS枢纽系统须遵循一级BOSS的技术规范和系统管理要求,详情见1.3参考文档的
《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5.doc》。
1.2.系统管理
农信通平台需要实现的系统管理交易见下表:
业务名称:
代码
交易名称:
机构签到:
BIP0C001
T0010006
机构签退:
BIP0C002
T0010007
连通测试:
BIP0C003
T0020008
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系统)连接,实现用户管理和计费结算功能。
农信通平台:
ChinaMobileRuralInformationNetwork,简称:
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转发应答消息给农村信息网;
农村信息网根据应答下发订购短信给用户。
退订流程:
同网站和语音订购流程,不需要短信确认
下面是农信通平台对业务受理的处理方式:
业务受理操作代码
业务平台处理方式
代码使用方
06-服务定购
根据BOSS应答开通用户指定的服务
07-服务退订
根据BOSS应答退订用户指定的服务
99-全业务退订
根据BOSS应答取消用户在农信通平台订购的所有业务
2.2.4.业务属性
冲正处理
无
安全性要求
业务编码:
分业务进行编码,如下表所列:
业务名称
业务编码
农信通平台业务受理
BIP2B141
2.2.5.交易单元
2.2.5.1.交易属性
交易编码:
T2001019
名称
取值
交易类型
00:
大圈类流程
冲正
0:
不需要冲正
人工冲正
不需要
对帐标记
1:
参与对帐
安全性:
密码加密
防篡改
发起方机构DOMAIN
落地方机构DOMAIN
BOSS
路由类型
路由类型01,路由关键值:
手机号(智能网用户使用省代码路由)
2.2.5.2.交易报文
报文分为报文头(MessageHeader)和报文体(ServiceContent)两部分,关于报文头的内容及格式参见接口规范1.4.4中2.1.4.1节公共报文头的描述。
在此只描述报文体部分。
(1)请求SvcCont:
父元素名称
元素名称
约束
类型
宽度
取值说明
InterBOSS
SvcCont
String
—
请求内容
XML格式的字符串,以CDATA区表达
18.1
BizReq
业务受理请求
18.1.1
IDType
F2
用户ID标识类型
01-手机号码
18.1.2
IDValue
V32
用户ID标识值
手机号码
18.1.3
AreaInfo
?
V30
该用户区域信息代码
参考区域信息文件接口(农信通平台不填,省发起填写)
18.1.4
BizOrder
+
业务订购/退订
18.1.4.1
OprNumb
本次操作的流水号
操作流水号规则的说明见注1
18.1.4.2
OprCode
操作代码
04-用户暂停
05-用户恢复
06-订购服务
07-退订服务
99-全业务退订
BizType
业务类型代码
27-农信通业务
18.1.4.3
Src
注册/变更/暂停/退定来源
01-WEB,02-网上营业厅,03-WAP,
04-SMS,07-1860,08-营业厅80-客户端,A1-业务管理员,R1-语音IVR
18.1.4.4
EffetiTime
F8
发起方希望的生效时间
如EffetiTime与操作流水号中的日期相同,表示立即生效;
否则表示在指定日期(EffetiTime)生效。
EffetiTime必须>
=操作流水号中的日期。
18.1.4.5
NewPwd
V64
业务密码/新业务密码
不需要填写
18.1.4.6
SPID
V18
SP企业代码
农信通企业代码
18.1.4.7
SPCont
SP提供的服务内容
只有在全业务退订操作时才为空
18.1.4.7.1
ProPackCode
V10
产品包编码或业务代码
订购产品包时,填产品包编码,订购单个产品时,填业务代码;
只有在全业务退订操作时才为空;
注1:
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:
BizRsp
业务受理应答
参考区域信息文件接口(农信通平台不填,省应答填写)
OprResult
业务操作应答
发起方的操作流水号
操作流水号规则的说明见请求报文注1
BizOrderResult
业务请求的结果
当应答报文头中的RsRspCode=0000时填写00;
当应答报文头中的RspType=2,RspCode=2998时,填写内容见下面的二级应答编码表;
Reserve
V256
保留字段
业务受理的二级应答编码表
二级应答编码
错误描述
错误理由说明
收到应答后,业务发起方的后续处理
RINP平台为业务发起方
00
成功
应答报文头中的RsRspCode=0000
请求成功
02
操作代码错误。
06、07、99之外的操作编码
按请求失败处理
03
业务代码错误。
04
生效时间错误。
生效时间<
操作时间(操作时间即操作流水号中的组包时间)
用户已订购该业务
当RINP平台或者省BOSS重复订购时,省BOSS或者RINP平台应答
按请求成功处理
用户未订购该业务或已退订
当RINP或者省BOSS对未订购或已退订服务的用户进行退订操作时,省BOSS或者RINP平台应答
用户已单向停机
订购业务:
对单向停机用户,应返回本应答,表示不能进行订购操作。
退订业务:
对单向停机用户,不允许返回此应答。
应进行退订操作并返回退订操作结果。
落地方不会返回此应答码(如返回按请求失败处理)
用户已停机
对停机用户,应返回本应答,表示不能进行订购操作。
对停机用户,不允许返回此应答,应进行退订操作并返回退订操作结果。
用户预销户
对预销户用户,应返回本应答表示不能进行订购操作。
对预销户用户,返回本应答(返回前需要检查订购关系是否已经退订,对没有退订的进行退订,然后返回本应答)。
用户销户
对销户用户,应返回本应答表示不能进行订购操作。
对销户用户,返回本应答(返回前需要检查订购关系是否已经退订,对没有退订的进行退订,然后返回本应答)。
用户不存在
区域匹配失败
80
需要短信二次确认
平台发起的需要短信二次确认的订购时省BOSS应答
平台生成临时订购关系,等待省BOSS的订购关系同步
98
落地方内部错误
99
其它错误
由落地方自行解释。
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向农信通平台发送注销请求,此时操作代码为“销户”;
在数据一致性比对时,可以使
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国移动 一级 BOSS 接口 规范 农信通 业务 单行本 154
![提示](https://static.bingdoc.com/images/bang_tan.gif)