申請(qǐng)免費(fèi)試用、咨詢(xún)電話：400-8352-114

項(xiàng)目名稱(chēng): K3標(biāo)準(zhǔn)憑證接口系統(tǒng)
創(chuàng)建者：
 
文檔修改紀(jì)錄

版本	日期	變化描述	修改人
1.0	2013-01-29	【ERD】 KE標(biāo)準(zhǔn)憑證接口系統(tǒng)
	2013-02-04	添加企業(yè)應(yīng)用圖

 

1.1產(chǎn)品概述

1號(hào)店財(cái)務(wù)總賬系統(tǒng)為金蝶K3系統(tǒng)，本次系統(tǒng)的目標(biāo)為建立一個(gè)通用憑證接口系統(tǒng)，未來(lái)所有需要和金蝶K3系統(tǒng)對(duì)接的系統(tǒng)都通過(guò)該憑證接口中間表，自動(dòng)生成金蝶K3系統(tǒng)的總賬憑證。
當(dāng)前的直接需求來(lái)自于泛普OA系統(tǒng)中的費(fèi)用報(bào)銷(xiāo)流程、內(nèi)采請(qǐng)款流程和一般請(qǐng)款流程對(duì)接K3系統(tǒng)自動(dòng)生成憑證的需求。
本接口系統(tǒng)的主要目標(biāo)是建立：

1. 對(duì)外提供針對(duì)中間表的讀寫(xiě)接口，接入金蝶K3的其他系統(tǒng)調(diào)用寫(xiě)入接口將憑證生成到中間表；金蝶K3調(diào)用讀取接口將特定狀態(tài)的憑證轉(zhuǎn)入K3系統(tǒng)，財(cái)務(wù)確認(rèn)后將生成K3系統(tǒng)的正式憑證；
2. 標(biāo)準(zhǔn)憑證接口的中間表，提供憑證查詢(xún)和錯(cuò)誤憑證修改功能。

1.2泛普OA軟件相關(guān)文檔

        

1.3 和其他項(xiàng)目的依賴(lài)

項(xiàng)目 ID	項(xiàng)目名稱(chēng)	依賴(lài)描述

 
 

2.1對(duì)現(xiàn)有設(shè)計(jì)分析

圖1 -系統(tǒng)上下文關(guān)系圖

圖2 –費(fèi)用報(bào)銷(xiāo)流程導(dǎo)入憑證過(guò)程圖
 

圖3 –金蝶K3系統(tǒng)生成正式憑證流程圖
 

2.21號(hào)店憑證接口系統(tǒng)架構(gòu)

2.3泛普軟件平臺(tái)新需求相關(guān)的設(shè)計(jì)

2.3.1表現(xiàn)層的設(shè)計(jì)

1. 查詢(xún)界面設(shè)計(jì)

 

1. 點(diǎn)擊憑證狀態(tài)，彈出詳情界面：

、

2.3.2泛普協(xié)同管理系統(tǒng)對(duì)外接口設(shè)計(jì)WebService

OA服務(wù)接口
http://<線上URL>/oa?wsdl，下面是接口內(nèi)容，屆時(shí)將替換成線上地址(具體內(nèi)容以實(shí)際URL服務(wù)接口為準(zhǔn))。
<definitions
    targetNamespace="http://impl.voucher.ws.service.finance.backend.yihaodian.com/"
    name="VoucherServiceOAWSImplService">
    <import namespace="http://voucher.ws.service.finance.backend.yihaodian.com/"
       location="backend-finance-service/oa?wsdl=1" />
    <binding name="VoucherServiceOAWSImplPortBinding" type="ns1:VoucherServiceOAWS">
       <soap:binding transport="http://schemas.xmlsoap.org/soap/http"
           style="rpc" />
       <operation name="createVoucher">
           <soap:operation soapAction="" />
           <input>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </input>
           <output>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </output>
       </operation>
    </binding>
    <service name="VoucherServiceOAWSImplService">
       <port name="VoucherServiceOAWSImplPort" binding="tns:VoucherServiceOAWSImplPortBinding">
          
       </port>
    </service>
</definitions>
 
