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

1、Telenor 系统系统(账单管理子系统账单管理子系统)功能设计说明书功能设计说明书编 写胡波编写 时间2015-12-22审 批审批 时间版本V0.16亚信科技（中国）有限公司版权所有亚信科技（中国）有限公司版权所有文档中的全部内容属亚信科技（中国）有限公司所有，未经允许，不可全部或部分发表、复制、使用于任何目的。功能设计说明书模板文档修订摘要文档修订摘要日期日期版本号版本号修订章节修订章节描述描述作者作者评审者评审者评审日期评审日期2014-01-17V0.1初稿林荣福2014-02-13V0.2评审后修改林荣福2014-03-20V0.3修改文档格式林荣福2014-4-28V0.6添加调

2、账规则和批量调账调账原因林荣福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反悔期调账胡波功能设计说明书模板i目录目录1引言引言.11.1文档用途.11.2阅读对象.11.3名词术语.11.4参考资料.12概述概述.32.1调账子系统概述.32.2调账子系统功能定义.32.3设

3、计约束.32.4复用内容.43总体结构说明总体结构说明.53.1系统结构.53.1.1系统内外部关系图.53.1.2功能模块简要说明.53.1.3依赖的外部接口.53.1.4对外提供的接口.133.2模块程序构建结构图.144子系统功能设计子系统功能设计.154.1账单调整子系统功能设计.154.1.1数据模型设计.154.1.2功能实现说明.224.1.3界面实现说明.344.2CREDIT NOTE.424.2.1数据模型设计.424.2.2功能实现说明.504.2.3界面实现说明.525附录附录.535.1错误码列表.535.2需求文档功能跟踪矩阵.53功能设计说明书模板11 引言引言1

4、.1 文档用途文档用途本文档的目的是确定 Veris Billing 账单管理模块的功能范围，明确账单管理功能的设计方案，指导开发人员完成开发设计工作，并帮助测试人员编写测试案例。1.2 阅读对象阅读对象产品设计工程师产品开发工程师产品测试工程师其他相关人员1.3 名词术语名词术语缩写、术语缩写、术语解解 释释正向调账正向调账也叫向上调账，是指因资费或其他特殊原因需增加客户的账单费用，表示客户需向运营商多缴纳一笔费用增加客户的账单费用叫做正调账负向调账负向调账也叫向下调账，常用于发生投诉时减少目标费用额度，表示运营商多收了客户费用，需退还给客户减少客户的账单费用叫做负调账Credit Note

5、当客户收到错误的帐单之后，基于法律要求，需要再给客户邮寄一份说明，告知其错误原因，正确帐单邮寄时间等信息。当账单因负向调整账单的时候还需要寄送 Credit Note 给客户当客户收到错误的帐单之后，基于法律要求，需要再给客户邮寄一份说明，告知其错误原因，正确帐单邮寄时间等信息。当账单上的金额比客户实际使用金额多时需要寄送 Credit Note。呆账呆账是指超过缴费期限，经过催讨仍然没有缴清，可能成为坏账的账单。功能设计说明书模板2坏账坏账是指无法收回或极小可能收回款项的账单。1.4 参考资料参考资料1. OpenBilling6.0 帐务管理详细设计规格说明书-调账.doc2. Credi

6、t Note 需求说明书 v1.0.doc3. 调账软件需求说明书 v1.0.doc3.4. 呆坏账功能规格说明书 v1.2.doc 软件功能设计说明书22 概述概述2.1 调账子系统概述调账子系统概述账单是用户消费记录查询的依据，账单用于记录客户使用计费服务产生的各种费用明细， 。Billing 系统需要能够对客户产生的这些账单进行查询和修改操作。客户能够账单查询来知晓自己的消费记录。如果客户的账单出现问题，需要有改正机制对账单进行修改。2.2 调账子系统功能定义调账子系统功能定义按照功能的不同可以将账单管理系统分为如下几个模块：1. 账单查询。2. 账单调整。3. 调账审批流程。2.3 设

