福建省社會保障金融卡醫(yī)院小額支付結(jié)算接口說明

1、.福建省社會保證金融卡醫(yī)院就診小額支付結(jié)算 SUBJECT * MERGEFORMAT 接口規(guī)范PAGE ：.；PAGE 29福建省社會保證金融IC卡醫(yī)院就診小額支付結(jié)算接口規(guī)范 中國銀聯(lián)股份福建分公司二一年五月十二日版本控制信息版本日期擬稿和修正闡明1.02021.05.12中國銀聯(lián)福建分公司初稿2021.5.21中國銀聯(lián)福建分公司根據(jù)和醫(yī)院溝通修正2021.5.24中國銀聯(lián)福建分公司完善參數(shù)描畫，合并代付文件格式目 錄 TOC o 1-3 h z HYPERLINK l _Toc262580216 1引言 PAGEREF _Toc262580216 h 4 HYPERLINK l _Toc

2、262580217 2接口函數(shù)定義 PAGEREF _Toc262580217 h 4 HYPERLINK l _Toc262580218 2.1卡片信息查詢接口 PAGEREF _Toc262580218 h 4 HYPERLINK l _Toc262580219 2.2脫機消費接口 PAGEREF _Toc262580219 h 5 HYPERLINK l _Toc262580220 ucTransAttachment格式 PAGEREF _Toc262580220 h 6 HYPERLINK l _Toc262580221 2.3 卡片買賣明細查詢接口 PAGEREF _Toc26258

3、0221 h 7 HYPERLINK l _Toc262580222 3.買賣明細的清算 PAGEREF _Toc262580222 h 8 HYPERLINK l _Toc262580223 31 IC卡脫機消費批扣文件接口 PAGEREF _Toc262580223 h 8 HYPERLINK l _Toc262580224 311文件功能 PAGEREF _Toc262580224 h 8 HYPERLINK l _Toc262580225 3.1.2.命名規(guī)那么及買賣類型 PAGEREF _Toc262580225 h 8 HYPERLINK l _Toc262580226 313買賣

4、代碼闡明 PAGEREF _Toc262580226 h 8 HYPERLINK l _Toc262580227 31.4 IC卡脫機批扣文件的組成 PAGEREF _Toc262580227 h 9 HYPERLINK l _Toc262580228 31.5根本記錄格式定義 PAGEREF _Toc262580228 h 9 HYPERLINK l _Toc262580229 系統(tǒng)概述 PAGEREF _Toc262580229 h 15 HYPERLINK l _Toc262580230 數(shù)據(jù)傳輸平安 PAGEREF _Toc262580230 h 15 HYPERLINK l _Toc

5、262580231 數(shù)據(jù)接口 PAGEREF _Toc262580231 h 16 HYPERLINK l _Toc262580232 概述 PAGEREF _Toc262580232 h 16 HYPERLINK l _Toc262580233 字段類型定義闡明 PAGEREF _Toc262580233 h 16 HYPERLINK l _Toc262580234 字段類型屬性 PAGEREF _Toc262580234 h 16 HYPERLINK l _Toc262580235 委托批量代收/代付懇求文件 PAGEREF _Toc262580235 h 17 HYPERLINK l _

6、Toc262580236 文件名 PAGEREF _Toc262580236 h 17 HYPERLINK l _Toc262580237 文件格式 PAGEREF _Toc262580237 h 17 HYPERLINK l _Toc262580238 文件記錄格式 PAGEREF _Toc262580238 h 17 HYPERLINK l _Toc262580239 委托代收/代付處置結(jié)果應(yīng)對文件 PAGEREF _Toc262580239 h 20 HYPERLINK l _Toc262580240 文件名 PAGEREF _Toc262580240 h 20 HYPERLINK l

7、_Toc262580241 文件格式 PAGEREF _Toc262580241 h 21 HYPERLINK l _Toc262580242 文件記錄格式 PAGEREF _Toc262580242 h 21 HYPERLINK l _Toc262580243 本卷須知 PAGEREF _Toc262580243 h 24 HYPERLINK l _Toc262580244 傳輸過程中文件的定義 PAGEREF _Toc262580244 h 24 HYPERLINK l _Toc262580245 參與md5校驗的數(shù)據(jù) PAGEREF _Toc262580245 h 24 HYPERLIN

8、K l _Toc262580246 應(yīng)對文件本卷須知 PAGEREF _Toc262580246 h 24 HYPERLINK l _Toc262580247 分配的代碼運用本卷須知 PAGEREF _Toc262580247 h 24 HYPERLINK l _Toc262580248 附表 PAGEREF _Toc262580248 h 24 HYPERLINK l _Toc262580249 行業(yè)單位代碼對照表 PAGEREF _Toc262580249 h 24 HYPERLINK l _Toc262580250 銀行代碼表 PAGEREF _Toc262580250 h 26 HYP

9、ERLINK l _Toc262580251 處置結(jié)果代碼表 PAGEREF _Toc262580251 h 27 HYPERLINK l _Toc262580252 醫(yī)院問題答疑 PAGEREF _Toc262580252 h 28 HYPERLINK l _Toc262580253 代收與代付能否可以在同一個文件中？ PAGEREF _Toc262580253 h 28 HYPERLINK l _Toc262580254 代收代付文件稱號REQCyyyymmdd？ PAGEREF _Toc262580254 h 28 HYPERLINK l _Toc262580255 醫(yī)院行業(yè)單位代碼是什

