產(chǎn)品詳細設計說明書-調(diào)賬

1、Telenor 系統(tǒng)系統(tǒng)(賬單管理子系統(tǒng)賬單管理子系統(tǒng))功能設計說明書功能設計說明書編 寫胡波編寫 時間2015-12-22審 批審批 時間版本V0.16亞信科技（中國）有限公司版權所有亞信科技（中國）有限公司版權所有文檔中的全部內(nèi)容屬亞信科技（中國）有限公司所有，未經(jīng)允許，不可全部或部分發(fā)表、復制、使用于任何目的。功能設計說明書模板文檔修訂摘要文檔修訂摘要日期日期版本號版本號修訂章節(jié)修訂章節(jié)描述描述作者作者評審者評審者評審日期評審日期2014-01-17V0.1初稿林榮福2014-02-13V0.2評審后修改林榮福2014-03-20V0.3修改文檔格式林榮福2014-4-28V0.6添加調(diào)

2、賬規(guī)則和批量調(diào)賬調(diào)賬原因林榮福2014-09-05V0.8按照產(chǎn)品調(diào)賬林榮福2014-09-24V0.9多賬期調(diào)賬林榮福2014-10-15V1.1添加 crm 審批林榮福2015-06-01V1.2增加調(diào)賬原因科目胡波2015-08-11V1.3Invoice 級調(diào)賬胡波2015-08-12V1.4Add line 調(diào)賬胡波2015-09-06V1.5用戶級調(diào)賬胡波2015-12-22V1.6反悔期調(diào)賬胡波功能設計說明書模板i目錄目錄1引言引言.11.1文檔用途.11.2閱讀對象.11.3名詞術語.11.4參考資料.12概述概述.32.1調(diào)賬子系統(tǒng)概述.32.2調(diào)賬子系統(tǒng)功能定義.32.3設

3、計約束.32.4復用內(nèi)容.43總體結構說明總體結構說明.53.1系統(tǒng)結構.53.1.1系統(tǒng)內(nèi)外部關系圖.53.1.2功能模塊簡要說明.53.1.3依賴的外部接口.53.1.4對外提供的接口.133.2模塊程序構建結構圖.144子系統(tǒng)功能設計子系統(tǒng)功能設計.154.1賬單調(diào)整子系統(tǒng)功能設計.154.1.1數(shù)據(jù)模型設計.154.1.2功能實現(xiàn)說明.224.1.3界面實現(xiàn)說明.344.2CREDIT NOTE.424.2.1數(shù)據(jù)模型設計.424.2.2功能實現(xiàn)說明.504.2.3界面實現(xiàn)說明.525附錄附錄.535.1錯誤碼列表.535.2需求文檔功能跟蹤矩陣.53功能設計說明書模板11 引言引言1

4、.1 文檔用途文檔用途本文檔的目的是確定 Veris Billing 賬單管理模塊的功能范圍，明確賬單管理功能的設計方案，指導開發(fā)人員完成開發(fā)設計工作，并幫助測試人員編寫測試案例。1.2 閱讀對象閱讀對象產(chǎn)品設計工程師產(chǎn)品開發(fā)工程師產(chǎn)品測試工程師其他相關人員1.3 名詞術語名詞術語縮寫、術語縮寫、術語解解 釋釋正向調(diào)賬正向調(diào)賬也叫向上調(diào)賬，是指因資費或其他特殊原因需增加客戶的賬單費用，表示客戶需向運營商多繳納一筆費用增加客戶的賬單費用叫做正調(diào)賬負向調(diào)賬負向調(diào)賬也叫向下調(diào)賬，常用于發(fā)生投訴時減少目標費用額度，表示運營商多收了客戶費用，需退還給客戶減少客戶的賬單費用叫做負調(diào)賬Credit Note

5、當客戶收到錯誤的帳單之后，基于法律要求，需要再給客戶郵寄一份說明，告知其錯誤原因，正確帳單郵寄時間等信息。當賬單因負向調(diào)整賬單的時候還需要寄送 Credit Note 給客戶當客戶收到錯誤的帳單之后，基于法律要求，需要再給客戶郵寄一份說明，告知其錯誤原因，正確帳單郵寄時間等信息。當賬單上的金額比客戶實際使用金額多時需要寄送 Credit Note。呆賬呆賬是指超過繳費期限，經(jīng)過催討仍然沒有繳清，可能成為壞賬的賬單。功能設計說明書模板2壞賬壞賬是指無法收回或極小可能收回款項的賬單。1.4 參考資料參考資料1. OpenBilling6.0 帳務管理詳細設計規(guī)格說明書-調(diào)賬.doc2. Credi

