【返回Z平臺-幫助文件-首頁】

---

本章重點講解如何正確使用Z平臺中財務總賬模組，方便大家在真實專案中快速的使用該功能進行記賬功能的開發。

應用場景介紹

記賬過程應用說明

電子賬戶記賬

第一、建立新的賬戶型別

第二、建立客戶資料

第三、進賬介面呼叫

第四、出賬介面呼叫

客戶積分記賬

記賬介面詳解

核心Service介紹

記賬模式介紹

直接入賬

凍結入賬

呼叫方式

Z平臺中JAVA類中呼叫【強烈推薦這種方式】

通過HTTP方式第三方應用呼叫

應用場景介紹

以電商專案為例，一般電商專案的組成，大多為前端APP與各種小程式 + 後臺管理系統【負責訂單、發貨、記賬等業務的處理】這種模式進行專案架構。那麼我們們就以Z平臺做為後臺管理系統開發平臺為例進行講解。

首先，我們們假定虛擬電商專案的後臺管理系統的主要模組為客戶管理、商品管理、訂單管理、財務管理等幾個核心模組。其中，財務模組中包括對客戶的電子錢包賬戶管理與積分管理功能。並且平臺設定了購物贈送積分的規則，規則為購物消費10元積1分的規則。

其次，我們們擬定一條客戶購物的業務流程如下：

 虛擬流程資料：     

                    客戶：張三         購買商品：手機1部           商品價格：5000元        獲得積分：500分【10元積1分規則】

---

通過以上應用場景與模擬資料有設定，我們們怎麼在Z平臺的財務總賬模組中進行，客戶賬戶與積分這兩項的記賬過程呢？請繼續閱讀下文的介紹

記賬過程應用說明

在應用場景介紹中可以看到，需要記賬的需求有兩塊，分別是客戶的電子賬戶與客戶積分兩種需要記賬的資料。那麼接下來我分別來介紹兩種資料是如何進行記賬操作的。由於多數專案的記賬過程都是在業務流程中自動通過呼叫記賬介面程式來完成的。所以我也以介面呼叫的方式來完成記賬的全過程演示。

電子賬戶記賬

第一、建立新的賬戶型別

開啟 【ERP系統/財務管理/賬戶型別】功能。新增一條記錄並儲存。

賬戶名稱：電子錢包

單位：元 【根據賬戶儲存資料的型別進行選擇】

保留小數位：2【記賬資料保留的小數位】

是否啟用：是

第二、建立客戶資料

記賬過程必須以客戶為根本，那麼我們也模擬建立幾位客戶資料，開啟【ERP系統 / 客戶管理 / 客戶資訊】功能，為了後續演示過程，本次建立了3名使用者。

 

第三、進賬介面呼叫

在應用場景介紹中描述的流程，客戶張三在購買商品前需要對自己的電子賬戶充值5000元。

充值介面：

http://伺服器IP/z/acc_add?
a_type=賬戶型別主鍵
&userid=客戶主鍵
&amount=進賬數量
&mode=進賬模式【0：直接進賬  1：凍結進賬】
&bizid=自定義業務ID【非必填】，例如：關聯的訂單號

介面呼叫中的引數都需要用到各種業務表記錄的主鍵，獲取主鍵的方法請參考【開發技巧--如何獲取表記錄的主鍵】

例項：

http://192.168.1.123/z/acc_add?a_type=e9b30833c7dc4ac4na2yce9etetpc12517auapro87913125175eaf1b2822222922211827241623252319262516&userid=75245e60ebcfsmo4tu12517ecdb19c1rr24mb03ff793bc1f17192213141312141313192712

&amount=5000&mode=0

第四、出賬介面呼叫

在應用場景介紹中描述的流程，客戶張三在購買商品是通過電子賬戶支付了5000元。

支付訂單介面：

http://伺服器IP/z/acc_sub?
a_type=賬戶型別主鍵
&userid=客戶主鍵
&amount=出賬數量
&mode=出賬模式【0：直接進賬  1：凍結進賬】
&bizid=自定義業務ID【非必填】，例如：關聯的訂單號

介面呼叫中的引數都需要用到各種業務表記錄的主鍵，獲取主鍵的方法請參考【開發技巧--如何獲取表記錄的主鍵】

例項：http://192.168.1.123/z/acc_sub?a_type=e9b30833c7dc4ac4na2yce9etetpc12517auapro87913125175eaf1b2822222922211827241623252319262516&userid=75245e60ebcfsmo4tu12517ecdb19c1rr24mb03ff793bc1f17192213141312141313192712&amount=5000&mode=0

客戶積分記賬

積分記賬與客戶電子賬戶記賬過程一同，只是建立新的賬戶型別為【積分】並且積分一般沒有小數位。其它呼叫進賬、出賬過程相同。

例如：客戶張三購買完商品後會獲得500積分，可以呼叫進賬介面，賬戶型別選擇為積分

 

記賬介面詳解

核心Service介紹

在Z平臺中，所有的記賬方法，都寫在 com.futvan.z.erp.erp_account.Erp_accountService Service中。有能力的同學建議自己定義新的Controller.來呼叫該Service中的方法。

核心方法：

Erp_accountService.Add  進賬方法

Erp_accountService.Subtract  出賬方法

Erp_accountService.Remove  刪除明細賬方法

Erp_accountService.Unfrozen  解除凍結賬方法

記賬模式介紹

Z平臺記賬分為兩種模式，直接入賬與凍結入賬兩種

直接入賬

指的是無論進賬或出賬，介面引數mode為0的狀態下，直接寫入總賬。

凍結入賬

指的是無論進賬或出賬，都是先執行凍結操作。然後通過呼叫解除凍結介面來完成真實的寫入總賬操作。如果還在凍結狀態的入賬可以通過刪除明細賬介面來完成刪除明細賬的操作過程。

呼叫方式

Z平臺中JAVA類中呼叫【強烈推薦這種方式】

在Z平臺後臺Controller類中，通過注入的方式載入Erp_accountService，然後自己重寫呼叫介面的方法，這種方式可以有效的保護記賬介面。比較完全。

通過HTTP方式第三方應用呼叫

http://伺服器IP/acc_add     進賬介面

http://伺服器IP/acc_sub      出賬介面

http://伺服器IP/acc_unfrozen   解除凍結介面

http://伺服器IP/acc_remove     刪除明細賬介面