10、么？ PAGEREF _Toc262580255 h 28 HYPERLINK l _Toc262580256 醫(yī)院代收付工程代碼是什么？ PAGEREF _Toc262580256 h 28 HYPERLINK l _Toc262580257 代收付懇求文件中的用戶號是什么？ PAGEREF _Toc262580257 h 28 HYPERLINK l _Toc262580258 委托代收付提出日期是什么？是文件生成日期或數(shù)據(jù)買賣日期 PAGEREF _Toc262580258 h 28 HYPERLINK l _Toc262580259 為紀錄的MD5校驗值如何生成？用第三方工具？ PAG

11、EREF _Toc262580259 h 28 HYPERLINK l _Toc262580260 代收代付文件生成否如何傳送？ PAGEREF _Toc262580260 h 28 HYPERLINK l _Toc262580261 批量委托關(guān)系建立/撤銷懇求文件含義是什么？ PAGEREF _Toc262580261 h 29 HYPERLINK l _Toc262580262 其他行業(yè)在生成代收代付文件后即已上傳，如何重新生成代收代付文件？規(guī)范中并未有反復(fù)提交的校驗？ PAGEREF _Toc262580262 h 29 HYPERLINK l _Toc262580263 一日內(nèi)能否可以

12、多個上傳文件？ PAGEREF _Toc262580263 h 29 HYPERLINK l _Toc262580264 代收代付金額N12.2轉(zhuǎn)換成字符后能否應(yīng)該為13位？ PAGEREF _Toc262580264 h 29 HYPERLINK l _Toc262580265 代收付系統(tǒng)環(huán)境如何搭建？ PAGEREF _Toc262580265 h 29 HYPERLINK l _Toc262580266 假設(shè)電子錢包買賣勝利，但醫(yī)院系統(tǒng)假設(shè)出現(xiàn)錯誤之類的沒有上送相關(guān)數(shù)據(jù)，銀行能否未來會將買賣取消？醫(yī)院能否需求一代收，一代付上傳買賣？ PAGEREF _Toc262580266 h 29

13、HYPERLINK l _Toc262580267 效力提供商保管信息能否為醫(yī)院保管信息？ PAGEREF _Toc262580267 h 29 HYPERLINK l _Toc262580268 代收代付應(yīng)對處置結(jié)果文件何時返還，何時到達醫(yī)院賬戶？ PAGEREF _Toc262580268 h 291引言本規(guī)范規(guī)定了福建省社會保證金融IC卡在醫(yī)院就診流程中進展小額支付結(jié)算的軟件接口函數(shù)等內(nèi)容，不涉及金融或行業(yè)前置系統(tǒng)、銀聯(lián)前置系統(tǒng)的規(guī)定。本規(guī)范作為和的補充規(guī)范運用，僅適用于福建銀行IC卡試點運用。規(guī)范適用于嵌入到商戶MIS系統(tǒng)，POS終端只擔任脫機買賣處置，而買賣流水日志維護和上送由MIS

14、系統(tǒng)擔任的情況。終端其它硬件、軟件和平安要求應(yīng)按照并經(jīng)過相關(guān)認證、具備相關(guān)資質(zhì)，MIS商戶系統(tǒng)平安要求應(yīng)參照執(zhí)行。2接口函數(shù)定義2.1卡片信息查詢接口函數(shù)原型long YKT_ICGetInfo (unsigned int nInfoType,char *szCardInfo,unsigned long *ulBalance,char *szWarnmsg,char *szErrmsg)功能闡明讀取IC卡上信息內(nèi)容，本函數(shù)包含的卡根本信息查詢、余額查詢等兩個功能。入口nInfoType：信息類型 0 讀卡信息及余額1 只讀卡信息, 2 只讀余額出口szCardInfo：卡信息內(nèi)容當nInfoT

15、ype = 0 或 = 1時，取值如下：偏移地址描畫長度字節(jié)數(shù)據(jù)類型031姓名32AN3233性別2AN3441出生日期8AN4243證件類型2AN4475證件號碼32AN7695銀行卡號20AN96104社?？ㄌ?AN當nInfoType = 2時，此域無意義性別：“01男，“00女證件類型：“00身份證 “01軍官證“02護照“03入境證僅限香港/臺灣居民運用“04暫時身份證 “05其他ulBalance：卡片余額當nInfoType = 1時，此域無意義szWarnmsg:警告信息，非空時應(yīng)顯示szErrmsg:錯誤信息社保卡號從社保運用獲取函數(shù)前往值0表示勝利，非0表示失敗，錯誤信息見

16、szErrmsg參數(shù)。注：數(shù)據(jù)類型AN的含義是字母和數(shù)字。2.2脫機消費接口函數(shù)原型long YKT_ICPurchase (unsigned long ulAmount,char *szTransTime,char *szTransOutInfo,unsigned long *ulTransCounter,unsigned long *ulBalance,char *szName,char szBankCardNo19+1,char *szCertID,char szSecureID9+1, char ucTransAttachment142+1,char *szWarnmsg,char *

17、szErrmsg)功能闡明脫機消費時調(diào)用或運用。入口ulAmount：買賣金額以分為單位szTransTime：買賣日期時間ASCII碼14字節(jié)例如：“20210512133959szWarnmsg:警告信息，非空時應(yīng)顯示szErrmsg:錯誤信息出口szTransOutInfo：買賣輸出信息偏移地址描畫長度字節(jié)數(shù)據(jù)類型019電子錢包帳號前19位20AN2031終端機編號12AN3245買賣日期時間14ANulTransCounter：卡片買賣計數(shù)器ulBalance：買賣后余額 以分為單位szName 姓名，最長32字節(jié)szBankCardNo 電子錢包帳號(不是磁條卡帳號)，定長19字節(jié)，