6、t Note 需求說明書 v1.0.doc3. 調(diào)賬軟件需求說明書 v1.0.doc3.4. 呆壞賬功能規(guī)格說明書 v1.2.doc 軟件功能設計說明書22 概述概述2.1 調(diào)賬子系統(tǒng)概述調(diào)賬子系統(tǒng)概述賬單是用戶消費記錄查詢的依據(jù)，賬單用于記錄客戶使用計費服務產(chǎn)生的各種費用明細， 。Billing 系統(tǒng)需要能夠?qū)蛻舢a(chǎn)生的這些賬單進行查詢和修改操作?？蛻裟軌蛸~單查詢來知曉自己的消費記錄。如果客戶的賬單出現(xiàn)問題，需要有改正機制對賬單進行修改。2.2 調(diào)賬子系統(tǒng)功能定義調(diào)賬子系統(tǒng)功能定義按照功能的不同可以將賬單管理系統(tǒng)分為如下幾個模塊：1. 賬單查詢。2. 賬單調(diào)整。3. 調(diào)賬審批流程。2.3 設

7、計約束設計約束調(diào)賬模塊設計的時候有如下的設計約束賬單管理模塊設計的時候有如下的設計約束：1.調(diào)賬往下調(diào)整賬單的時候調(diào)整額度如果大于客戶的未繳金額則多余部分要當做Advance Payment 返回給客戶（例如：客戶賬單為 100，未繳金額為 40，如果往下調(diào)整 60，則賬單往下調(diào)整 40，剩余的 20 會當做 Advance Payment 返回給客戶） 。2.往下調(diào)整賬單的時候必須生成往下調(diào)整賬單的時候可以指定是否生成 Credit Note。3.調(diào)整賬單明細的時候賬單總金額要一起調(diào)整，需要保證賬單總金額和賬單明細金額加起來的總額相等。4. 只有有調(diào)賬權限的操作員才可以執(zhí)行調(diào)賬操作（如調(diào)賬

8、200 元，只有操作權 軟件功能設計說明書3限大于 200 的操作員才可以進行調(diào)賬操作，操作權限小于 200 元的操作員是無法執(zhí)行此次調(diào)賬的，需要提交申請單給高權限的操作員） 。4.5. 呆壞賬賬單不允許進行調(diào)賬。無科目調(diào)賬的時候需要使用默認調(diào)帳科目進行調(diào)賬。5.2.4 復用內(nèi)容復用內(nèi)容 軟件功能設計說明書43 總體結構說明總體結構說明3.1 系統(tǒng)結構系統(tǒng)結構3.1.1系統(tǒng)內(nèi)外部關系圖系統(tǒng)內(nèi)外部關系圖3.1.2功能模塊簡要說明功能模塊簡要說明1.賬單查詢：將客戶的實時賬單和歷史賬單進行查詢，使客戶可以查詢自己的實時消費記錄和歷史消費記錄。2.調(diào)賬執(zhí)行：對某個費用科目，某個賬單進行調(diào)整，以一定的

9、形式（一次性費用，負賬單，賬單，賬本，外部費用）反饋給用戶。3.調(diào)賬審批流程：當操作員權限不足時，不足以達到所需的金額限制；發(fā)送調(diào)賬申請給上一級等待審批通過；再調(diào)用調(diào)賬執(zhí)行。3.1.3依賴的外部接口依賴的外部接口3.1.3.1權限查詢接口權限查詢接口權限查詢接口分為當前操作員權限查詢和查詢具有調(diào)賬權限的操作員信息兩個接口：查詢當前操作員權限：名稱do_queryOperEntity接口路徑：com.ailk.openbilling.service.imsinner.IImsReverseService. do_queryOperEntity ()原型public Do_queryOperEnt

10、ityResponse do_queryOperEntity(SOperInfo SOper, SQueryOperEntityReq SQueryOperEntityReq)功能查詢當前操作員權限信息字段類型字段名稱說明SOperInfoSOper工單入?yún)?shù)SQueryOperEntityReqSQueryOperEntityReq權限查詢參數(shù)返回值字段類型說明 軟件功能設計說明書5Do_queryOperEntityResponse返回值結構體備注該接口可以根據(jù)當前操作員的 ID 查詢出操作員所具有的調(diào)賬權限SOperInfo：字段類型字段名說明Stringso_nbr交易流水號Inte

11、gerbusi_codeAPI 業(yè)務編碼Shortso_mode受理一級區(qū)劃編碼Stringso_date受理二級區(qū)劃編碼Shortcharge_flag受理渠道類型Shortisnormal受理渠道Stringouter_cust_id外部客戶標識Longcust_id客戶標識Stringouter_acct_id外部賬號標識Longacct_id賬號標識Longuser_id用戶 idStringphone_id電話號碼Longop_id操作員 idshortprov_code省市編碼Shortregion_code地區(qū)編碼Shortcounty_code國家編碼Integerorg_id

