产品详细设计说明书 - 调账.doc

Telenor 系统系统 账单管理子系统账单管理子系统 功能设计说明书功能设计说明书 编 写胡波编写 时间2015 12 22 审 批审批 时间 版本V0 16 亚信科技 中国 有限公司版权所有亚信科技 中国 有限公司版权所有 文档中的全部内容属亚信科技 中国 有限公司所有 未经允许 不可全部或部分发表 复制 使用于任何目的 文档修订摘要文档修订摘要 日期日期版本号版本号修订章节修订章节描述描述作者作者评审者评审者评审日期评审日期 2014 01 17V0 1初稿林荣福 2014 02 13V0 2评审后修改林荣福 2014 03 20V0 3修改文档格式林荣福 2014 4 28V0 6 添加调账规则和批量调账调账 原因 林荣福 2014 09 05V0 8按照产品调账林荣福 2014 09 24V0 9多账期调账林荣福 2014 10 15V1 1添加 crm 审批林荣福 2015 06 01V1 2增加调账原因科目胡波 2015 08 11V1 3Invoice 级调账胡波 2015 08 12V1 4Add line 调账胡波 2015 09 06V1 5用户级调账胡波 2015 12 22V1 6反悔期调账胡波 目录目录 1引言引言 1 1 1文档用途 1 1 2阅读对象 1 1 3名词术语 1 1 4参考资料 1 2概述概述 3 2 1调账子系统概述 3 2 2调账子系统功能定义 3 2 3设计约束 3 2 4复用内容 4 3总体结构说明总体结构说明 5 3 1系统结构 5 3 1 1系统内外部关系图 5 3 1 2功能模块简要说明 5 3 1 3依赖的外部接口 5 3 1 4对外提供的接口 13 3 2模块程序构建结构图 14 4子系统功能设计子系统功能设计 15 4 1账单调整子系统功能设计 15 4 1 1数据模型设计 15 4 1 2功能实现说明 22 4 1 3界面实现说明 34 4 2CREDIT NOTE 42 4 2 1数据模型设计 42 4 2 2功能实现说明 50 4 2 3界面实现说明 52 5附录附录 53 5 1错误码列表 53 5 2需求文档功能跟踪矩阵 53 1 引言引言 1 1 文档用途文档用途 本文档的目的是确定 Veris Billing 账单管理模块的功能范围 明确账单管理功 能的设计方案 指导开发人员完成开发设计工作 并帮助测试人员编写测试案例 1 2 阅读对象阅读对象 产品设计工程师 产品开发工程师 产品测试工程师 其他相关人员 1 3 名词术语名词术语 缩写 术语缩写 术语解解 释释 正向调账 正向调账也叫向上调账 是指因资费或其他特殊原因需增加客 户的账单费用 表示客户需向运营商多缴纳一笔费用增加客户 的账单费用叫做正调账 负向调账 负向调账也叫向下调账 常用于发生投诉时减少目标费用额度 表示运营商多收了客户费用 需退还给客户减少客户的账单费 用叫做负调账 Credit Note 当客户收到错误的帐单之后 基于法律要求 需要再给客户邮 寄一份说明 告知其错误原因 正确帐单邮寄时间等信息 当 账单因负向调整账单的时候还需要寄送 Credit Note 给客户当 客户收到错误的帐单之后 基于法律要求 需要再给客户邮寄 一份说明 告知其错误原因 正确帐单邮寄时间等信息 当账 单上的金额比客户实际使用金额多时需要寄送 Credit Note 呆账 呆账是指超过缴费期限 经过催讨仍然没有缴清 可能成为坏 账的账单 坏账坏账是指无法收回或极小可能收回款项的账单 1 4 参考资料参考资料 1 OpenBilling6 0 帐务管理详细设计规格说明书 调账 doc 2 Credit Note 需求说明书 v1 0 doc 3 调账软件需求说明书 v1 0 doc 3 4 呆坏账功能规格说明书 v1 2 doc 2 概述概述 2 1 调账子系统概述调账子系统概述 账单是用户消费记录查询的依据 账单用于记录客户使用计费服务产生的各种费 用明细 Billing 系统需要能够对客户产生的这些账单进行查询和修改操作 客户能 够账单查询来知晓自己的消费记录 如果客户的账单出现问题 需要有改正机制对账 单进行修改 2 2 调账子系统功能定义调账子系统功能定义 按照功能的不同可以将账单管理系统分为如下几个模块 1 账单查询 2 账单调整 3 调账审批流程 2 3 设计约束设计约束 调账模块设计的时候有如下的设计约束账单管理模块设计的时候有如下的设计约束 1 调账往下调整账单的时候调整额度如果大于客户的未缴金额则多余部分要当做 Advance Payment 返回给客户 例如 客户账单为 100 未缴金额为 40 如果往 下调整 60 则账单往下调整 40 剩余的 20 会当做 Advance Payment 返回给客户 2 往下调整账单的时候必须生成往下调整账单的时候可以指定是否生成 Credit Note 3 调整账单明细的时候账单总金额要一起调整 需要保证账单总金额和账单明细金额 加起来的总额相等 4 只有有调账权限的操作员才可以执行调账操作 如调账 200 元 只有操作权限 大于 200 的操作员才可以进行调账操作 操作权限小于 200 元的操作员是无法执行此 次调账的 需要提交申请单给高权限的操作员 4 5 呆坏账账单不允许进行调账 无科目调账的时候需要使用默认调帐科目进行调账 5 2 4 复用内容复用内容 3 总体结构说明总体结构说明 3 1 系统结构系统结构 3 1 1系统内外部关系图系统内外部关系图 3 1 2功能模块简要说明功能模块简要说明 1 账单查询 将客户的实时账单和历史账单进行查询 使客户可以查询自己的实时消 费记录和历史消费记录 2 调账执行 对某个费用科目 某个账单进行调整 以一定的形式 一次性费用 负 账单 账单 账本 外部费用 反馈给用户 3 调账审批流程 当操作员权限不足时 不足以达到所需的金额限制 发送调账申请 给上一级等待审批通过 再调用调账执行 3 1 3依赖的外部接口依赖的外部接口 3 1 3 1权限查询接口权限查询接口 权限查询接口分为当前操作员权限查询和查询具有调账权限的操作员信息两个接口 查询当前操作员权限 名称 do queryOperEntity 接口路 径 com ailk openbilling service imsinner IImsReverseService do queryOperEntity 原型 public Do queryOperEntityResponse do queryOperEntity SOperInfo SOper SQueryOperEntityReq SQueryOperEntityReq 功能查询当前操作员权限信息 字段类型字段名称说明 SOperInfoSOper工单入参 参数 SQueryOperEntityReq SQueryOperEntityRe q 权限查询参数 字段类型说明 返回值 Do queryOperEntityRespons返回值结构体 e 备注该接口可以根据当前操作员的 ID 查询出操作员所具有的调账权限 SOperInfo 字段类型字段名说明 Stringso nbr交易流水号 Integerbusi codeAPI 业务编码 Shortso mode受理一级区划编码 Stringso date受理二级区划编码 Shortcharge flag受理渠道类型 Shortisnormal受理渠道 Stringouter cust id外部客户标识 Longcust id客户标识 Stringouter acct id外部账号标识 Longacct id账号标识 Longuser id用户 id Stringphone id电话号码 Longop id操作员 id shortprov code省市编码 Shortregion code地区编码 Shortcounty code国家编码 Integerorg id备用字段 Stringrso nbr备用字段 Shortis monitor备用字段 Stringremark备注信息 Shortstep id备用字段 Stringsource system对外围系统的定义 Shortnotify flag告警标志 Stringtenant id租户 id SQueryOperEntityReq 字段类型字段名说明 StringopId操作员标识 StringorgId组织标识 StringacceptStaffId受理员工号 Do queryOperEntityResponse 字段类型字段名说明 List entityIds 操作员的权限信息 查询具有调账权限的操作员信息 名称do queryOperByEntityIds 接口路径 com ailk openbilling service imsinner IImsReverseService do queryOperByEntityIds 原型 public Do queryOperByEntityIdsResponse do queryOperByEntityIds SOperInfo SOper SQueryOperByEntityIdsReq SQueryOperByEntityIdsReq 功能查询具有调账权限的操作员信息 字段类型字段名称说明 SOperInfoSOper工单入参 参数 SQueryOperByEntityIdsReq SQueryOperByEntityIdsRe q 权限查询参数 字段类型说明 返回值Do queryOperByEntityIdsRespons e 返回值结构体 备注该接口可以根据需要的权限信息查询具有该权限的操作员信息 SQueryOperByEntityIdsReq 字段类型字段名说明 List entityIds 需要查询的权限信息 StringopId操作员标识 StringorgId组织标识 StringacceptStaffId受理员工号 Do queryOperByEntityIdsResponse 字段类型字段名说明 ListoperInfoList需要查询的权限信息 OpInfo 字段类型字段名说明 StringopId操作员标识 StringoperatorId操作员编码 StringstaffId序列号 StringloginName操作员工号 StringcustOpId客服员工编号 StringpassWord登录密码 StringsecurityLevel密码安全级别 StringallowUpdateFlag是否允许修改密码 StringeffectDate账号生效时间 StringexpireDate账号失效时间 StringtryTimes失败登录尝试次数 StringlockFlag账号锁定状态 StringpWDEffectDate密码生效时间 String chgPWDAlarmDay s 密码过期提前通知天数 StringpWDUpdateAlarm密码修改提醒标示 StringisAdmin是否是超级管理员 StringorgId操作员组织 StringparentOrdId操作员上级组织 StringregionCode操作员地市 StringdefaultSys操作员状态 StringstaffName操作员默认系统 StringorgName员工姓名 Stringstatus状态 StringtenantId租户 id 3 1 3 2一次性费用接口一次性费用接口 名称用户级优惠 Sdl 文件onetimecharge def sdl onetimecharge sdl 原型 int32 otc calc in MOnetimechargeDef SOtcCalc sOtcCalc out MOnetimechargeDef SOtcConfirm sOtcConfirm 功能用户级优惠月帐计算 字段类型字段名称说明 上行参数MOnetimecharge Def SOtcCalc sOtcCalc 字段类型字段名称说明 下行参数 MOnetimechargeDe f SOtcConfirm sOtcConfirm 错误码cErrorMsg 错误信息返回值 SOtcCalc 字段类型字段名说明 int64 cust id 客户编号 int64 acct id 帐户编号 int64 pay acct id付费账户 int64 resource id设备编号 int64 otc opt date 一次性费用产生的时间 int64 so nbr 工单号 int32 spec id 业务代码 int32 pricing plan id定价计划 ID int16channel id渠道 ID int16 calc type算费类型 int16 service type业务类型 1 recurring 2 on demand int32accumulate times累计次数 int16 object type0 设备 相关客户信息全传 1 账户 只传 cust id acct id int16 deduct type扣费模式 0 非强制扣费 1 强制扣费 int16 billing type0 预付费 1 后付费 int16 event type算费事件 0 正式算费冻结接口 累计量冻结 费用冻 结 1 算费累计接口 计算费用 更新累计量 stringphone id手机号 stringtopup phone id充值手机号 充值的号码 即被充入资金的号码 SOtcFeeList otc fee list算费接口费用列表 ExtParaMapext para扩展参数 SOtcConfirm SOtcConfirm 字段类型字段名说明 int64 cust id 客户编号 int64 acct id 帐户编号 int64 pay acct id付费账户 int64 resource id设备编号 int64 otc opt date 一次性费用产生的时间 int64 so nbr 工单号 int32 spec id 业务代码 int32 pricing plan id定价计划 ID int16channel id渠道 ID int16 calc type算费类型 int16 service type业务类型 1 recurring 2 on demand int32accumulate times累计次数 int16 object type0 设备 相关客户信息全传 1 账户 只 传 cust id acct id int16 deduct type扣费模式 0 非强制扣费 1 强制扣费 int16 billing type0 预付费 1 后付费 int16 event type算费事件 0 正式算费冻结接口 累 计量冻结 费用冻结 1 算费累计 接口 计算费用 更新累计量 stringphone id手机号 string topup phone id 充值手机号 充值的号码 即被充入资 金的号码 int32 result value 计算费用各种返回情况 1 无资费 2 正常算费成功 3 预付费业务扣费失败 即余额不足 含分帐帐户帐单 SOtcUserInfootc user info一次性费用资料信息 SOtcFeeLogList otc fee log list算费接口费用日志列表 SOtcTaxFeeList otc tax fee list税费列表 SAccumulateLogListaccumulate log list累计量日志列表 SBillRoundDetailListround detail list税费遗失信息 ExtParaMapext para扩展参数 MAbmInterfaceBillingDef SAbmSessionInfoList session listsession 编号 MAbmInterfaceBillingDef SAbmSessionInfoList reguide session list一次性费用扣费中的代付 累计量会 话编号 MAbmInterfaceBillingDef SAccumulateList accumulate list累计量记录 MAbmInterfaceBillingDef SPayFeeLogList pay fee log list代付日志信息 MAbmInterfaceBillingDef SBudgetInfoList budget list预算信息 MAbmInterfaceBillingDef SDeductBalanceList deduct balance list剩余资金 MAbmInterface SDeductBillList bill list历史欠费 MAbmInterface SPocketDeductLogList pocket deduct list帐本冲销日志 MAbmInterface SCreditDeductLogList credit deduct list信用度冲销日志 MAbmInterface SBudgetDeductLogList budget deduct list预算冲销日志 3 1 3 3冲销接口冲销接口 名称deduct 接口路径 com ailk openbilling topuppayment business payment AbmMgnt deduct 原型 public int deduct WriteoffRet writeoffRet Holder List listCredit Holder List listPocketDeductLog 功能进行账单的冲销 字段类型字段名称说明 WriteoffRetwriteoffRet冲销参数 Holder List listCredit信用度信息参数 Holder List listPocketDeductLo g 冲销记录 字段类型说明 返回值 int返回值 1 冲销成功 备注该接口可以根据需要的权限信息查询具有该权限的操作员信息 WriteoffRet 字段类型字段名说明 ListcDeductBillList冲销账单信息 CaPocketcAPocket账本信息 ListnotificationList告警参数 LongacctId账户编号 IntegerbillDate账单日期 IntegernotificationId 告警编号 SCredit 字段类型字段名说明 int64acct id 帐户编号 int64serv id 用户编号 int64asset id 资产编号 int64amount 信用度值 int64freeze fee 冻结费用 int64deduct fee 当前冲销额度 int64his deduct fee 历史冲销费用 int64real deduct fee 实时冲销费用 int64risk deduct fee 欠控冲销费用 int64risk freeze fee 欠控冻结费用 int64valid date 生效期 int64expire date 失效期 int64last update time 上次更新时间 int32risk freeze time 欠控冻结时间 int32risk deduct time 欠控冲销时间 int32item code 信用度科目编号 int32freeze time 冻结时间 int32measure id 货币编号 int64tenant id mvno 标记 int16billing type 计费类型 0 int16credit flag 是否为临时信用度 0 否 int16hierarche type 层级标志 SPocketDeductLog 字段类型字段名说明 int64acct id 帐户编号 int64serv id 用户编号 账本 int64bill object id 使用对象 账单 int64bill id 帐单编号 int64asset id 资产编号 int64product id 产品编号 账单 int64woff fee 本次冲销费用 int64woff tax fee 本次冲销税费 int64bill begin date 账单起始时间 int32pocket item code 账本科目编号 int32pocketmeas id 资金货币编号 int32bill item code 账单科目代码 int64tenant id mvno 标记 int16bill object type 使用对象类型 账单 int16bill billing type 付费类型 账单 int16confirm bill force 费用强制转移 0 非强制 1 强制 floatexchange rate 汇率 创建申请单接口创建申请单接口 名称DoCreateTicket 接口路径 com ailk openbilling service imsinner IImsReverseService DoCreateTi cket 原型 public DoCreateTicketResponse DoCreateTicket SOperInfo soperinfo DoCreateTicketReq docreateticketreq 功能向 CRM 提交申请单 字段类型字段名称说明 SOperInfosoperinfo工单公共头参数 DoCreateTicketReqdocreateticketreq申请单明细 字段类型说明 返回值 DoCreateTicketResponse返回值 备注该接口可以向 CRM 提交调账申请单 DoCreateTicketReq 字段类型字段名说明 AdjustIdString调账 id 调账的唯一编码 代码由 3 部分组成 调帐时间 YYYYMMDD 15 位帐户编号 不足前补 0 15 位的业务工 单号 不足前补 0 20140701 000000878253500 000000026650833 20140701000000878253500000000026650833 OperateWayShort操作方式 1 初次提交 2 修改后提交 AdjustAmountDouble调账金额 trouble ticket 将根据该参数值路由到不同审批金额 权限的工作组 AdjustDescString调账描述 本次调账信息的文本化的描述 trouble ticket 直接存 储到工单内容中 Billing 测示例 调帐原因代码 0002 调帐总 金额 200 0 调帐备注 费用错误 AdjustDetailUrlString调账详情界面 url 在 Trouble ticket 工单详情界面上 可通过点 击调账 id 后面的按钮 打开 billing 提供的详细的结构化界面 Billing 提供的 url 会自动拼装一些页面必要参数 通过 URL 直接传进来 OperatorId String操作员 id sec sec operator operator id AcceptStaffId String操作员 id TenantId String租户 DoCreateTicketResponse 字段类型字段名说明 ShowSerialNo String工单流水号 算税接口算税接口 名称taxFeeCalculate 接口路径 com ailk openbilling topuppayment consume SalInterface taxFeeCalculate 原型public STaxOut taxFeeCalculate STaxIn staxIn 功能算税 字段类型字段名称说明 参数 STaxInstaxIn算税入参 字段类型说明 返回值 STaxOut返回值 备注对费用科目进行算税 STaxIn 字段名字段类型说明 billListCsdlArrayListSBillInfo 结构 billId 标识唯一性 sbill caBill 结构字段 flag 0 正常账单 rcbilldetaillist caBillItem 结构 STaxOut 字段名字段类型说明 billListCsdlArrayListSBillInfo 结构 rcbilldetaillist caBillItem 结构 算税后的费用科目 taxbilldetaillist caBillTax 结构 算出来的税 3 1 4对外提供的接口对外提供的接口 3 1 4 1调账对外接口调账对外接口 com ailk openbilling topuppayment service billAadjust BillAdjustService adj ustBill AdjustBillIn adjustIn CommonParam commonParam AdjustBillInAdjustBillIn 字段类型字段名说明 LongacctId账户编号 StringadjustType调整方式 有两位 第一位是上调的方式 第二位是下 调的方式 0 表示调一次性费用 1 表示调账单 不需 要传入 shortbillFlag0 调整历时账单 1 调整实时账单 默认 0 IntegermeasureId货币单位 ListlistAdjustDtl调整明细 StringadjReason调整原因 调整备注 IntegeradjCode调整原因 Code IntegersynAssetFlag是否需要校验 db mdb 一致性 默认不校验 ShortneedCreditNote0 不需要生成 Credit Note 1 需要生成 Credit Note ShortnextBill下账期标志位 当为 1 的时候则是调到外部费用 只有下调的时候可以传入 LongresourceId用户 id doubleamount无账单调账金额 BooleancheckPermission是否需要校验权限 默认是 true false 的时候不校 验 AdjustBillDtlAdjustBillDtl 字段类型字段名说明 LongbillNo账单编号 StringinvoiceNumberInvoice Number IntegeradjCode调整原因 Code IntegeradjustFee调整金额 IntegeritemCode调整科目 IntegerbillMonth账单月 调账审批反馈接口调账审批反馈接口 com ailk openbilling topuppayment service billAdjust BillAdjustService dealApproveResponse CommonParam commonParam ApproveResult approveResult ApproveResultApproveResult 字段名字段类型说明 adjustId String 调账的唯一编码 代码由 3 部分组成 调帐时间 YYYYMMDD 15 位帐户编号 不足前补 0 15 位的业务工单号 不足 前补 0 approveResultShort 1 审批通过进行调账 2 审批不通过并退回修改 3 取消调账单 approveResultD esc String审批附加信息 operatorId Long调整科目 模块程序模块程序构建构建结构图结构图 4 子系统功能设计子系统功能设计 4 1 账单调整子系统功能设计账单调整子系统功能设计 4 1 1数据模型设计数据模型设计 4 1 1 1逻辑实体模型逻辑实体模型 1 模型上需要增加权限申请记录表和调账审批明细表用于对调账操作进行申请和 审批 2 使用现有表 CA APPLIED RATE 表用以记录调账信息 3 在 SYS ENUM DATA 中添加基础数据用来记录权限的等级划分 4 1 1 1 1 实体模型实体模型 调账审批模型 CA APPROVAL DTL DTL CA APPROVAL 调账规则模型 BI BUSI AVAILABLEBI BUSI PLAN PM COMPOSITE RULE PRICEPM PROD OFFER PRICE RULE PM ADJUST RULE 4 1 1 2表结构 物理设计 表结构 物理设计 4 1 1 2 1 表汇总表汇总 序号子系统表名中文名称和简单描述 1 CA APPROVAL权限申请记录表 2 调账审批 CA APPROVAL DTL申请审批明细表 3 CA BUSI REC BILL调账扩展工单表 4 PM ADJUST RULE调账规则表 5 调账执行 PM REASON CODE调账原因表 6 CA BILL账单表 7 CA BILL ITEM账单明细表 8 账单查询 CA BILL PROD产品话费周期表 4 1 1 2 1 1权限申请记录表权限申请记录表 CA APPROVAL 权限申请记录表用来记录操作员提交的申请单 按照创建时间进行分表 主键为 流水号 字段名数据类型字段简单描述 so nbrLong 流水号 create dateDate 创建时间 busi spec idInteger 业务类型 acct idLong 账户编号 reasonString 申请原因 remarkString 审批备注 deal flagshort 处理状态 0 未审批 1 审批通过 2 审批不通过 deal dateDate 审批日期 deal amountLong 涉及的总金额 measure idInteger 货币单位 Comment J1 名称修改一下 approve opIdLong 审批操作员编号 approve orgIdInteger 审批操作员组织 op IdLong 申请操作员编号 org IdInteger 申请操作员组织 tenant idLong 租户 id ext1String 扩展字段 1 调账这里是 billFlag 0 调整历史 账单 1 调整实时账单 ext2String 扩展字段 2 调账这里用于区分是否需要生成 Credit Note 0 不生成 1 要生成 ext3String 扩展字段 3 调账这里是是否调整到下账期 0 否 1 调整到下账期是否调整到下账期 4 1 1 2 1 2申请审批明细表申请审批明细表 CA APPROVAL DTL 审批明细表用以记录申请单需要操作的业务的详细信息 按照创建时间进行分表 主键是流水号和创建时间还有科目 字段名数据类型字段简单描述 so nbrLong 流水号 create dateDate 创建时间 busi spec idInteger 业务类型 ext1String 扩展字段 1 这里是 Invoice no ext2String billNo adjust code resourceId base invoice amount 扩展字段 2 这里是 bill no amountLong 设计的资产额度 measure idInteger 货币单位 item codeInteger 科目编号 acct idLong 账户编号 tenant idLong 租户 ID 4 1 1 2 1 3调账扩展工单表调账扩展工单表 CA BUSI REC BILLL 字段名数据类型字段简单描述 sonbrLong 工单流水号 so dateDate 工单时间 acct idLong 账户编号 item codeInteger 调账科目 adjust feeLong 调整费用 measure idInteger 货币单位 bill monthInteger 账期月 begin dateDate 账期开始时间 end dateDate 账期结束时间 adjust typeShort 调账类型 0 一次性费用 1 账本 2 账单 3 外部 费用 5 负账单 reason codeInteger 调账原因 resource idLong 用户编号 tenant idLong 租户 negative invoice nString 生成的负账单的 invoice no o base item codeLong 原始科目 4 1 1 2 1 4调账规则表调账规则表 PM ADJUST RULE 调账规则表规定了调账的调整方式 以及是否需要生成 Credit Note 等信息 字段名数据类型字段描述 price rule idInteger 定价计划 need credit flagInteger 下调的时候是否需要生成 Credit Note0 需要 1 不需要 positive flagInteger 正向调账方式 0 一次性费用 1 账本 2 账单 3 外 部费用 月底收 negative flagInteger 负向调账方式 0 一次性费用 1 账本 2 账单 3 外 部费用 月底收 valid typeInteger 调到账本的时候账本的生效时间 1 指定时间 2 月末 3 延长天数 4 自然月 5 账期 6 使用系统默认值 valid unitInteger 调到账本的时候账本的生效时间 1 YYYYMMDD 2 当前时间所在月的月末 3 从当前时间延长的天数 可以小于 0 4 从当月过 n 个自然月生效 为 0 指当前月 月初 为 1 下个月月初 5 从当前账期延长 n 个账期生效 为 0 指当 前账期开始时间 为 1 下个账期开始时间 6 使用系统默认值 tenant idLong 租户 4 1 1 2 1 5调账原因表调账原因表 PM REASON CODE 调账原因表记录了调账可以选择的所有原因类型 原因按照不同类型进行分组 字段名字段类型字段描述 code idInteger 调账原因代码 ID busi spec idInteger 业务类型 code typeInteger 原因类型 descriptionString 调账原因描述 tax IncludeInteger 0 需要反算调税 1 不调不需要反算税 nameString 显示的原因值 用于页面显示 tenant idLong 租户 is displayShort 是否需要展示 approval flagShort 是否需要审批 0 需要 1 不需要 默认 0 base item flagShort 是否基于账单调整 0 不基于 1 基于 adjust flagShort 调整类型 1 不参考 0 上调 1 下调 Item codeLong 调账原因科目 4 1 1 2 1 6调账履历表调账履历表 CA BUSI REC IDX 字段名数据类型字段简单描述 acct idLong 账号 invoice noString 账单号 amountLong 改变金额 measure id 金额单位 so nbr 工单号 so date 工单时间 busi spec id 业务规格 bill month 账单月 tenant id 租户 ext1 扩展字段 1 调账目前用于展现调账费用类型 ext2 扩展字段 2 ext3 扩展字段 3 4 1 1 3视图列表视图列表 4 1 2功能实现说明功能实现说明 功能概要说明功能概要说明 当系统因为任何错误 如常见的资费配置错误 客户资料受理错误 甚至有些系 统未知错误 计算出来的账单费用和客户实际使用的费用不一致时需要有修正机制对 客户的账单费用进行修改 调账功能模块的作用就是允许有一定权限的操作员对费用 或账单进行调整 以此来人为修正这些错误带来的错误账单结果 调账按照调账类型的不同可以分为正向调账和负向调账两种 正向调账也叫向上 调账 是指因资费或其他特殊原因需增加客户的账单费用 表示客户需向运营商多缴 纳一笔费用 负向调账也叫向下调账 常用于发生投诉时减少目标费用额度 表示运 营商多收了客户费用 需退还给客户 按照功能的不同可以将调账划分为如下功能模块 1 调账审批 2 调账执行 4 1 2 2 4 1 2 2数据流程图数据流程图 调账审批调账执行 调账明细 查询更新 CA APPROVALCA APPROVAL DTL 账单明细调账金额 ABM信用度信息 更新 Credit Note记录业务工单 账单调 整总额 插入 CA INFO NOTE 调账结果 插入 CA BUSI REC CA BILL ITEM CHG CA BUSI REC BILL CA BILL PROD CA BILL ITEM CA BILL 更新 调账审批 科目调账 非科目调账 调账明细 查询更新 CA BUSI AUTHCA AUTH DTL 账单明细调账金额 信用度信息 信用度信息 更新 更新 账单信息 Credit Note记录业务工单 账单调 整总额 插入 CA INFO NOTE 调账结果 插入 CA BUSI REC CA BILL ITEM CHG CA APPLIED RATE 4 1 2 34 1 2 3序列图序列图 4 1 2 4 4 1 2 4功能点实现说明功能点实现说明 4 1 2 4 1 调账审批和权限控制调账审批和权限控制 调账审批是调账执行的一部分 当操作员进行调账时 需要先判断自己当前的操 作权限是否可以执行此次调账 如果权限足够则直接进行调账操作 如果权限不足 则需要提交申请单给上级操作员进行审批 现在审批放在 CRM 侧 操作员申请的时候 会调用 CRM 接口生成申请单 上级操作员可以在调账详情页面查看调账的明细信息 审批完成后 CRM 会调用 Billing 的反馈接口进行审批结果反馈 如果审批成功 则直 接调用调账接口进行调账 如果审批失败 需要退回修改 则将申请单状态设置为审 批失败 等待修改 申请人在看到审批失败后可以修改申请单 然后进行重新提交 如果上级操作员想取消这个申请单 则将申请单置为撤单状态 撤单状态的申请单表 明不执行此次调账 调账开始 查询当前操作员调 账权限 权限是否可 以执行调账 进行调账操作 查询具有该操作权 限的操作员信息 是否 提交申请单 结束 审批开始 查询提交给自己的 申请单 是否执行 该调账操作 将申请单状态修改 为审批通过 将申请单状态修改 为审批不通过 是否 执行调账操作 结束 业务开始 执行调账 是否有权 限调账 执行调账 权限足够 Billing CRM 向CRM提交申请 单 权限不足 操作员 是否有权 限审批 转发给上级进 行审批 没有权限 执行审批有权限 在调账详情页 面查看调账明 细 反馈审批结果 给Billing 修改申请单状 态为审批失败 等待修改 审批失败 修改申请单状 态为审批成功 修改申请单状 态为撤销申请 单 审批成功 撤销审批单 修改申请单后 重新提交给CRM 进行审批 记录业务工单 业务结束 调账权限调账权限 一 调账金额权限 1 调账金额 1 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000243 代表调账操作员的第一级权限 调账金额从 0 1499 对应 crm 的是实体编号为 77000243 2 调账金额 2 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000244 代表调账操作员的第二级权限 调账金额从 1499 2499 对应 crm 的实体编号是 77000244 3 调账金额 3 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000245 代表调账操作员的第三级权限 调账金额从 2499 9999 对应 crm 的实体编号是 77000245 4 调账金额 4 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000249 代 表调账操作员的第四级权限 调账金额从 9999 49999 对应 crm 的实体编号是 77000249 5 调账金额 5 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000250 代 表调账操作员的第五级权限 调账金额从 49999 正无穷 拥有这个权限的人有最高的 操作权限 可以操作所有调账金额 对应 crm 的实体编号是 77000250 二 其他调账权限 1 显示不审批的调账原因权限 拥有该权限的操作员才会显示不审批的调账原因 如果没有该权限 界面上只显示需要审批的调账原因 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000246 对应的 crm 实体编号是 77000246 2 显示发送 credit note 选项权限 拥有该权限的操作员才可以选择下调发送 credit note 并且直接调整历史账单 没有该权限的操作员做下调的时候默认调到下 账期 有该权限的操作员选择了发送 credit note 则不再调到下账期 而是直接调整 历史账单并且给客户发送 credit note 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000247 对应的 crm 实体编号是 77000247 3 是否允许操作员输入调账金额权限 拥有该权限的操作员才可以进行调账金额 的输入 否则只能将账单调整为 0 对应 MD SYS PRIVILEGE 表中的 PRIV CODE 为 adjust 77000248 对应的 crm 实体编号是 77000248 权限实体的获取权限实体的获取 当从 crm 页面第一次跳转到账管页面时 会回调 sso 接口放入权限实体 而是从 系管的配置表中获取权限信息 系管在单点登录成功以后会将权限信息放到 session 中 如果从 session 中取出来的对应权限的 value 为 16 代表拥有该权限 例如调账 2600 如果从 session 中取出来的权限 code adjust 77000245 对应的 value 为 16 代 表该操作员可以执行调账 如果 value 不是 16 则代表没有权限 需要创建申请单 当页面集成在 CRM 中的时候 系管会从 crm 查询出操作员对应的所有权限并放到 session 中 调账的时候根据 session 中的权限信息进行权限的判断 4 1 2 4 2 调账执行调账执行 调账执行步骤如下 1 校验 校验输入的用户名 invoice 级调账如果已经调过则不允许再次调账 2 账单查询 将传入的费用科目绑定原始 bill 3 定型 根据调整类型和调整明细对账单进行调整 根据调整的类型来进行调账 操作 一次性费用 无账单调账上调 无账单调账下调 账单级调账下调 负账单 账单级调账下调 4 算税 分析调账原因 如果是需要算税的调账原因 则将输入科目的含税金额 拆分为税和不含税两部分 5 调用冲销接口 将调整费用体现在信用度上 6