1、業務數據通訊模塊概要設計文檔杭州方欣計算機工程有限公司2009年7月目 錄TOC o 1-3 h z t DN-序號,3 HYPERLINK l _Toc236466452 引言 PAGEREF _Toc236466452 h 3 HYPERLINK l _Toc236466453 概述 PAGEREF _Toc236466453 h 4 HYPERLINK l _Toc236466454 1、背景介紹 PAGEREF _Toc236466454 h 4 HYPERLINK l _Toc236466455 2、通訊需求 PAGEREF _Toc236466455 h 4 HYPERLINK l

2、 _Toc236466456 采用TCP/IP協議 PAGEREF _Toc236466456 h 4 HYPERLINK l _Toc236466457 傳遞報文 PAGEREF _Toc236466457 h 4 HYPERLINK l _Toc236466458 同步或異步傳輸 PAGEREF _Toc236466458 h 4 HYPERLINK l _Toc236466459 文本或文件傳輸 PAGEREF _Toc236466459 h 4 HYPERLINK l _Toc236466460 3、通訊示意圖 PAGEREF _Toc236466460 h 4 HYPERLINK l

3、 _Toc236466461 第一章通訊業務基本規則 PAGEREF _Toc236466461 h 6 HYPERLINK l _Toc236466462 1、通訊中涉及到的數據范圍及數據流向： PAGEREF _Toc236466462 h 6 HYPERLINK l _Toc236466463 2、總公司FTP服務器規范說明： PAGEREF _Toc236466463 h 6 HYPERLINK l _Toc236466464 3、分公司端與總公司端通訊報文： PAGEREF _Toc236466464 h 6 HYPERLINK l _Toc236466465 3.1、用途 PAGE

4、REF _Toc236466465 h 6 HYPERLINK l _Toc236466466 3.2、格式 PAGEREF _Toc236466466 h 6 HYPERLINK l _Toc236466467 第二章客戶端交易過程流程圖 PAGEREF _Toc236466467 h 7 HYPERLINK l _Toc236466468 第三章服務端交易過程 PAGEREF _Toc236466468 h 9 HYPERLINK l _Toc236466469 第四章通訊相關業務描述 PAGEREF _Toc236466469 h 9 HYPERLINK l _Toc236466470

5、一、基礎資料傳輸交易 PAGEREF _Toc236466470 h 9 HYPERLINK l _Toc236466471 二、基礎資料傳輸流程圖 PAGEREF _Toc236466471 h 10 HYPERLINK l _Toc236466472 三、開票信息傳輸交易 PAGEREF _Toc236466472 h 10 HYPERLINK l _Toc236466473 四、開票信息傳輸流程圖 PAGEREF _Toc236466473 h 10 HYPERLINK l _Toc236466474 第五章通訊報文格式描述 PAGEREF _Toc236466474 h 12 HYPE

6、RLINK l _Toc236466475 分公司與總公司通訊報文 PAGEREF _Toc236466475 h 12 HYPERLINK l _Toc236466476 1、基礎資料傳輸交易 PAGEREF _Toc236466476 h 12 HYPERLINK l _Toc236466477 2、基礎資料傳輸狀態查詢交易 PAGEREF _Toc236466477 h 14 HYPERLINK l _Toc236466478 3、開票信息傳輸交易 PAGEREF _Toc236466478 h 14 HYPERLINK l _Toc236466479 4、開票信息傳輸狀態查詢交易 PA

7、GEREF _Toc236466479 h 15 HYPERLINK l _Toc236466480 5、網絡狀態查詢 PAGEREF _Toc236466480 h 17 HYPERLINK l _Toc236466481 第六章附錄 PAGEREF _Toc236466481 h 17 HYPERLINK l _Toc236466482 一、交易存儲過程返回代碼說明： PAGEREF _Toc236466482 h 17引言閱讀指南。閱讀對象名詞解釋【注意】聯系人【警告】無。概述1、背景介紹在某大型企業的信息化應用中，分公司的業務系統需要和總公司的系統進行數據通訊和傳輸，每天總公司需要獲得

8、分公司的業務數據，如產品銷售情況，同時更新分公司相應的基礎資料信息。數據通訊必須要遵守標準協議和約定,所以分公司數據通訊客戶端與總公司的數據通訊模塊服務器端之間要有統一的業務接口。以便通訊服務器端在接收客戶端數據后,可把數據傳遞給總公司管理系統,總公司管理系統把處理的結果返回給通訊服務器端,通過服務器端再把應答消息返回給分公司數據通訊客戶端。2、通訊需求采用TCP/IP協議采用標準的TCP/IP協議。通訊服務端是TCP/IP的服務端，是通訊連接和關閉的被動方。傳遞報文通訊報文、業務報文格式由總公司已擬訂好,通訊服務器端在接收客戶端的業務報文后,根據報文內容進行后續處理,處理后生成處理結果,再把