12、備用字段Stringrso_nbr備用字段Shortis_monitor備用字段Stringremark備注信息Shortstep_id備用字段Stringsource_system對外圍系統(tǒng)的定義Shortnotify_flag告警標志Stringtenant_id租戶 idSQueryOperEntityReq:字段類型字段名說明StringopId操作員標識StringorgId組織標識StringacceptStaffId受理員工號Do_queryOperEntityResponse：字段類型字段名說明ListentityIds操作員的權限信息查詢具有調(diào)賬權限的操作員信息： 軟件功能設

13、計說明書6名稱do_queryOperByEntityIds接口路徑： com.ailk.openbilling.service.imsinner.IImsReverseService. do_queryOperByEntityIds ()原型public Do_queryOperByEntityIdsResponse do_queryOperByEntityIds(SOperInfo SOper, SQueryOperByEntityIdsReq SQueryOperByEntityIdsReq)功能查詢具有調(diào)賬權限的操作員信息字段類型字段名稱說明SOperInfoSOper工單入?yún)?shù)SQ

14、ueryOperByEntityIdsReqSQueryOperByEntityIdsReq權限查詢參數(shù)字段類型說明返回值Do_queryOperByEntityIdsResponse返回值結構體備注該接口可以根據(jù)需要的權限信息查詢具有該權限的操作員信息SQueryOperByEntityIdsReq：字段類型字段名說明ListentityIds需要查詢的權限信息StringopId操作員標識StringorgId組織標識StringacceptStaffId受理員工號 Do_queryOperByEntityIdsResponse：字段類型字段名說明ListoperInfoList需要查詢的

15、權限信息 OpInfo： 字段類型字段名說明StringopId操作員標識StringoperatorId操作員編碼StringstaffId序列號StringloginName操作員工號StringcustOpId客服員工編號StringpassWord登錄密碼StringsecurityLevel密碼安全級別StringallowUpdateFlag是否允許修改密碼StringeffectDate賬號生效時間StringexpireDate賬號失效時間StringtryTimes失敗登錄嘗試次數(shù)StringlockFlag賬號鎖定狀態(tài) 軟件功能設計說明書7StringpWDEffectDa

16、te密碼生效時間StringchgPWDAlarmDays密碼過期提前通知天數(shù)StringpWDUpdateAlarm密碼修改提醒標示StringisAdmin是否是超級管理員StringorgId操作員組織StringparentOrdId操作員上級組織StringregionCode操作員地市StringdefaultSys操作員狀態(tài)StringstaffName操作員默認系統(tǒng)StringorgName員工姓名Stringstatus狀態(tài)StringtenantId租戶 id3.1.3.2一次性費用接口一次性費用接口名稱用戶級優(yōu)惠Sdl 文件onetimecharge_def.sdl, o

17、netimecharge.sdl原型int32 otc_calc( in MOnetimechargeDef:SOtcCalc sOtcCalc, out MOnetimechargeDef:SOtcConfirm sOtcConfirm);功能用戶級優(yōu)惠月帳計算字段類型字段名稱說明上行參數(shù)MOnetimechargeDef:SOtcCalcsOtcCalc字段類型字段名稱說明下行參數(shù)MOnetimechargeDef:SOtcConfirmsOtcConfirm錯誤碼cErrorMsg：錯誤信息返回值 SOtcCalc：字段類型字段名說明int64 cust_id 客戶編號int64 acc

18、t_id 帳戶編號int64 pay_acct_id付費賬戶int64 resource_id設備編號int64 otc_opt_date 一次性費用產(chǎn)生的時間int64 so_nbr 工單號int32 spec_id 業(yè)務代碼int32 pricing_plan_id定價計劃 IDint16channel_id渠道 IDint16 calc_type算費類型 軟件功能設計說明書8int16 service_type業(yè)務類型 1:recurring，2:on demand int32accumulate_times累計次數(shù)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擴展參數(shù)SOtcConfirm:SOtcConfirm:字段類型字段名說明i

20、nt64 cust_id 客戶編號int64 acct_id 帳戶編號int64 pay_acct_id付費賬戶int64 resource_id設備編號int64 otc_opt_date 一次性費用產(chǎn)生的時間int64 so_nbr 工單號int32 spec_id 業(yè)務代碼int32 pricing_plan_id定價計劃 IDint16channel_id渠道 IDint16 calc_type算費類型int16 service_type業(yè)務類型 1:recurring，2:on demand int32accumulate_times累計次數(shù)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 預付費業(yè)務扣費失?。从囝~不足，含分帳帳戶帳單）S

