计费系统与营帐规范.docx
《计费系统与营帐规范.docx》由会员分享，可在线阅读，更多相关《计费系统与营帐规范.docx（35页珍藏版）》请在冰豆网上搜索。
计费系统与营帐规范
CDMA计费系统与营帐和网间结算
接口文档
2020-10-16
第一章联机指令与营帐的接口1
1.接口概述1
2.消息包方式的接口实现2
2.1消息头的格式（69字节定长字符串）2
2.2消息尾部的格式（4字节定长字符串）4
2.3消息体的差不多格式（变长字符串）4
2.3.1创建新用户请求的消息体（CRUSER）4
2.3.2删除用户请求的消息体（DLUSER）5
2.3.3业务操纵请求的消息体（CHGSRV）5
2.3.4修改DN请求消息体（CHGMDN）6
2.3.5修改IMSI请求消息体（CHIMSI）6
2.3.6修改ESN请求消息体（CHGESN）7
2.3.7修改PIC请求消息体（CHGPIC）7
2.3.8用户信息查询请求消息体（QUINFO）8
2.3.9用户信息查询反馈消息体（USIRSP）8
2.3.10结果返回消息体（FEBRSP）9
2.3.11工单状态查询请求消息体（QWSTAT）9
2.3.12工单状态查询返回消息体（WITRSP）9
2.3.13工单内容查询请求消息体（QWINFO）10
2.3.14工单内容查询应答消息体（WDTRSP）10
2.3.15应答消息体（REQACK和RSPACK）11
2.3.16信息单元总表11
2.4错误处理13
3.文件接口13
3.1文件接口处理模式13
3.2批文件存放目录13
3.3批文件名命名规则14
3.4批文件格式14
第二章一次批价与营帐的话单接口15
1.一次批价提供给营帐系统的话单接口15
1.1一次详单文件首记录格式15
1.2一次详单文件记录信息15
2.备注17
2.1一次批价文件命名规则18
第三章一次批价和网间结算的话单接口19
第一章联机指令与营帐的接口
1.接口概述
联机指令模块与综营的接口有两种方式:
一种是基于TCP协议的网络接口,此种接口接收停机，开机，特服操纵命令请求，并反馈请求的执行结果。
另一种则是基于文件的批处理接口.。
联机指令模块与综合营帐子系统之间有两种通信机制，即通过文件通信的批处理方式和通过消息包处理的方式。
为了保证与综合营帐子系统之间保持工单状态的一致性，批处理的方式仅限于成批开卡,成批开机以及成批停机的情况，其余情况均建议采纳消息包的处理方式。
消息包接口方式的消息流能够分为两种类型。
一种是与用户联机指令及执行结果相关的业务类消息；另一种是综合营帐系统查询联机指令模块执行状态的监控类消息。
营帐系统
联机指令模块
联机指令请求
收到请求应答
执行结果反馈
收到结果应答
业务类消息如下图所示，联机指令请求由营帐系统发起，联机指令模块同步返回收到请求应答。
当完成请求后，联机指令模块向营帐系统反馈执行结果，营帐系统同步返回收到结果应答。
在这种情况下，营帐系统发送联机指令与联机指令模块执行指令的操作方式是异步的，但两端的消息应答采纳同步方式。
监控类消息如下图所示。
营帐系统发出状态查询请求，联机指令模块同步返回查询结果。
在此种情况下，两端操作是同步方式。
需要特不指出的是，在消息包方式下，联机指令和营帐系统间只有一个接口，即在全省只有一个接口点。
需要特不指出的是，联机指令系统采纳集中处理的方式，在全省只有一个接口点，即：
（1）于消息包的接口方式，联机指令系统提供唯一的IP:
PORT，用于接收营帐系统发送来的消息包。
（2）关于文件的接口方式，联机指令系统提供唯一的FTP主机与路径，营帐系统将所有批文件请求存放在该路径下。
营帐系统提供唯一的IP:
PORT，用于异步地接收“执行结果反馈信息”，同时，营帐系统提供唯一的FTP主机与路径，联机指令系统将所有文件应答存放在该路径下。
2.消息包方式的接口实现
综合营帐子系统与联机指令模块之间交换的消息由消息头，消息体，消息尾加字符0x0A组成，为保证消息在多协议，多平台的网络中顺利传送，综合营帐子系统与联机指令子系统之间交换的消息由可打印的ASCII码组成。
消息体
消息体
消息尾
0x0A
2.1消息头的格式（69字节定长字符串）
字段
长度（字节）
内容
类型
头段标识
3
MHF
字符串
版本信息
5
00001
字符串
营帐系统代码
8
默认全空格
字符串
联机子系统代码
8
默认全空格
字符串
请求的日期时刻
14
YYYYMMDDH24MISS
字符串
序列号（流水号）
16
左补零，文件和消息包统一定义序列号
数字串
请求优先级
2
1-99，左补零，数值越大优先级越高
数字串
是否文件请求
1
0：
消息包；1：
文件
字符串
消息类型
6
内容见消息类型表
字符串
信息体长度
6
左补零
数字串
特注:
1.流水号由综营系统产生,并保证文件和消息包统一定义序列号;
2.信息长度为6.
消息类型表：
值
消息类型
含义
CRUSER
业务类
创建新用户请求
CHGSRV
业务类
业务操纵请求
DLUSER
业务类
删除用户请求
CHIMSI
业务类
修改用户IMSI请求
CHGMDN
业务类
修改用户DN请求
CHGESN
业务类
修改用户ESN请求
CHGPIC
业务类
修改用户PIC请求
QUINFO
业务类
用户信息查询请求
USIRSP
业务类
用户信息查询反馈
QWINFO
监控类
工单内容查询请求
QWSTAT
监控类
工单状态查询请求
WDTRSP
监控类
工单内容查询结果消息
REQACK
业务类
收到请求应答
FEBRSP
业务类
请求结果消息
WITRSP
监控类
查询工单结果消息
RSPACK
业务类
反馈结果应答
以下图示综营和联机指令消息传递的类型：
1）
业务类1
2）业务类2
3）监控类1
综合营帐
联机指令
发送QWINFO
返回WDTRSP
4）监控类2
2.2消息尾部的格式（4字节定长字符串）
字段
类型长度
内容
消息尾标识
3位字符串
MNF
2.3消息体的差不多格式（变长字符串）
消息体包括一个或多个信息单元组。
信息单元组之间以字符|分隔。
除WITRSP类型的消息,其余消息均只含有一个信息单元组。
一个信息单元组由若干信息单元构成，它们之间的分隔符为'。
信息单元的格式采纳"名字+值",或“业务名+值+参数1#参数2#+动作”的表示方法，以'+'作为名字和值间的分隔符。
2.3.1创建新用户请求的消息体（CRUSER）
讲明：
消息单元若是必需，则这类消息单元必需出现在请求中，若没出现，联机指令模块将拒绝此请求。
信息单元
取值定义
必需/可选
DN
（电话号码）
必需
IMSI
必需
ESN
（电子序列号）
必需
PIC
（长途线路）
必需
AKEY
（鉴权码）
可选
CHECKSUM
可选
KEYID
可选
预付费标识（PREPAID）
Y/N
可选
差不多话音业务（BASIC）
R/E
可选
本地呼叫能力限定（LOCAL）
R/E—国际长途打开/关闭（缺省开国内长途）
可选
漫游时呼叫能力限定
（ROAMING）
D0++R/E—本地漫游许可/禁止
D1++R/E—省内漫游许可/禁止
D2++R/E—国内漫游许可/禁止
D3++R/E—国际漫游许可/禁止
（D0,D1,D2,D3次序中某业务许可，意味次序靠前的所有业务均被同意；若某业务禁止，同时也意味次序靠前的业务被同意）。
可选
来话业务限定（INTERIM）
D0++R/E—所有来话许可/禁止
D1++R/E—所有呼出许可/禁止
D2++R/E—所有来去话许可/禁止
可选
短信服务（SMS）
D0++R/E—短信发送许可/禁止
D1++R/E—短信接收许可/禁止
D2++R/E—短信收发许可/禁止
可选
话音邮箱（VMR）
R/E
可选
遇忙前转（CFB）
R/E
可选
无应答前转（CFNR）
R/E
可选
立即转移（CFU）
R/E
可选
不可及的呼叫转移（CFC）
R/E
可选
呼叫转移到语音信箱（CT）
R/E
可选
消息等待通知（MWN）
R/E
可选
呼叫等待（CW）
R/E
可选
呼叫保持（CH）
R/E
可选
三方呼叫（3WC）
R/E
可选
主叫号码识不显示（CLIR）
R/E
可选
主叫号码识不限制（CNIR）
R/E
可选
会议电话（CC）
R/E
可选
互联网数据业务（INTERNET）
R/E
可选
特注：
D0++R/E，表明无参数。
2.3.2删除用户请求的消息体（DLUSER）
信息单元
取值定义
必需/可选
DN
必需
IMSI
必需
ESN
必需
PIC
必需
预付费标识（PREPAID）
可选
2.3.3业务操纵请求的消息体（CHGSRV）
信息单元
取值定义
必需/可选
DN
必需
IMSI
必需
ESN
必需
PIC
必需
预付费标识（PREPAID）
Y/N
可选
本地呼叫能力限定（LOCAL）
R/E—国际长途打开/关闭（开国内长途）
可选
漫游时呼叫能力限定
（ROAMING）
D0++R/E—本地漫游许可/禁止
D1++R/E—省内漫游许可/禁止
D2++R/E—国内漫游许可/禁止
D3++R/E—国际漫游许可/禁止
（D0,D1,D2,D3次序中某业务许可，意味次序靠前的所有业务均被同意；若某业务禁止，同时也意味次序靠前的业务被同意）。
可选
来话业务限定（INTERIM）
D0++R/E—所有来话许可/禁止
D1++R/E—所有呼出许可/禁止
D2++R/E—所有来去话许可/禁止
可选
短信服务（SMS）
D0++R/E—短信发送许可/禁止
D1++R/E—短信接收许可/禁止
D2++R/E—短信收发许可/禁止
可选
话音邮箱（VMR）
R/E
可选
遇忙前转（CFB）
R/E
可选
无应答前转（CFNR）
R/E
可选
立即转移（CFU）
R/E
可选
不可及呼叫转移（CFC）
R/E
可选
呼叫转移到语音信箱（CT）
R/E
可选
消息等待通知（MWN）
R/E
可选
呼叫等待（CW）
R/E
可选
呼叫保持（CH）
R/E
可选
三方呼叫（3WC）
R/E
可选
主叫号码识不显示（CLIR）
R/E
可选
主叫号码识不限制（CNIR）
R/E
可选
会议电话（CC）
R/E
可选
互联网数据业务（INTERNET）
R/E
可选
2.3.4修改DN请求消息体（CHGMDN）
信息单元
取值定义
存在
DN
必需
IMSI
必需
ESN
必需
PIC
必需
预付费标识（PREPAID）
可选
NEWDN
必需
AKEY
可选
CHECKSUM
可选
KEYID
可选
2.3.5修改IMSI请求消息体（CHIMSI）
信息单元
取值定义
存在
DN
必需
IMSI
必需
NE
升级会员 