7、计约束设计约束调账模块设计的时候有如下的设计约束账单管理模块设计的时候有如下的设计约束：1.调账往下调整账单的时候调整额度如果大于客户的未缴金额则多余部分要当做Advance Payment 返回给客户（例如：客户账单为 100，未缴金额为 40，如果往下调整 60，则账单往下调整 40，剩余的 20 会当做 Advance Payment 返回给客户） 。2.往下调整账单的时候必须生成往下调整账单的时候可以指定是否生成 Credit Note。3.调整账单明细的时候账单总金额要一起调整，需要保证账单总金额和账单明细金额加起来的总额相等。4. 只有有调账权限的操作员才可以执行调账操作（如调账

8、200 元，只有操作权 软件功能设计说明书3限大于 200 的操作员才可以进行调账操作，操作权限小于 200 元的操作员是无法执行此次调账的，需要提交申请单给高权限的操作员） 。4.5. 呆坏账账单不允许进行调账。无科目调账的时候需要使用默认调帐科目进行调账。5.2.4 复用内容复用内容 软件功能设计说明书43 总体结构说明总体结构说明3.1 系统结构系统结构3.1.1系统内外部关系图系统内外部关系图3.1.2功能模块简要说明功能模块简要说明1.账单查询：将客户的实时账单和历史账单进行查询，使客户可以查询自己的实时消费记录和历史消费记录。2.调账执行：对某个费用科目，某个账单进行调整，以一定的

9、形式（一次性费用，负账单，账单，账本，外部费用）反馈给用户。3.调账审批流程：当操作员权限不足时，不足以达到所需的金额限制；发送调账申请给上一级等待审批通过；再调用调账执行。3.1.3依赖的外部接口依赖的外部接口3.1.3.1权限查询接口权限查询接口权限查询接口分为当前操作员权限查询和查询具有调账权限的操作员信息两个接口：查询当前操作员权限：名称do_queryOperEntity接口路径：com.ailk.openbilling.service.imsinner.IImsReverseService. do_queryOperEntity ()原型public Do_queryOperEnt

10、ityResponse do_queryOperEntity(SOperInfo SOper, SQueryOperEntityReq SQueryOperEntityReq)功能查询当前操作员权限信息字段类型字段名称说明SOperInfoSOper工单入参参数SQueryOperEntityReqSQueryOperEntityReq权限查询参数返回值字段类型说明 软件功能设计说明书5Do_queryOperEntityResponse返回值结构体备注该接口可以根据当前操作员的 ID 查询出操作员所具有的调账权限SOperInfo：字段类型字段名说明Stringso_nbr交易流水号Inte

11、gerbusi_codeAPI 业务编码Shortso_mode受理一级区划编码Stringso_date受理二级区划编码Shortcharge_flag受理渠道类型Shortisnormal受理渠道Stringouter_cust_id外部客户标识Longcust_id客户标识Stringouter_acct_id外部账号标识Longacct_id账号标识Longuser_id用户 idStringphone_id电话号码Longop_id操作员 idshortprov_code省市编码Shortregion_code地区编码Shortcounty_code国家编码Integerorg_id

12、备用字段Stringrso_nbr备用字段Shortis_monitor备用字段Stringremark备注信息Shortstep_id备用字段Stringsource_system对外围系统的定义Shortnotify_flag告警标志Stringtenant_id租户 idSQueryOperEntityReq:字段类型字段名说明StringopId操作员标识StringorgId组织标识StringacceptStaffId受理员工号Do_queryOperEntityResponse：字段类型字段名说明ListentityIds操作员的权限信息查询具有调账权限的操作员信息： 软件功能设

13、计说明书6名称do_queryOperByEntityIds接口路径： com.ailk.openbilling.service.imsinner.IImsReverseService. do_queryOperByEntityIds ()原型public Do_queryOperByEntityIdsResponse do_queryOperByEntityIds(SOperInfo SOper, SQueryOperByEntityIdsReq SQueryOperByEntityIdsReq)功能查询具有调账权限的操作员信息字段类型字段名称说明SOperInfoSOper工单入参参数SQ