22、OtcUserInfootc_user_info一次性費用資料信息SOtcFeeLogList otc_fee_log_list算費接口費用日志列表SOtcTaxFeeList otc_tax_fee_list稅費列表 軟件功能設計說明書9SAccumulateLogListaccumulate_log_list累計量日志列表SBillRoundDetailListround_detail_list稅費遺失信息ExtParaMapext_para擴展參數(shù)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沖銷參數(shù)HolderListlistCredit信用度信息參數(shù)HolderListlistPocketDeductLog沖銷記錄字段類型說明返回值int返回值（1 沖銷成功）備注該接口可以根據(jù)需要的權限信息查詢具有該權限的操作員信息 軟件功能設計說明書10 Wri

26、teoffRet：字段類型字段名說明ListcDeductBillList沖銷賬單信息CaPocketcAPocket賬本信息ListnotificationList告警參數(shù)LongacctId賬戶編號IntegerbillDate賬單日期IntegernotificationId 告警編號 SCredit：字段類型字段名說明int64acct_id; 帳戶編號int64serv_id; 用戶編號int64asset_id; 資產(chǎn)編號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;資產(chǎn)編號int64product_id;產(chǎn)品編號(賬單)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;/費用強制轉(zhuǎn)移：0 非強制，1 強制floatexchange_rate;匯率創(chuàng)建申請單接口創(chuàng)建申請單接口名稱DoCreateTicket接口路徑：com.ailk.openbilling

30、.service.imsinner.IImsReverseService.DoCreateTicket()原型public DoCreateTicketResponse DoCreateTicket(SOperInfo soperinfo, DoCreateTicketReq docreateticketreq);功能向 CRM 提交申請單字段類型字段名稱說明SOperInfosoperinfo工單公共頭參數(shù)DoCreateTicketReqdocreateticketreq申請單明細字段類型說明返回值DoCreateTicketResponse返回值備注該接口可以向 CRM 提交調(diào)賬申請單D

31、oCreateTicketReq：字段類型字段名說明AdjustIdString調(diào)賬 id 調(diào)賬的唯一編碼 代碼由 3 部分組成：調(diào)帳時間(YYYYMMDD)+15 位帳戶編號(不足前補 0)+15 位的業(yè)務工單號(不足前補 0)20140701+000000878253500+ 000000026650833=20140701000000878253500000000026650833OperateWayShort操作方式 1、初次提交，2、修改后提交AdjustAmountDouble調(diào)賬金額，trouble ticket 將根據(jù)該參數(shù)值路由到不同審批金額權限的工作組。AdjustDesc

32、String調(diào)賬描述 本次調(diào)賬信息的文本化的描述，trouble ticket 直接存儲到工單內(nèi)容中。 Billing 測示例: 調(diào)帳原因代碼:0002;調(diào)帳總金額:200.0;調(diào)帳備注:費用錯誤; 軟件功能設計說明書12AdjustDetailUrlString調(diào)賬詳情界面 url 在 Trouble ticket 工單詳情界面上，可通過點擊調(diào)賬 id 后面的按鈕，打開 billing 提供的詳細的結構化界面，Billing 提供的 url 會自動拼裝一些頁面必要參數(shù)，通過 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)功能算稅字段類型字段名稱說明參數(shù)STaxInstaxIn算稅入?yún)⒆侄晤愋驼f明返回值STaxOut返回值備

34、注對費用科目進行算稅 STaxIn:字段名字段類型說明billListCsdlArrayListSBillInfo 結構:billId:標識唯一性 sbill:caBill 結構字段flag:0 正常賬單 rcbilldetaillist:caBillItem 結構 STaxOut字段名字段類型說明billListCsdlArrayListSBillInfo 結構:rcbilldetaillist:caBillItem 結構(算稅后的費用科目)taxbilldetaillist:caBillTax 結構(算出來的稅) 軟件功能設計說明書133.1.4對外提供的接口對外提供的接口3.1.4.1調(diào)

35、賬對外接口調(diào)賬對外接口com.ailk.openbilling.topuppayment.service.billAadjust.BillAdjustService.adjustBill(AdjustBillIn adjustIn, CommonParam commonParam);AdjustBillInAdjustBillIn: :字段類型字段名說明LongacctId賬戶編號StringadjustType調(diào)整方式,有兩位,第一位是上調(diào)的方式,第二位是下調(diào)的方式,0 表示調(diào)一次性費用 1 表示調(diào)賬單，不需要傳入shortbillFlag0 調(diào)整歷時賬單 1 調(diào)整實時賬單,默認 0Inte

36、germeasureId貨幣單位ListlistAdjustDtl調(diào)整明細StringadjReason調(diào)整原因,調(diào)整備注IntegeradjCode調(diào)整原因 CodeIntegersynAssetFlag是否需要校驗 db，mdb 一致性，默認不校驗ShortneedCreditNote0 不需要生成 Credit Note 1 需要生成 Credit NoteShortnextBill下賬期標志位，當為 1 的時候則是調(diào)到外部費用，只有下調(diào)的時候可以傳入LongresourceId用戶 iddoubleamount無賬單調(diào)賬金額BooleancheckPermission是否需要校驗權限，