18、左對齊，缺乏右補空格，此值用來拷貝到脫機批扣文件段0內(nèi)的19位主賬號szCertID 證件號碼，最長32字節(jié)szSecureID 社?？ㄌ枺ㄩL9位，從社保運用獲取ucTransAttachment：買賣附加域，轉(zhuǎn)成ASC字符串，格式見下表 用于上送銀聯(lián)，固定長度 142+1 個字節(jié)szWarnmsg:警告信息，非空時應(yīng)顯示szErrmsg:錯誤信息函數(shù)前往值0表示勝利，非0表示失敗，錯誤信息見szErrmsg參數(shù)。ucTransAttachment格式位置長度格式內(nèi)容域號內(nèi)容I/O闡明020n卡片序列號I/O左對齊，缺乏補空格，第20位補F208an買賣金額I/O用8個可見的十六進制字符09

19、，AF表示；假設(shè)無法填寫用缺省值空格填充282n買賣類型標識I/O取值06表示電子錢包脫機消費3012n終端機編號I/O428an終端買賣序號I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充508n終端買賣日期I/O格式：YYYYMMDD586n終端買賣時間I/O格式：HHMMSS648an買賣驗證代碼(TAC)I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充722an消費密鑰版本號I/O用2個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充742cn消費密鑰索引I/O764an卡片脫機買賣序列號I/O用4個可見的十六進制字符0

20、9，AF表示；假設(shè)無法填寫用缺省值空格填充808an錢包余額I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充8816n發(fā)卡方標識I/O1048an偽隨機數(shù)I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充11230ans保管運用I/O填空格注：買賣金額、買賣類型標識、終端機編號、終端買賣序號、終端買賣日期、終端買賣時間等六個字段按照上述順序參與TAC計算2.3 卡片買賣明細查詢接口函數(shù)原型long YKT_ICTransLog(int nRecNumber,unsigned char *ucTransLog,char *szWarnmsg,ch

21、ar *szErrmsg)功能闡明讀取IC卡上買賣明細。入口nRecNumber買賣記錄明細號，1代表最后一筆買賣，2代表倒數(shù)第二筆買賣，依此類推。在脫機消費函數(shù)無前往情況下，建議調(diào)用本函數(shù)查看最后一筆買賣能否勝利。電子錢包最多保管最后20筆買賣的明細。出口ucTransLog：買賣明細記錄內(nèi)容。其買賣記錄格式為：偏移地址描畫長度字節(jié)數(shù)據(jù)類型0-5卡片買賣序號6AN6-17透支限額12AN18-29買賣金額12AN30-31買賣類型標識2AN32-43終端機編號12AN44-51買賣日期終端8AN52-57買賣時間終端6AN買賣類型標識01 - ED圈存02 - EP圈存04 - ED取款05

22、 - ED消費06 - EP消費其他 - 圈提注：ED電子存折錢包 EPIC卡電子錢包 單條記錄長度為58字節(jié) 卡片買賣序號指電子錢包內(nèi)買賣的流水號 終端機編號指卡具內(nèi)PSAM卡的編號szWarnmsg:警告信息，非空時應(yīng)顯示szErrmsg:錯誤信息函數(shù)前往值0表示勝利，非0表示失敗，錯誤信息見szErrmsg參數(shù)。 闡明： 讀卡器翻開、封鎖以及讀取磁條等接口沿用原來，不再另行定義。3.買賣明細的清算醫(yī)院商戶按相關(guān)規(guī)范的格式將消費明細組成文件，定時上送至指定效力器，銀聯(lián)和發(fā)卡銀行將及時進展資金清算，由收單銀行提供明細文件給醫(yī)院商戶。31 IC卡脫機消費批扣文件接口311文件功能該類文件包括金

23、融IC卡前置系統(tǒng)或其他入網(wǎng)機構(gòu)向POSP提交的IC卡脫機買賣批扣文件。金融IC卡前置系統(tǒng)或其他入網(wǎng)機構(gòu)向POSP傳送IC卡脫機買賣批扣文件后，再由POSP向CUPS提交的IC卡脫機買賣批扣文件用于CUPS對入網(wǎng)機構(gòu)進展清算；CUPS清算后向POSP分發(fā)的IC卡脫機買賣批扣文件用于入網(wǎng)機構(gòu)對賬處置。境內(nèi)IC卡脫機買賣批扣文件由段0、段2構(gòu)成。3.1.2.命名規(guī)那么及買賣類型 文件名字段FILE_NAME可定義為以下五部分：12341819242526方向標志卡分類標志文件分類商戶代碼文件日期批次號/順序號位置闡明取值1方向標志O：表示文件是從終端傳送到POSP2卡買賣分類標志N：境內(nèi)買賣和不帶匯

24、率信息的跨境買賣 F：帶匯率信息的人民幣卡跨境買賣暫不用 O：外卡類包括外卡收單3文件分類F：表示脫機買賣文件。O：其他文件。418商戶代碼15位的商戶代碼，由銀聯(lián)分配1924文件日期YYMMDD2526批次號/順序號00-99例 ONF30835014900008010051201，無文件后綴名313買賣代碼闡明IC卡脫機買賣批扣文件所包含的買賣代碼列表記錄類型代碼(TC)買賣稱號Incoming/Outgoing362脫機消費I/O31.4 IC卡脫機批扣文件的組成IC卡脫機批扣文件是一個順序文件，而順序文件有其特有的組成方式：每個文件中包含一個或多個邏輯買賣，每個邏輯買賣被稱作一條記錄，

