移动总机业务接入BOSS平台需求说明.doc

1 移动总机业务接入移动总机业务接入 bossboss 平台平台 需求说明需求说明 修改内容修改内容修改时间修改时间修改人修改人 移动总机订购移动总机订购/ /变更变更 增加报文节点（增加报文节点（idid）作为唯一标识）作为唯一标识 2010-12-172010-12-17 移动总机销户移动总机销户 增加报文节点（增加报文节点（idid）作为唯一标识）作为唯一标识 2010-12-172010-12-17 业务交易代码编码加以说明（见尾部）业务交易代码编码加以说明（见尾部） 2010-12-222010-12-22 2 目 录 1 1 概述概述 3 1.1 移动总机业务介绍及现状 .3 2 2 需求说明需求说明.4 2.1 移动总机产品订购信息维护 .4 2.1.1 移动总机产品开户.4 2.1.2 移动总机产品销户.5 2.1.3 移动总机产品信息变更.6 2.2 移动总机产品成员信息维护 .7 2.2.1 添加成员.7 2.2.2 删除成员.8 2.2.3 修改成员.9 2.3 其他 .10 2.3.1 业务付费优化.10 2.3.2 号段数据接口.10 3 附表附表.11 报文头说明11 3.1 表 1 移动总机订购/变更信息表11 3.2 表 2 移动总机销户信息表.13 3.3 表 3 移动总机 添加/修改 成员信息表.15 3.4 表 4 移动总机删除成员信息表.18 4 移动总机交易代码移动总机交易代码 20 3 1 1 概述概述 1.1 移动总机业务介绍及现状移动总机业务介绍及现状 4 2 2 需求说明需求说明 2.1 移动总机产品订购信息维护移动总机产品订购信息维护 实现从 boss 平台到移动总机业务平台产品订购信息同步。考虑到为了保证数据一致性， 仅提供从 boss 平台发起产品订购请求并同步至移动总机业务平台。 2.1.12.1.1 移动总机产品开户移动总机产品开户 2.1.1.12.1.1.1业务功能业务功能 由客户经理在 boss 系统完成移动总机产品开户功能，并实现与移动总机平台订购信息同 步。 2.1.1.22.1.1.2业务流程业务流程 1.在 boss 侧业务受理发送受理请求 2.填写移动总机相关资料，如集团编号，总机号码、web 管理后台登陆密码、 资费类型等信息，并进行校验（详细信息参见表 1）。 3.验证通过后 boss 平台将信息发送给移动总机业务平台。 4.移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 5.boss 平台接收移动总机业务平台返回成功信息后，将之前设定的总机号 码进行无条件呼转至移动总机业务平台语音号码（0451125554），完成业务开通。 2.1.22.1.2 移动总机产品销户移动总机产品销户 2.1.2.12.1.2.1 业务功能业务功能 由客户经理在 boss 系统完成移动总机产品销户功能，并实现与移动总机平台订购信息同 5 步。(先删成员) 2.1.2.22.1.2.2 业务流程业务流程 1.在 boss 侧业务受理界面发送受理请求 2.验证通过后 boss 平台销户将信息发送给移动总机业务平台（详细信息参 见表 2）。 。 3.移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 4.boss 平台接收移动总机业务平台返回成功信息后，将之前设定的总机号 码无条件呼转取消，完成产品销户。 2.1.32.1.3 移动总机产品信息变更移动总机产品信息变更 2.1.3.12.1.3.1 业务功能业务功能 由客户经理在 boss 系统完成移动总机产品信息变更功能，并实现与移动总机平台订购信 息同步。 2.1.3.22.1.3.2 业务流程业务流程 1. 在 boss 侧业务受理界面发送受理请求 6 2. 修改移动总机相关资料，如总机号码、web 管理后台登陆密码、资费类型等 信息，并进行校验（详细信息参见表 1）。 3. 验证通过后 boss 平台将信息发送给移动总机业务平台。 4. 移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 5. boss 平台接收移动总机业务平台返回成功信息后，将之前设定的总机号码 进行无条件呼转至移动总机业务平台语音号码（0451125554），完成业务开 通。 注意：当用户资费变更时，对应档位的成员数上限应立即生效。 2.2 移动总机产品成员信息维护移动总机产品成员信息维护 提供从 boss 平台到移动总机业务平台单向信息同步。 7 2.2.12.2.1 添加成员添加成员 2.2.1.12.2.1.1 boss 到移动总机平台到移动总机平台 2.2.1.1.12.2.1.1.1 业务功能业务功能 由客户经理在 boss 系统完成成员添加功能，并实现与移动总机平台信息同步。 2.2.1.1.12.2.1.1.1 业务流程业务流程 1.在 boss 侧业务受理界面发送受理请求 2.添加成员资料，如姓名、号码、分机短号码等，并进行校验（详细信息参见表 3）。 3.验证通过后 boss 平台将信息发送给移动总机业务平台。 4.移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 5.boss 平台接收移动总机业务平台返回成功信息后，完成一次成员添加操 作。 注：支持以 txt 文本批量导入方式添加成员。 8 2.2.22.2.2 删除成员删除成员 2.2.2.12.2.2.1 boss 到移动总机平台到移动总机平台 2.2.2.1.12.2.2.1.1 业务功能业务功能 由客户经理在 boss 系统完成成员删除功能，并实现与移动总机平台信息同步。 2.2.2.1.22.2.2.1.2 业务流程业务流程 1. 在 boss 侧业务受理界面发送受理请求。 （详细信息见表 4） 2. 移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 3. boss 平台接收移动总机业务平台返回成功信息后，完成一次成员删除操作。 注：支持多选后批量删除方式。 2.2.32.2.3 修改成员修改成员 2.2.3.12.2.3.1 boss 到移动总机平台到移动总机平台 2.2.3.1.12.2.3.1.1 业务功能业务功能 由客户经理在 boss 系统完成成员修改功能，并实现与移动总机平台信息同步。 9 2.2.3.1.12.2.3.1.1 业务流程业务流程 1. 在 boss 侧业务受理界面发送受理请求 2. 修改成员资料，如姓名、号码、分机短号码等，并进行校验（详细信息参见表 3）。 3. 验证通过后 boss 平台将信息发送给移动总机业务平台。 4. 移动总机业务平台接收信息后进行有效性检查，并返回结果给 boss 平台。 5. boss 平台接收移动总机业务平台返回成功信息后，完成一次成员修改操作。 2.3 其他其他 2.3.12.3.1 业务付费优化业务付费优化 总机号码和集团账户进行对应，业务功能费用在集团账户上统一扣费。通话费原由 总机付费费用转至集团账户中扣费，主叫付费费用仍按其号码扣费。 对于 e 档套餐用户，以每月月末成员数量为标准计算功能费。 10 2.3.22.3.2 号段数据接口号段数据接口 提供网内及他网号码号段数据，包括归属地代码（区号）、号码段。用于处理经 移动总机平台呼叫产生费用批价，数据格式及更新频率待定。 11 3 3 附表附表 报文头说明报文头说明 序号元素名 称 类 型 宽 度 描述取值说明 1origdomainstringv4交易请求来源域boss/ ydzj 2homedomainstringv4交易请求目的域boss/ ydzj 5transcodestringv8交易代码参见业务交易代码编码表 6actioncodestringv1交易动作代码0：请求，1：应答 9transidostringv30交易请求流水号在交易发起方唯一标识一个交易的流水号，系统内唯一 11processtimestringv14处理时间发起方发起请求的时间/应答方处理请求的时间 yyyymmddhhmmss 12.1rsptypestringv1应答/错误类型成功：0 系统错误： 1 业务错误： 2 12.2rspcodestringv6应答/错误代码成功：000000 系统错误：000001 业务错误：000002 12.3rspdescstringv256应答/错误描述应答或错误描述 3.1 表表 1 移动总机订购移动总机订购/变更信息表变更信息表 请求报文 提供者：ydzj 调用者：boss 接口名称zjcpdg 消息格式 交易请求来源域 交易请求目的域 交易代码 交易动作代码 交易请求流水号 12 处理时间 唯一id 集团id 集团名称 总机号码 状态 铁通号码 集团计费档次 移动总机业务管理后台登陆密码 客户经理工号 企业联系人姓名 企业联系人电话 响应报文 接口名称zjcpdg 消息格式 交易请求来源域 交易请求目的域 交易代码 交易动作代码 交易请求流水号 处理时间 应答/错误类型 应答/错误代码 应答/错误描述 13 序号描述类型宽度取值说明 0. 唯一 id作为数据库中唯一标识 1. 集团 idstringv32boss 系统中的集团客户编号 2. 集团名称stringv128集团名称 3. 总机号码stringv32需验证号码是否与该集团归属地一致且状态有效、唯一 4. 状态 1 开通 2 变更 3 暂停 4 恢复 5. 铁通号码stringv32可为空 6. 集团计费 档次 stringv32套餐 a、b、c、d、e f 免费 套餐 a 为最多 50 个分机数目（功能费：200 元/月） 套餐 b 为最多 100 个分机数目（功能费：300 元/月） 套餐 c 为最多 200 个分机数目（功能费：400 元/月） 套餐 d 为最多 400 个分机数目（功能费：500 元/月） 套餐 e 为最多 20000 分机数目，功能费 500 +(当前用户数-400) *2 元/月 (超出 400 个用户后,每用户按 2 元/月计) 7. 移动总机 业务管理 后台登陆 密码 stringv326-12 位数字、字母组合，必填 8. 客户经理 工号 stringv32办理该业务的客户经理工号 9. 企业联系 人姓名 stringv32 10. 企业联系 人电话 stringv32 11. 预留信息 1stringv32 12. 预留信息 2stringv32 3.2 表表 2 移动总机销户信息表移动总机销户信息表 请求报文 提供者：ydzj 调用者：boss 接口名称zjcpxh 消息格式 交易请求来源域 交易请求目的域 14 交易代码 交易动作代码 交易请求流水号 处理时间 唯一id 集团id 总机号码 客户经理工号 销户原因 响应报文 接口名称zjcpxh 消息格式 交易请求来源域 交易请求目的域 交易代码 交易动作代码 交易请求流水号 处理时间 应答/错误类型 应答/错误代码 应答/错误描述 15 3.3 表表 3 移动总机移动总机 添加添加/修改修改 成员信息表成员信息表 请求报文 提供者：ydzj 调用者：boss 接口名称zjcydg 消息格式 交易请求来源域 交易请求目的域 交易代码 交易动作代码 交易请求流水号 处理时间 集团id 总机号码 状态 用户id 成员姓名 成员姓名拼音首字母 序号描述类 型 宽度取值说明 1.id作为数据库中唯一标识 2.集团 idstringv32boss 系统中的集团客户编号 3.总机号码stringv32 4.客户经理工号stringv32客户经理工号 5.销户原因stringv128 16 电话号码 分机号码 是否外呼 是否长途 外呼显示号码 外呼付费方式 外呼付费阀值 是否开通办公助手 短信付费方式 是否开通电话会议 是否开通日程提醒 是否开通个人通讯录 是否开通免打扰功能 客户经理号码 预留1 预留2 响应报文 接口名称zjcydg 消息格式 交易请求来源域 交易请求目的域 交易代码 交易动作代码 交易请求流水号 处理时间 应答/错误类型 应答/错误代码 17 应答/错误描述 序号描述类型宽度取值说明 1.集团 idstringv32boss 系统中的集团客户编号。必填 2.总机号码stringv32需验证号码是否与该集团归属地一致且状态有效、唯一。 必填 3.状态stringv11 开通 2 变更 4.用户 idstringv32成员编号。（不可修改） 本集团内部唯一，必填 5.成员姓名stringv16必填 6.成员姓名拼音首字母stringv16必填 7.电话号码stringv32允许添加他网号码。（不可修改） 号码与该集团归属地一致。必填 对于移动号码需验证当前状态是否有效。 8.分机号码stringv32本集团内部号码唯一，必填 号码规则： 1、分机号码长度应为 4 到 6 位 2、移动用户分机号码第一位为 6,第二位不能为 0 3、他网用户分机号码第一位必须设置为 8 9.是否开通外呼权限numberf11 开通 0 关闭 默认为 1 10.是否开通长途权限numberf1仅当开通外呼权限时才可以开通长途权限 1 开通 0 关 闭 默认为 0 11.外呼显示号码numberf10 主叫号码 1 总机号码 默认为 0 12.外呼付费方式numberf10 主叫号码 1 总机号码 默认为 1 13.外呼付费阀值integerf5单位：元，默认为 0 14.是否开通办公助手numberf11 开通 0 关闭 默认为 0