14、ueryOperByEntityIdsReqSQueryOperByEntityIdsReq权限查询参数字段类型说明返回值Do_queryOperByEntityIdsResponse返回值结构体备注该接口可以根据需要的权限信息查询具有该权限的操作员信息SQueryOperByEntityIdsReq：字段类型字段名说明ListentityIds需要查询的权限信息StringopId操作员标识StringorgId组织标识StringacceptStaffId受理员工号 Do_queryOperByEntityIdsResponse：字段类型字段名说明ListoperInfoList需要查询的

15、权限信息 OpInfo： 字段类型字段名说明StringopId操作员标识StringoperatorId操作员编码StringstaffId序列号StringloginName操作员工号StringcustOpId客服员工编号StringpassWord登录密码StringsecurityLevel密码安全级别StringallowUpdateFlag是否允许修改密码StringeffectDate账号生效时间StringexpireDate账号失效时间StringtryTimes失败登录尝试次数StringlockFlag账号锁定状态 软件功能设计说明书7StringpWDEffectDa

16、te密码生效时间StringchgPWDAlarmDays密码过期提前通知天数StringpWDUpdateAlarm密码修改提醒标示StringisAdmin是否是超级管理员StringorgId操作员组织StringparentOrdId操作员上级组织StringregionCode操作员地市StringdefaultSys操作员状态StringstaffName操作员默认系统StringorgName员工姓名Stringstatus状态StringtenantId租户 id3.1.3.2一次性费用接口一次性费用接口名称用户级优惠Sdl 文件onetimecharge_def.sdl, o

17、netimecharge.sdl原型int32 otc_calc( in MOnetimechargeDef:SOtcCalc sOtcCalc, out MOnetimechargeDef:SOtcConfirm sOtcConfirm);功能用户级优惠月帐计算字段类型字段名称说明上行参数MOnetimechargeDef:SOtcCalcsOtcCalc字段类型字段名称说明下行参数MOnetimechargeDef:SOtcConfirmsOtcConfirm错误码cErrorMsg：错误信息返回值 SOtcCalc：字段类型字段名说明int64 cust_id 客户编号int64 acc

18、t_id 帐户编号int64 pay_acct_id付费账户int64 resource_id设备编号int64 otc_opt_date 一次性费用产生的时间int64 so_nbr 工单号int32 spec_id 业务代码int32 pricing_plan_id定价计划 IDint16channel_id渠道 IDint16 calc_type算费类型 软件功能设计说明书8int16 service_type业务类型 1:recurring，2:on demand int32accumulate_times累计次数int16 object_type0:设备(相关客户信息全传) 1:账户

19、（只传 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:字段类型字段名说明i

20、nt64 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定价计划 IDint16channel_id渠道 IDint16 calc_type算费类型int16 service_type业务类型 1:recurring，2:on demand int32accumulate_times累计次数int16 object_type0:设备

21、(相关客户信息全传) 1:账户（只传 cust_id,acct_id） int16 deduct_type扣费模式 0:非强制扣费; 1:强制扣费int16 billing_type0:预付费 1：后付费int16 event_type算费事件：=0 正式算费冻结接口（累计量冻结、费用冻结） ；=1 算费累计接口（计算费用、更新累计量）stringphone_id手机号stringtopup_phone_id充值手机号;充值的号码，即被充入资金的号码int32result_value计算费用各种返回情况：=1 无资费；=2 正常算费成功；=3 预付费业务扣费失败（即余额不足，含分帐帐户帐单）S

22、OtcUserInfootc_user_info一次性费用资料信息SOtcFeeLogList otc_fee_log_list算费接口费用日志列表SOtcTaxFeeList otc_tax_fee_list税费列表 软件功能设计说明书9SAccumulateLogListaccumulate_log_list累计量日志列表SBillRoundDetailListround_detail_list税费遗失信息ExtParaMapext_para扩展参数MAbmInterfaceBillingDef:SAbmSessionInfoListsession_listsession 编号MAbmIn