25、實踐上這些記錄并不是獨立的行，而是延續(xù)的“流，即記錄與記錄之間無換行符等其它符號。買賣的種類由買賣代碼定義。文件頭記錄000和文件尾記錄001分別位于順序文件的開頭和結(jié)尾。圖示如下：段0 TC000TC 段n段0段n段0 TC段n段0 TC001段n文件頭第一條記錄最后一條記錄文件尾圖 3順序文件構(gòu)造圖31.5根本記錄格式定義31.5.1TC 000315.1.1段0根本文件頭格式表 1段0根本文件頭格式位置長度格式內(nèi)容(O )內(nèi)容(I)闡明03n買賣代碼買賣代碼常量：00034an段位圖段位圖常量：8000711n機構(gòu)代碼機構(gòu)代碼(BIN)常量：“00010000 188an批結(jié)日期本批次結(jié)

26、算日期上送時的日期，格式為YYYYMMDD268anCUPS保管清算日期上送時的日期，格式為YYYYMMDD344an版本標志(TEST/PROD)版本標志只允許填寫TEST或PROD測試版本：TEST消費版本：PROD388an版本號版本號填寫：0000000131.5.2 TC 0013段0根本文件尾格式表 2段0根本文件尾格式位置長度格式內(nèi)容I/O闡明03n買賣代碼常量：00134an段位圖常量：8000710n買賣記錄數(shù)包括買賣代碼000、001在內(nèi)的總記錄數(shù)，數(shù)字前補01716anMAK MAC密鑰，填全0 。3316anMACMAC，填全03153 IC卡脫機批扣文件記錄格式定義.

27、1 TC 36231531.1段0根本清算信息表 5段0根本清算信息位置長度格式內(nèi)容域號內(nèi)容I/O闡明03n買賣代碼I/O362：IC卡脫機消費34an段位圖I/O“C000719n主賬號2I/O即電子錢包的卡號，可由脫機消費函數(shù)輸出參數(shù)獲取，向左對齊，缺乏19位時缺乏部分補空格2612n買賣金額4I/O以分為單位，數(shù)字前補0383an買賣貨幣代碼49I/O指示買賣的幣種，填“1564110n買賣時間7I/O格式為MMDDhhmmss，買賣時間，此域和醫(yī)院流水號組合成獨一主鍵，用于對帳，醫(yī)院系統(tǒng)內(nèi)記錄可保管年份YYYY516n系統(tǒng)跟蹤號11I/O醫(yī)院賦予每筆買賣一個流水號，和上面的買賣時間組合

28、成獨一主鍵，用于對帳576An授權(quán)應(yīng)對標識碼38I/O本處填寫空格634N授權(quán)日期I/O本處填寫空格6712An檢索參考號37I/O添滿空格7911Ans代理機構(gòu)標識碼32I/O常量：“00093900 9011Ans發(fā)送機構(gòu)標識碼33I/O常量：“00093900 1014n商戶類型18I/O受理方商戶類型碼，由銀聯(lián)提供1058ans受卡機終端標識碼41I/O受卡機具的終端標識，由銀聯(lián)提供11315an受卡方標識碼42I/O由POS管理機構(gòu)分配的受卡方機構(gòu)標識代碼，由銀聯(lián)提供12840an受卡方稱號地址43I/O受卡機構(gòu)的稱號和所在地16823an原始買賣信息I/O填全01914n報文緣由代

29、碼I/O以“0000填充1951n單雙信息標志I/O取值“11969nCUPS流水號I填寫“000000000。20511ans接納機構(gòu)代碼100I填滿空格21611ans發(fā)卡機構(gòu)代碼I填滿空格2271nCUPS通知標志I常量：填02282n買賣發(fā)起渠道I/O常量，填 032301a買賣特征標識I/O以空格填充2318anCUPS保管運用I預(yù)保管，全補空格2392nPOS效力點條件代碼25I/O填滿空格24112x+n11本方手續(xù)費I/O填全02531n買賣跨境標志填025415ans保管運用I/O填滿空格術(shù)語解釋：受卡機終端標識碼：由銀聯(lián)分配的8位長終端號。受卡方標識碼：由銀聯(lián)分配的15位長

30、商戶號。31531.2段2IC卡特征信息 該信息由脫機消費函數(shù)的輸出參數(shù)ucTransAttachment給出，整體拷貝過來即可。表 6段2IC卡特征信息位置長度格式內(nèi)容域號內(nèi)容I/O闡明020n卡片序列號I/O208an買賣金額I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充282n買賣類型標識I/O取值06表示電子錢包脫機消費3012n終端機編號I/O428an終端買賣序號I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充508n終端買賣日期I/O格式：YYYYMMDD586n終端買賣時間I/O格式：HHMMSS648an買賣驗證代碼(TA

31、C)I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充722an消費密鑰版本號I/O用2個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充742cn消費密鑰索引I/O764an卡片脫機買賣序列號I/O用4個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充808an錢包余額I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充8816n發(fā)卡方標識I/O1048an偽隨機數(shù)I/O用8個可見的十六進制字符09，AF表示；假設(shè)無法填寫用缺省值空格填充11230ans保管運用I/O注：買賣金額、買賣類型標識、終端機編號、終端買賣序號

32、、終端買賣日期、終端買賣時間等六個字段按照上述順序參與TAC計算3.1.6文件傳送效力器銀聯(lián)接納脫機批扣文件的效力器開放FTP效力給醫(yī)院，每個醫(yī)院由銀聯(lián)分配單獨的用戶和密碼可登錄到本人的目錄下上傳文件。FTP登錄勝利后，進入batchdeduct目錄存放脫機批扣文件。文件必需在當晚20:30分前上送到銀聯(lián)效力器，那么銀聯(lián)將在第二天清算當日所上傳的文件；20:30分以后的買賣并入第二天上送的文件清算，每天可多次上送文件。銀聯(lián)測試FTP效力器地址：1，用戶名/密碼：test/test，消費FTP效力器地址：9，用戶名另行單獨通知。該效力器同時接納批量代付文件，F(xiàn)TP登錄勝利后，進入batchpay