9、此結果信息返回給分公司客戶端。同步或異步傳輸傳輸可以使用同步或異步模式。如果是同步模式，服務器端把業務處理完畢后才能返回消息給客戶端；如果是異步模式，則服務器端接收完數據后就先把應答消息頭返回給客戶端,再傳遞業務數據處理。文本或文件傳輸可支持文本傳輸，同時也支持文件的傳輸。文件的傳輸通過FTP進行傳輸。3、通訊示意圖傳輸客戶端傳輸客戶端報文傳輸服務端總公司管理系統分公司分公司業務系統總公司FTPTCP/IP協議總公司FTP協議第一章 通訊業務基本規則1、通訊中涉及到的數據范圍及數據流向：注:為了說明方便，通訊端客戶端指分公司，通訊端服務端指總公司。數據流向說明：開票數據：分公司-總公司-分公司

10、（說明：客戶端發起交易生成數據，傳送到服務端，服務端經過數據處理后返回日志，客戶端獲取日志后根據日志內容修改數據庫）基礎數據：總公司-分公司：（說明：客戶端發起交易但不生成數據，由服務端生成數據，客戶端獲取數據后根據數據內容修改數據庫）數據覆蓋原則：以總公司為準進行覆蓋。數據范圍及數據流向表交易名稱數據流向落地機制數據覆蓋機制基礎資料傳輸交易總公司-分公司允許部分落地，無法落地的信息記入錯誤日志表以總公司為準進行覆蓋;服務端返回數據項中：總公司沒有分公司有，采取刪除原則。開票信息傳輸交易分公司-總公司-分公司允許部分落地，無法落地的信息記入錯誤日志表日志返回成功的結果回寫開票表的傳送標記字段，

11、不成功的結果則不操作2、總公司FTP服務器規范說明：總公司FTP服務器根據不同分公司建立用戶，用戶名和密碼都為分公司編碼，在總公司FTP上建立一個目錄做為根目錄，然后以分公司編碼做為子目錄名，客戶端和服務端生成的數據文件上傳到該分公司編碼的子目錄下，命名方式以YYYYMMDD-業務名稱XX.xml，總公司返回日志文件名稱為YYYYMMDD-業務名稱YZXX.xml。3、分公司端與總公司端通訊報文：3.1、用途通訊中，任何方發送或接收的第一個內容必須是專用報文。發送方利用專用報文告訴接收方：本次通訊的目的、方式、內容；接收方必須接收到專用報文后才能確定后續應該如何操作。3.2、格式專用報文長度必

12、須是512字節。如果不足512字節，則必須用空格補充。下表說明專用報文的組成結構：序號名稱長度（字節）說明1應答碼4如果本字段為“9999”，則表示是客戶端向服務器發送的請求；如果本字段為“0000”，則表示服務器向客戶端返回成功信息；如果本字段為“0001”，則表示客戶端接收數據超時；如果本字段為“0002”，則表示接收服務器向客戶端返回失敗信息。如果本字段為“5555”，則表示客戶端向服務器發送斷開連接的請求。2同步或異步10:同步；1:異步3文件名50本字段在服務器端passMessage調用時起作用。4文件傳輸標識10本字段在服務器向客戶端傳輸文件時的標識,值為”0”則代表通過本系統傳

13、輸,值為”1”則代表通過FTP服務器傳輸。本字段不夠長度的用空格補全.5業務報文長度10如果本字段為0，則表示專用報文后不需傳輸業務報文；如果不為0，則表示專用報文后緊跟著傳輸的是本字段所規定長度的業務報文。 6數據文件長度10如果本字段為0，則表示在傳輸業務報文之后不需要再傳輸數據文件；如果本字段不為0，則表示業務報文后緊跟著傳輸的是數據文件的內容。7消息鑒別碼10服務器端在接收到數據后要對該數據進行消息鑒別碼的判斷,如果不一樣,說明數據被篡改.不再作業務處理,告訴業務業務處理失敗應答.(暫不用算法實現,用10個A填充);第二章 客戶端交易過程流程圖流程說明：主要為兩個交易：基礎資料交易、開