37、默認是 true，false 的時候不校驗AdjustBillDtlAdjustBillDtl：字段類型字段名說明LongbillNo賬單編號StringinvoiceNumberInvoice NumberIntegeradjCode調(diào)整原因 CodeIntegeradjustFee調(diào)整金額IntegeritemCode調(diào)整科目IntegerbillMonth賬單月調(diào)賬審批反饋接口調(diào)賬審批反饋接口com.ailk.openbilling.topuppayment.service.billAdjust.BillAdjustService. 軟件功能設計說明書14dealApproveRespo

38、nse (CommonParam commonParam,ApproveResult approveResult);ApproveResultApproveResult：字段名字段類型說明adjustIdString調(diào)賬的唯一編碼 代碼由 3 部分組成：調(diào)帳時間(YYYYMMDD)+15位帳戶編號(不足前補 0)+15 位的業(yè)務工單號(不足前補 0)approveResultShort1 審批通過進行調(diào)賬；2、審批不通過并退回修改；3、取消調(diào)賬單。approveResultDescString審批附加信息operatorIdLong調(diào)整科目模塊程序模塊程序構建構建結構圖結構圖 軟件功能設計說明

39、書154 子系統(tǒng)功能設計子系統(tǒng)功能設計4.1 賬單調(diào)整子系統(tǒng)功能設計賬單調(diào)整子系統(tǒng)功能設計4.1.1數(shù)據(jù)模型設計數(shù)據(jù)模型設計4.1.1.1邏輯實體模型邏輯實體模型1. 模型上需要增加權限申請記錄表和調(diào)賬審批明細表用于對調(diào)賬操作進行申請和審批。2. 使用現(xiàn)有表 CA_APPLIED_RATE 表用以記錄調(diào)賬信息。3. 在 SYS_ENUM_DATA 中添加基礎數(shù)據(jù)用來記錄權限的等級劃分。4.1.1.1.1 實體模型實體模型調(diào)賬審批模型:CA_APPROVAL_DTL_DTLCA_APPROVAL調(diào)賬規(guī)則模型: 軟件功能設計說明書16BI_BUSI_AVAILABLEBI_BUSI_PLANPM_

40、COMPOSITE_RULE_PRICEPM_PROD_OFFER_PRICE_RULEPM_ADJUST_RULE4.1.1.2表結構（物理設計）表結構（物理設計）4.1.1.2.1 表匯總表匯總序號子系統(tǒng)表名中文名稱和簡單描述1CA_APPROVAL權限申請記錄表2調(diào)賬審批CA_APPROVAL_DTL申請審批明細表3CA_BUSI_REC_BILL調(diào)賬擴展工單表4PM_ADJUST_RULE調(diào)賬規(guī)則表5調(diào)賬執(zhí)行PM_REASON_CODE調(diào)賬原因表6CA_BILL賬單表7CA_BILL_ITEM賬單明細表8賬單查詢CA_BILL_PROD產(chǎn)品話費周期表Comment J1: 名稱修改一下

41、 軟件功能設計說明書174.1.1.2.1.1權限申請記錄表權限申請記錄表 CA_APPROVAL權限申請記錄表用來記錄操作員提交的申請單，按照創(chuàng)建時間進行分表，主鍵為流水號。字段名數(shù)據(jù)類型字段簡單描述so_nbrLong流水號 create_dateDate創(chuàng)建時間busi_spec_idInteger業(yè)務類型 acct_idLong賬戶編號reasonString申請原因remarkString審批備注deal_flagshort處理狀態(tài) 0 未審批 1 審批通過 2 審批不通過deal_dateDate審批日期deal_amountLong涉及的總金額measure_idInteger貨

42、幣單位approve_opIdLong審批操作員編號approve_orgIdInteger審批操作員組織op_IdLong申請操作員編號org_IdInteger申請操作員組織tenant_idLong租戶 idext1String擴展字段 1，調(diào)賬這里是 billFlag，0 調(diào)整歷史賬單 1 調(diào)整實時賬單ext2String擴展字段 2，調(diào)賬這里用于區(qū)分是否需要生成 軟件功能設計說明書18Credit Note,0 不生成 1 要生成ext3String擴展字段 3，調(diào)賬這里是是否調(diào)整到下賬期 0否 1 調(diào)整到下賬期是否調(diào)整到下賬期4.1.1.2.1.2申請審批明細表申請審批明細表 CA

43、_APPROVAL_ DTL 審批明細表用以記錄申請單需要操作的業(yè)務的詳細信息，按照創(chuàng)建時間進行分表，主鍵是流水號和創(chuàng)建時間還有科目。字段名數(shù)據(jù)類型字段簡單描述so_nbrLong流水號 create_dateDate創(chuàng)建時間busi_spec_idInteger業(yè)務類型ext1String擴展字段 1，這里是 Invoice_noext2StringbillNo|adjust code|resourceId|base invoice amount 擴展字段 2,這里是 bill_noamountLong設計的資產(chǎn)額度measure_idInteger貨幣單位item_codeInteger科

