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