33、目錄存放代付文件，另醫(yī)院方也需開放FTP效力器給銀行用于接納對賬明細文件。目錄構(gòu)造用戶主目錄$HOME/batchpay 存放代付文件用戶主目錄$HOME/batchdeduct 存放脫機批扣文件4、退款代付文件接口 醫(yī)院選擇非現(xiàn)金退費時，采用每日生成下述代付文件發(fā)給銀聯(lián)，銀聯(lián)處置后轉(zhuǎn)發(fā)給銀行進展代付費處置。中國銀聯(lián)福建分公司批量代收代付技術(shù)規(guī)范文檔稱號：工程稱號：中國銀聯(lián)福建分公司批量代收代付技術(shù)規(guī)范當前版本號： FORMTEXT 1. FORMTEXT 0創(chuàng)建者：福建分公司技術(shù)部：汪治國創(chuàng)建日期：2021-07-28復(fù)核者：復(fù)核日期：審批者：審批日期：版本號修正內(nèi)容撰寫者發(fā)布日期1.0創(chuàng)建

34、汪治國2021-07-281.11、修正代收和代付工程的位數(shù)為3位2、添加md5算法的術(shù)語解釋3、修正文檔中不同角色方的用語4、修正各章節(jié)中提到的文件格式，進展細化5、對附表中的處置結(jié)果代碼表進展精簡剔除用不上的汪治國2021-08-181.2修正了對數(shù)值型的錯誤描畫汪治國2021-10-111.3修正了對金額域描畫錯誤汪治國2021-12-31.41、添加了賬戶類型字段存折、銀行卡等2、添加了本卷須知章節(jié)4，目前描畫了傳輸過程中文件和最終文件的命名方式和md5的校驗內(nèi)容須留意的汪治國2021-02-161.5在綁定關(guān)系的建立和撤銷中添加了回答截止日期字段汪治國2021-03-121.6在第4

35、章節(jié)添加了應(yīng)對文件的本卷須知汪治國2021-03-231.7精簡并更新應(yīng)對碼部分汪治國2021-04-271.8行業(yè)接口的文件名升位為24位，根據(jù)調(diào)試中發(fā)現(xiàn)的常見問題更新本卷須知汪治國2021-09-281.9醫(yī)院問題答疑汪治國2021-05-24版權(quán)聲明：此文檔的版權(quán)歸中國銀聯(lián)福建分公司一切，作為本系統(tǒng)的最終用戶，可以擁有該份文檔的運用權(quán)，但未征得中國銀聯(lián)福建分公司的書面同意，不得向第三方借閱、出讓、出版該文檔。 TOC o 1-3 h z u HYPERLINK l _Toc205034086 1.系統(tǒng)概述 PAGEREF _Toc205034086 h 3 HYPERLINK l _To

36、c205034087 2.數(shù)據(jù)傳輸平安 PAGEREF _Toc205034087 h 4 HYPERLINK l _Toc205034088 3.數(shù)據(jù)接口 PAGEREF _Toc205034088 h 4 HYPERLINK l _Toc205034089 3.1概述 PAGEREF _Toc205034089 h 4 HYPERLINK l _Toc205034090 3.2字段類型定義闡明 PAGEREF _Toc205034090 h 4 HYPERLINK l _Toc205034091 3.2.1字段類型屬性 PAGEREF _Toc205034091 h 4 HYPERLINK

37、 l _Toc205034092 3.3委托批量代收/代付懇求文件 PAGEREF _Toc205034092 h 5 HYPERLINK l _Toc205034093 3.3.1文件名 PAGEREF _Toc205034093 h 5 HYPERLINK l _Toc205034094 3.3.2文件格式 PAGEREF _Toc205034094 h 5 HYPERLINK l _Toc205034095 3.3.3文件記錄格式 PAGEREF _Toc205034095 h 5 HYPERLINK l _Toc205034096 3.4委托代收/代付處置結(jié)果應(yīng)對文件 PAGEREF

38、_Toc205034096 h 8 HYPERLINK l _Toc205034097 3.4.1文件名 PAGEREF _Toc205034097 h 8 HYPERLINK l _Toc205034098 3.4.2文件格式 PAGEREF _Toc205034098 h 8 HYPERLINK l _Toc205034099 3.4.3文件記錄格式 PAGEREF _Toc205034099 h 8 HYPERLINK l _Toc205034108 4.附表 PAGEREF _Toc205034108 h 16 HYPERLINK l _Toc205034109 4.1行業(yè)單位代碼對照

39、表 PAGEREF _Toc205034109 h 16 HYPERLINK l _Toc205034110 4.2銀行代碼表 PAGEREF _Toc205034110 h 17 HYPERLINK l _Toc205034111 4.3處置結(jié)果代碼表 PAGEREF _Toc205034111 h 18系統(tǒng)概述本規(guī)范描畫了效力提供商、銀聯(lián)、委托銀行之間的批量文件處置買賣的通訊方法、數(shù)據(jù)接口等，設(shè)計原那么是充分利用現(xiàn)有的福建省銀行卡代收代付網(wǎng)絡(luò)，以最省的投資實現(xiàn)最稱心的效果。文件批量處置買賣的業(yè)務(wù)有其特殊性。它主要包括批量代收、批量代付以及批量委托關(guān)系建立/撤銷這三種批量文件格式，對應(yīng)三種不

