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

中国移动通信有限公司

一级BOSS枢纽系统接口规范
农信通业务单行本

(V1.5.4)

中国移动通信集团公司
二○○八年十一月

文档变更记录
序号
变更内容说明
版本号
版本日期
执笔人
1
讨论稿
1.0.0
2007-6-8
王进
2
次稿
1.1.0
2007-6-12
王进
3
修订稿：2.2节增加从BOSS侧的业务受理
1.2.0
2007-6-13
王进
4
修订稿：增加8农信通CP结算信息文件
1.3.0
2007-6-14
王进
5
修订稿：2.2.5.2请求报文中SPID字段无需填写
1.3.1
2007-6-14
王进
6
修订稿：修改2.2.5.2请求报文的注1（平台操作编码），在原流水号部分增加订购渠道
1.3.1
2007-6-14
王进
7
修订稿：将笔误RNIP统一更改为RINP
1.3.2
2007-6-14
王进
8
修订稿：7.1.2 农信通CP信息同步文件格式中的中、英文字段同名，将英文字段改为CPEName
1.3.3
2007-7-11
王进
9
修订稿： 8.1.2 农信通CP信息同步的1.2.3 CPInfo与父节点同名，改为OprNum
1.3.3
2007-7-11
王进
10
修订稿：6.1.2业务信息同步文件中BillingType的宽度由F2变为F1
1.3.4
2007-9-8
王进
11
修订稿：4订购关系同步接口中增加了农信通向内容计费系统同步订购关系文件的描述
1.3.5
2008-2-3
王进
12
修订稿：4订购关系同步接口中增加了内容计费向农信通系统同步订购关系确认文件的描述
1.3.6
2008-2-3
王进
13
修订稿：增加2.3农信通业务订购关系同步实时接口；4订购关系同步接口中去掉了关于内容计费系统与农信通平体同步订购关系文件的描述
1.3.7
2008-5-12
盛英辉
14
修订稿：增加区域信息文件从省到平台章节；新增相关产品包内容
1.3.8
2008-8-19
盛英辉
15
修订稿：修订文件接口应答部分等
1.3.8.1
2008-8-19
盛英辉
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
盛英辉
21
修订稿：修订全量区域信息同步确认文件格式内容
1.4.4
2008-11-6
盛英辉
22
修订稿：业务受理的业务编码改为T2001019；把给内容计费的订购关系报文恢复。
1.4.4.1
2008-11-10
盛英辉
23
修订稿：修订农信通CP信息同步确认文件格式内容。
1.4.4.1
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.6 SPID约束改为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系统）连接，实现用户管理和计费结算功能。
农信通平台：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. 农信通平台业务流程
订购流程：
l 短信订购：
Ø 用户发送业务代码到农村信息网（经过行业网关转/百事易产品经过北京梦网网关转）；
Ø 农村信息网根据用户的地域属性和业务代码，转换为产品代码，向一级BOSS转发订购请求；
Ø 一级BOSS根据用户的归属地，向省BOSS转发订购请求；
Ø 省BOSS收到业务申请后首先进行用户状态检查、订购关系检查并通过订购渠道判断需要向用户下发二次确认短信，省BOSS答复需要二次确认（应答报文二级应答码BizOrderResult的值为80），一级BOSS转发应答消息给农村信息网；农信通平台生成临时订购关系，根据省BOSS订购关系同步报文中的平台操作流水号最终生成正式订购关系。
在数据一致性比对时，可以使用省BOSS应答消息报文头中的处理时间作为比对时间。
l 网站、语音订购： 不需要短信确认
Ø 用户、话务员选择区域和该区域下的产品名称；
Ø 农村信息网根据地域属性和产品名称，转换为产品代码，向一级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：不需要冲正
人工冲正
0：不需要
对帐标记
1：参与对帐
安全性：密码加密
0：不需要
安全性：防篡改
0：不需要
发起方机构DOMAIN
RINP
落地方机构DOMAIN
BOSS
路由类型
路由类型01，路由关键值：手机号（智能网用户使用省代码路由）

2.2.5.2. 交易报文
报文分为报文头(Message Header)和报文体(Service Content)两部分，关于报文头的内容及格式参见接口规范1.4.4中2.1.4.1节公共报文头的描述。在此只描述报文体部分。
(1)请求SvcCont：
序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
BizReq
1
—
—
业务受理请求