44、目編號acct_idLong賬戶編號tenant_idLong租戶 ID4.1.1.2.1.3調(diào)賬擴展工單表調(diào)賬擴展工單表 CA_BUSI_REC_BILLL字段名數(shù)據(jù)類型字段簡單描述sonbrLong工單流水號 軟件功能設計說明書19so_dateDate工單時間acct_idLong賬戶編號item_codeInteger調(diào)賬科目adjust_feeLong調(diào)整費用measure_idInteger貨幣單位bill_monthInteger賬期月begin_dateDate賬期開始時間end_dateDate賬期結束時間adjust_typeShort調(diào)賬類型 0 一次性費用 1 賬本 2

45、 賬單 3 外部費用 5.負賬單reason_codeInteger調(diào)賬原因resource_idLong用戶編號tenant_idLong租戶negative_invoice_noString生成的負賬單的 invoice nobase_item_codeLong原始科目4.1.1.2.1.4調(diào)賬規(guī)則表調(diào)賬規(guī)則表 PM_ADJUST_RULE調(diào)賬規(guī)則表規(guī)定了調(diào)賬的調(diào)整方式，以及是否需要生成 Credit Note 等信息。字段名數(shù)據(jù)類型字段描述price_rule_idInteger定價計劃need_credit_flagInteger下調(diào)的時候是否需要生成 Credit Note0 需要

46、軟件功能設計說明書201 不需要positive_flagInteger正向調(diào)賬方式 0 一次性費用 1 賬本 2 賬單 3 外部費用（月底收）negative_flagInteger負向調(diào)賬方式 0 一次性費用 1 賬本 2 賬單 3 外部費用（月底收）valid_typeInteger調(diào)到賬本的時候賬本的生效時間1.指定時間2.月末3.延長天數(shù)4.自然月5.賬期6.使用系統(tǒng)默認值valid_unitInteger調(diào)到賬本的時候賬本的生效時間1.YYYYMMDD2.當前時間所在月的月末3.從當前時間延長的天數(shù)，可以小于 04.從當月過 n 個自然月生效（為 0 指當前月月初，為 1 下個月月

47、初）5.從當前賬期延長 n 個賬期生效（為 0 指當前賬期開始時間，為 1 下個賬期開始時間） 軟件功能設計說明書216.使用系統(tǒng)默認值tenant_idLong租戶4.1.1.2.1.5調(diào)賬原因表調(diào)賬原因表 PM_REASON_CODE調(diào)賬原因表記錄了調(diào)賬可以選擇的所有原因類型。原因按照不同類型進行分組。字段名字段類型字段描述code_idInteger調(diào)賬原因代碼 IDbusi_spec_idInteger業(yè)務類型code_typeInteger原因類型descriptionString調(diào)賬原因描述tax_IncludeInteger0 需要反算調(diào)稅 1 不調(diào)不需要反算稅nameStrin

48、g顯示的原因值，用于頁面顯示tenant_idLong租戶is_displayShort是否需要展示approval_flagShort是否需要審批 0 需要 1 不需要，默認 0base_item_flagShort是否基于賬單調(diào)整 0 不基于 1 基于adjust_flagShort調(diào)整類型-1 不參考 0 上調(diào) 1 下調(diào)Item_codeLong調(diào)賬原因科目4.1.1.2.1.6調(diào)賬履歷表調(diào)賬履歷表 CA_BUSI_REC_IDX字段名數(shù)據(jù)類型字段簡單描述acct_idLong賬號 軟件功能設計說明書22 invoice_noString賬單號 amountLong改變金額 measur

49、e_id金額單位 so_nbr工單號 so_date工單時間 busi_spec_id業(yè)務規(guī)格 bill_month賬單月 tenant_id租戶 ext1擴展字段 1（調(diào)賬目前用于展現(xiàn)調(diào)賬費用類型） ext2擴展字段 2 ext3擴展字段 34.1.1.3視圖列表視圖列表4.1.2功能實現(xiàn)說明功能實現(xiàn)說明功能概要說明功能概要說明當系統(tǒng)因為任何錯誤（如常見的資費配置錯誤、客戶資料受理錯誤、甚至有些系統(tǒng)未知錯誤）計算出來的賬單費用和客戶實際使用的費用不一致時需要有修正機制對客戶的賬單費用進行修改。調(diào)賬功能模塊的作用就是允許有一定權限的操作員對費用或賬單進行調(diào)整，以此來人為修正這些錯誤帶來的錯誤賬