40、同的業(yè)務(wù)。本文描畫了這三種業(yè)務(wù)功能的相關(guān)技術(shù)接口規(guī)范。數(shù)據(jù)傳輸平安為了保證數(shù)據(jù)傳輸?shù)钠桨残?，各方在文件傳輸中均運用MD5的加密算法，作為保證文件傳輸?shù)钠桨残?。需傳輸?shù)奈募A(yù)先根據(jù)文件的內(nèi)容按照MD5算法，計算得出最終的結(jié)果值，作為校驗值填寫在文件內(nèi)容的最后一行。同時該校驗值以專人、專門的郵箱進展發(fā)送給銀聯(lián)的制定郵箱，這樣保證校驗值分2個不同的途徑進展傳輸需傳輸?shù)奈募写嬖谛ｒ炛到?jīng)過專線傳輸和校驗值經(jīng)過電子郵箱進展傳輸，降低傳輸?shù)奈募淮鄹牡娘L(fēng)險。MD5的全稱是Message-Digest Algorithm 5信息-摘要算法，在90年代初由MIT Laboratory for Computer

41、 Science和RSA Data Security Inc的Ronald L. Rivest開發(fā)出來，經(jīng)MD2、MD3和MD4開展而來。它的作用是讓大容量信息在用數(shù)字簽名軟件簽署私人密匙前被緊縮成一種嚴密的格式就是把一個恣意長度的字節(jié)串變換成一定長的大整數(shù)。數(shù)據(jù)接口概述效力提供商、銀行與銀聯(lián)之間采用文件方式進展數(shù)據(jù)交換，文件為文本文件(ASCII)，一條記錄占一行，每一行都以回車換行符0D 0A終了。記錄中的字段均采用定長方式，并且字段與字段之間運用制表符09進展隔符。文件有：批量代收/代付懇求文件批量代收/代付處置結(jié)果應(yīng)對文件批量委托關(guān)系建立/撤銷懇求文件批量委托關(guān)系建立/撤銷應(yīng)對文件字段

42、類型定義闡明字段類型采用屬性后加上長度的方法來描畫。下表定義這些屬性的含義：字段類型屬性表示含義C允許字母和數(shù)字字符N僅含數(shù)字字符(0,1,2,3,4,5,6,7,8,9)U允許字母、數(shù)字字符和特殊字符數(shù)據(jù)表示方法一切數(shù)據(jù)字段均采用字節(jié)邊境對位。一切數(shù)據(jù)按ASCII顯示格式表示。數(shù)據(jù)中給出的一切長度均表示需求的字節(jié)數(shù)。一切類型為N的數(shù)字字段均采用右對齊，數(shù)字為正時,前面空位補零；數(shù)字為負時,左邊第一位為符號,其他空位補零。例如：假設(shè)數(shù)字字段長度為10位(N10),那么12345表示為 0000012345 ，-12345 表示為 -000012345格式Nn.d表示該字段長度為n，小數(shù)點位數(shù)為

43、d，小數(shù)點不包含在數(shù)據(jù)中。例如，一字段格式為N8.3，值為123.456，那么表示為00123.456。除數(shù)字字段外，一切其它類型的字段，假設(shè)為固定長度，那么采用左對齊，其后空位以空格填充。當某字段表示日期且長度為8時，那么該字段的格式為YYYYMMDD，例如，19970908表示1997年9月8日委托批量代收/代付懇求文件委托代收/代付懇求文件用于提交用戶的委托代收/代付懇求信息。文件為文本文件格式，一條記錄占一行，第一條記錄為總計記錄，后跟代收/代付懇求記錄，最后為校驗尾文件。其中，總計記錄和尾記錄是必需提供的，其他記錄那么是可選的。既使當日無任何代收/代付，文件仍要求產(chǎn)生(文件僅有一條總

44、計記錄和一條尾記錄)。文件名REQCyyyymmddXXXXXXXX.txt委托批量代收REQDyyyymmddXXXXXXXX.txt委托批量代付文件格式委托批量代收懇求文件格式總計記錄委托批量代收懇求記錄. 尾記錄委托批量代付懇求文件格式總計記錄委托批量代付懇求記錄. 尾記錄文件記錄格式總計記錄格式總計記錄必需為委托代收/代付懇求文件的第一條記錄。編號字段名類型闡明1文件名C24REQCyyyymmddXXXXXXXX.txt或REQDyyyymmddXXXXXXXX.txt2產(chǎn)生文件的行業(yè)單位代碼C10請查看行業(yè)單位代碼對照表3委托代收/代付總計筆數(shù)N10委托代收/代付懇求記錄筆數(shù)的合計

45、4委托代收/代付總計金額N16.2委托代收/代付金額的合計委托代收懇求記錄格式一條委托代收懇求記錄對應(yīng)于一個用戶號的一條委托代收記錄，不同的時間、不同的行業(yè)單位代碼、不同的代收工程、不同的用戶號對應(yīng)不同的委托代收懇求記錄。編號字段名類型闡明1行業(yè)單位代碼C10請查看行業(yè)單位代碼對照表2代收工程C3各代收工程見附錄(該字段和效力提供商的資金清算賬戶有關(guān))3用戶號C224委托代收提出日期N8YYYYMMDD5系統(tǒng)流水號N12由銀聯(lián)產(chǎn)生，3方查找買賣的關(guān)鍵值6代收資金商戶號N15行業(yè)單位懇求時該字段為空，本字段由銀聯(lián)填寫7代收資金結(jié)算帳戶C40行業(yè)單位懇求時該字段為空，本字段由銀聯(lián)填寫8用戶姓名C2

