DBOSS和BOSS接口业务消息规范.docx

按DBOSS和BOSS1.5接口业务消息规范1 协议消息头序号名称长度类型说明1包头标识2字节无符号整数其值为0XFFFF2包长度2字节无符号整数仅为数据明细内容长度3包长度校验1字节无符号整数为包长度的高低位的简单相加4进程号1字节无符号整数5后续包1字节无符号整数6压缩加密标志1字节无符号整数0未压缩加密1压缩加密7厂家4字节字符串过滤非法请求8命令字10字节字符串9外部工单号20字节字符串如果外部没有工单号，填BOSS工单号10BOSS工单号20字节字符串11包序号4字节无符号整数12记录分割符5字节字符串13字段分割符5字节字符串14保留18字节字符串15保留28字节字符串包体部分内容不定长包尾2字节无符号整数其值为0XFFFF2 BOSSàDBOSS业务消息规范2.1 手机报业务2.1.1 开户指令921标题内容消息功能手机报业务开户命令字921消息类别参数名称参数说明请求消息customer_type用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码billing_mode套餐计费模式1：免费；2：按条计费；3：包月计费；4：封顶方式；5：其他meal_id套餐IDrate套餐资费，以分为单位password客户手机密码customer_name客户名称personal_id客户身份证号码connect_phone客户其他联系号码postal_code客户邮政编码address客户地址user_state客户手机状态应答消息RETCRETC返回码定义：0手机报业务开户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.1.2 销户指令922标题内容消息功能手机报业务销户命令字922消息类别参数名称参数说明请求消息customer_type用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码meal_id套餐ID应答消息RETCRETC返回码定义：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套餐IDmax_user最大用户数1：个人用户此字段为1；X：集团用户此字段为该集团中个人用户数量；max_connection用户定义的最大连接数量个人用户一般为1；集团用户一般为该集团中个人用户数量time_unit有效时间单位0：月为单位 1：年为单位valid_time宽带业务的有效时间长度，单位以time_unit指定area_id宽带用户所在的3位地区区号bb_address宽带用户安装的地址z_cm_numberCableModel设备编号，广电用户填写此参数z_tv_number有线电视证编号，广电用户填写此参数z_agent宽带业务代理商编号password客户手机密码customer_name客户名称personal_id客户身份证号码connect_phone客户其他联系号码postal_code客户邮政编码address客户地址user_state客户手机状态 应答消息RETCRETC返回码定义：0宽带业务受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例2.2.2 销户指令924标题内容消息功能宽带业务销户命令字924消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：0宽带业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例2.2.3 开机指令925标题内容消息功能宽带业务开机命令字925消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：0宽带业务开机受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例2.2.4 关机指令926标题内容消息功能宽带业务关机命令字926消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：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操作请求时间，格式:YYYYMMDDHHMISSquota_perday日消费限额（单位：厘）operator_no操作员工号，定为：791ebmpp01comment备注字段，（参数值选填，但是要有此参数）account_pw帐户密码，（参数值选填，但是要有此参数）trade_password交易密码，（参数值选填，但是要有此参数）password客户手机密码customer_name客户名称personal_id客户身份证号码connect_phone客户其他联系号码postal_code客户邮政编码address客户地址user_state客户手机状态应答消息RETCRETC返回码定义：（只有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操作请求时间，格式:YYYYMMDDHHMISSflag标志由用户发起还是由BOSS发起。0：用户发起 1：BOSS发起如果由BOSS发起，则不需要输入帐户密码operator_no操作员工号，定为：791ebmpp01comment备注字段，（参数值选填，但是要有此参数）account_pw帐户密码，（参数值选填，但是要有此参数）应答消息RETCRETC返回码定义：（只有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应答消息RETCRETC返回码定义：-1请求不合法或者出错9001IP不合法9002手机号不合法1000订购成功1001退定成功4000定购失败4001退定失败2001非梦网管家定购用户2002梦网管家定购用户DESC结果描述举例消息举例2.4.2 销户指令933标题内容消息功能销户命令字933消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码nodeid鉴权IP应答消息RETCRETC返回码定义：-1请求不合法或者出错9001IP不合法9002手机号不合法1000订购成功1001退定成功4000定购失败4001退定失败2001非梦网管家定购用户2002梦网管家定购用户DESC结果描述举例2.4.3 查询指令934标题内容消息功能查询命令字934消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码nodeid鉴权IP应答消息RETCRETC返回码定义：-1请求不合法或者出错9001IP不合法9002手机号不合法1000订购成功1001退定成功4000定购失败4001退定失败2001非梦网管家定购用户2002梦网管家定购用户DESC结果描述举例2.5 移动欢乐谷业务2.5.1 开户指令（935）标题内容消息功能移动欢乐谷业务开户命令字消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码meal_id套餐ID（BOSS制定 81020006） 请确认password客户手机密码customer_name客户名称personal_id客户身份证号码connect_phone客户其他联系号码postal_code客户邮政编码address客户地址user_state客户手机状态应答消息RETCRETC返回码定义：0业务开户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.5.2 销户指令（936）标题内容消息功能移动欢乐谷业务销户命令字消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例2.6 综合数据业务（目前有手机炒股,手机出品）*2.6.1 开户指令（937）标题内容消息功能中国移动综合数据业务开户命令字消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码meal_id套餐ID（BOSS指定），如果是多个套餐的话，中间用逗号分隔。例如：80020045,91020009, 8002010220900001  传情短信 （183）2008071491020009 15元手机炒股 (152)80020102 5元手机出品 (156)80020076 6元手机支付(154)80020103 手机基金（157）30535700 智能应答（158）80020104手机证券行情查询（159）80020105 手机证券在线交易（160）80020106手机证券行情查询+在线交易（161）91020094 我家家话0元(122)91020093 我i我家9人(179)91020092 我i我家6人(180)91020091 我i我家3人(181)91020090 我i我家0人(182)password客户手机密码customer_name客户名称personal_id客户身份证号码connect_phone客户其他联系号码postal_code客户邮政编码address客户地址user_state客户手机状态应答消息RETCRETC返回码定义：0业务开户受理成功1BOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述fail_meal_id失败的套餐ID，采用逗号分割举例消息举例2.6.2 销户指令（938）标题内容消息功能中国移动综合数据业务销户命令字消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码meal_id套餐ID（BOSS指定 *）如果是多个套餐的话，中间用逗号分隔。例如：80020045,91020009, 80020102应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述fail_meal_id失败的套餐ID，采用逗号分割举例2.7 我爱我家业务（新增）2.7.1 我爱我家成员开销户指令（985）标题内容消息功能我爱我家成员开销户指令命令字985消息类别参数名称参数说明请求消息customer_name户主名称personal_id户主身份证号码address客户地址phone_no户主号码residence_place户主的归属地meal_id套餐ID（BOSS指定），如果是多个套餐的话，中间用逗号分隔。例如：80020045,91020009, 8002010291020094 我家家话0元(122)91020093 我i我家9人(179)91020092 我i我家6人(180)91020091 我i我家3人(181)91020090 我i我家0人(182)home_no一家通号码member _count总计成员的个数，后续参数通过此参数的值确定member_short_no1成员短号1member_phone_no1成员手机号1member_ residence_place1成员归属地1member_short_no2成员短号2member_phone_no2成员手机号2member_ residence_place2成员归属地2member_short_noN成员短号Nmember_phone_noN成员手机号Nmember_ residence_placeN成员归属地Ncreate_time开通时间sequence_no流水号type一家通开通的指令（开户、销户、维护）ret_code返回码ret_msg返回消息应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述fail_meal_id失败的套餐ID，采用逗号分割举例消息举例2.7.2 我爱我家增删成员指令（986）标题内容消息功能我爱我家增删成员指令命令字986消息类别参数名称参数说明请求消息member_name成员名称member_personal_id成员身份证号码member_address成员地址member_phone_no成员号码member_residence_place成员的归属地member_home_no成员所属一家通号码member_short_no成员短号create_time开通时间sequence_no流水号type家庭成员开通的指令（增加、删除）ret_code返回码ret_msg返回消息应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.7.3 我爱我家业务受理指令（987）标题内容消息功能我爱我家业务受理指令命令字987消息类别参数名称参数说明请求消息customer_no订购业务的号码servie_sort业务分类(属于个人业务还是家庭业务)member_address业务归属地service_name业务的名称，业务代码service_type业务类型（彩信、短信、WAP）book_type业务订购类型（包月还是按条或是免费）service_fee业务资费create_time开通时间sequence_no流水号type指令（业务的开通、删除指令码）ret_code返回码ret_msg返回消息应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.7.4 我爱我家开关振铃指令（988）标题内容消息功能我爱我家开关振铃指令命令字988消息类别参数名称参数说明请求消息home_no一家通号码phone_no户主号码residence_place归属区号call_mode振铃方式（顺振和正振）create_time功能开关时间sequence_no流水号type开关指令ret_code返回码ret_msg返回消息应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.7.5 我爱我家家庭手机号码变更指令（989取消）标题内容消息功能我爱我家家庭手机号码变更指令命令字989消息类别参数名称参数说明请求消息home_no一家通号码residence_place归属区号family_phone_no家庭手机号create_time变更时间sequence_no流水号type指令ret_code返回码ret_msg返回消息应答消息RETCRETC返回码定义：0业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户无此业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例2.8 快乐平台（新增）2.8.1 开户指令（BOSS提供命令字）标题内容消息功能快乐业务套餐开户命令字消息类别参数名称参数说明customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码meal_id套餐ID （BOSS制定） 80020156快乐产品GPRS包月套餐1（boss-80020156） 53001赠送200M省内手机上网流量80020157 快乐产品GPRS包月套餐253001赠送300M省内手机上网流量应答消息RETCRETC返回码定义：DESC结果描述举例2.8.2 销户指令（BOSS提供命令字）标题内容消息功能快乐业务套餐销户命令字消息类别参数名称参数说明customer_type 用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：DESC结果描述举例2.9 无限眼平台手机视频业务2.9.1 业务受理指令（BOSS提供命令字）2.9.2 消息说明：请求消息的各个字段和文档DBOSS和无线眼平台交互消息规范V1.00中请消息体格式一致标题内容消息功能手机视频业务命令字消息类别参数名称参数说明请求消息TYPE0：开户1：销户2：查询3：其他应答消息RETCRETC返回码定义：0业务开户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例消息举例3 DBOSS->BOSS业务消息规范3.1 手机报业务3.1.1 开户指令901标题内容消息功能手机报业务开户命令字901消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码billing_mode套餐计费模式1：免费；2：按条计费；3：包月计费；4：封顶方式；5：其他meal_idMealId MEALNAME rate98020005 20元包月2(2000) 80020037 10元包月(1000)80020038 20元包月(2000)80020051 音像专刊(2002)80020063 移动至尊(5000)80020045 6元包月(600)80020052 5元新华移动手机报套餐(500)rate套餐资费，以分为单位应答消息RETCRETC返回码定义：0手机报业务开户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例3.1.2 销户指令902标题内容消息功能手机报业务销户命令字902消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETCRETC返回码定义：0手机报业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例3.2 宽带业务3.2.1 开户指令903标题内容消息功能宽带业务开户命令字903消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码meal_id套餐IDmax_user最大用户数1：个人用户此字段为1；X：集团用户此字段为该集团中个人用户数量；max_connection用户定义的最大连接数量个人用户一般为1；集团用户一般为该集团中个人用户数量time_unit有效时间单位0：月为单位 1：年为单位valid_time宽带业务的有效时间长度，单位以time_unit指定area_id宽带用户所在的3位地区区号bb_address宽带用户安装的地址z_cm_numberCableModel设备编号，广电用户填写此参数z_tv_number有线电视证编号，广电用户填写此参数z_agent宽带业务代理商编号应答消息RETCRETC返回码定义：0宽带业务开户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例3.2.2 销户指令904标题内容消息功能宽带业务销户命令字904消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETC返回码定义：0宽带业务销户受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理DESC结果描述举例3.2.3 开机指令905标题内容消息功能宽带业务开机命令字905消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETC返回码定义：0宽带业务开机受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例3.2.4 关机指令906标题内容消息功能宽带业务关机命令字906消息类别参数名称参数说明请求消息customer_type 用户类型0：个人用户1：集团用户2：其他用户phone_no用户手机号码应答消息RETC返回码定义：0宽带业务关机受理成功1DBOSS发送的参数不正确2系统正忙，请稍候再申请业务（用于BOSS内部操作错误）3该用户已在黑名单，业务不予受理4该用户欠费，业务不予受理5该用户已申请本业务，业务不予受理6该用户号码无效，业务不予受理误DESC结果描述举例3.3 小额支付业务3.3.1 开户指令910标题内容消息功能小额支付业务开户命令字910消息类别参数名称参数说明请求消息customer_type用户类型0：个人用户 1：集团用户 2：其他用户phone_no用户手机号码transaction_id操作流水号request_timestamp操作请求时间，格式:YYYYMMDDHHMISSuser_name日消费限额（单位：厘）id_type证件类型00 - 保留未用 01 - 身份证02 - 军官证 03 - 护照04 介绍信 05 户口本06 - 其它证件 id_number证件号码，（根据id_type来填写）so_type_id受理类型，开户时固定填写361operator_no操作员工号，定为：791ebmpp01comment备注字段，（参数值选填，但是要有此参数）应答消息RETCRETC返回码定义：（只有0标志操作成功）0开户受理成功1DBOSS发送的参数不正确2 没有权限作指定操作3 TLV格式中指定的Tag类型协议中不存在4 TLV格式不合法5 时间格式不正确6 用户号码在系统中不存在7 证件类型错8 该业务已申请9 操作流水号重复10 时间不合理11 缺少必需参数12 系统错误13 用户手机号