協(xié)同OA軟件與金蝶K3集成技術(shù)方案

項目名稱: 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.1產(chǎn)品概述

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

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

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

1.3 和其他項目的依賴

項目 ID	項目名稱	依賴描述

2泛普協(xié)同OA軟件設(shè)計

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

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

圖2 –費用報銷流程導(dǎo)入憑證過程圖

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

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

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

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

查詢界面設(shè)計

點擊憑證狀態(tài)，彈出詳情界面：

、

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

OA服務(wù)接口
http://<線上URL>/oa?wsdl，下面是接口內(nèi)容，屆時將替換成線上地址(具體內(nèi)容以實際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)容，屆時將替換成線上地址(具體內(nèi)容以實際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泛普軟件公司對外接口設(shè)計

服務(wù)以webservice方式提供給OA和K3系統(tǒng)調(diào)用。
提供給K3的服務(wù)接口：
獲取待生成憑證清單接口：VoucherService.getVoucherList(String FAIS);
輸入?yún)?shù)：FAIS 字符串類型，為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è)計

Finanace庫新增表：

通用憑證接口表表頭：

common_voucher_head:

字段	類型	是否NULL	說明	其它
ID	NUMBER(18)	N	ID	主鍵
Source	VARCHAR2(5)	N	來源	來源：如泛普OA、資產(chǎn)管理系統(tǒng)、后臺系統(tǒng)等
Doc_Type	VARCHAR2(5)	N	單據(jù)類型
Doc_NO	VARCHAR2(40)	N	源單據(jù)號
Doc_ID	NUMBER(18)	N	源單據(jù)ID
Create_person	VARCHAR2(80)	N	創(chuàng)建人
Create_Time	DATE	N	創(chuàng)建時間
Update_person	VARCHAR2(80)	Y	更新人
Update_Time	DATE		更新時間
FVoucherID	VARCHAR2(80)	N	某一張憑證的唯一性標(biāo)志字段
FAIS	VARCHAR2(80)	N	K3帳套標(biāo)志，區(qū)分不同的帳套
FDate	DATE		憑證日期	1：開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：生成憑證報錯
FErrDesc	VARCHAR2(250)		生成憑證報錯的信息
FSerialNum	NUMBER(18)		生成憑證的憑證序號

通用憑證接口表表體：

common_voucher_body:

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

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

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

安全驗證的key可以存放在財務(wù)公用的參數(shù)配置表中。

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

2.3.5SQL語句

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
'來源：如泛普OA、資產(chǎn)管理系統(tǒng)、后臺系統(tǒng)等';
comment on column COMMON_VOUCHER_HEAD.DOC_TYPE is
'單據(jù)類型';
comment on column COMMON_VOUCHER_HEAD.DOC_NO is
'源單據(jù)號';
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)建時間';
comment on column COMMON_VOUCHER_HEAD.UPDATE_PERSON is
'更新人';
comment on column COMMON_VOUCHER_HEAD.UPDATE_TIME is
'更新時間';
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：生成憑證報錯';
comment on column COMMON_VOUCHER_HEAD.FERR_DESC is
'生成憑證報錯的信息';
comment on column COMMON_VOUCHER_HEAD.FSERIAL_NUM is
'生成憑證的憑證序號';
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
'憑證分錄號，從1開始，標(biāo)示出該條記錄是該憑證的第幾行';
comment on column COMMON_VOUCHER_BODY.FACCOUNT_NUMBER is
'科目代碼';
comment on column COMMON_VOUCHER_BODY.FACCOUNT_NAME is
'科目名稱';
comment on column COMMON_VOUCHER_BODY.FCURRENCY_NUMBER is
'幣別代碼';
comment on column COMMON_VOUCHER_BODY.FCURRENCY_NAME is
'幣別名稱';
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
'匯率類型';
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é)算號';
comment on column COMMON_VOUCHER_BODY.FEXPLANATION is
'摘要';
comment on column COMMON_VOUCHER_BODY.FTRANS_NO is
'往來業(yè)務(wù)編號';
comment on column COMMON_VOUCHER_BODY.FQTY is
'數(shù)量';
comment on column COMMON_VOUCHER_BODY.FPRICE is
'單價';
comment on column COMMON_VOUCHER_BODY.FUNIT_NAME is
'計量單位';
comment on column COMMON_VOUCHER_BODY.FITEM_LIST is
'核算項目信息，格式為：核算項目類別,核算項目編碼,核算項目名稱; 核算項目類別,核算項目編碼,核算項目名稱…
例如：部門,001,采購部;職員,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;