46、09銀行代號N10各銀行代號見附錄。10銀行帳號類型C201 銀行卡02 存折99 其他11銀行帳號C28銀聯(lián)根據(jù)帳號檢索卡表，判別發(fā)卡行，假設(shè)能得到發(fā)卡行，那么以為是卡號，否那么以為是帳號，缺乏右補空格。12證件類型C201身份證02護照03軍官證04回鄉(xiāng)證05臺胞證06警官證07士兵證08戶口簿99其他13證件標識號C2014委托代收金額N12.215回答截止日期N8行業(yè)端提出的懇求文件無該字段補空，銀聯(lián)提交銀行端的懇求文件必需有該字段。銀行應(yīng)在此日期含之前將處置結(jié)果前往給銀聯(lián)，否那么，銀聯(lián)將直接回絕該懇求記錄。16處置結(jié)果代碼N2行業(yè)端提出的懇求文件無該字段補空，銀聯(lián)提交銀行端的懇求文件

47、中該字段內(nèi)容默以為00。17效力提供商保管信息C30用于存放效力提供商要求的特殊信息，銀聯(lián)及銀行不作處置，但要求在委托代收處置結(jié)果記錄中原樣前往委托代付懇求記錄格式一條委托代付懇求記錄對應(yīng)于一個用戶號的一條委托代付記錄，不同的時間、不同的行業(yè)單位代碼、不同的代付工程、不同的用戶號對應(yīng)不同的委托代付懇求記錄。編號字段名類型闡明1行業(yè)單位代碼C10請查看行業(yè)單位代碼對照表2代付工程C3各代付工程見附錄(該字段和效力提供商的資金清算賬戶有關(guān))3用戶號C224委托代付提出日期N8YYYYMMDD5系統(tǒng)流水號N12由銀聯(lián)產(chǎn)生，3方查找買賣的關(guān)鍵值6代付資金商戶號N15行業(yè)單位懇求時該字段為空，本字段由銀

48、聯(lián)填寫7代付資金結(jié)算帳戶C40行業(yè)單位懇求時該字段為空，本字段由銀聯(lián)填寫8用戶姓名C209銀行代號N10各銀行代號見附錄。10銀行帳號類型C201 銀行卡02 存折99 其他11銀行帳號C2812證件類型C201身份證02護照03軍官證04回鄉(xiāng)證05臺胞證06警官證07士兵證08戶口簿99其他醫(yī)院請選擇該項13證件標識號C2014委付代收金額N12.215回答截止日期N8行業(yè)端提出的懇求文件無該字段補空，銀聯(lián)提交銀行端的懇求文件必需有該字段。5銀行應(yīng)在此日期含之前將處置結(jié)果前往給銀聯(lián)，否那么，銀聯(lián)將直接回絕該懇求記錄。16處置結(jié)果代碼N2行業(yè)端提出的懇求文件無該字段補空，銀聯(lián)提交銀行端的懇求文

49、件中該字段內(nèi)容默以為00。17效力提供商保管信息C30用于存放效力提供商要求的特殊信息，銀聯(lián)及銀行不作處置，但要求在委拜托收處置結(jié)果記錄中原樣前往尾記錄格式該記錄為1行，內(nèi)容為MD5的校驗值編號字段名類型闡明1MD5校驗值C32本行不參與MD5計算文件內(nèi)容刪除該行，計算MD5值委托代收/代付處置結(jié)果應(yīng)對文件委托代收/代付處置結(jié)果回答文件用于提交已處置的代收/代付信息。文件為文本文件格式，一條記錄占一行，第一條記錄為總計記錄，后跟委托代收/代付處置結(jié)果記錄，最后為校驗尾文件。其中，總計記錄和尾文件是必需提供的，其他記錄那么是可選的。既使當日無任何已處置的委托代收/代付信息，文件仍要求產(chǎn)生(文件僅

50、有一條總計記錄和一條尾記錄)。文件名REPCyyyymmddXXXXXXXX.txt委托批量代收REPDyyyymmddXXXXXXXX.txt委托批量代付文件格式委托批量代收處置結(jié)果應(yīng)對文件格式總計記錄委托代收處置結(jié)果記錄尾記錄委托批量代付處置結(jié)果應(yīng)對文件格式總計記錄委托代付處置結(jié)果記錄尾記錄文件記錄格式總計記錄格式總計記錄必需為委托代收/代付處置結(jié)果回答文件的第一條記錄。編號字段名類型闡明1文件名C24REPCyyyymmddXXXXXXXX.txt或REPDyyyymmddXXXXXXXX.txt2產(chǎn)生文件的行業(yè)單位代碼C10請查看行業(yè)單位代碼對照表3委托代收/代付總計筆數(shù)N10委托代收

51、/代付懇求記錄勝利記錄的筆數(shù)合計4委托代收/代付總計金額N16.2委托代收/代付勝利記錄金額的合計委托代收處置結(jié)果記錄格式編號字段名類型闡明1行業(yè)單位代碼C10和懇求內(nèi)容一致2代收工程C3和懇求內(nèi)容一致3用戶號C22和懇求內(nèi)容一致4委托代收提出日期N8和懇求內(nèi)容一致5系統(tǒng)流水號N12和懇求內(nèi)容一致6代收資金商戶號N15和懇求內(nèi)容一致7代收資金結(jié)算帳戶C40和懇求內(nèi)容一致8用戶姓名C20和懇求內(nèi)容一致9銀行代號N10和懇求內(nèi)容一致10銀行帳號類型C2和懇求內(nèi)容一致11銀行帳號C28和懇求內(nèi)容一致12證件類型C2和懇求內(nèi)容一致13證件標識號C20和懇求內(nèi)容一致14委托代收金額N12.2和懇求內(nèi)容一