23、terfaceBillingDef:SAbmSessionInfoListreguide_session_list一次性费用扣费中的代付、累计量会话编号MAbmInterfaceBillingDef:SAccumulateListaccumulate_list累计量记录MAbmInterfaceBillingDef:SPayFeeLogListpay_fee_log_list代付日志信息MAbmInterfaceBillingDef:SBudgetInfoListbudget_list预算信息MAbmInterfaceBillingDef:SDeductBalanceListdeduct_ba

24、lance_list剩余资金MAbmInterface:SDeductBillListbill_list历史欠费MAbmInterface:SPocketDeductLogListpocket_deduct_list帐本冲销日志MAbmInterface:SCreditDeductLogListcredit_deduct_list信用度冲销日志MAbmInterface:SBudgetDeductLogList budget_deduct_list预算冲销日志3.1.3.3冲销接口冲销接口名称deduct接口路径：com.ailk.openbilling.topuppayment.busine

25、ss.payment.AbmMgnt.deduct ()原型public int deduct(WriteoffRet writeoffRet, HolderList listCredit, HolderList listPocketDeductLog)功能进行账单的冲销字段类型字段名称说明WriteoffRetwriteoffRet冲销参数HolderListlistCredit信用度信息参数HolderListlistPocketDeductLog冲销记录字段类型说明返回值int返回值（1 冲销成功）备注该接口可以根据需要的权限信息查询具有该权限的操作员信息 软件功能设计说明书10 Wri

26、teoffRet：字段类型字段名说明ListcDeductBillList冲销账单信息CaPocketcAPocket账本信息ListnotificationList告警参数LongacctId账户编号IntegerbillDate账单日期IntegernotificationId 告警编号 SCredit：字段类型字段名说明int64acct_id; 帐户编号int64serv_id; 用户编号int64asset_id; 资产编号int64amount; 信用度值int64freeze_fee; 冻结费用int64deduct_fee; 当前冲销额度int64his_deduct_fee;

27、 历史冲销费用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; mv