18.1.1
BizReq
IDType
1
String
F2
用户ID标识类型
01-手机号码
18.1.2
BizReq
IDValue
1
String
V32
用户ID标识值
手机号码
18.1.3
BizReq
AreaInfo
?
String
V30
该用户区域信息代码
参考区域信息文件接口（农信通平台不填，省发起填写）
18.1.4
BizReq
BizOrder
+
—
—
业务订购/退订

18.1.4.1
BizOrder
OprNumb
1
String
V32
本次操作的流水号
操作流水号规则的说明见注1
18.1.4.2
BizOrder
OprCode
1
String
F2
操作代码
04 - 用户暂停
05 - 用户恢复
06 - 订购服务
07 - 退订服务
99 - 全业务退订
18.1.4.2
BizOrder
BizType
1
String
F2
业务类型代码
27-农信通业务
18.1.4.3
BizOrder
Src
1
String
F2
注册/变更/暂停/退定来源
01-WEB，02-网上营业厅，03-WAP，
04-SMS，07-1860，08-营业厅 80-客户端，A1-业务管理员，R1-语音IVR
18.1.4.4
BizOrder
EffetiTime
1
String
F8
发起方希望的生效时间
如EffetiTime与操作流水号中的日期相同，表示立即生效；否则表示在指定日期（EffetiTime）生效。EffetiTime必须>=操作流水号中的日期。
18.1.4.5
BizOrder
NewPwd
?
String
V64
业务密码/新业务密码
不需要填写
18.1.4.6
BizOrder
SPID
1
String
V18
SP企业代码
农信通企业代码
18.1.4.7
BizOrder
SPCont
?
—
—
SP提供的服务内容
只有在全业务退订操作时才为空
18.1.4.7.1
SPCont
ProPackCode
1
String
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：

序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
BizRsp
1
—
—
业务受理应答

18.1.1
BizRsp
IDType
1
String
F2
用户ID标识类型
01-手机号码
18.1.2
BizRsp
IDValue
1
String
V32
用户ID标识值
手机号码
18.1.3
BizRsp
AreaInfo
?
String
V30
该用户区域信息代码
参考区域信息文件接口（农信通平台不填，省应答填写）
18.1.4
BizRsp
OprResult
+
—
—
业务操作应答

18.1.4.1
OprResult
OprNumb
1
String
V32
发起方的操作流水号
操作流水号规则的说明见请求报文注1
18.1.4.2
OprResult
BizOrderResult
1
String
F2
业务请求的结果
当应答报文头中的RsRspCode=0000时填写00；
当应答报文头中的RspType=2,RspCode=2998时，填写内容见下面的二级应答编码表；
18.1.4.3
OprResult
Reserve
?
String
V256
保留字段

业务受理的二级应答编码表
二级应答编码
错误描述
错误理由说明
收到应答后，业务发起方的后续处理
RINP平台为业务发起方
00
成功
应答报文头中的RsRspCode=0000
请求成功
02
操作代码错误。
06、07、99之外的操作编码
按请求失败处理
03
业务代码错误。

按请求失败处理
04
生效时间错误。
生效时间<操作时间（操作时间即操作流水号中的组包时间）
按请求失败处理
11
用户已订购该业务
当RINP平台或者省BOSS重复订购时，省BOSS或者RINP平台应答
按请求成功处理
12
用户未订购该业务或已退订
当RINP或者省BOSS对未订购或已退订服务的用户进行退订操作时，省BOSS或者RINP平台应答
按请求成功处理
20
用户已单向停机
订购业务：对单向停机用户，应返回本应答，表示不能进行订购操作。

退订业务：对单向停机用户，不允许返回此应答。 应进行退订操作并返回退订操作结果。
订购业务：按请求失败处理
退订业务：落地方不会返回此应答码（如返回按请求失败处理）
21
用户已停机
订购业务：对停机用户，应返回本应答，表示不能进行订购操作。

退订业务：对停机用户，不允许返回此应答，应进行退订操作并返回退订操作结果。
订购业务：按请求失败处理
退订业务：落地方不会返回此应答码（如返回按请求失败处理）
22
用户预销户
订购业务：对预销户用户，应返回本应答表示不能进行订购操作。