50、單結果。 軟件功能設計說明書23調(diào)賬按照調(diào)賬類型的不同可以分為正向調(diào)賬和負向調(diào)賬兩種。正向調(diào)賬也叫向上調(diào)賬，是指因資費或其他特殊原因需增加客戶的賬單費用，表示客戶需向運營商多繳納一筆費用。負向調(diào)賬也叫向下調(diào)賬，常用于發(fā)生投訴時減少目標費用額度，表示運營商多收了客戶費用，需退還給客戶。按照功能的不同可以將調(diào)賬劃分為如下功能模塊：1. 調(diào)賬審批2. 調(diào)賬執(zhí)行4.1.2.24.1.2.2數(shù)據(jù)流程圖數(shù)據(jù)流程圖調(diào)賬審批調(diào)賬執(zhí)行調(diào)賬明細查詢更新CA_APPROVALCA_APPROVAL_DTL賬單明細調(diào)賬金額ABM信用度信息更新Credit Note記錄業(yè)務工單賬單調(diào)整總額插入CA_INFO_NOTE調(diào)

51、賬結果插入CA_BUSI_RECCA_BILL_ITEM_CHGCA_BUSI_REC_BILLCA_BILL_PRODCA_BILL_ITEMCA_BILL更新 軟件功能設計說明書25調(diào)賬審批科目調(diào)賬非科目調(diào)賬調(diào)賬明細查詢更新CA_BUSI_AUTHCA_AUTH_DTL賬單明細調(diào)賬金額信用度信息信用度信息更新更新賬單信息Credit Note記錄業(yè)務工單賬單調(diào)整總額插入CA_INFO_NOTE調(diào)賬結果插入CA_BUSI_RECCA_BILL_ITEM_CHGCA_APPLIED_RATE 軟件功能設計說明書264.1.2.34.1.2.3序列圖序列圖4.1.2.44.1.2.4功能點實現(xiàn)說

52、明功能點實現(xiàn)說明4.1.2.4.1 調(diào)賬審批和權限控制調(diào)賬審批和權限控制調(diào)賬審批是調(diào)賬執(zhí)行的一部分，當操作員進行調(diào)賬時，需要先判斷自己當前的操作權限是否可以執(zhí)行此次調(diào)賬，如果權限足夠則直接進行調(diào)賬操作，如果權限不足，則需要提交申請單給上級操作員進行審批?，F(xiàn)在審批放在 CRM 側(cè)，操作員申請的時候會調(diào)用 CRM 接口生成申請單，上級操作員可以在調(diào)賬詳情頁面查看調(diào)賬的明細信息。審批完成后，CRM 會調(diào)用 Billing 的反饋接口進行審批結果反饋。如果審批成功，則直接調(diào)用調(diào)賬接口進行調(diào)賬，如果審批失敗，需要退回修改，則將申請單狀態(tài)設置為審批失敗，等待修改。申請人在看到審批失敗后可以修改申請單，然后

53、進行重新提交。如果上級操作員想取消這個申請單，則將申請單置為撤單狀態(tài)。撤單狀態(tài)的申請單表明不執(zhí)行此次調(diào)賬。 軟件功能設計說明書27調(diào)賬開始查詢當前操作員調(diào)賬權限權限是否可以執(zhí)行調(diào)賬進行調(diào)賬操作查詢具有該操作權限的操作員信息是否提交申請單結束審批開始查詢提交給自己的申請單是否執(zhí)行該調(diào)賬操作將申請單狀態(tài)修改為審批通過將申請單狀態(tài)修改為審批不通過是否執(zhí)行調(diào)賬操作結束業(yè)務開始執(zhí)行調(diào)賬是否有權限調(diào)賬執(zhí)行調(diào)賬權限足夠BillingCRM向CRM提交申請單權限不足操作員是否有權限審批轉(zhuǎn)發(fā)給上級進行審批沒有權限執(zhí)行審批有權限在調(diào)賬詳情頁面查看調(diào)賬明細反饋審批結果給Billing修改申請單狀態(tài)為審批失敗等待修改

54、審批失敗修改申請單狀態(tài)為審批成功修改申請單狀態(tài)為撤銷申請單審批成功撤銷審批單修改申請單后重新提交給CRM進行審批記錄業(yè)務工單業(yè)務結束調(diào)賬權限調(diào)賬權限一調(diào)賬金額權限： 軟件功能設計說明書281.調(diào)賬金額 1，對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為 adjust_77000243，代表調(diào)賬操作員的第一級權限，調(diào)賬金額從 0-1499，對應 crm 的是實體編號為77000243。2.調(diào)賬金額 2，對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為 adjust_77000244，代表調(diào)賬操作員的第二級權限，調(diào)賬金額從 1499-2499，對應 c