14、票信息交易基礎資料交易1客戶端向服務器端發送網絡狀態查詢報文，監測能否接受服務器應答而決定是否進行后續操作。2客戶端向通訊服務器端發送傳輸交易業務報文。3通訊服務器端的業務模塊進行業務相關數據操作，生成該分公司的基礎資料。4通訊服務器端業務模塊把生成的處理結果上傳至總公司FTP服務器。5客戶端向通訊服務器端發送查詢交易業務報文。6 通訊服務器業務模塊檢查該次業務數據操作是否完成，并返回查詢結果報文。7 服務器端向客戶端返回處理結果消息及基礎資料文件。8 客戶端根據服務器端返回結果決定是否進行后續操作，成功則去FTP服務器上下載處結果文件。9 客戶端做數據驗證并做更新本地基礎資料數據操作，產生日

15、志，日志本地保存，并上傳至總公司FTP服務器。開票信息交易1客戶端向服務器端發送網絡狀態查詢報文，監測能否接受服務器應答而決定是否進行后續操作。2客戶端生成開票數據文件，并把生成的數據文件上傳至向總公司FTP服務器。3 客戶端向通訊服務器端發送傳輸交易業務報文。4通訊服務器端的業務模塊收到開票數據文件，然后進行業務相關數據操作。5客戶端向通訊服務器端發送查詢交易業務報文。6 通訊服務器業務模塊檢查該次業務數據操作是否完成，并返回查詢結果報文。7 服務器端向客戶端返回處理結果消息。8 客戶端根據服務器端返回結果決定是否進行后續操作，成功則去FTP服務器上下載處結果文件。9 客戶端做數據驗證并做更

16、新本地開票數據操作，對于總公司已成功接收的開票數據打上已傳輸標識，并產生日志，日志本地保存，并上傳至總公司FTP服務器。第三章 服務端交易過程流程說明：1通訊服務器端接受客戶端的傳輸交易報文，讀取客戶端上傳文件，經過基本驗證后返回應答報文。2通訊服務器端的業務模塊進行業務數據操作，并生成返回處理結果。3 業務模塊生成處理結果并上傳至總公司FTP服務器。4 通訊服務器端接受客戶端的傳輸交易報文，經過基本驗證后返回應答報文。5 客戶端根據應答報文內容決定是否進行后續操作，成功則去FTP服務器上下載處結果文件。6 客戶端做數據驗證并入庫操作，產生日志，日志本地保存，并上傳至總公司FTP服務器。注：服

17、務端程序功能已經實現，會根據報文內容處理服務端的事務。因此服務端程序功能不需要在本需求中實現。第四章 通訊相關業務描述一、基礎資料傳輸交易分公司通過這個交易，準確地獲取到公司的兩個方面的基本信息。其中包括：1、分公司的基本信息。分公司基本信息以總公司為準，每次更新總公司下發的最新信息。2、產品列表信息。產品列表以總公司為準：1)更新已經存在的產品列表信息。2)停用或者刪除（未存在開票信息）沒有下發確在分公司已經存在的產品列表信息。二、基礎資料傳輸流程圖三、開票信息傳輸交易分公司端通過這個交易，將某段時間內的業務銷售開票信息（包括銷售單和退貨單）傳送到總公司。根據業務表YW_BILLINFO的傳

18、送標記字段CSBJ，查詢出需要未上傳的票據信息CSBJ=0。根據報文格式生產上傳的XML文件。最后根據報文格式生成數據文件上傳總公司FTP服務器，再由開票信息傳輸交易報送到總公司端，總公司端經過驗證后數據部分落地后返回日志并上傳總公司FTP服務器，分公司端下載日志后分析內容，如果有錯則分公司端修改數據后重新傳送。四、開票信息傳輸流程圖第五章 通訊報文格式描述分公司與總公司通訊報文交易名稱實時性要求交易代碼基礎資料傳輸交易同步、實時76基礎資料傳輸狀態查詢交易同步、實時77開票信息傳輸交易同步、實時80開票信息傳輸狀態查詢交易同步、實時81網絡狀態查詢同步、實時881、基礎資料傳輸交易交易涉及到

19、的內容：1、分公司的基本信息。分公司基本信息以總公司為準，每次更新總公司下發的最新信息。2、產品列表信息。產品列表以總公司為準：1)更新已經存在的產品列表信息。2)停用或者刪除（未存在開票信息）沒有下發確在分公司已經存在的產品列表信息。1.1 報文格式分公司向總公司發送報文：“交易名稱” -基礎資料傳輸交易“交易類型” -76“交易驗證信息” -基礎資料傳輸交易“所屬區域碼”“分公司編碼”“傳輸日期”- 格式(YYYY-MM-DD)“批次號” -從0開始遞增總公司向分公司返回報文：“交易名稱” -基礎資料傳輸交易“交易類型” -76“交易驗證信息” -基礎資料傳輸交易“返回碼” -錯誤碼詳見（