52、致15回答截止日期N8銀行端前往的回答文件必需有該字段，銀聯(lián)提交行業(yè)端的回答文件無該字段。銀行應(yīng)在此日期含之前將處置結(jié)果前往給銀聯(lián)，否那么，銀聯(lián)將直接回絕該懇求記錄。16處置結(jié)果代碼N2運用附錄中的處置結(jié)果代碼表例如：00買賣勝利14-無此卡號/存折帳號30-記錄格式錯41-喪失卡43-被盜卡45補登折數(shù)已滿51余額缺乏94反復(fù)買賣17效力提供商保管信息C30用于存放效力提供商要求的特殊信息，銀聯(lián)及銀行不作處置，但要求在委托代收處置結(jié)果記錄中原樣前往委托代付處置結(jié)果記錄格式編號字段名類型闡明1行業(yè)單位代碼C10和懇求內(nèi)容一致2代付工程C3和懇求內(nèi)容一致3用戶號C22和懇求內(nèi)容一致4委托代付提出

53、日期N8和懇求內(nèi)容一致5系統(tǒng)流水號N12和懇求內(nèi)容一致6代付資金商戶號N15和懇求內(nèi)容一致7代付資金結(jié)算帳戶C40和懇求內(nèi)容一致8用戶姓名C20和懇求內(nèi)容一致9銀行代號N10和懇求內(nèi)容一致10銀行帳號類型C2和懇求內(nèi)容一致11銀行帳號C28和懇求內(nèi)容一致12證件類型C2和懇求內(nèi)容一致13證件標識號C20和懇求內(nèi)容一致14委托代付金額N12.2和懇求內(nèi)容一致15回答截止日期N8銀行端前往的回答文件必需有該字段，銀聯(lián)提交行業(yè)端的回答文件無該字段。銀行應(yīng)在此日期含之前將處置結(jié)果前往給銀聯(lián)，否那么，銀聯(lián)將直接回絕該懇求記錄。16處置結(jié)果代碼N2運用附錄中的處置結(jié)果代碼表例如：00買賣勝利14-無此卡號

54、/存折帳號30-記錄格式錯41-喪失卡43-被盜卡45補登折數(shù)已滿51余額缺乏94反復(fù)買賣17效力提供商保管信息C30用于存放效力提供商要求的特殊信息，銀聯(lián)及銀行不作處置，但要求在委托代付處置結(jié)果記錄中原樣前往尾記錄格式該記錄為1行，內(nèi)容為MD5的校驗值編號字段名類型闡明1MD5校驗值C32本行不參與MD5計算文件內(nèi)容刪除該行，計算MD5值本卷須知傳輸過程中文件的定義假設(shè)文件正在傳輸過程時，請運用后綴名為tmp的命名，例如：在ftp的傳輸過程中運用REQC20210101.tmp這時系統(tǒng)假設(shè)讀取文件名時，發(fā)現(xiàn)后綴名為tmp，文件還在傳輸過程中不完好，不提取文件，傳輸終了后把文件重新命名為REQ

55、Cyyyymmdd.txt。這時系統(tǒng)假設(shè)讀取文件名時，發(fā)現(xiàn)后綴為txt，闡明文件是完好，可以提取處置。參與md5校驗的數(shù)據(jù) 文件中的md5值，是根據(jù)文件內(nèi)容剔除最后一行尾記錄，進展計算的。由于行與行之間運用的回車換行符0D 0A，剔出md5行記錄后，文件的最后字符應(yīng)為回車換行符。應(yīng)對文件本卷須知 假設(shè)是應(yīng)對文件，其中頭文件的記錄條數(shù)應(yīng)為勝利總條數(shù)，金額應(yīng)為勝利買賣的累積金額；應(yīng)對文件的記錄條數(shù)、各條記錄的金額應(yīng)和懇求文件的數(shù)目一致即懇求和應(yīng)對條數(shù)一致。分配的代碼運用本卷須知 請嚴厲按照銀聯(lián)分配的單位代碼和代收付工程代碼，生成對應(yīng)的懇求文件。由于單位代碼和代收付工程是和文件名進展捆綁的，假設(shè)不按

56、照要求添加將出現(xiàn)資金異常。附表行業(yè)單位代碼對照表序號行業(yè)單位稱號行業(yè)單位代碼業(yè)務(wù)代碼行政區(qū)劃代碼業(yè)內(nèi)細分備注1中國銀聯(lián)福建分公司0135000000主要為開展聯(lián)網(wǎng)結(jié)合宣傳促銷活動持卡人獎金等的入賬處置。2保險公司02按照保險公司所轄范圍確定。根據(jù)保險公司接入銀聯(lián)平臺先后順序01-99如：太平人壽為01福建國壽為02，以此類推保險金代扣、分紅、理賠等業(yè)務(wù)3挪動公司03按照挪動公司所轄范圍確定。如省挪動為35000000通訊費扣收包括滯納金4電信公司04按照電信公司所轄范圍確定。如省電信為35000000通訊費扣收包括滯納金5稅務(wù)05按照稅務(wù)所轄范圍確定。如省地稅為350000按照國地稅稅接入的先后順序分配，國稅為01地稅為02納稅人應(yīng)繳稅款費的扣收。6自來水公司06按照自來水公司所轄范圍確定。根據(jù)自來水公司接入銀聯(lián)平臺先后順序00-99水費計收包括滯納金7電力公司07按照自來水公司所轄范圍確定。根據(jù)自來水公司接入銀聯(lián)平臺先后順序00-