DBOSS和BOSS15接口业务消息规范V108.docx
《DBOSS和BOSS15接口业务消息规范V108.docx》由会员分享,可在线阅读,更多相关《DBOSS和BOSS15接口业务消息规范V108.docx(99页珍藏版)》请在冰豆网上搜索。
DBOSS和BOSS15接口业务消息规范V108
按DBOSS和BOSS1.5接口业务消息规范
1协议消息头
序号
名称
长度
类型
说明
1
包头标识
2字节
无符号整数
其值为0XFFFF
2
包长度
2字节
无符号整数
仅为数据明细内容长度
3
包长度校验
1字节
无符号整数
为包长度的高低位的简单相加
4
进程号
1字节
无符号整数
5
后续包
1字节
无符号整数
6
压缩加密标志
1字节
无符号整数
0未压缩加密1压缩加密
7
厂家
4字节
字符串
过滤非法请求
8
命令字
10字节
字符串
9
外部工单号
20字节
字符串
如果外部没有工单号,填BOSS工单号
10
BOSS工单号
20字节
字符串
11
包序号
4字节
无符号整数
12
记录分割符
5字节
字符串
13
字段分割符
5字节
字符串
14
保留1
8字节
字符串
15
保留2
8字节
字符串
包体部分
内容不定长
包尾
2字节
无符号整数
其值为0XFFFF
2BOSSDBOSS业务消息规范
2.1手机报业务
2.1.1开户指令921
标题
内容
消息功能
手机报业务开户
命令字
921
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户1:
集团用户2:
其他用户
phone_no
用户手机号码
billing_mode
套餐计费模式
1:
免费;
2:
按条计费;
3:
包月计费;
4:
封顶方式;
5:
其他
meal_id
套餐ID
rate
套餐资费,以分为单位
password
客户手机密码
customer_name
客户名称
personal_id
客户身份证号码
connect_phone
客户其他联系号码
postal_code
客户邮政编码
address
客户地址
user_state
客户手机状态
应答消息
RETC
RETC
返回码定义:
0手机报业务开户受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户已申请本业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
消息举例
2.1.2销户指令922
标题
内容
消息功能
手机报业务销户
命令字
922
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户1:
集团用户2:
其他用户
phone_no
用户手机号码
meal_id
套餐ID
应答消息
RETC
RETC
返回码定义:
0手机报业务销户受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户无此业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
2.2宽带业务
2.2.1开户指令923
标题
内容
消息功能
宽带业务开户
命令字
923
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户1:
集团用户2:
其他用户
phone_no
用户手机号码
meal_id
套餐ID
max_user
最大用户数
1:
个人用户此字段为1;
X:
集团用户此字段为该集团中个人用户数量;
max_connection
用户定义的最大连接数量
个人用户一般为1;
集团用户一般为该集团中个人用户数量
time_unit
有效时间单位
0:
月为单位1:
年为单位
valid_time
宽带业务的有效时间长度,单位以time_unit指定
area_id
宽带用户所在的3位地区区号
bb_address
宽带用户安装的地址
z_cm_number
CableModel设备编号,广电用户填写此参数
z_tv_number
有线电视证编号,广电用户填写此参数
z_agent
宽带业务代理商编号
password
客户手机密码
customer_name
客户名称
personal_id
客户身份证号码
connect_phone
客户其他联系号码
postal_code
客户邮政编码
address
客户地址
user_state
客户手机状态
应答消息
RETC
RETC
返回码定义:
0宽带业务受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户已申请本业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
2.2.2销户指令924
标题
内容
消息功能
宽带业务销户
命令字
924
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户
1:
集团用户
2:
其他用户
phone_no
用户手机号码
应答消息
RETC
RETC
返回码定义:
0宽带业务销户受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户无此业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
2.2.3开机指令925
标题
内容
消息功能
宽带业务开机
命令字
925
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户
1:
集团用户
2:
其他用户
phone_no
用户手机号码
应答消息
RETC
RETC
返回码定义:
0宽带业务开机受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户已申请本业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
2.2.4关机指令926
标题
内容
消息功能
宽带业务关机
命令字
926
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户
1:
集团用户
2:
其他用户
phone_no
用户手机号码
应答消息
RETC
RETC
返回码定义:
0宽带业务关机受理成功
1DBOSS发送的参数不正确
2系统正忙,请稍候再申请业务(用于BOSS内部操作错误)
3该用户已在黑名单,业务不予受理
4该用户欠费,业务不予受理
5该用户已申请本业务,业务不予受理
6该用户号码无效,业务不予受理误
DESC
结果描述
举例
2.3小额支付业务
2.3.1开户指令927
标题
内容
消息功能
小额支付业务开户
命令字
927
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户1:
集团用户2:
其他用户
phone_no
用户手机号码
transaction_id
操作流水号
request_timestamp
操作请求时间,格式:
YYYYMMDDHHMISS
quota_perday
日消费限额(单位:
厘)
operator_no
操作员工号,定为:
791ebmpp01
comment
备注字段,(参数值选填,但是要有此参数)
account_pw
帐户密码,(参数值选填,但是要有此参数)
trade_password
交易密码,(参数值选填,但是要有此参数)
password
客户手机密码
customer_name
客户名称
personal_id
客户身份证号码
connect_phone
客户其他联系号码
postal_code
客户邮政编码
address
客户地址
user_state
客户手机状态
应答消息
RETC
RETC
返回码定义:
(只有0标志操作成功)
0开户受理成功
1BOSS发送的参数不正确
2没有权限作指定操作
3给定金额格式不合理
4TLV格式中指定的Tag类型协议中不存在
5TLV格式不合法
6时间格式不正确
7用户号码在系统中已存在
8操作流水号重复
9时间不合理
10缺少必需参数
11系统错误
12自定义错误
DESC
结果描述,(上述操作码对应的描述信息,关键是这个)
举例
消息举例
2.3.2销户指令928
标题
内容
消息功能
小额支付业务销户
命令字
928
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户1:
集团用户2:
其他用户
phone_no
用户手机号码
transaction_id
操作流水号
request_timestamp
操作请求时间,格式:
YYYYMMDDHHMISS
flag
标志由用户发起还是由BOSS发起。
0:
用户发起1:
BOSS发起
如果由BOSS发起,则不需要输入帐户密码
operator_no
操作员工号,定为:
791ebmpp01
comment
备注字段,(参数值选填,但是要有此参数)
account_pw
帐户密码,(参数值选填,但是要有此参数)
应答消息
RETC
RETC
返回码定义:
(只有0标志操作成功)
0销户受理成功
1BOSS发送的参数不正确
2没有权限作指定操作
3TLV格式中指定的Tag类型协议中不存在
4TLV格式不合法
5时间格式不正确
6用户号码在系统中已存在
7操作流水号重复
8时间不合理
9帐户密码有误
10缺少必需参数
11系统错误
12用户已销户
13自定义错误
DESC
结果描述,(上述操作码对应的描述信息,关键是这个)
举例
2.4梦网管家业务
2.4.1开户指令932
标题
内容
消息功能
开户
命令字
921
消息类别
参数名称
参数说明
请求消息
customer_type
用户类型
0:
个人用户
1:
集团用户
2:
其他用户
phone_no
用户手机号码
nodeid
鉴权IP
应答消息
RETC
RETC
返回码定义:
-1-请求不合法或者出错
9001-IP不合法
9002-手机号不合法
1000-订购成功
1001-退定成功