成都市基本醫(yī)療保險(xiǎn)
支付接口應(yīng)用編程規(guī)范
Version 4.0
銀海軟件
2010年06月
1、 變更說明
§1.1.
2、 概述
《成都市基本醫(yī)療保險(xiǎn)支付接口應(yīng)用編程規(guī)范（Version 4.0）》（以下簡稱規(guī)范）的使用對(duì)象為將使用銀海醫(yī)保支付組件庫（以下簡稱組件庫）來完成醫(yī)保支付的為定點(diǎn)醫(yī)療機(jī)構(gòu)提供應(yīng)用軟件的HIS供應(yīng)商、藥店MIS供應(yīng)商或其它第三方應(yīng)用軟件供應(yīng)商。
規(guī)范公布了組件庫所提供的交易，規(guī)定了調(diào)用每一交易的前提條件，詳細(xì)描述了每一交易的調(diào)用方法。規(guī)范從編程的角度來介紹以上內(nèi)容，對(duì)醫(yī)保政策和醫(yī)保支付流程的介紹不屬于本規(guī)范的范圍。
§1.2. 術(shù)語及參考資料
COM： Common Object Model
HIS：Hospital Information System
MIS：Management Information System
§1.3. 應(yīng)用模式
銀海醫(yī)保支付組件庫是一組運(yùn)行在WINDOWS 32位環(huán)境下的COM組件，第三方應(yīng)用軟件使用相應(yīng)的COM組件調(diào)用方式來調(diào)用它。
§1.4. 環(huán)境要求
§1.4.1. 硬件環(huán)境
指標(biāo) 指標(biāo)值
CPU ≧1.6MHz
Memory ≧256MB
HardDisk ≧100M(free)
NetCard ≧10MB
§1.4.2. 網(wǎng)絡(luò)環(huán)境
指標(biāo) 指標(biāo)值
協(xié)議 TCP/IP、HTTP/HTTPS
廣域網(wǎng)帶寬 ≧56k
網(wǎng)絡(luò)連接 客戶端直接訪問醫(yī)保中心網(wǎng)絡(luò)
§1.4.3. 系統(tǒng)軟件
指標(biāo) 指標(biāo)值
操作系統(tǒng) WIN98 SE或WIN 2000及以上WIN系列操作系統(tǒng)
輔助軟件 IE6.0
Msxml4.0
§2. 接口描述
§2.1. 總體描述
組件庫注冊(cè)在每一臺(tái)需要進(jìn)行醫(yī)保支付業(yè)務(wù)的客戶機(jī)上（該客戶端也必須能連接到醫(yī)保網(wǎng)絡(luò)），通過被動(dòng)調(diào)用的方式將醫(yī)保支付業(yè)務(wù)功能嵌入到定點(diǎn)醫(yī)療機(jī)構(gòu)的系統(tǒng)中（以下簡稱HIS）；
接口交易組件庫提供了六個(gè)公共方法(yh_interface_init 初始化，yh_interface_destroy 資源釋放，yh_interface_call業(yè)務(wù)方法調(diào)用，yh_interface_confirm業(yè)務(wù)辦理確認(rèn)，yh_interface_cancel業(yè)務(wù)辦理取消，yh_interface_getuncertaintytrade不確定交易查詢)，交易參數(shù)組織采用xml（所有社保經(jīng)辦機(jī)構(gòu)交易調(diào)用及交易參數(shù)統(tǒng)一），差別處理對(duì)于HIS透明。
新接口存在多社保經(jīng)辦機(jī)構(gòu)處理，并且各社保經(jīng)辦機(jī)構(gòu)處理模式存在差異，接口交易內(nèi)部也可能存在用戶交互窗口，因此建議HIS事務(wù)管理與接口交易調(diào)用相互獨(dú)立。
§2.2. 接口COM說明
組件庫提供交易的COM組件屬性如下：
屬性 值
App ID {5767E3DB-64CF-46B0-8997-04CC6506CA37}
Type Library ID {A6C75A98-FC7F-456A-9E2D-4141CC758C63}
Program ID YinHai.ChenDu.Interface
COM ClassName CoClass_n_yh_interface
COM ClassID {1FB2A005-1AAF-42BD-A95E-AED025ABD75B}
Interface Type Dual Interface
Interface Name In_yh_interface
Interface ID {BC708B00-5ED0-4DC7-8345-14FA94D5F840}
§2.3. 交易接口函數(shù)描述
yh_interface_init
原型定義：
yh_interface_init(
ref long aint_appcode,
ref string astr_appmsg)
yh_interface_init2
yh_interface_init2(string astr_parmxml,
ref long aint_appcode,
ref string astr_appmsg)
astr_parmxml：
< asy>1 1:表示異步執(zhí)行確認(rèn)或取消 0：表示同步執(zhí)行
astr_parmxml:
函數(shù)說明：
初始化函數(shù)，HIS應(yīng)用啟動(dòng)時(shí)調(diào)用，進(jìn)行醫(yī)保交易處理初始化，本交易調(diào)用成功后才能進(jìn)行其他交易處理。
yh_interface_destroy
原型定義：
yh_interface_destroy()
函數(shù)說明：
資源釋放函數(shù)，在HIS應(yīng)用退出時(shí)調(diào)用。
yh_interface_call
原型定義：
yh_interface_call(
string astr_jybh,
string astr_jykz_xml,
string astr_jysr_xml,
ref string astr_pcbh,
ref string astr_jylsh,
ref string astr_jyyzm,
ref string astr_jysc_xml,
ref long aint_appcode,
ref string astr_appmsg)
參數(shù)名稱 參數(shù)含義 參數(shù)類型 參數(shù)類別 參數(shù)說明
astr_jybh 交易編號(hào) String 入口參數(shù) 具體的交易代碼見〖交易列表〗
astr_jykz_xml 交易控制 String 入口參數(shù) xml方式，組織方式見業(yè)務(wù)說明
astr_jysr_xml 交易輸入 String 入口參數(shù) xml方式，組織方式見業(yè)務(wù)說明
astr_pcbh 批次編號(hào) String 出口參數(shù) 與簽到交易中返回的值相同，用于標(biāo)識(shí)簽到與支付數(shù)據(jù)的相關(guān)性
astr_jylsh 交易流水號(hào) String 出口參數(shù) 唯一標(biāo)識(shí)一次交易，VARCHAR(20)
astr_jyyzm 交易驗(yàn)證碼 String 出口參數(shù) 處理類交易返回，確認(rèn)交易時(shí)傳入
VARCHAR(15)
astr_jysc_xml 交易輸出 String 出口參數(shù) xml方式，組織方式見業(yè)務(wù)說明
aint_appcode 交易標(biāo)志 long 出口參數(shù) 小于0均為失敗。此值數(shù)據(jù)類型是整數(shù)，范圍為-2147483648 to +2147483647
astr_appmsg 交易信息 String 出口參數(shù) 錯(cuò)誤信息描述。aint_appcode小于0時(shí)存放錯(cuò)誤描述，其他aint_appcode不用關(guān)心該參數(shù)內(nèi)容。
函數(shù)說明：
交易主函數(shù)，完成所有醫(yī)療業(yè)務(wù)的實(shí)際處理。
由于交易調(diào)用遠(yuǎn)程方法，并且可能存在用戶交互界面，因此建議所有交易不要納入HIS系統(tǒng)事務(wù)管理。
在交易接口函數(shù)定義中，傳遞的參數(shù)都是字符串。但是在交易詳細(xì)說明中，數(shù)據(jù)類型都是邏輯類型，常用類型有三種：string,number,datetime，下面的表格描述了交易接口進(jìn)行類型轉(zhuǎn)換的限制和說明。
數(shù)據(jù)類型 空字符串 格式不合法 其它說明
string 視同空串 無 無特別說明標(biāo)注的長度為最大長度
number 視同0 返回錯(cuò)誤 無特別說明標(biāo)注的長度為最大長度（小數(shù)尾數(shù)同）
datetime 視同空值 返回錯(cuò)誤 足19位長，格式如下：
YYYY-MM-DD hh24:mm:ss
date 視同空值 返回錯(cuò)誤 足19位長，格式如下：
YYYY-MM-DD 00:00:00
astr_jykz_xml、astr_jysr_xml、astr_jysc_xml參數(shù)均按照交易詳細(xì)說明里xml參數(shù)組合，順序無關(guān)。接口調(diào)用示例：
VB調(diào)用
|
|
資源大小：145.70 KB 