退订业务：对预销户用户，返回本应答（返回前需要检查订购关系是否已经退订，对没有退订的进行退订，然后返回本应答）。
订购业务：按请求失败处理
退订业务：按请求成功处理
23
用户销户
订购业务：对销户用户，应返回本应答表示不能进行订购操作。

退订业务：对销户用户，返回本应答（返回前需要检查订购关系是否已经退订，对没有退订的进行退订，然后返回本应答）。
订购业务：按请求失败处理
退订业务：按请求成功处理
24
用户不存在

按请求失败处理
25
区域匹配失败

按请求失败处理
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向农信通平台发送注销请求，此时操作代码为“销户”；

在数据一致性比对时，可以使用省BOSS消息报文体中的OprT（操作时间）字段的值作为比对时间。

l 交易异常时，省BOSS和农信通平台的处理方式：
1）由于订购关系同步是通知类交易，省BOSS收到来自一级BOSS枢纽的应答即可认为发送成功。
2）农信通平台需确保订购关系同步成功，可以通过一级BOSS枢纽的日对帐知悉某笔交易没有成功。
注：
1) 省BOSS发送请求消息后，如果超时没有收到一级BOSS的确认应答消息，会进行重发，在重发指定的次数后一级BOSS还没有返回确认应答，则写错误日志，并结束本次发送，对没有成功同步的变更信息，在下一次同步的时候还会再次同步。
2) 鉴于各平台需同步的数据量很大，为保障下游系统能够均衡地支撑所有跨区业务，省BOSS发送报文时需遵循下述约定：报文最大不能超过128k，连续两个报文的间隔时间不能小于2秒。

2.3.3. 业务属性
冲正处理
无
安全性要求
不需要

业务编码：
业务名称
业务编码
农信通业务订购关系同步
BIP2B289

2.3.4. 交易单元
2.3.4.1. 交易属性
1、农信通业务订购关系同步
交易编码：T2101229
名称
取值
交易类型
10：通知类流程
冲正
0：不需要冲正
对帐标记
1：参与对帐
安全性：密码加密
0：不需要加密
安全性：防篡改
0：不需要
发起方机构DOMAIN
BOSS
落地方机构DOMAIN
RINP
路由类型
路由类型：00
路由关键值：000

2.3.4.2. 交易报文
报文分为报文头(Message Header)和报文体(Service Content)两部分，关于报文头的内容及格式参见接口规范1.4.4中2.1.4.1节公共报文头的描述。在此只描述报文体部分。
1、省BOSS订购关系同步
(1)请求SvcCont：

序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
UDR
1
—
—
用户业务数据传送请求

18.1.1
UDR
PkgSeq
1
String
V32
省BOSS填写的交易包流水号
编码规则的说明见注1
18.1.2
UDR
UDSum
1
Number
V6
用户数据总数
此报文中包含的用户定购关系记录合计
18.1.3
UDR
UD
+
-
-
用户数据
每个用户一组数据
18.1.3.1
UD
IDType
1
String
F2
标识类型
01-手机号码
18.1.3.2
UD
IDVal
1
String
V32
标识值
手机号码
18.1.3.3
UD
POCont
+
—
—
平台操作内容

18.1.3.3.1
POCont
BONumb
?
String
V32
对每个用户的操作编号
见注2
18.1.3.3.2
POCont
OprCode
1
String
F2
操作代码
04-业务暂停 05-业务恢复
06-业务定购 07-业务退定
18.1.3.3.3
POCont
OprT
1
String
F14
操作时间
省BOSS完成操作代码所代表的操作的时间，YYYYMMDDHH24MMSS
18.1.3.3.4
POCont
EfftT
1
String
F14
生效时间
业务的生效时间，若此时间与“操作时间”相同代表即时生效
18.1.3.3.5
POCont
Src
1
String
F2
注册/变更/暂停/退定来源
01-WEB，02-网上营业厅，03-WAP，
04-SMS，07-1860，08-营业厅，80-客户端，A1-业务管理员，R1-语音IVR
18.1.3.3.6
POCont
BizType
1
String
F2
业务类型
27-农信通业务
18.1.3.3.7
POCont
ThrdNum
?
String
V32
第三方号码
当没有第三方号码时默认填‘0’
18.1.3.3.8
POCont
ChgFlg
?
String
F1
SP业务变更标识
SP业务变更引起的定购/退订需要将此标记置位为1 ，不需要时不填
18.1.3.3.9
POCont
BillFlg
?
String
F1
业务计费类型
0－免费、1－按条计费、2－包月计费、3－包时计费、4－包次计费
18.1.3.3.10
POCont
Seq
?
String
V32
交易包流水号
不填。
18.1.3.3.11
POCont
BizOrder
1
—
—
业务定购/注销数据