K3 服務(wù)接口
http://<線上URL>/k3?wsdl，下面是接口內(nèi)容，屆時(shí)將替換成線上地址(具體內(nèi)容以實(shí)際URL服務(wù)接口為準(zhǔn))。
<definitions
    targetNamespace="http://impl.voucher.ws.service.finance.backend.yihaodian.com/"
    name="VoucherServiceK3WSImplService">
    <import namespace="http://voucher.ws.service.finance.backend.yihaodian.com/"
    
    <binding name="VoucherServiceK3WSImplPortBinding" type="ns1:VoucherServiceK3WS">
       <soap:binding transport="http://schemas.xmlsoap.org/soap/http"
           style="rpc" />
       <operation name="getVoucherList">
           <soap:operation soapAction="" />
           <input>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </input>
           <output>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </output>
       </operation>
       <operation name="setVoucherInfo">
           <soap:operation soapAction="" />
           <input>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </input>
           <output>
              <soap:body use="literal"
                  namespace="http://voucher.ws.service.finance.backend.yihaodian.com/" />
           </output>
       </operation>
    </binding>
    <service name="VoucherServiceK3WSImplService">
       <port name="VoucherServiceK3WSImplPort" binding="tns:VoucherServiceK3WSImplPortBinding">
          
       </port>
    </service>
</definitions>

2.3.3泛普軟件公司對(duì)外接口設(shè)計(jì)

服務(wù)以webservice方式提供給OA和K3系統(tǒng)調(diào)用。
提供給K3的服務(wù)接口：
獲取待生成憑證清單接口：VoucherService.getVoucherList(String  FAIS);
輸入?yún)?shù)：FAIS 字符串類(lèi)型，為K3帳套標(biāo)志
返回參數(shù)：List<VoucherInfo> voucherList 為待生成憑證的憑證清單
生成憑證反饋信息接口：VoucherService. setVoucherInfo(List<VoucherInfo> voucherList);
輸入?yún)?shù)：voucherList單據(jù)列表。          
返回參數(shù)：ReturnInfo 返回消息，code：狀態(tài)碼；message：返回消息
 
提供給OA的服務(wù)接口：
生成憑證服務(wù)：VoucherService.createVoucher(VoucherInfo voucherInfo);
輸入信息：voucherInf待生成憑證信息
返回參數(shù)：ReturnInfo 返回消息，code：狀態(tài)碼；message：返回消息
 

2.3.4泛普協(xié)同軟件表結(jié)構(gòu)的設(shè)計(jì)

 
Finanace庫(kù)新增表：

1. 通用憑證接口表表頭：

common_voucher_head:

字段	類(lèi)型	是否NULL	說(shuō)明	其它
ID	NUMBER(18)	N	ID	主鍵
Source	VARCHAR2(5)	N	來(lái)源	來(lái)源：如泛普OA、資產(chǎn)管理系統(tǒng)、后臺(tái)系統(tǒng)等
Doc_Type	VARCHAR2(5)	N	單據(jù)類(lèi)型
Doc_NO	VARCHAR2(40)	N	源單據(jù)號(hào)
Doc_ID	NUMBER(18)	N	源單據(jù)ID
Create_person	VARCHAR2(80)	N	創(chuàng)建人
Create_Time	DATE	N	創(chuàng)建時(shí)間
Update_person	VARCHAR2(80)	Y	更新人
Update_Time	DATE		更新時(shí)間
FVoucherID	VARCHAR2(80)	N	某一張憑證的唯一性標(biāo)志字段
FAIS	VARCHAR2(80)	N	K3帳套標(biāo)志，區(qū)分不同的帳套
FDate	DATE		憑證日期	1：開(kāi)0:關(guān)
FTransDate	DATE		業(yè)務(wù)日期
FGroupName	VARCHAR2(10)		憑證字
FReference	VARCHAR2(80)		參考信息
FAttachMents	INT		附件數(shù)
FStatus	INT		狀態(tài)	0：待確認(rèn) 1：待生成憑證 2：已生成憑證 3：生成憑證報(bào)錯(cuò)
FErrDesc	VARCHAR2(250)		生成憑證報(bào)錯(cuò)的信息
FSerialNum	NUMBER(18)		生成憑證的憑證序號(hào)

 

1. 通用憑證接口表表體：

common_voucher_body:

字段	類(lèi)型	是否NULL	說(shuō)明	其它
ID	NUMBER(18)	N	ID	主鍵
HEAD_ID	NUMBER(18)	N	表頭id
FEntryID	INT		憑證分錄號(hào)，從1開(kāi)始，標(biāo)示出該條記錄是該憑證的第幾行
FAccountNumber	VARCHAR2(80)		科目代碼
FAccountName	VARCHAR2(80)		科目名稱(chēng)
FCurrencyNumber	VARCHAR2(80)		幣別代碼
FCurrencyName	VARCHAR2(80)		幣別名稱(chēng)
FDC	VARCHAR2(1)		借貸方向，D：借；C：貸
FAmountFor	NUMBER(18,4)		原幣金額
FExchangeRateTypeName	VARCHAR2(20)		匯率類(lèi)型
FExchangeRate	NUMBER(18,4)		匯率
FAmount	NUMBER(18,4)		本位幣金額
FSettleTypeName	VARCHAR2(80)		結(jié)算方式
FSettleNo	VARCHAR2(80)		結(jié)算號(hào)
FExplanation	VARCHAR2(80)		摘要
FTransNo	VARCHAR2(80)		往來(lái)業(yè)務(wù)編號(hào)
FQty	NUMBER(18,0)		數(shù)量
FPrice	NUMBER(18,4)		單價(jià)
FUnitName	VARCHAR2(80)		計(jì)量單位
FItemList	VARCHAR2(250)		核算項(xiàng)目信息	核算項(xiàng)目信息，格式為：核算項(xiàng)目類(lèi)別,核算項(xiàng)目編碼,核算項(xiàng)目名稱(chēng); 核算項(xiàng)目類(lèi)別,核算項(xiàng)目編碼,核算項(xiàng)目名稱(chēng)… 例如：部門(mén),001,采購(gòu)部;職員,023,張三

