产品详细设计说明书调账样本

Telenor系统(账单管理子系统)功能设计阐明书编写胡波编写时间-12-22审批审批时间版本V0.16亚信科技（中华人民共和国）有限公司版权所有文档中所有内容属亚信科技（中华人民共和国）有限公司所有，未经容许，不可所有或某些刊登、复制、使用于任何目。文档修订摘要日期版本号修订章节描述作者评审者评审日期-01-17V0.1草稿林荣福-02-13V0.2评审后修改林荣福-03-20V0.3修改文档格式林荣福-4-28V0.6添加调账规则和批量调账调账因素林荣福-09-05V0.8按照产品调账林荣福-09-24V0.9多账期调账林荣福-10-15V1.1添加crm审批林荣福-06-01V1.2增长调账因素科目胡波-08-11V1.3Invoice级调账胡波-08-12V1.4Addline调账胡波-09-06V1.5顾客级调账胡波-12-22V1.6反悔期调账胡波目录1 引言 11.1 文档用途 11.2 阅读对象 11.3 名词术语 11.4 参照资料 12 概述 32.1 调账子系统概述 32.2 调账子系统功能定义 32.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.2 CreditNote 424.2.1 数据模型设计 424.2.2 功能实现阐明 504.2.3 界面实现阐明 525 附录 535.1 错误码列表 535.2 需求文档功能跟踪矩阵 53引言文档用途本文档目是拟定VerisBilling账单管理模块功能范畴，明确账单管理功能设计方案，指引开发人员完毕开发设计工作，并协助测试人员编写测试案例。阅读对象产品设计工程师产品开发工程师产品测试工程师其她有关人员名词术语缩写、术语解释正向调账正向调账也叫向上调账，是指因资费或其她特殊因素需增长客户账单费用，表达客户需向运营商多缴纳一笔费用增长客户账单费用叫做正调账负向调账负向调账也叫向下调账，惯用于发生投诉时减少目的费用额度，表达运营商多收了客户费用，需退还给客户减少客户账单费用叫做负调账CreditNote当客户收到错误帐单之后，基于法律规定，需要再给客户邮寄一份阐明，告知其错误因素，对的帐单邮寄时间等信息。当账单因负向调节账单时候还需要寄送CreditNote给客户当客户收到错误帐单之后，基于法律规定，需要再给客户邮寄一份阐明，告知其错误因素，对的帐单邮寄时间等信息。当账单上金额比客户实际使用金额多时需要寄送CreditNote。呆账呆账是指超过缴费期限，通过催讨依然没有缴清，也许成为坏账账单。坏账坏账是指无法收回或极小也许收回款项账单。参照资料OpenBilling6.0帐务管理详细设计规格阐明书-调账.docCreditNote需求阐明书v1.0.doc调账软件需求阐明书v1.0.doc4.呆坏账功能规格阐明书v1.2.doc概述调账子系统概述账单是顾客消费记录查询根据，账单用于记录客户使用计费服务产生各种费用明细，。Billing系统需要可以对客户产生这些账单进行查询和修改操作。客户可以账单查询来知晓自己消费记录。如果客户账单浮现问题，需要有改正机制对账单进行修改。调账子系统功能定义按照功能不同可以将账单管理系统分为如下几种模块：账单查询。账单调节。调账审批流程。设计约束调账模块设计时候有如下设计约束账单管理模块设计时候有如下设计约束：调账往下调节账单时候调节额度如果不不大于客户未缴金额则多余某些要当做AdvancePayment返回给客户（例如：客户账单为100，未缴金额为40，如果往下调节60，则账单往下调节40，剩余20会当做AdvancePayment返回给客户）。往下调节账单时候必要生成往下调节账单时候可以指定与否生成CreditNote。调节账单明细时候账单总金额要一起调节，需要保证账单总金额和账单明细金额加起来总额相等。只有有调账权限操作员才可以执行调账操作（如调账200元，只有操作权限不不大于200操作员才可以进行调账操作，操作权限不大于200元操作员是无法执行本次调账，需要提交申请单给高权限操作员）。呆坏账账单不容许进行调账。无科目调账时候需要使用默认调帐科目进行调账。复用内容总体构造阐明系统构造系统内外部关系图功能模块简要阐明账单查询：将客户实时账单和历史账单进行查询，使客户可以查询自己实时消费记录和历史消费记录。调账执行：对某个费用科目，某个账单进行调节，以一定形式（一次性费用，负账单，账单，账本，外部费用）反馈给顾客。调账审批流程：当操作员权限局限性时，局限性以达到所需金额限制；发送调账申请给上一级等待审批通过；再调用调账执行。依赖外部接口权限查询接口权限查询接口分为当前操作员权限查询和查询具备调账权限操作员信息两个接口：查询当前操作员权限：名称do_queryOperEntity接口途径：com.ailk.openbilling.service.imsinner.IImsReverseService.do_queryOperEntity()原型publicDo_queryOperEntityResponsedo_queryOperEntity(SOperInfoSOper，SQueryOperEntityReqSQueryOperEntityReq)功能查询当前操作员权限信息参数字段类型字段名称阐明SOperInfoSOper工单入参SQueryOperEntityReqSQueryOperEntityReq权限查询参数返回值字段类型阐明Do_queryOperEntityResponse返回值构造体备注该接口可以依照当前操作员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顾客idStringphone_id电话号码Longop_id操作员idshortprov_code省市编码Shortregion_code地区编码Shortcounty_code国家编码Integerorg_id备用字段Stringrso_nbr备用字段Shortis_monitor备用字段Stringremark备注信息Shortstep_id备用字段Stringsource_system对外围系统定义Shortnotify_flag告警标志Stringtenant_id租户idSQueryOperEntityReq:字段类型字段名阐明StringopId操作员标记StringorgId组织标记StringacceptStaffId受理员工号Do_queryOperEntityResponse：字段类型字段名阐明List<String>entityIds操作员权限信息查询具备调账权限操作员信息：名称do_queryOperByEntityIds接口途径：com.ailk.openbilling.service.imsinner.IImsReverseService.do_queryOperByEntityIds()原型publicDo_queryOperByEntityIdsResponsedo_queryOperByEntityIds(SOperInfoSOper，SQueryOperByEntityIdsReqSQueryOperByEntityIdsReq)功能查询具备调账权限操作员信息参数字段类型字段名称阐明SOperInfoSOper工单入参SQueryOperByEntityIdsReqSQueryOperByEntityIdsReq权限查询参数返回值字段类型阐明Do_queryOperByEntityIdsResponse返回值构造体备注该接口可以依照需要权限信息查询具备该权限操作员信息SQueryOperByEntityIdsReq：字段类型字段名阐明List<String>entityIds需要查询权限信息StringopId操作员标记StringorgId组织标记StringacceptStaffId受理员工号Do_queryOperByEntityIdsResponse：字段类型字段名阐明List<OpInfo>operInfoList需要查询权限信息OpInfo：字段类型字段名阐明StringopId操作员标记StringoperatorId操作员编码StringstaffId序列号StringloginName操作员工号StringcustOpId客服员工编号StringpassWord登录密码StringsecurityLevel密码安全级别StringallowUpdateFlag与否容许修改密码StringeffectDate账号生效时间StringexpireDate账号失效时间StringtryTimes失败登录尝试次数StringlockFlag账号锁定状态StringpWDEffectDate密码生效时间StringchgPWDAlarmDays密码过期提前告知天数StringpWDUpdateAlarm密码修改提示标示StringisAdmin与否是超级管理员StringorgId操作员组织StringparentOrdId操作员上级组织StringregionCode操作员地市StringdefaultSys操作员状态StringstaffName操作员默认系统StringorgName员工姓名Stringstatus状态StringtenantId租户id一次性费用接口名称顾客级优惠Sdl文献onetimecharge_def.sdl，onetimecharge.sdl原型int32otc_calc(inMOnetimechargeDef::SOtcCalcsOtcCalc,outMOnetimechargeDef::SOtcConfirmsOtcConfirm);功能顾客级优惠月帐计算上行参数字段类型字段名称阐明MOnetimechargeDef::SOtcCalcsOtcCalc下行参数字段类型字段名称阐明MOnetimechargeDef::SOtcConfirmsOtcConfirm错误码cErrorMsg：错误信息返回值SOtcCalc：字段类型字段名阐明int64cust_id客户编号int64acct_id帐户编号int64pay_acct_id付费账户int64resource_id设备编号int64otc_opt_date一次性费用产生时间int64so_nbr工单号int32spec_id业务代码int32pricing_plan_id定价筹划IDint16 channel_id渠道IDint16calc_type算费类型int16service_type业务类型1:recurring，2:ondemandint32 accumulate_times合计次数int16object_type0:设备(有关客户信息全传)1:账户（只传cust_id,acct_id）int16deduct_type扣费模式0:非强制扣费；1:强制扣费int16billing_type0:预付费1：后付费int16event_type算费事件：=0正式算费冻结接口（合计量冻结、费用冻结）；=1算费合计接口（计算费用、更新合计量）stringphone_id手机号stringtopup_phone_id充值手机号;充值号码，即被充入资金号码SOtcFeeListotc_fee_list算费接口费用列表ExtParaMapext_para扩展参数SOtcConfirm:字段类型字段名阐明int64cust_id客户编号int64acct_id帐户编号int64pay_acct_id付费账户int64resource_id设备编号int64otc_opt_date一次性费用产生时间int64so_nbr工单号int32spec_id业务代码int32pricing_plan_id定价筹划IDint16 channel_id渠道IDint16calc_type算费类型int16service_type业务类型1:recurring，2:ondemandint32 accumulate_times合计次数int16object_type0:设备(有关客户信息全传)1:账户（只传cust_id,acct_id）int16deduct_type扣费模式0:非强制扣费；1:强制扣费int16billing_type0:预付费1：后付费int16event_type算费事件：=0正式算费冻结接口（合计量冻结、费用冻结）；=1算费合计接口（计算费用、更新合计量）stringphone_id手机号stringtopup_phone_id充值手机号;充值号码，即被充入资金号码int32result_value计算费用各种返回状况：=1无资费；=2正常算费成功；=3预付费业务扣费失败（即余额局限性，含分帐帐户帐单）SOtcUserInfo otc_user_info一次性费用资料信息SOtcFeeLogListotc_fee_log_list算费接口费用日记列表SOtcTaxFeeListotc_tax_fee_list税费列表SAccumulateLogList accumulate_log_list合计量日记列表SBillRoundDetailListround_detail_list税费遗失信息ExtParaMap ext_para扩展参数MAbmInterfaceBillingDef::SAbmSessionInfoListsession_listsession编号MAbmInterfaceBillingDef::SAbmSessionInfoListreguide_session_list一次性费用扣费中代付、合计量会话编号MAbmInterfaceBillingDef::SAccumulateListaccumulate_list合计量记录MAbmInterfaceBillingDef::SPayFeeLogListpay_fee_log_list代付日记信息MAbmInterfaceBillingDef::SBudgetInfoListbudget_list预算信息MAbmInterfaceBillingDef::SDeductBalanceListdeduct_balance_list剩余资金MAbmInterface::SDeductBillListbill_list历史欠费MAbmInterface::SPocketDeductLogListpocket_deduct_list帐本冲销日记MAbmInterface::SCreditDeductLogListcredit_deduct_list信用度冲销日记MAbmInterface::SBudgetDeductLogListbudget_deduct_list预算冲销日记冲销接口名称deduct接口途径：com.ailk.openbilling.topuppayment.business.payment.AbmMgnt.deduct()原型publicintdeduct(WriteoffRetwriteoffRet，Holder<List<SCredit>>listCredit,Holder<List<SPocketDeductLog>>listPocketDeductLog)功能进行账单冲销参数字段类型字段名称阐明WriteoffRetwriteoffRet冲销参数Holder<List<SCredit>>listCredit信用度信息Holder<List<SPocketDeductLog>>listPocketDeductLog冲销记录返回值字段类型阐明int返回值（1冲销成功）备注该接口可以依照需要权限信息查询具备该权限操作员信息WriteoffRet：字段类型字段名阐明List<DeductBill>cDeductBillList冲销账单信息CaPocketcAPocket账本信息List<Notification>notificationList告警参数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；计费类型(0int16credit_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.DoCreateTicket()原型publicDoCreateTicketResponseDoCreateTicket(SOperInfosoperinfo，DoCreateTicketReqdocreateticketreq);功能向CRM提交申请单参数字段类型字段名称阐明SOperInfosoperinfo工单公共头DoCreateTicketReqdocreateticketreq申请单明细返回值字段类型阐明DoCreateTicketResponse返回值备注该接口可以向CRM提交调账申请单DoCreateTicketReq：字段类型字段名阐明AdjustIdString调账id调账唯一编码代码由3某些构成：调帐时间(YYYYMMDD)+15位帐户编号(局限性前补0)+15位业务工单号(局限性前补0)0701+500+833=833OperateWayShort操作方式1、初次提交，2、修改后提交AdjustAmountDouble调账金额，troubleticket将依照该参数值路由到不同审批金额权限工作组。AdjustDescString调账描述本次调账信息文本化描述，troubleticket直接存储到工单内容中。Billing测示例：调帐因素代码:0002;调帐总金额:200.0;调帐备注:费用错误;AdjustDetailUrlString调账详情界面url在Troubleticket工单详情界面上，可通过点击调账id背面按钮，打开billing提供详细构造化界面，Billing提供url会自动拼装某些页面必要参数，通过URL直接传进来。OperatorIdString操作员id。sec.sec_operator.operator_idAcceptStaffIdString操作员idTenantIdString租户DoCreateTicketResponse：字段类型字段名阐明ShowSerialNoString工单流水号算税接口名称taxFeeCalculate接口途径：com.ailk.openbilling.topuppayment.consume.SalInterface.taxFeeCalculate()原型publicSTaxOuttaxFeeCalculate(STaxInstaxIn)功能算税参数字段类型字段名称阐明STaxInstaxIn算税入参返回值字段类型阐明STaxOut返回值备注对费用科目进行算税STaxIn:字段名字段类型阐明billListCsdlArrayList<SBillInfo>SBillInfo构造:billId:标记唯一性sbill:caBill构造字段flag:0正常账单rcbilldetaillist:caBillItem构造STaxOut字段名字段类型阐明billListCsdlArrayList<SBillInfo>SBillInfo构造:rcbilldetaillist:caBillItem构造(算税后费用科目)taxbilldetaillist:caBillTax构造(算出来税)对外提供接口调账对外接口com.ailk.openbilling.topuppayment.service.billAadjust.BillAdjustService.adjustBill(AdjustBillInadjustIn，CommonParamcommonParam);AdjustBillIn:字段类型字段名阐明LongacctId账户编号StringadjustType调节方式,有两位,第一位是上调方式,第二位是下调方式,0表达调一次性费用1表达调账单，不需要传入shortbillFlag0调节历时账单1调节实时账单,默认0IntegermeasureId货币单位List<AdjustBillDtl>listAdjustDtl调节明细StringadjReason调节因素,调节备注IntegeradjCode调节因素CodeIntegersynAssetFlag与否需要校验db，mdb一致性，默认不校验ShortneedCreditNote0不需要生成CreditNote1需要生成CreditNoteShortnextBill下账期标志位，当为1时候则是调到外部费用，只有下调时候可以传入LongresourceId顾客iddoubleamount无账单调账金额BooleancheckPermission与否需要校验权限，默认是true，false时候不校验AdjustBillDtl：字段类型字段名阐明LongbillNo账单编号StringinvoiceNumberInvoiceNumberIntegeradjCode调节因素CodeIntegeradjustFee调节金额IntegeritemCode调节科目IntegerbillMonth账单月调账审批反馈接口com.ailk.openbilling.topuppayment.service.billAdjust.BillAdjustService.dealApproveResponse(CommonParamcommonParam,ApproveResultapproveResult);ApproveResult：字段名字段类型阐明adjustIdString调账唯一编码代码由3某些构成：调帐时间(YYYYMMDD)+15位帐户编号(局限性前补0)+15位业务工单号(局限性前补0)approveResultShort1审批通过进行调账；2、审批不通过并退回修改；3、取消调账单。approveResultDescString审批附加信息operatorIdLong调节科目模块程序构建构造图子系统功能设计账单调节子系统功能设计数据模型设计逻辑实体模型模型上需要增长权限申请登记表和调账审批明细表用于对调账操作进行申请和审批。使用既有表CA_APPLIED_RATE表用以记录调账信息。在SYS_ENUM_DATA中添加基本数据用来记录权限级别划分。实体模型调账审批模型:CA_CA_APPROVAL_DTL_DTLCA_APPROVAL调账规则模型:BI_BUSI_AVAILABLEBI_BUSI_PLANBI_BUSI_AVAILABLEBI_BUSI_PLANPM_COMPOSITE_RULE_PRICEPM_PROD_OFFER_PRICE_RULEPM_ADJUST_RULE表构造（物理设计）表汇总序号子系统表名中文名称和简朴描述1调账审批CA_APPROVAL权限申请登记表2CA_APPROVAL_DTL申请审批明细表3调账执行CA_BUSI_REC_BILL调账扩展工单表4PM_ADJUST_RULE调账规则表5PM_REASON_CODE调账因素表6账单查询CA_BILL账单表7CA_BILL_ITEM账单明细表8CA_BILL_PROD产品话费周期表权限申请登记表CA_APPROVAL权限申请登记表用来记录操作员提交申请单，按照创立时间进行分表，主键为流水号。字段名数据类型字段简朴描述so_nbrLong流水号create_dateDate创立时间busi_spec_idInteger业务类型acct_idLong账户编号reasonString申请因素remarkString审批备注deal_flagshort解决状态0未审批1审批通过2审批不通过deal_dateDate审批日期deal_amountLong涉及总金额measure_idInteger货币单位approve_opIdLong审批操作员编号approve_orgIdInteger审批操作员组织op_I名称修改一下d名称修改一下Long申请操作员编号org_IdInteger申请操作员组织tenant_idLong租户idext1String扩展字段1，调账这里是billFlag，0调节历史账单1调节实时账单ext2String扩展字段2，调账这里用于区别与否需要生成CreditNote,0不生成1要生成ext3String扩展字段3，调账这里是与否调节到下账期0否1调节到下账期与否调节到下账期申请审批明细表CA_APPROVAL_DTL审批明细表用以记录申请单需要操作业务详细信息，按照创立时间进行分表，主键是流水号和创立时间尚有科目。字段名数据类型字段简朴描述so_nbrLong流水号create_dateDate创立时间busi_spec_idInteger业务类型ext1String扩展字段1，这里是Invoice_noext2StringbillNo|adjustcode|resourceId|baseinvoiceamount扩展字段2,这里是bill_noamountLong设计资产额度measure_idInteger货币单位item_codeInteger科目编号acct_idLong账户编号tenant_idLong租户ID调账扩展工单表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_noString生成负账单invoicenobase_item_codeLong原始科目调账规则表PM_ADJUST_RULE调账规则表规定了调账调节方式，以及与否需要生成CreditNote等信息。字段名数据类型字段描述price_rule_idInteger定价筹划need_credit_flagInteger下调时候与否需要生成CreditNote0需要1不需要positive_flagInteger正向调账方式0一次性费用1账本2账单3外部费用（月底收）negative_flagInteger负向调账方式0一次性费用1账本2账单3外部费用（月底收）valid_typeInteger调到账本时候账本生效时间指定期间月末延长天数自然月账期使用系统默认值valid_unitInteger调到账本时候账本生效时间YYYYMMDD当前时间所在月月末从当前时间延长天数，可以不大于0从当月过n个自然月生效（为0指当前月月初，为1下个月月初）从当前账期延长n个账期生效（为0指当前账期开始时间，为1下个账期开始时间）使用系统默认值tenant_idLong租户调账因素表PM_REASON_CODE调账因素表记录了调账可以选取所有因素类型。因素按照不同类型进行分组。字段名字段类型字段描述code_idInteger调账因素代码IDbusi_spec_idInteger业务类型code_typeInteger因素类型descriptionString调账因素描述tax_IncludeInteger0需要反算调税1不调不需要反算税nameString显示因素值，用于页面显示tenant_idLong租户is_displayShort与否需要展示approval_flagShort与否需要审批0需要1不需要，默认0base_item_flagShort与否基于账单调节0不基于1基于adjust_flagShort调节类型-1不参照0上调1下调Item_codeLong调账因素科目调账履历表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扩展字段2ext3扩展字段3视图列表功能实现阐明功能概要阐明当系统由于任何错误（如常用资费配备错误、客户资料受理错误、甚至有些系统未知错误）计算出来账单费用和客户实际使用费用不一致时需要有修正机制对客户账单费用进行修改。调账功能模块作用就是容许有一定权限操作员对费用或账单进行调节，以此来人为修正这些错误带来错误账单成果。调账按照调账类型不同可以分为正向调账和负向调账两种。正向调账也叫向上调账，是指因资费或其她特殊因素需增长客户账单费用，表达客户需向运营商多缴纳一笔费用。负向调账也叫向下调账，惯用于发生投诉时减少目的费用额度，表达运营商多收了客户费用，需退还给客户。按照功能不同可以将调账划分为如下功能模块：调账审批调账执行数据流程图序列图功能点实现阐明调账审批和权限控制调账审批是调账执行一某些，当操作员进行调账时，需要先判断自己当前操作权限与否可以执行本次调账，如果权限足够则直接进行调账操作，如果权限局限性，则需要提交申请单给上级操作员进行审批。当前审批放在CRM侧，操作员申请时候会调用CRM接口生成申请单，上级操作员可以在调账详情页面查看调账明细信息。审批完毕后，CRM会调用Billing反馈接口进行审批成果反馈。如果审批成功，则直接调用调账接口进行调账，如果审批失败，需要退回修改，则将申请单状态设立为审批失败，等待修改。申请人在看到审批失败后可以修改申请单，然后进行重新提交。如果上级操作员想取消这个申请单，则将申请单置为撤单状态。撤单状态申请单表白不执行本次调账。调账权限一．调账金额权限：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.显示发送creditnote选项权限：拥有该权限操作员才可以选取下调发送creditnote，并且直接调节历史账单。没有该权限操作员做下调时候默认调到下账期。有该权限操作员选取了发送creditnote，则不再调到下账期，而是直接调节历史账单并且给客户发送creditnote。相应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中取出来权限codeadjust_77000245相应value为16，代表该操作员可以执行调账，如果value不是16，则代表没有权限，需要创立申请单。当页面集成在CRM中时候，系管会从crm查询出操作员相应所有权限并放到session中，调账时候依照session中权限信息进行权限判断。调账执行调账执行环节如下：校验：校验输入顾客名,invoice级调账如果已经调过则不容许再次调账。账单查询：将传入费用科目绑定原始bill。定型：依照调节类型和调节明细对账单进行调节。依照调节类型来进行调账操作；一次性费用：无账单调账上调，无账单调账下调，账单级调账下调负账单：账单级调账下调算税：分析调账因素，如果是需要算税调账因素，则将输入科目含税金额拆分为税和不含税两某些。调用冲销接口，将调节费用体当前信用度上。判断与否需要生成CreditNote，如果需要生成则往CA_INFO_NOTE表中写入录入数据(生成CreditNote信息需要涉及调账因素，调账金额等信息)。记录变更轨迹和业务工单。发送调账告警。批量调账批量调账可以支持对各种账户,各种账单进行同步调账解决.批量调账解决时候,操作员需要将所有需要解决账单数据按照指定格式录入到文献当中,数据格式在模板中可以看到.录入完账单数据后需要在批量页面进行文献上传,文献上传后会由流程将数据录入到数据库当中.然后批量解决流程会将录入到数据库中数据进行逐条解决(这里是多线程解决,一种线程解决一条),数据解析好后会调用调账接口进行调账,如果数据解析错误或者调账出错,会将数据标为失败状态,如果调账成功则将数据标为成功状态并移到历史表当中.在批量查询页面,可以查询批量文献解决进度,也可以看到所有解决出错数据.对于解决出错数据操作员需要修改文献内容后放到新批量文献中进行重新解决.批量文献中调帐数据不进行审批（上传上去文献中数据默认就是可以做），操作员需要自己先审核通过后然后才进行文献上传,批量调账需要支持按照产品进行调账，在批量文献中数据中填写产品实例化id，则调账时候是依照产品进行调账。进行上调时候，调节相应产品，相应科目费用。如果是下调，则调节费用不可以不不大于产品相应科目费用。不不大于这某些费用则直接调节到账本中。需要有页面可以录入批量数据，并且需要可以依照录入数据进行批量文献生成。批量调账每行文献格式如下:列名ACCT_ID(1)ADJUST_FEE(2)MEASURE_ID(3)REASON_CODE(4)NEXT_BILL_FLAG(5)INVOICE_NO(6)描述账户ID调账费用（如果

负值前面+负号）单位调账因素编号1.下账期生效

0.本账期生效发票号列名SERVICE_NO(7)ITEM_CODE(8)FREE_TEXT(9)BEGIN_DATE(10)END_DATE(11)描述设备标记科目号备注账期起始时间账期结束时间无账单调账页面支持无账单调账。操作员在进行无账单调账时候，输入金额需要包括了税费调节金额（如需要调节账单100Euro，税20Euro，则操作员需要输入120Euro）。如果调节金额为正则是向上调节账单费用，这时候需要生成调账金额相应一次性费用到实时费用当中，这个费用相应科目为默认调帐科目，一次性费用在出账时不再进行收税。无账单调账下调时候有及时生效和下账期生效两种方式。当及时生效时候，需要生成一份负账单，如果有欠费账单，账单账期月和最早一次欠费账单账期月相似；如果没有欠费账单按照出账筹划里面，账单账期和近来一次未出账出账筹划相似。并需要发送creditnote给客户。无账单下调下账期生效时候生成一条负一次性费用。账单级调账页面支持账单级调账。操作员在进行账单级调账时只可以选取下调，并且一次调节要将整一份账单调完；如果历史曾经调节过该份账单，不可以再次调账。操作员可以选取当前账期生效或者下周期生效。如果当前账单生效产生一份和被调账单账期相似负账单，并且发送creditnote给客户。一次性费用会产生一条负一次性费用金额。账单金额分为2某些：不含税金额和税金额，页面呈现时候为总金额；后台解决时会拆分这份账单总金额。调账规则调账方式需要依赖于客户类型。不同客户类型依照调账规则表中配备可以有不同调账方式。调账规则表重要规定了向上调帐和向下调账方式，总共分为四五种：0调节账单费用到一次性费用当中。1调节账单费用到账本中（只有下调时候才可以调节到账本当中）。2.直接修改账单。3.调节账单费用到外部费用当中（这里体当前月底收取）。5.调账生成负账单。如果是调节账单费用到账本当中，还可以依照配备指定账本生效时间（依照规则可以指定下列生效时间1.指定期间生效2.月末生效3. 延长N天之后生效4.从当月过n个自然月生效（为0指当前月月初，为1下个月月初）5.从当前账期延长n个账期生效（为0指当前账期开始时间，为1下个账期开始时间）6.使用系统默认值，账户创立时间）。如果操作员在接口中指定了要调节费用到下个账期（只有向下调节时候可以指定），则调账是调节到外部费用当中，并且在月底进行收取。调账时候如果调节出负实时费用（下调到一次性费用或者外部费用），则帐处需要支持对负账单进行解决，billData出账单也需要展示这某些负账单费用。如果没有配备调账规则则使用默认调账方式（上调一次性费用，下调调节账单，如果是到下账期则下调到外部费用）。如果是调账生成负账单，则默认生一种负账单（和调节账单完全独立账单，拥有独立bill_no和invoice_no），并且需要调用billdata模块接口生成负账单相应invoice。并发送creditnote给客户。调账因素调账时候需要可以设立输入调账因素，不同调账因素用不同因素代码进行代替。新增因素登记表用来定义系统中用到各种因素。业务在使用时候依照业务类型来获取有关业务因素定义。调账因素规定了调账与否同步调税，如果调账因素规定了调账同步需要调税则税费需要依照调账金额进行相应调节，如果调账因素规定了调账不需要调节税费，则只需要调节账单金额就可以。调账因素也可以决定本次调账与否需要审批。如果选取是需要审批调账因素，则调账需要向crm查询权限，如果权限足够则直接调账，如果权限局限性则需要向crm提交申请单。如果选取是不需要审批因素，则直接执行调账不需要再查询权限。对于普通调账，选取必要是基于账单调账因素，对于无账单调账需要选取无账单调账调账因素。调账因素需要支持到科目级。每个科目调节时候需要输入一种调账因素。税费调节在进行账单调节时候,需要对账单相应税费进行调节。与否需要进行税费调节由调账因素进行决定。当调账因素表中taxInclude字段配备为0时候是需要进行税费调节。税费计算接口由帐处提供，账管访问帐处提供SAL服务进行税费计算。依照调账方式不同税费调节也可以分为如下几种：如果账单是调节到下账期一次性费顾客或者外部费用当中，则税费调节也体当前下个账期，下账期出账时候会对一次性费用，外部费用进行收税。如果对历史费用调节是直接调成账本，则税费相应调节金额也需要调成账本返还给顾客。如果调节时候是直接修改账单，则需要对税费明细进行相应调节。调账历史查询对账户进行调账后，会留下调账工单历史记录。需要有界面可以对账户底下调账记录进行查询。查询界面需要展示调账时间，调账金额和调节科目明细等。如果调账祈求发生时候账单已经发给CA，则在查询本次调账记录时候需要表白调节是发给CA账单。调账履历对某一份账单调账后，在调账界面点击账单按钮跳转到该invoice历史调账履历页面。在履历页面当中，依照invoiceNo或者invoiceNo+billNo+ItemCode找到相应工单找到明细最后呈现到页面中。Addline在调账界面中，无账单调账想要同步调节各种此时点击下方Add按钮，就会新增一条记录；在提交时候将这些记录都保存到数据库中。顾客级调账无账单调账时，对其可以选取一种顾客，进行调账。此时生成负账单或者一次性费用都会落在选取顾客上面；信用度扣减依然是账户级。反悔期调账当客户订购某个设备后在反悔期内返回，需要退订该设备；当客户某个顾客需要销户时此时由crm发起，调用billing侧返回退费

程序设计类定义无【内容】阐明类定义，涉及属性、接口函数等。【裁剪原则】此某些内容不容许裁剪。数据构造定义无【内容】给出数据构造或数据元素（变量）特性，涉及名称、标记符、数据类型和格式、值有效范畴，并给出定义性描述，最佳能用类C语言给出类型阐明。【裁剪原则】此某些内容不容许裁剪。目的文献定义无【内容】阐明该模块将提供哪些包（.So,.jar等）。【裁剪原则】此某些内容不容许裁剪。接口定义调账接口：com.ailk.openbilling.topuppayment.service.billAdjust.BillAdjustService.adjustBill(AdjustBillInadjustIn，CommonParamcommonParam);界面实现阐明调账界面构造阐明调账界面地址：ng/bill-new/app.jsp#/billAdjustcreditAdjustment调账界面重要功能是对客户账单进行调节，在调节之前，需要选取上调还是下调。选取完后来选取需要调节账单科目，输入调节金额，然后选取调账因素就可以进行调账。如果是下调，可以选取调到下账期和与否生成creditnote。可以按照科目对查询出来账单进行过滤。此外调账因素有两种，需要审批因素和不需要审批因素，如果选取了需要审批因素类型，则只会显示需要审批因素，如果选取了不需要审批因素类型，则只显示不需要审批因素。调账上调时候，没有账单调账，只有无账单调账。调账审批界面构造阐明调账审批有两个界面，一种是提交申请单界面，一种是审核申请单界面。当操作员权限不够调账时候，需要提交申请单给上级操作员，这时候可以在申请单提交界面新增一种申请单，上级操作员在收到申请单后可以在审核界面对申请单进行审批。审批完后调账直接执行。提交申请单界面URL：/page/modules/billadjust/adjustmentApply.jsp审核申请单界面URL：/page/modules/billadjust/adjustmentApproval.jsp提交申请单界面和审核申请单界面需要配备在Payment主菜单中。申请单提交页面可以查询当前操作员所有提交过申请单，双击申请单可以查看申请单详情，如果申请单尚未审批，则操作元可以对这个申请单进行修改或者直接删除。点击复制按钮可以对申请单进行复制。点击添加按钮可以新增申请单，新增申请单时需要先填写好调账详细信息，然后点击add按钮添加需要提交上级操作员，然后点击submit按钮进行提交申请单。审核申请单界面操作员可以查询所有提交给自己申请单，双击申请单记录可以查看申请单详情，如果申请单尚未审批，则可以点击审批按钮或者回绝审批按钮对审批单进行审批。申请界面：审批页面：批量调账界面构造阐明批量调账页面URL：/page/modules/batchBusiness/main.jsp批量调账成果查询页面URL：/page/modules/batchBusiness/query.jsp批量文献是上传：上传后来文献会ftp到服务器上，然后批量流程会对文献进行解决。批量调账成果查询界面：批量调账文献生页面URL：/page/modules/batchbilladj/batchBillAdjust.jsp生成批量文献有两种方式，一种是直接手动输入每行数据信息，然后点击按钮进行文献生成。第二种是依照销售品生成指定月份内订购过这个产品所有账户调账数据。输入好数据后点击save按钮，数据会保存在table里面可以点击复制按钮进行数据复制，点击数据行可以进行数据查看和修改当数据录入好后点击生成文献按钮进行批量文献生成。依照销售品生成文献相对简朴一点，选取好要调节销售品，要调节科目和账期月，点击文献生成按钮就会生成批量文献。调账因素界面构造阐明调账履历界面构造阐明调账履历URL：/bill-new/app.jsp#/creditAdjustment显示是某个操作员在某时间对XXX账单调了多少钱。AddLine界面构造阐明在调账界面单次可以同步提交各种无账单调账，点击“+”按钮可以新增一条，点击“-”则删除该条。顾客级调账界面构造阐明无账单调账中，每一笔记录都可以选取一种顾客，默以为账户级，下拉列表所呈现为ServiceNo.CreditNote数据模型设计逻辑实体模型模型上需要增长权限申请登记表和调账审批明细表用于对调账操作进行申请和审批。使用既有表CA_APPLIED_RATE表用以记录调账信息。在SYS_ENUM_DATA中添加基本数据用来记录权限级别划分。实体模型调账审批模型:CA_CA_APPROVAL_DTL_DTLCA_APPROVAL调账规则模型:BI_BUSI_AVAILABLEBI_BUSI_PLANBI_BUSI_AVAILABLEBI_BUSI_PLANPM_COMPOSITE_RULE_PRICEPM_PROD_OFFER_PRICE_RULEPM_ADJUST_RULE表构造（物理设计）表汇总序号子系统表名中文名称和简朴描述1调账审批CA_APPROVAL权限申请登记表2CA_APPROVAL_DTL申请审批明细表3调账执行CA_BUSI_REC_BILL调账扩展工单表4PM_ADJUST_RULE调账规则表5PM_REASON_CODE调账因素表6账单查询CA_BILL账单表7CA_BILL_ITEM账单明细表8CA_BILL_PROD产品话费周期表权限申请登记表CA_APPROVAL权限申请登记表用来记录操作员提交申请单，按照创立时间进行分表，主键为流水号。字段名数据类型字段简朴描述so_nbrLong流水号create_dateDate创立时间busi_spec_idInteger业务类型acct_idLong账户编号reasonString申请因素remarkString审批备注deal_flagshort解决状态0未审批1审批通过2审批不通过deal_dateDate审批日期deal_amountLong涉及总金额measure_idInteger货币单位approve_opIdLong审批操作员编号approve_orgIdInteger审批操作员组织op_I名称修改一下d名称修改一下Long申请操作员编号org_IdInteger申请操作员组织tenant_idLong租户idext1String扩展字段1，调账这里是billFlag，0调节历史账单1调节实时账单ext2String扩展字段2，调账这里用于区别与否需要生成CreditNote,0不生成1要生成ext3String扩展字段3，调账这里是与否调节到下账期0否1调节到下账期与否调节到下账期申请审批明细表CA_APPROVAL_DTL审批明细表用以记录申请单需要操作业务详细信息，按照创立时间进行分表，主键是流水号和创立时间尚有科目。字段名数据类型字段简朴描述so_nbrLong流水号create_dateDate创立时间busi_spec_idInteger业务类型ext1String扩展字段1，这里是Invoice_noext2StringbillNo|adjustcode|resourceId|baseinvoiceamount扩展字段2,这里是bill_noamountLong设计资产额度measure_idInteger货币单位item_codeInteger科目编号acct_idLong账户编号tenant_idLong租户ID调账扩展工单表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_noString生成负账单invoicenobase_item_codeLong原始科目调账规则表PM_ADJUST_RULE调账规则表规定了调账调节方式，以及与否需要生成CreditNote等信息。字段名数据类型字段描述price_rule_idInteger定价筹划need_credit_flagInteger下调时候与否需要生成CreditNote0需要1不需要positive_flagInteger正向调账方式0一次性费用1账本2账单3外部费用（月底收）negative_flagInteger负向调账方式0一次性费用1账本2账单3外部费用（月底收）valid_typeInteger调到账本时候账本生效时间指定期间月末延长天数自然月账期使用系统默认值valid_unitInteger调到账本时候账本生效时间YYYYMMDD当前时间所在月月末从当前时间延长天数，可以不大于0从当月过n个自然月生效（为0指当前月月初，为1下个月月初）从当前账期延长n个账期生效（为0指当前账期开始时间，为1下个账期开始时间）使用系统默认值tenant_idLong租户调账因素表PM_REASON_CODE调账因素表记录了调账可以选取所有因素类型。因素按照不同类型进行分组。字段名字段类型字段描述code_idInteger调账因素代码IDbusi_spec_idInteger业务类型code_typeInteger因素类型descriptionString调账因素描述tax_IncludeInteger0需要反算调税1不调不需要反算税nameString显示因素值，用于页面显示tenant_idLong租户is_displayShort与否需要展示approval_flagShort与否需要审批0需要1不需要，默认0base_item_flagShort与否基于账单调节0不基于1基于adjust_flagShort调节类型-1不参照0上调1下调Item_codeLong调账因素科目调账履历表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扩展字段2ext3扩展字段3视图列表功能实现阐明功能概要阐明客户收到错误帐单后向运营商电话投诉，运营商接到投诉并确认后会对本次错误有关信息进行记录，日后会依照此记录生成一份用以对错误帐单阐明CreditNote，告知客户出错因素，以及调帐信息等，以此提高顾客感知度和使用忠诚度。数据流程图图5.SEQ图\*ARABIC1序列图功能点实现阐明Creditnote录入顾客发现帐单错误后，向客服投诉，客服确认后需在creditnote录入界面手工录入生成creditnote有关信息，录入信息涉及：帐户ID，操作人姓名，错误帐单编号，错误类型，与否需要重出帐，投递日期，调帐总额，备注信息等(详细字段信息参见CreditNote录入界面)。调帐CreditNote信息录入完毕后，针对该记录会有超链接连接至调帐页面，操作员需在调帐页面录入调帐有关信息进行手动调帐。Creditnote生成调帐完毕后，CreditNote生成流程会依照数据库CreditNote生成表CA_INFO_NOTE中状态为2(即处在调帐状态)记录生成CreditNote。生成要素涉及wrongamount-fullinvoice客户及操作人姓名；出错日期；一种唯一标记这份文档序列号；被此文档引用且已被修正原始帐单；一种对本次修正简短阐明；所有账目反转(带负号)；creditnote不应包具有效时间期限；wrongamount-partialamount客户及操作人姓名；出错日期；一种唯一标记这份文档序列号；原始帐单内也许被此文档引用且已被修正科目；一种对本次修正简短阐明；wrongcustomerdata客户及修改人姓名；修改日期；一种唯一标记这份文档序列号；被此文档引用且已被修正原始帐单；错误资料；修正资料；修正因素；creditnote不应包具有效时间期限；程序设计类定义数据构造定义目的文献定义接口定义界面实现阐明功能点1界面构造阐明功能点2界面构造阐明功能设计附录功能设计错误码列表CreditNote模块错误码列表错误码描述备注159600Entitynotfoundindatabase.param:[{0}][{1}][{2}]数据库中未查询到相应实体159601SystemParameter[{0}]IsUndefined.参数未定义需求文档功能跟踪矩阵序号原始需求ID原始需求描述需求分解功能点文档中相应章节LOG_BIL_882OpenAdjustmentcase

Abilitytosetupdifferentrolesforcreatingadjustmentandauthorisationrelatedtotheadjustmentamount5.2账单调账LOG_BIL_886AdjustmentAnalysis(incl.approval)

Abilitytosetupahierarchyforapprovalwithdifferentamount5.2账单调账LOG_BIL_887AdjustmentAnalysis(incl.approval)

Supporttheapporvalprocesswithautomaticworkflow5.2账单调账LOG_BIL_888AdjustmentAnalysis(incl.approval)

Createandmanintaintheapprovalhierachy5.2账单调账LOG_BIL_112Creditnote

Tocorrectaninvoicethathasalreadybeenprocessedandsenttothecustomer.Therearetwobasicscenariosforthisevent:

1.Wrongamount

A-Fullinvoice：toprovideacreditforthatfullinvoice，Telenorwouldsendcustomersacredit_note.Youcanthinkofacredit_noteasa"negativeinvoice.”

B-Partialamount：singleormultipleitemtobecorrected

2.Wrongcustomerdata

A-Customeraddress，customername，taxID，etc.hasbeenmodified，andTelenorhastosendaletter，whichcontainsonlythereasonfortheamendment/ratifications(e.g.addresschange，etc.)5.5CreditNoteLOG_BIL_114Creditnote-Wrongamount–partialamount

Thefollowingrequirementsshallapplyforthistypeofcreditnote:

a)Nameofthecustomerandtheoperator

b)Thedateofissue

c)Asequentialnumber，whichuniquelyidentifiesthedocument

d)Possibilitytorefertotheitemwithintheinitialinvoicethatisbeingamendedbythisdocument

e)Anindicationofthedetailthat