28、no 标记int16billing_type; 计费类型(0int16credit_flag;是否为临时信用度,0-否int16hierarche_type;层级标志 SPocketDeductLog：字段类型字段名说明int64acct_id;帐户编号int64serv_id;用户编号(账本)int64bill_object_id;使用对象(账单)int64bill_id;帐单编号int64asset_id;资产编号int64product_id;产品编号(账单)int64woff_fee;本次冲销费用int64woff_tax_fee;本次冲销税费 软件功能设计说明书11int64bill

29、_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

30、.service.imsinner.IImsReverseService.DoCreateTicket()原型public DoCreateTicketResponse DoCreateTicket(SOperInfo soperinfo, DoCreateTicketReq docreateticketreq);功能向 CRM 提交申请单字段类型字段名称说明SOperInfosoperinfo工单公共头参数DoCreateTicketReqdocreateticketreq申请单明细字段类型说明返回值DoCreateTicketResponse返回值备注该接口可以向 CRM 提交调账申请单D

31、oCreateTicketReq：字段类型字段名说明AdjustIdString调账 id 调账的唯一编码 代码由 3 部分组成：调帐时间(YYYYMMDD)+15 位帐户编号(不足前补 0)+15 位的业务工单号(不足前补 0)20140701+000000878253500+ 000000026650833=20140701000000878253500000000026650833OperateWayShort操作方式 1、初次提交，2、修改后提交AdjustAmountDouble调账金额，trouble ticket 将根据该参数值路由到不同审批金额权限的工作组。AdjustDesc

32、String调账描述 本次调账信息的文本化的描述，trouble ticket 直接存储到工单内容中。 Billing 测示例: 调帐原因代码:0002;调帐总金额:200.0;调帐备注:费用错误; 软件功能设计说明书12AdjustDetailUrlString调账详情界面 url 在 Trouble ticket 工单详情界面上，可通过点击调账 id 后面的按钮，打开 billing 提供的详细的结构化界面，Billing 提供的 url 会自动拼装一些页面必要参数，通过 URL直接传进来。OperatorIdString操作员 id。sec.sec_operator.operator_i

33、dAcceptStaffIdString操作员 idTenantIdString租户DoCreateTicketResponse：字段类型字段名说明ShowSerialNoString工单流水号算税接口算税接口 名称taxFeeCalculate接口路径：com.ailk.openbilling.topuppayment.consume.SalInterface.taxFeeCalculate() 原型public STaxOut taxFeeCalculate(STaxIn staxIn)功能算税字段类型字段名称说明参数STaxInstaxIn算税入参字段类型说明返回值STaxOut返回值备

34、注对费用科目进行算税 STaxIn:字段名字段类型说明billListCsdlArrayListSBillInfo 结构:billId:标识唯一性 sbill:caBill 结构字段flag:0 正常账单 rcbilldetaillist:caBillItem 结构 STaxOut字段名字段类型说明billListCsdlArrayListSBillInfo 结构:rcbilldetaillist:caBillItem 结构(算税后的费用科目)taxbilldetaillist:caBillTax 结构(算出来的税) 软件功能设计说明书133.1.4对外提供的接口对外提供的接口3.1.4.1调

35、账对外接口调账对外接口com.ailk.openbilling.topuppayment.service.billAadjust.BillAdjustService.adjustBill(AdjustBillIn adjustIn, CommonParam commonParam);AdjustBillInAdjustBillIn: :字段类型字段名说明LongacctId账户编号StringadjustType调整方式,有两位,第一位是上调的方式,第二位是下调的方式,0 表示调一次性费用 1 表示调账单，不需要传入shortbillFlag0 调整历时账单 1 调整实时账单,默认 0Inte

36、germeasureId货币单位ListlistAdjustDtl调整明细StringadjReason调整原因,调整备注IntegeradjCode调整原因 CodeIntegersynAssetFlag是否需要校验 db，mdb 一致性，默认不校验ShortneedCreditNote0 不需要生成 Credit Note 1 需要生成 Credit NoteShortnextBill下账期标志位，当为 1 的时候则是调到外部费用，只有下调的时候可以传入LongresourceId用户 iddoubleamount无账单调账金额BooleancheckPermission是否需要校验权限，

37、默认是 true，false 的时候不校验AdjustBillDtlAdjustBillDtl：字段类型字段名说明LongbillNo账单编号StringinvoiceNumberInvoice NumberIntegeradjCode调整原因 CodeIntegeradjustFee调整金额IntegeritemCode调整科目IntegerbillMonth账单月调账审批反馈接口调账审批反馈接口com.ailk.openbilling.topuppayment.service.billAdjust.BillAdjustService. 软件功能设计说明书14dealApproveRespo

38、nse (CommonParam commonParam,ApproveResult approveResult);ApproveResultApproveResult：字段名字段类型说明adjustIdString调账的唯一编码 代码由 3 部分组成：调帐时间(YYYYMMDD)+15位帐户编号(不足前补 0)+15 位的业务工单号(不足前补 0)approveResultShort1 审批通过进行调账；2、审批不通过并退回修改；3、取消调账单。approveResultDescString审批附加信息operatorIdLong调整科目模块程序模块程序构建构建结构图结构图 软件功能设计说明

39、书154 子系统功能设计子系统功能设计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_DTLCA_APPROVAL调账规则模型: 软件功能设计说明书16BI_BUSI_AVAILABLEBI_BUSI_PLANPM_

40、COMPOSITE_RULE_PRICEPM_PROD_OFFER_PRICE_RULEPM_ADJUST_RULE4.1.1.2表结构（物理设计）表结构（物理设计）4.1.1.2.1 表汇总表汇总序号子系统表名中文名称和简单描述1CA_APPROVAL权限申请记录表2调账审批CA_APPROVAL_DTL申请审批明细表3CA_BUSI_REC_BILL调账扩展工单表4PM_ADJUST_RULE调账规则表5调账执行PM_REASON_CODE调账原因表6CA_BILL账单表7CA_BILL_ITEM账单明细表8账单查询CA_BILL_PROD产品话费周期表Comment J1: 名称修改一下

41、 软件功能设计说明书174.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货

42、币单位approve_opIdLong审批操作员编号approve_orgIdInteger审批操作员组织op_IdLong申请操作员编号org_IdInteger申请操作员组织tenant_idLong租户 idext1String扩展字段 1，调账这里是 billFlag，0 调整历史账单 1 调整实时账单ext2String扩展字段 2，调账这里用于区分是否需要生成 软件功能设计说明书18Credit Note,0 不生成 1 要生成ext3String扩展字段 3，调账这里是是否调整到下账期 0否 1 调整到下账期是否调整到下账期4.1.1.2.1.2申请审批明细表申请审批明细表 CA

43、_APPROVAL_ DTL 审批明细表用以记录申请单需要操作的业务的详细信息，按照创建时间进行分表，主键是流水号和创建时间还有科目。字段名数据类型字段简单描述so_nbrLong流水号 create_dateDate创建时间busi_spec_idInteger业务类型ext1String扩展字段 1，这里是 Invoice_noext2StringbillNo|adjust code|resourceId|base invoice amount 扩展字段 2,这里是 bill_noamountLong设计的资产额度measure_idInteger货币单位item_codeInteger科

44、目编号acct_idLong账户编号tenant_idLong租户 ID4.1.1.2.1.3调账扩展工单表调账扩展工单表 CA_BUSI_REC_BILLL字段名数据类型字段简单描述sonbrLong工单流水号 软件功能设计说明书19so_dateDate工单时间acct_idLong账户编号item_codeInteger调账科目adjust_feeLong调整费用measure_idInteger货币单位bill_monthInteger账期月begin_dateDate账期开始时间end_dateDate账期结束时间adjust_typeShort调账类型 0 一次性费用 1 账本 2

45、 账单 3 外部费用 5.负账单reason_codeInteger调账原因resource_idLong用户编号tenant_idLong租户negative_invoice_noString生成的负账单的 invoice nobase_item_codeLong原始科目4.1.1.2.1.4调账规则表调账规则表 PM_ADJUST_RULE调账规则表规定了调账的调整方式，以及是否需要生成 Credit Note 等信息。字段名数据类型字段描述price_rule_idInteger定价计划need_credit_flagInteger下调的时候是否需要生成 Credit Note0 需要

46、软件功能设计说明书201 不需要positive_flagInteger正向调账方式 0 一次性费用 1 账本 2 账单 3 外部费用（月底收）negative_flagInteger负向调账方式 0 一次性费用 1 账本 2 账单 3 外部费用（月底收）valid_typeInteger调到账本的时候账本的生效时间1.指定时间2.月末3.延长天数4.自然月5.账期6.使用系统默认值valid_unitInteger调到账本的时候账本的生效时间1.YYYYMMDD2.当前时间所在月的月末3.从当前时间延长的天数，可以小于 04.从当月过 n 个自然月生效（为 0 指当前月月初，为 1 下个月月

47、初）5.从当前账期延长 n 个账期生效（为 0 指当前账期开始时间，为 1 下个账期开始时间） 软件功能设计说明书216.使用系统默认值tenant_idLong租户4.1.1.2.1.5调账原因表调账原因表 PM_REASON_CODE调账原因表记录了调账可以选择的所有原因类型。原因按照不同类型进行分组。字段名字段类型字段描述code_idInteger调账原因代码 IDbusi_spec_idInteger业务类型code_typeInteger原因类型descriptionString调账原因描述tax_IncludeInteger0 需要反算调税 1 不调不需要反算税nameStrin

48、g显示的原因值，用于页面显示tenant_idLong租户is_displayShort是否需要展示approval_flagShort是否需要审批 0 需要 1 不需要，默认 0base_item_flagShort是否基于账单调整 0 不基于 1 基于adjust_flagShort调整类型-1 不参考 0 上调 1 下调Item_codeLong调账原因科目4.1.1.2.1.6调账履历表调账履历表 CA_BUSI_REC_IDX字段名数据类型字段简单描述acct_idLong账号 软件功能设计说明书22 invoice_noString账单号 amountLong改变金额 measur

49、e_id金额单位 so_nbr工单号 so_date工单时间 busi_spec_id业务规格 bill_month账单月 tenant_id租户 ext1扩展字段 1（调账目前用于展现调账费用类型） ext2扩展字段 2 ext3扩展字段 34.1.1.3视图列表视图列表4.1.2功能实现说明功能实现说明功能概要说明功能概要说明当系统因为任何错误（如常见的资费配置错误、客户资料受理错误、甚至有些系统未知错误）计算出来的账单费用和客户实际使用的费用不一致时需要有修正机制对客户的账单费用进行修改。调账功能模块的作用就是允许有一定权限的操作员对费用或账单进行调整，以此来人为修正这些错误带来的错误账

50、单结果。 软件功能设计说明书23调账按照调账类型的不同可以分为正向调账和负向调账两种。正向调账也叫向上调账，是指因资费或其他特殊原因需增加客户的账单费用，表示客户需向运营商多缴纳一笔费用。负向调账也叫向下调账，常用于发生投诉时减少目标费用额度，表示运营商多收了客户费用，需退还给客户。按照功能的不同可以将调账划分为如下功能模块：1. 调账审批2. 调账执行4.1.2.24.1.2.2数据流程图数据流程图调账审批调账执行调账明细查询更新CA_APPROVALCA_APPROVAL_DTL账单明细调账金额ABM信用度信息更新Credit Note记录业务工单账单调整总额插入CA_INFO_NOTE调

51、账结果插入CA_BUSI_RECCA_BILL_ITEM_CHGCA_BUSI_REC_BILLCA_BILL_PRODCA_BILL_ITEMCA_BILL更新 软件功能设计说明书25调账审批科目调账非科目调账调账明细查询更新CA_BUSI_AUTHCA_AUTH_DTL账单明细调账金额信用度信息信用度信息更新更新账单信息Credit Note记录业务工单账单调整总额插入CA_INFO_NOTE调账结果插入CA_BUSI_RECCA_BILL_ITEM_CHGCA_APPLIED_RATE 软件功能设计说明书264.1.2.34.1.2.3序列图序列图4.1.2.44.1.2.4功能点实现说

52、明功能点实现说明4.1.2.4.1 调账审批和权限控制调账审批和权限控制调账审批是调账执行的一部分，当操作员进行调账时，需要先判断自己当前的操作权限是否可以执行此次调账，如果权限足够则直接进行调账操作，如果权限不足，则需要提交申请单给上级操作员进行审批。现在审批放在 CRM 侧，操作员申请的时候会调用 CRM 接口生成申请单，上级操作员可以在调账详情页面查看调账的明细信息。审批完成后，CRM 会调用 Billing 的反馈接口进行审批结果反馈。如果审批成功，则直接调用调账接口进行调账，如果审批失败，需要退回修改，则将申请单状态设置为审批失败，等待修改。申请人在看到审批失败后可以修改申请单，然后

53、进行重新提交。如果上级操作员想取消这个申请单，则将申请单置为撤单状态。撤单状态的申请单表明不执行此次调账。 软件功能设计说明书27调账开始查询当前操作员调账权限权限是否可以执行调账进行调账操作查询具有该操作权限的操作员信息是否提交申请单结束审批开始查询提交给自己的申请单是否执行该调账操作将申请单状态修改为审批通过将申请单状态修改为审批不通过是否执行调账操作结束业务开始执行调账是否有权限调账执行调账权限足够BillingCRM向CRM提交申请单权限不足操作员是否有权限审批转发给上级进行审批没有权限执行审批有权限在调账详情页面查看调账明细反馈审批结果给Billing修改申请单状态为审批失败等待修改

54、审批失败修改申请单状态为审批成功修改申请单状态为撤销申请单审批成功撤销审批单修改申请单后重新提交给CRM进行审批记录业务工单业务结束调账权限调账权限一调账金额权限： 软件功能设计说明书281.调账金额 1，对应 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 为 adjust_77000243，代表调账操作员的第一级权限，调账金额从 0-1499，对应 crm 的是实体编号为77000243。2.调账金额 2，对应 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 为 adjust_77000244，代表调账操作员的第二级权限，调账金额从 1499-2499，对应 c

55、rm 的实体编号是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_770

56、00250，代表调账操作员的第五级权限，调账金额从 49999-正无穷。拥有这个权限的人有最高的操作权限。可以操作所有调账金额。对应 crm 的实体编号是 77000250。二其他调账权限1.显示不审批的调账原因权限：拥有该权限的操作员才会显示不审批的调账原因，如果没有该权限，界面上只显示需要审批的调账原因。对应 MD.SYS_PRIVILEGE 表中的PRIV_CODE 为 adjust_77000246，对应的 crm 实体编号是 77000246。2.显示发送 credit note 选项权限：拥有该权限的操作员才可以选择下调发送credit note，并且直接调整历史账单。没有该权限的

57、操作员做下调的时候默认调到下账期。有该权限的操作员选择了发送 credit note，则不再调到下账期，而是直接调整历史账单并且给客户发送 credit note。对应 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 为adjust_77000247，对应的 crm 实体编号是 77000247。3.是否允许操作员输入调账金额权限：拥有该权限的操作员才可以进行调账金额的输入。否则只能将账单调整为 0. 对应 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 为adjust_77000248，对应的 crm 实体编号是 77000248。权限实体的获取权限实体的获取当从

58、 crm 页面第一次跳转到账管页面时，会回调 sso 接口放入权限实体，而是从 软件功能设计说明书29系管的配置表中获取权限信息，系管在单点登录成功以后会将权限信息放到 session中，如果从 session 中取出来的对应权限的 value 为 16 代表拥有该权限。例如调账2600，如果从 session 中取出来的权限 code adjust_77000245 对应的 value 为 16，代表该操作员可以执行调账，如果 value 不是 16，则代表没有权限，需要创建申请单。当页面集成在 CRM 中的时候，系管会从 crm 查询出操作员对应的所有权限并放到session 中，调账的时

59、候根据 session 中的权限信息进行权限的判断。4.1.2.4.2 调账执行调账执行调账执行步骤如下：1. 校验：校验输入的用户名,invoice 级调账如果已经调过则不允许再次调账。2. 账单查询：将传入的费用科目绑定原始 bill。3. 定型：根据调整类型和调整明细对账单进行调整。根据调整的类型来进行调账操作；一次性费用：无账单调账上调，无账单调账下调，账单级调账下调负账单：账单级调账下调4. 算税：分析调账原因，如果是需要算税的调账原因，则将输入科目的含税金额拆分为税和不含税两部分。5. 调用冲销接口，将调整费用体现在信用度上。6. 判断是否需要生成 Credit Note，如果需要

60、生成则往 CA_INFO_NOTE 表中写入录入数据(生成的 Credit Note 信息需要包括调账原因，调账金额等信息)。7. 记录变更轨迹和业务工单。8. 发送调账告警。 软件功能设计说明书309.调账开始查询操作员权限是否有权限进行调账操作查询具有操作权限的操作员信息否根据invoiceNo查询账单信息是提交申请单给上级操作员是否是直接调整账单调用一次性费用接口将费用收取到下账期否对账单进行修改，如果是下调并且不够调则多余的转为Advance Payment是遍历调账明细根据调账原因判断是否需要调整税费如果需要调税则调用账务接口进行算税对税费进行调整调用冲销接口，将调整费用体现在信用度