1. 通用業(yè)務(wù)變更日志表：

業(yè)務(wù)變更日志被記錄在通用日志接口中，此接口參考通用日志記錄接口的ERD
 

1. 安全驗(yàn)證的key可以存放在財(cái)務(wù)公用的參數(shù)配置表中。

 安全驗(yàn)證采用參數(shù)串+key進(jìn)行MD5加密的方式進(jìn)行防篡改和身份驗(yàn)證。

2.3.5SQL語(yǔ)句

drop table COMMON_VOUCHER_HEAD cascade constraints;
/*==============================================================*/
/* Table: COMMON_VOUCHER_HEAD                                   */
/*==============================================================*/
create table COMMON_VOUCHER_HEAD
(
   ID                   NUMBER(18)           not null,
   SOURCE               VARCHAR2(5),
   DOC_TYPE             VARCHAR2(5),
   DOC_NO               VARCHAR2(40),
   DOC_ID               NUMBER(18),
   CREATE_PERSON        VARCHAR2(80),
   CREATE_TEME          DATE,
   UPDATE_PERSON        VARCHAR2(80),
   UPDATE_TIME          DATE,
   FVOUCHER_ID          VARCHAR2(80),
   FAIS                 VARCHAR2(80),
   FDATE                DATE,
   FTRANS_DATE          DATE,
   FGROUP_NAME          VARCHAR2(10),
   FREFERENCE           VARCHAR2(80),
   FATTACH_MENTS        INT,
   FSTATUS              INT,
   FERR_DESC            VARCHAR2(250),
   FSERIAL_NUM          NUMBER(18),
   constraint PK_COMMON_VOUCHER_HEAD primary key (ID)
);
comment on table COMMON_VOUCHER_HEAD is
'通用憑證接口表表頭';
comment on column COMMON_VOUCHER_HEAD.ID is
'主鍵';
comment on column COMMON_VOUCHER_HEAD.SOURCE is
'來(lái)源：如泛普OA、資產(chǎn)管理系統(tǒng)、后臺(tái)系統(tǒng)等';
comment on column COMMON_VOUCHER_HEAD.DOC_TYPE is
'單據(jù)類(lèi)型';
comment on column COMMON_VOUCHER_HEAD.DOC_NO is
'源單據(jù)號(hào)';
comment on column COMMON_VOUCHER_HEAD.DOC_ID is
'源單據(jù)ID';
comment on column COMMON_VOUCHER_HEAD.CREATE_PERSON is
'創(chuàng)建人';
comment on column COMMON_VOUCHER_HEAD.CREATE_TEME is
'創(chuàng)建時(shí)間';
comment on column COMMON_VOUCHER_HEAD.UPDATE_PERSON is
'更新人';
comment on column COMMON_VOUCHER_HEAD.UPDATE_TIME is
'更新時(shí)間';
comment on column COMMON_VOUCHER_HEAD.FVOUCHER_ID is
'某一張憑證的唯一性標(biāo)志字段';
comment on column COMMON_VOUCHER_HEAD.FAIS is
'K3帳套標(biāo)志，區(qū)分不同的帳套';
comment on column COMMON_VOUCHER_HEAD.FDATE is
'憑證日期';
comment on column COMMON_VOUCHER_HEAD.FTRANS_DATE is
'業(yè)務(wù)日期';
comment on column COMMON_VOUCHER_HEAD.FGROUP_NAME is
'憑證字';
comment on column COMMON_VOUCHER_HEAD.FREFERENCE is
'參考信息';
comment on column COMMON_VOUCHER_HEAD.FATTACH_MENTS is
'附件數(shù)';
comment on column COMMON_VOUCHER_HEAD.FSTATUS is
'0：待確認(rèn)，1：待生成憑證，2：已生成憑證，3：生成憑證報(bào)錯(cuò)';
comment on column COMMON_VOUCHER_HEAD.FERR_DESC is
'生成憑證報(bào)錯(cuò)的信息';
comment on column COMMON_VOUCHER_HEAD.FSERIAL_NUM is
'生成憑證的憑證序號(hào)';
drop table COMMON_VOUCHER_BODY cascade constraints;
/*==============================================================*/
/* Table: COMMON_VOUCHER_BODY                                   */
/*==============================================================*/
create table COMMON_VOUCHER_BODY
(
   ID                   NUMBER(18)           not null,
   HEAD_ID              NUMBER(18),
   FENTRY_ID            INT,
   FACCOUNT_NUMBER      VARCHAR2(80),
   FACCOUNT_NAME        VARCHAR2(80),
   FCURRENCY_NUMBER     VARCHAR2(80),
   FCURRENCY_NAME       VARCHAR2(80),
   FDC                  VARCHAR2(1),
   FAMOUNT_FOR          NUMBER(18,4),
   FEXCHANGE_RATE_TYPE_NAME VARCHAR2(20),
   FEXCHANGE_RATE       NUMBER(18,4),
   FAMOUNT              NUMBER(18,4),
   FSETTLE_TYPE_NAME    VARCHAR2(80),
   FSETTLE_NO           VARCHAR2(80),
   FEXPLANATION         VARCHAR2(80),
   FTRANS_NO            VARCHAR2(80),
   FQTY                 NUMBER(18,0),
   FPRICE               NUMBER(18,4),
   FUNIT_NAME           VARCHAR2(80),
   FITEM_LIST           VARCHAR2(250),
   constraint PK_COMMON_VOUCHER_BODY primary key (ID)
);
comment on table COMMON_VOUCHER_BODY is
'通用憑證接口表表體';
comment on column COMMON_VOUCHER_BODY.HEAD_ID is
'表頭id';
comment on column COMMON_VOUCHER_BODY.FENTRY_ID is
'憑證分錄號(hào)，從1開(kāi)始，標(biāo)示出該條記錄是該憑證的第幾行';
comment on column COMMON_VOUCHER_BODY.FACCOUNT_NUMBER is
'科目代碼';
comment on column COMMON_VOUCHER_BODY.FACCOUNT_NAME is
'科目名稱(chēng)';
comment on column COMMON_VOUCHER_BODY.FCURRENCY_NUMBER is
'幣別代碼';
comment on column COMMON_VOUCHER_BODY.FCURRENCY_NAME is
'幣別名稱(chēng)';
comment on column COMMON_VOUCHER_BODY.FDC is
'借貸方向，D：借；C：貸';
comment on column COMMON_VOUCHER_BODY.FAMOUNT_FOR is
'原幣金額';
comment on column COMMON_VOUCHER_BODY.FEXCHANGE_RATE_TYPE_NAME is
'匯率類(lèi)型';
comment on column COMMON_VOUCHER_BODY.FEXCHANGE_RATE is
'匯率';
comment on column COMMON_VOUCHER_BODY.FAMOUNT is
'本位幣金額';
comment on column COMMON_VOUCHER_BODY.FSETTLE_TYPE_NAME is
'結(jié)算方式';
comment on column COMMON_VOUCHER_BODY.FSETTLE_NO is
'結(jié)算號(hào)';
comment on column COMMON_VOUCHER_BODY.FEXPLANATION is
'摘要';
comment on column COMMON_VOUCHER_BODY.FTRANS_NO is
'往來(lái)業(yè)務(wù)編號(hào)';
comment on column COMMON_VOUCHER_BODY.FQTY is
'數(shù)量';
comment on column COMMON_VOUCHER_BODY.FPRICE is
'單價(jià)';
comment on column COMMON_VOUCHER_BODY.FUNIT_NAME is
'計(jì)量單位';
comment on column COMMON_VOUCHER_BODY.FITEM_LIST is
'核算項(xiàng)目信息，格式為：核算項(xiàng)目類(lèi)別,核算項(xiàng)目編碼,核算項(xiàng)目名稱(chēng); 核算項(xiàng)目類(lèi)別,核算項(xiàng)目編碼,核算項(xiàng)目名稱(chēng)…
例如：部門(mén),001,采購(gòu)部;職員,023,張三';
drop sequence SEQ_COMMON_VOUCHER_BODY;
create sequence SEQ_COMMON_VOUCHER_BODY
increment by 1
start with 1
 nomaxvalue
 minvalue 1
nocycle
 cache 30;
 
drop sequence SEQ_COMMON_VOUCHER_HEAD;
create sequence SEQ_COMMON_VOUCHER_HEAD
increment by 1
start with 1
 nomaxvalue
 minvalue 1
nocycle
 cache 30;
 

2.3.6頁(yè)面重量的考慮

2.3.7頁(yè)面緩存的影響