20、錯誤列表）“返回碼信息”1.2 總公司向分公司返回的基礎資料信息（文件）1、作用：總公司接到分公司的基礎資料信息傳輸交易請求成功后，生成基礎資料信息文件（兩個文件），然后用分公司編碼作用戶名，分公司編碼為密碼的口令登錄總公司端FTP服務器，總公司端的目錄結構以分公司編碼做為目錄，并上傳至總公司FTP服務器供客戶端下載。2、命名規范：YYYYMMDD-DWXX-批次號.xml（分公司的基本信息文件）YYYYMMDD-CPLBXX-批次號.xml（產品列表信息文件）3、文件格式：YYYYMMDD-DWXX-批次號.xml（分公司的基本信息文件）“交易名稱” -基礎資料傳輸交易“交易類型” -76“

21、交易驗證信息”-基礎資料傳輸交易 -分公司信息，多條，實際上只有一條分公司編碼“分公司所屬區域碼”“分公司名稱”“分公司簡稱”“地址”“郵編”“法人代表聯系電話”“法人代表姓名”“法人代表(傳真)”“財務負責人姓名”“財務負責人(聯系電話)”“財務負責人(傳真)”“業務負責人(姓名)”“業務負責人(聯系電話)”“業務負責人(傳真)”“在職人數”“離退休人數”“臨時人數”“是否開展項目業務”“公司授權”“數據庫同步標志”“最近同步日期”“備注”“電子郵件”“傳真號碼”“3位碼”YYYYMMDD-CPLBXX-批次號.xml（產品列表信息文件）“交易名稱” -基礎資料傳輸交易“交易類型” -76“

22、交易驗證信息” -基礎資料傳輸交易 -產品列表信息，多條“產品ID”“產品系列”“產品名稱”“單位” “單價”“折扣率”“是否特價”“是否為默認顯示”“是否為主營產品”“狀態”2、基礎資料傳輸狀態查詢交易分公司向總公司通訊報文：“交易名稱” -基礎資料傳輸狀態查詢交易“交易類型” -77“交易驗證信息” -基礎資料傳輸狀態查詢交易“所屬區域碼”“分公司編碼”“傳輸日期”- 格式(YYYY-MM-DD)“批次號”總公司向分公司通訊報文：“交易名稱” -基礎資料傳輸狀態查詢交易“交易類型” -77“交易驗證信息” -基礎資料傳輸狀態查詢交易“返回碼” -錯誤碼詳見（錯誤列表）“返回碼信息”“基礎資

23、料信息文件名稱”-（多個文件名稱間用“，”分隔）“基礎資料信息文件大小”-（多個文件大小間用“，”分隔）3、開票信息傳輸交易3.1 報文格式分公司向總公司發送報文：“交易名稱” -開票信息傳輸交易“交易類型” -80“交易驗證信息” -開票信息傳輸交易“所屬區域碼”“分公司編碼”“交易時間” - 格式(YYYY-MM-DD)“批次號” -從0開始遞增“開票信息文件名稱”“開票信息文件大小”總公司向分公司返回報文：“交易名稱” -開票信息傳輸交易“交易類型” -80“交易驗證信息” -開票信息傳輸交易“返回碼”-錯誤碼詳見（錯誤列表）“返回碼信息”3.2分公司向總公司提供開票信息（文件）1、作用

24、：分公司日常業務中，發生業務數據，銷售單或退貨單，每天下班后，定時將業務開票數據傳送到總公司，由總公司進行業務數據入庫。2、命名規范：YYYYMMDD-KPXX-批次號.xml3、文件格式：“交易名稱” -開票信息傳輸交易“交易類型” -80“交易驗證信息”-開票信息傳輸交易 -開票信息，多條“票據種類編碼” -（3位）“票據號碼” -（10位）“分公司編碼” -（6位）“所屬區域碼” -（6位）“開票日期” -格式為（YYYY-MM-DD）“票據開具狀態” -(1位：1正常，2錯票，3廢票)“客戶全稱” -（最大60字節）“票據合計金額” -NUMBER(16,4)“收款方式” -（1位：0現金，1轉支）“開票員用戶編碼” -（最大20位）“開票員用戶名稱” -（最大30字節）“備注” -票面明細，多條“產品編碼” -（最大20位）“單位” -（最大20位）“單價” -NUMBER(16,4)“數量” -NUMBER(16,4)“金額” -NUMBER