18.1.3.3.11.1
BizOrder
SPID
1
String
V18
企业代码
SP企业代码
18.1.3.3.11.2
BizOrder
PackNum
?
String
V10
套餐包编号
不填
18.1.3.3.11.3
BizOrder
SPBizCode
1
String
V10
业务代码
SP业务代码
18.1.3.3.12
POCont
OprInfo
*
—
—
资料/受理信息
不填
18.1.3.3.12.1
OprInfo
Icode
1
String
F3
信息代码
参见信息代码
18.1.3.3.12.2
OprInfo
Ivalue
1
String
V256
信息值

18.1.3.3.13
POCont
Res
?
String
V256
保留字段

注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. 文件格式
3.2.1. 文件命名规则
文件命名遵循以下规则：
l 凡是农信通发给省BOSS的文件，均以RINP开头，3位省代码结尾
l 省BOSS给农信通的文件，均以BOSS＋3位省代码开头，RINP结尾
3.2.2. 文件格式说明
文件是以XML格式表达的。在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述：
元素的约束条件使用以下符号表示
符号
含义
?
0..1，可选项
*
0..n，可以没有，也可以有多项
+
1..n，至少有1项，也可以有多项
1
数字1，代表必须且只能填1项

3.3. 文件的获取
农信通、省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通过该接口向农信通平台发送与该省相关的区域定义全量信息。
4.1. 文件格式
4.1.1. 文件名
l 各省BOSS发送给农信通平台的区域全量信息文件名BOSSXXX_BAreaInfo_YYYYMMDDHHMISS_RINP
² 文件名中的XXX表示省代码；
² 文件名中的YYYYMMDDHHMISS表示文件生成时间；
l 农信通平台发送给省BOSS的区域全量信息确认文件名RINP_BAreaInfoRsp_YYYYMMDDHHMISS_BOSSXXX
² 文件名中的XXX表示省代码；
² 文件名中的YYYYMMDDHHMISS表示文件生成时间；
4.1.2. 文件格式说明
根据XML的定义，每个XML文件需要有特定的Root Tag（根标记），在本文件中的Root Tag为“InterBOSS”.各个字段解释如下表

1、全量区域信息同步格式
序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
1
InterBOSS
ProvID
1
String
F2
两位省级区域编码
参见该表格后的注1
2
InterBOSS
Seq
1
String
V32
本次操作的流水号
注：同订购关系文件格式中的编码规则
农信通通过应答文件回复处理结果时，将此流水号带回。
3
InterBOSS
CityInfo
+
—
—
该省下的市区域信息

3.1
CityInfo
CityCode
1
String
V4
市编码
例如常州市编码为0901
3.2
CityInfo
CityName
1
String
V20
市名称
例如常州市
3.3
CityInfo
CountyInfo
+
—
—
该市下的县区域信息
包括县级市
3.3.1
CountyInfo
CountyCode
1
String
V4
县编码

3.3.2
CountyInfo
CountyName
1
String
V20
县名称

3.3.3
CountyInfo
TownInfo
*
—
—
该县下的镇区域信息

3.3.3.1
TownInfo
TownCode
1
String
V4
镇编码

3.3.3.2
TownInfo
TownName
1
String
V20
镇名称

3.3.3.3
TownInfo
VillageInfo
*
—
—
该镇下的村区域信息

3.3.3.3.1
VillageInfo
VillageCode
1
String
V4
村编码

3.3.3.3.2
VillageInfo
VillageName
1
String
V20
村名称

注1：省级区域编码为2位，各省编码如下表：
北京20
天津21
河北22
山西23
内蒙古25
辽宁26
吉林27
黑龙江28