55、rm 的實體編號是77000244。3.調(diào)賬金額 3，對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為 adjust_77000245，代表調(diào)賬操作員的第三級權限，調(diào)賬金額從 2499-9999，對應 crm 的實體編號是77000245。4.調(diào)賬金額 4.對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為 adjust_77000249，代表調(diào)賬操作員的第四級權限，調(diào)賬金額從 9999-49999，對應 crm 的實體編號是77000249。5.調(diào)賬金額 5.對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為 adjust_770

56、00250，代表調(diào)賬操作員的第五級權限，調(diào)賬金額從 49999-正無窮。擁有這個權限的人有最高的操作權限?？梢圆僮魉姓{(diào)賬金額。對應 crm 的實體編號是 77000250。二其他調(diào)賬權限1.顯示不審批的調(diào)賬原因權限：擁有該權限的操作員才會顯示不審批的調(diào)賬原因，如果沒有該權限，界面上只顯示需要審批的調(diào)賬原因。對應 MD.SYS_PRIVILEGE 表中的PRIV_CODE 為 adjust_77000246，對應的 crm 實體編號是 77000246。2.顯示發(fā)送 credit note 選項權限：擁有該權限的操作員才可以選擇下調(diào)發(fā)送credit note，并且直接調(diào)整歷史賬單。沒有該權限的

57、操作員做下調(diào)的時候默認調(diào)到下賬期。有該權限的操作員選擇了發(fā)送 credit note，則不再調(diào)到下賬期，而是直接調(diào)整歷史賬單并且給客戶發(fā)送 credit note。對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為adjust_77000247，對應的 crm 實體編號是 77000247。3.是否允許操作員輸入調(diào)賬金額權限：擁有該權限的操作員才可以進行調(diào)賬金額的輸入。否則只能將賬單調(diào)整為 0. 對應 MD.SYS_PRIVILEGE 表中的 PRIV_CODE 為adjust_77000248，對應的 crm 實體編號是 77000248。權限實體的獲取權限實體的獲取當從

58、 crm 頁面第一次跳轉(zhuǎn)到賬管頁面時，會回調(diào) sso 接口放入權限實體，而是從 軟件功能設計說明書29系管的配置表中獲取權限信息，系管在單點登錄成功以后會將權限信息放到 session中，如果從 session 中取出來的對應權限的 value 為 16 代表擁有該權限。例如調(diào)賬2600，如果從 session 中取出來的權限 code adjust_77000245 對應的 value 為 16，代表該操作員可以執(zhí)行調(diào)賬，如果 value 不是 16，則代表沒有權限，需要創(chuàng)建申請單。當頁面集成在 CRM 中的時候，系管會從 crm 查詢出操作員對應的所有權限并放到session 中，調(diào)賬的時

59、候根據(jù) session 中的權限信息進行權限的判斷。4.1.2.4.2 調(diào)賬執(zhí)行調(diào)賬執(zhí)行調(diào)賬執(zhí)行步驟如下：1. 校驗：校驗輸入的用戶名,invoice 級調(diào)賬如果已經(jīng)調(diào)過則不允許再次調(diào)賬。2. 賬單查詢：將傳入的費用科目綁定原始 bill。3. 定型：根據(jù)調(diào)整類型和調(diào)整明細對賬單進行調(diào)整。根據(jù)調(diào)整的類型來進行調(diào)賬操作；一次性費用：無賬單調(diào)賬上調(diào)，無賬單調(diào)賬下調(diào)，賬單級調(diào)賬下調(diào)負賬單：賬單級調(diào)賬下調(diào)4. 算稅：分析調(diào)賬原因，如果是需要算稅的調(diào)賬原因，則將輸入科目的含稅金額拆分為稅和不含稅兩部分。5. 調(diào)用沖銷接口，將調(diào)整費用體現(xiàn)在信用度上。6. 判斷是否需要生成 Credit Note，如果需要

60、生成則往 CA_INFO_NOTE 表中寫入錄入數(shù)據(jù)(生成的 Credit Note 信息需要包括調(diào)賬原因，調(diào)賬金額等信息)。7. 記錄變更軌跡和業(yè)務工單。8. 發(fā)送調(diào)賬告警。 軟件功能設計說明書309.調(diào)賬開始查詢操作員權限是否有權限進行調(diào)賬操作查詢具有操作權限的操作員信息否根據(jù)invoiceNo查詢賬單信息是提交申請單給上級操作員是否是直接調(diào)整賬單調(diào)用一次性費用接口將費用收取到下賬期否對賬單進行修改，如果是下調(diào)并且不夠調(diào)則多余的轉(zhuǎn)為Advance Payment是遍歷調(diào)賬明細根據(jù)調(diào)賬原因判斷是否需要調(diào)整稅費如果需要調(diào)稅則調(diào)用賬務接口進行算稅對稅費進行調(diào)整調(diào)用沖銷接口，將調(diào)整費用體現(xiàn)在信用度