定點醫(yī)療機構(gòu)API開發(fā)手冊.doc

文檔編號：DX12L002 分冊名稱：定點醫(yī)療機構(gòu)API開發(fā)手冊 第2.0 版定點醫(yī)療機構(gòu)API開發(fā)手冊河北東軟軟件有限公司2014年1月1日版權(quán)聲明定點醫(yī)療機構(gòu)API開發(fā)手冊的版權(quán)歸河北東軟軟件有限公司所有。未經(jīng)河北東軟軟件有限公司的書面準許，不得將本規(guī)范的任何內(nèi)容以任何形式、任何手段（電子的或機械的，包括照相復制或錄制）、或為任何目的，進行復制或擴散。版權(quán)所有，翻制必究。Copyright2014 河北東軟軟件有限公司。精品文檔交流文檔修改歷史版本修改記錄修改日期修改人0.5增加開發(fā)險種范圍、安全機制、將HIS流程說明放到前面，常用API接口函數(shù)介紹2010-7-15薛亞玲0.6增加和修改文檔中的部分說明2010-7-21陳曉明0.61Comminterface醫(yī)療類型入?yún)⒃黾俞t(yī)療類別。調(diào)整API常見流程介紹2010-7-23薛亞玲0.62接口表KC22主鍵去掉AAE0402010-7-26薛亞玲0.63預結(jié)算、結(jié)算去掉支付方式、經(jīng)辦人、賬戶支付金額；讀人員審批信息去掉審批類別2010-8-10薛亞玲0.64將讀卡、讀取封鎖、讀取審批合并；將讀藥品、讀診療對照信息合并；去掉疾病和批量讀取收費項目對照信息。2010-8-12薛亞玲0.65接口表KC22，增加每次用量單位AKA076,KC21增加患者聯(lián)系電話PHONE2010-8-17薛亞玲0.66讀卡身份驗證，增加兩個返回值：結(jié)算年月，定點醫(yī)療機構(gòu)編號。2010-8-20武剛0.67修改xml字符串格式為小寫2010-8-26陳曉明0.68修改門診預結(jié)算和住院預結(jié)算出參2010-9-6陳曉明0.69修改kc22表結(jié)構(gòu)，去掉aae040,zka101,aae073,ckc048,ckc1252010-9-13武剛0.70修改xml字符串示例，使之與kc22表結(jié)構(gòu)一致2010-9-13武剛0.71調(diào)整kc21表結(jié)構(gòu)2010-9-13武剛0.81讀卡身份驗證增加疾病編碼2010-9-21薛亞玲0.82去掉入院登記回退業(yè)務(wù)2010-11-09薛亞玲0.83支持環(huán)境增加大醫(yī)院模式使用oracle 10g版本2010-11-10薛亞玲0.84修改入院登記傳入?yún)?shù)2010-11-17陳曉明0.85修改xml字符串示例2010-11-18陳曉明0.86醫(yī)療類別去掉中途結(jié)算與年終結(jié)算，住院結(jié)算參數(shù)增加結(jié)算方式（1-普通住院結(jié)算，2-中途結(jié)算，3-年終結(jié)算）2010-11-19薛亞玲0.87增加醫(yī)保結(jié)算成功his失敗后，如何處理的問題2010-12-01薛亞玲0.9定版0.9.0.9遺留問題：HIS傳輸費用明細后，如果費用等級發(fā)生變化，再次傳入負記錄也不能解決問題，需提供專門退費的函數(shù)來處理。接口函數(shù)增加參數(shù)中不能含有”#”;增加示例三2010-12-08薛亞玲0.91增加錯誤信息列表、驗收標準；住院結(jié)算函數(shù)增加入?yún)①M用總額；database.ini改名為neuqhd.ini;增加病歷號2010-12-09薛亞玲0.92修改住院費用明細修改調(diào)用流程2010-12-22陳曉明0.93門診預結(jié)算、住院預結(jié)算增加返回參數(shù)2011-01-14陳曉明目 錄第一章概述71.1背景71.2API接口開發(fā)險種范圍71.3API接口開發(fā)安全機制71.4API接口數(shù)據(jù)流圖81.5支持環(huán)境要求91.6術(shù)語9第二章快速上手102.1認識API接口組成102.2創(chuàng)建接口表112.3定點結(jié)算系統(tǒng)登錄用戶信息對照122.4ODBC配置142.5三目編碼對照142.5.1藥品對照152.5.2診療對照162.5.3疾病編碼對照維護162.6示例一：入院登記處理17第三章API接口函數(shù)說明183.1API函數(shù)參數(shù)說明18第四章HIS調(diào)用API接口函數(shù)流程說明204.1門診部分204.1.1門診結(jié)算204.1.2門診結(jié)算回退214.2住院部分224.2.1入院登記224.2.2住院登記信息修改224.2.3住院費用錄入（或執(zhí)行醫(yī)囑）234.2.4住院費用明細修改244.2.5住院結(jié)算264.2.6住院結(jié)算回退274.3單據(jù)格式274.3.1門診結(jié)算單274.3.2住院結(jié)算單29第五章常用業(yè)務(wù)協(xié)議碼315.1讀卡身份驗證315.2讀取收費項目對照信息355.3門診預結(jié)算355.4門診結(jié)算365.5門診結(jié)算回退375.6門診結(jié)算單打印385.7入院登記395.8住院錄費預結(jié)算405.9住院費用明細修改415.10住院結(jié)算425.11住院結(jié)算回退435.12住院結(jié)算單打印445.13無費出院45第六章定點結(jié)算系統(tǒng)功能介紹46第七章常見問題477.1在交易過程中，先提交哪一個系統(tǒng)數(shù)據(jù)庫事務(wù)？477.2住院日常費用錄入如何處理的？477.3如何才能查詢到API接口事務(wù)是否成功或作進一步處理？477.4如果在進行his結(jié)算時，調(diào)用接口函數(shù)成功，但是his數(shù)據(jù)庫突然斷開，造成醫(yī)保中存在結(jié)算數(shù)據(jù)，his中無結(jié)算數(shù)據(jù)，該如何處理？477.5住院錄入費用過程中有沒有什么限制？在正常的住院錄入費用過程中，是否是每一筆處方都調(diào)一次動態(tài)庫，還是錄入完成之后再調(diào)一次？有沒有限制或者規(guī)定性內(nèi)容？487.6調(diào)用API接口函數(shù)（住院錄費預結(jié)算）時，提示“發(fā)送請求失敗”487.7如未正常維護三目對照，會有什么影響或者問題出現(xiàn)？487.8項目未對照已收費，且已傳輸?shù)絼趧颖Ｕ舷到y(tǒng)前置機中，此時將項目進行對照，但已傳輸過的項目收費項目等級不能修改，仍顯示為丙類，該怎樣處理？487.9能否醫(yī)院的多個藥品對應醫(yī)保的某個藥品？497.10讀卡輸入密碼窗口需要HIS開發(fā)嗎？497.11發(fā)生DLL調(diào)用錯誤怎么辦？497.12進行API接口開發(fā)是否威脅到HIS系統(tǒng)數(shù)據(jù)安全？497.13能否由HIS系統(tǒng)提供接口，由定點結(jié)算系統(tǒng)來調(diào)用？507.14如果在住院錄費預結(jié)算時費用明細傳輸錯誤，該怎么處理？507.15在住院期間住院患者變更單位，原單位存在封鎖，而新單位沒有封鎖，或者卡掛失，卡號發(fā)生變化，在HIS中該如何處理？507.16當醫(yī)保/工傷等項目發(fā)生變化之后，HIS系統(tǒng)如何處理?507.17如何獲取HIS中所有藥品或所有診療對照醫(yī)保項目的信息？507.18在進行費用錄入時如何顯示項目的收費項目等級？517.19在住院費用錄入時錄入明細大于5條后，調(diào)用API接口住院錄費預結(jié)算函數(shù)時，提示存儲過程失效的錯誤。517.20讀卡身份驗證都驗證哪些內(nèi)容？517.21如何進行API接口函數(shù)的聲明引用？51第八章附錄528.1病人就診信息表kc21結(jié)構(gòu)528.2費用明細信息表kc22結(jié)構(gòu)538.3接口表指標代碼表548.4病人就診信息表kc21建表語句578.5費用明細信息表kc22建表語句598.6XML字符串示例608.7錯誤信息列表618.8驗收標準65第一章 概述1.1 背景隨著國家對勞動保障信息化工作的大力投入，勞動保障部門需要與定點醫(yī)療機構(gòu)建立更加緊密的信息互聯(lián)與交換，這就需要把定點醫(yī)療機構(gòu)原來的信息管理系統(tǒng)（下稱HIS系統(tǒng)）與勞動保障部門的業(yè)務(wù)系統(tǒng)互聯(lián)。目前，勞動保障部門延伸到定點醫(yī)療機構(gòu)的業(yè)務(wù)系統(tǒng)有：職工醫(yī)療保險定點結(jié)算系統(tǒng)、居民醫(yī)療保險定點結(jié)算系統(tǒng)、工傷保險定點結(jié)算系統(tǒng)，下面統(tǒng)稱這三個定點結(jié)算系統(tǒng)為定點結(jié)算系統(tǒng)。HIS系統(tǒng)與勞動保障部門的業(yè)務(wù)系統(tǒng)互聯(lián)，將有助于減輕定點醫(yī)療機構(gòu)的日常管理和業(yè)務(wù)經(jīng)辦工作量，提高工作效率。同時，也有利于勞動保障部門對基金的監(jiān)督管理，有利于參保人員合法權(quán)益的保護。1.2 API接口開發(fā)險種范圍序號險種是否有卡患者識別方式1職工醫(yī)療無IC卡號2城鎮(zhèn)居民有卡CPU卡3工傷保險無社會保障號1.3 API接口開發(fā)安全機制序號機制說明1授權(quán)碼API接口開發(fā)的授權(quán)碼，每個險種對應一個授權(quán)碼，由東軟公司提供。2登錄用戶和口令定點結(jié)算系統(tǒng)中的登錄用戶和口令；用來確定是哪個用戶/業(yè)務(wù)員傳上來的數(shù)據(jù)，作為API接口的登錄用戶。3MAC地址通過MAC地址來限制各定點使用的終端接入和信息跟蹤。1.4 API接口數(shù)據(jù)流圖定點結(jié)算系統(tǒng)提供API接口函數(shù)供定點醫(yī)療機構(gòu)HIS系統(tǒng)調(diào)用，以完成相應險種的數(shù)據(jù)傳輸與結(jié)算處理，其基本數(shù)據(jù)流圖如下：說明：1、 HIS系統(tǒng)進行業(yè)務(wù)數(shù)據(jù)錄入，將就診信息和費用明細寫入HIS接口表中，根據(jù)接口表數(shù)據(jù)，生成XML格式數(shù)據(jù)。2、 HIS系統(tǒng)提供對應API接口函數(shù)的入?yún)?，其中要提供定點結(jié)算系統(tǒng)中的登錄名和密碼，并提供險種的授權(quán)碼，調(diào)用定點結(jié)算系統(tǒng)的API接口函數(shù)。3、 API接口函數(shù)在接收到HIS系統(tǒng)的調(diào)用請求后，進行授權(quán)碼驗證和用戶合法性校驗，然后把傳入的就診信息XML數(shù)據(jù)和費用明細XML數(shù)據(jù)傳輸?shù)絼趧颖Ｕ舷到y(tǒng)前置機業(yè)務(wù)系統(tǒng)中。4、 API接口函數(shù)根據(jù)就診信息和費用明細，按照政策要求進行相應的運算。5、 API接口函數(shù)返回執(zhí)行結(jié)果，HIS系統(tǒng)根據(jù)返回結(jié)果進行相應的判斷處理，以完成相應的業(yè)務(wù)處理。至此整個調(diào)用過程結(jié)束。1.5 支持環(huán)境要求計算機至少要1G 內(nèi)存，磁盤剩余空間至少1G。該API接口只支持WINDOWS 2000/XP系統(tǒng)平臺下所開發(fā)的應用系統(tǒng)，各應用系統(tǒng)必須能正常調(diào)用接口函數(shù)，傳入Windows標準API函數(shù)（例如用PB、Delphi、VB、VC、CB等開發(fā)的軟件都可以支持）。不支持其他操作系統(tǒng)。如果為大醫(yī)院模式，本地ORACLE數(shù)據(jù)庫服務(wù)器端和各業(yè)務(wù)員客戶端需要安裝oracle 10g（10.2.0.1以上）版本。1.6 術(shù)語序號術(shù)語含義1勞動保障系統(tǒng)前置機定點結(jié)算系統(tǒng)數(shù)據(jù)庫所在服務(wù)器2預結(jié)算將未上傳的費用明細傳輸?shù)絼趧颖Ｕ舷到y(tǒng)前置機，對費用信息計算預覽3定點結(jié)算系統(tǒng)職工醫(yī)療保險定點結(jié)算系統(tǒng)、居民醫(yī)療保險定點結(jié)算系統(tǒng)、工傷保險定點結(jié)算系統(tǒng)，統(tǒng)稱這三個定點結(jié)算系統(tǒng)為定點結(jié)算系統(tǒng)。軟件版權(quán)歸東軟公司。4HIS系統(tǒng)指各定點醫(yī)療機構(gòu)使用的醫(yī)院信息管理系統(tǒng)。5大醫(yī)院模式在我市定點結(jié)算系統(tǒng)中，有10多家大型醫(yī)院安裝了本地數(shù)據(jù)庫，一些沒有安裝本地數(shù)據(jù)庫。安裝了本地數(shù)據(jù)庫的醫(yī)院叫大醫(yī)院模式，沒有安裝本地數(shù)據(jù)庫的醫(yī)院稱為托管模式。大醫(yī)院模式對不同的定點結(jié)算系統(tǒng)可能不同，如某醫(yī)院可能職工定點結(jié)算系統(tǒng)是大醫(yī)院模式，而城居和工傷定點結(jié)算系統(tǒng)就可能不是大醫(yī)院模式，這一點要注意。第二章 快速上手 本章將對API接口組成和開發(fā)前的準備工作做一下簡單介紹，并用例子讓開發(fā)者初步認識調(diào)用API接口函數(shù)的一般過程與方法。API授權(quán)碼創(chuàng)建接口表定點結(jié)算系統(tǒng)登錄用戶信息對照三目編碼對照HIS調(diào)用API接口程序開發(fā)API接口業(yè)務(wù)調(diào)試HIS系統(tǒng)定點結(jié)算系統(tǒng)API接口文件2.1 認識API接口組成請從東軟公司獲取API接口文件。該API接口文件包括如下內(nèi)容：序號文件名說明1hiscomminterface.dll醫(yī)保API接口2hiscomminterface.h供c開發(fā)的his系統(tǒng)開發(fā)使用3hiscomminterface.lib供c開發(fā)的his系統(tǒng)開發(fā)使用4Dcic32.dll卡相關(guān)動態(tài)庫5HSMApi.dll卡相關(guān)動態(tài)庫6LSCard.dll卡相關(guān)動態(tài)庫7TYICAPI.dll卡相關(guān)動態(tài)庫8TYICRD.dll卡相關(guān)動態(tài)庫9TYReader.dll卡相關(guān)動態(tài)庫10eapagent.dll醫(yī)保相關(guān)動態(tài)庫11Hdcrw.dll卡相關(guān)動態(tài)庫12Mwic_32.dll卡相關(guān)動態(tài)庫13SSSE32.dll卡相關(guān)動態(tài)庫14ICCARD.dll卡相關(guān)動態(tài)庫15neuqhd.ini配置文件16eapagent.ini配置文件（醫(yī)院不能修改）請將以上從東軟公司獲取的API接口文件保存到HIS系統(tǒng)前端程序的安裝目錄下，配置文件neuqhd.ini的修改項的說明見配置文件中的說明。2.2 創(chuàng)建接口表所謂接口表，是在進行API接口開發(fā)之前，需要在HIS系統(tǒng)中創(chuàng)建的兩個實體表，特指病人就診信息表kc21和費用明細信息表kc22兩張表，這兩張表用于生成XML數(shù)據(jù)。具體表結(jié)構(gòu)和字段含義，請參考附錄病人就診信息表kc21和費用明細信息表kc22中的描述。這里，對創(chuàng)建接口表作如下要求：1、接口表建在HIS系統(tǒng)數(shù)據(jù)庫中，建在HIS系統(tǒng)的同一數(shù)據(jù)庫用戶下。 2、如果HIS系統(tǒng)所使用的數(shù)據(jù)庫不是ORACLE，創(chuàng)建接口表時，把接口表的表名和字段名設(shè)置為大寫。3、接口表作為HIS系統(tǒng)數(shù)據(jù)庫的一部分，用于HIS自身的事務(wù)處理。說明：建立接口表的目的是為了在調(diào)用API接口函數(shù)時，生成接口函數(shù)所需要的XML數(shù)據(jù)， 至于哪些函數(shù)需要XML數(shù)據(jù)，請參照常用業(yè)務(wù)協(xié)議碼介紹。2.3 定點結(jié)算系統(tǒng)登錄用戶信息對照HIS系統(tǒng)在調(diào)用API接口函數(shù)時需要提供合法的登錄用戶和口令，如果登錄用戶和口令與定點結(jié)算系統(tǒng)中的登錄用戶匹配，那么可以正常調(diào)用API接口函數(shù)，否則提示用戶不合法。因此，HIS系統(tǒng)中要提供定點結(jié)算系統(tǒng)中登錄用戶信息與HIS系統(tǒng)中登錄用戶信息對照的功能。在初次啟動動態(tài)庫時，操作員要使用此功能模塊將定點結(jié)算系統(tǒng)中的登錄用戶和口令信息保存到HIS系統(tǒng)中，在日常使用過程中，如果定點結(jié)算系統(tǒng)中的用戶信息發(fā)生變化，操作員還需要應用此模塊重新進行對照，否則不能正常做醫(yī)保業(yè)務(wù)。目前，定點醫(yī)療機構(gòu)的業(yè)務(wù)系統(tǒng)有：職工醫(yī)療保險定點結(jié)算系統(tǒng)、居民醫(yī)療保險定點結(jié)算系統(tǒng)、工傷保險定點結(jié)算系統(tǒng)，在HIS系統(tǒng)中需要對三套定點結(jié)算系統(tǒng)進行登錄用戶對照。下方為HIS系統(tǒng)社會保障系統(tǒng)登錄用戶對照功能示例，HIS可參照，也可自己開發(fā)，只要實現(xiàn)此功能即可。假設(shè)HIS系統(tǒng)中用戶信息表為T_USER。1. 表結(jié)構(gòu)字段類型長度是否可空主鍵備注LOGIN_NAMEVARCHAR2(20)否是HIS系統(tǒng)中用戶登錄名 PASSWORDVARCHAR2(20)否HIS系統(tǒng)中登錄密碼NAMEVARCHAR2(20)否操作員姓名ZGYL_LOGIN_NAMEVARCHAR2(20)否職工定點結(jié)算系統(tǒng)中登錄名ZGYL_PASSWORDVARCHAR2(20)否職工定點結(jié)算系統(tǒng)中密碼CZJM_LOGIN_NAMEVARCHAR2(20)否城鎮(zhèn)居民定點結(jié)算系統(tǒng)中登錄名CZJM_PASSWORDVARCHAR2(20)否城鎮(zhèn)居民定點結(jié)算系統(tǒng)中密碼GS_LOGIN_NAMEVARCHAR2(20)否工傷保險定點結(jié)算系統(tǒng)中登錄名GS_PASSWORDVARCHAR2(20)否工傷保險定點結(jié)算系統(tǒng)中密碼黃色部分為原系統(tǒng)中不存在列，需要針對動態(tài)庫新增2. HIS系統(tǒng)中原用戶信息：LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD張三123456張三李四780215李四3. 動態(tài)庫啟動后，操作員通過用戶信息對照功能模塊，錄入定點結(jié)算系統(tǒng)中登錄名與密碼。打開定點結(jié)算系統(tǒng)登錄用戶信息對照窗口，定點結(jié)算系統(tǒng)中登錄用戶信息部分會自動顯示已維護過的信息，如果為空，證明還未進行維護?；疑煮w不可錄，藍色字體為必錄項。操作員填寫登錄用戶與密碼，保存即可。HIS系統(tǒng)存入的密碼為明碼值。定點結(jié)算系統(tǒng)登錄用戶信息對照 HIS系統(tǒng)用戶信息登錄用戶張三定點結(jié)算系統(tǒng)中登錄用戶信息職工醫(yī)療登錄用戶1001zhangsan職工醫(yī)療密碼*城鎮(zhèn)居民登錄用戶1001zhangsan城鎮(zhèn)居民密碼*工傷保險登錄用戶1001zhangsan工傷保險密碼*保 存關(guān) 閉就緒定點結(jié)算系統(tǒng)登錄用戶信息對照4. 操作員維護后用戶信息LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD張三123456張三1001zhangsan8888881001zhangsan888888李四780215李四lisi000000lisi0000005. 調(diào)用API接口函數(shù)時，HIS系統(tǒng)在驗證其HIS系統(tǒng)登錄安全后，再從該對照表T_USER中獲取對應險種的登錄名和密碼（如zhangsan、888888）傳給API函數(shù)，由API函數(shù)傳到定點結(jié)算系統(tǒng)中進行醫(yī)保相應的安全驗證。6. 如果操作員在定點結(jié)算系統(tǒng)中變更密碼，那么須在此窗口重新維護。如果未在HIS系統(tǒng)中修改定點結(jié)算系統(tǒng)登錄密碼，那么在調(diào)用API接口函數(shù)時會提示用戶不合法。2.4 ODBC配置定點結(jié)算系統(tǒng)存在本地數(shù)據(jù)庫的醫(yī)院需要進行ODBC配置，否則不用配置ODBC。ODBC數(shù)據(jù)源中只需錄入數(shù)據(jù)源名稱及TNS Service Name即可，其中TNS Service Name為客戶端連接本地數(shù)據(jù)庫的服務(wù)名。配置時按如下表中名稱配置：險種ODBC數(shù)據(jù)源名稱TNS Service Name備注職工connection_zgzgyl數(shù)據(jù)源名稱需要與neuqhd.ini中對應險種的【#醫(yī)保前置機連接】下的ServerName名稱一致。城居connection_cjcjyl工傷connection_gsgsyl例：客戶端連接職工醫(yī)療數(shù)據(jù)庫的服務(wù)名為zgyl。2.5 三目編碼對照醫(yī)?；颊咴卺t(yī)院就診且發(fā)生費用時，就應該按照醫(yī)保中心的相關(guān)政策對該患者在就診期間所發(fā)生的各項費用進行結(jié)算。而各種藥品、診療項目、病種、服務(wù)設(shè)施的相關(guān)信息在結(jié)算過程中扮演著重要角色，因此醫(yī)院對醫(yī)?；颊哌M行費用結(jié)算時就必須明確告訴醫(yī)保中心，自己所用的目錄中的各個項目分別對應于醫(yī)保中心目錄中的哪一條。然而，各個醫(yī)院都有自己獨立的HIS系統(tǒng)，也有自己獨立的藥品、診療、病種，并且這些目錄都有可能不同于醫(yī)保中心對應的目錄。所以，為了將醫(yī)院目錄中的各個項目與醫(yī)保中心的相關(guān)目錄關(guān)聯(lián)起來（而又不需要對醫(yī)院已有的目錄進行改動），就需要將醫(yī)院的目錄中的信息和醫(yī)保中心相關(guān)信息進行對照。目錄經(jīng)過對照后，在醫(yī)院的每一種藥品、診療、病種就都可以在醫(yī)保中心找到一條記錄與之相對應，也就使得醫(yī)院與醫(yī)保中心的記錄統(tǒng)一起來。這樣，醫(yī)院就能在通過醫(yī)保接口與醫(yī)保中心進行對照時，以提供對照碼的方式來告訴醫(yī)保中心醫(yī)院所用的項目對應于中心的哪條記錄。2.5.1 藥品對照點擊定點結(jié)算系統(tǒng)中【醫(yī)療信息維護】下的【藥品對照】會打開下圖所示的窗口：圖5-1圖5-2【操作流程】1. 選擇批量方式對照時需要把his的藥品庫導入到醫(yī)保庫中，然后再his藥品信息中選擇需要對照的藥品，選種該藥品的同時在醫(yī)保藥品信息中也查出相應的藥品，然后再醫(yī)保藥品信息中選擇正確的藥品后點擊【對照】按鈕就可以把醫(yī)院和醫(yī)保的藥品對照起來了。2. 選擇單個對照方式時錄入拼音碼或名稱后點擊【檢索】按鈕在醫(yī)保藥品信息中找到該藥品后同時再對照信息中插入一條該藥品信息，把his的編碼錄入到該記錄中后點擊【保存】按鈕，把剛才錄入的信息進行保存。2.5.2 診療對照同【藥品對照】。2.5.3 疾病編碼對照維護同【藥品對照】。2.6 示例一：入院登記處理通過該示例，你將學習到如何調(diào)用API接口函數(shù)，完成信息在HIS系統(tǒng)與定點結(jié)算系統(tǒng)之間的交互與處理全過程。掌握了該示例，其他的業(yè)務(wù)處理基本都相同，請認真體會。首先錄入住院就診信息，然后選擇錄入醫(yī)療類型及醫(yī)保IC卡號或社會保障號進行入院登記業(yè)務(wù)處理。以職工醫(yī)保為例。ls_ywxym = “CC311001”/業(yè)務(wù)協(xié)議碼 入院登記ls_ywrc = “ZY0100000000000001” /住院號ls_yllx = “0|21|0707110925|XX” /職工醫(yī)保|醫(yī)療類別（普通住院）|IC卡號ls_yblongin_name = “manager” /通過HIS登錄用戶獲取ls_yb_password = “neusoft” /通過HIS登錄用戶獲取ls_licence = “1111111111” /由東軟公司提供給HIS的職工醫(yī)療的授權(quán)碼ls_jzxx = “zy01000000000000010212010-6-302010-6-30test2010-6-301test123456” /就診信息xmlls_fymx = “0” /費用明細為0/調(diào)用API函數(shù)li_res=comminterface(ls_ywxym,ls_ywrc,ls_yllx,ls_yblongin_name,ls_yb_password,ls_licence,ls_jzxx,ls_fymx,ref ls_ywcc)ls_ywcc = “” /業(yè)務(wù)出參為空/后續(xù)處理HIS相關(guān)業(yè)務(wù)第三章 API接口函數(shù)說明 3.1 API函數(shù)參數(shù)說明本接口API函數(shù)只提供了一個comminterface函數(shù)，通過給該函數(shù)傳入不同的業(yè)務(wù)協(xié)議碼，來實現(xiàn)不同的業(yè)務(wù)功能。因此，對于調(diào)用者，需要詳細學習該函數(shù)的組成，以便靈活調(diào)用。comminterface (in業(yè)務(wù)協(xié)議碼, in業(yè)務(wù)入?yún)?，in醫(yī)療類型，in 登錄名,in 密碼，in 授權(quán)碼，in 就診信息，in 費用明細, out業(yè)務(wù)出參) 參數(shù)描述：參數(shù)內(nèi)不能帶有和#標識符號列方向說明業(yè)務(wù)協(xié)議碼in請參考業(yè)務(wù)協(xié)議碼表中的業(yè)務(wù)協(xié)議碼業(yè)務(wù)入?yún)n請參考業(yè)務(wù)協(xié)議碼表中的業(yè)務(wù)入?yún)?；醫(yī)療類型in(險種|醫(yī)療類別|患者識別信息|XX)HIS系統(tǒng)需要提供選擇職工醫(yī)保、城居醫(yī)保、工傷的功能， 同時要提供錄入IC卡號社會保障號的功能。險種：0-職工醫(yī)保，1-城居醫(yī)保，2-工傷；醫(yī)療類別：見接口代碼表；患者識別信息：定點機構(gòu)需用讀卡器讀取卡上信息的此參數(shù)置為0，職工醫(yī)療不用讀卡器讀取卡上信息的此參數(shù)需置上參保人的醫(yī)保IC卡號，對于工傷險種此參數(shù)置為工傷人員社保編號；XX:兩個大寫的X屬于固定格式，必須放在最后；險種、醫(yī)療類別、患者識別信息、XX之間要用“|”分隔。如果使用社?？?，dll將自動區(qū)分是職工還是居民，并且在讀卡身份驗證業(yè)務(wù)中返回是職工還是居民，第20個參數(shù)，其他業(yè)務(wù)根據(jù)此參數(shù)判斷險種為0還是1登錄名in定點結(jié)算系統(tǒng)中登錄名口令in定點結(jié)算系統(tǒng)中密碼（密碼須為明碼）授權(quán)碼in授權(quán)碼(東軟公司提供)就診信息in根據(jù)kc21表結(jié)構(gòu)生成的XML字符串。費用明細in根據(jù)kc22表結(jié)構(gòu)生成的XML字符串。業(yè)務(wù)出參out請參考業(yè)務(wù)協(xié)議碼表中的出參格式；備注： 調(diào)用預結(jié)算、結(jié)算、住院登記協(xié)議時，就診信息、費用明細需要傳入XML字符串，其他情況可傳入”0”。 XML格式要求見【XML字符串示例】返回值：返回值類型：int。1. 0 表示成功，業(yè)務(wù)出參為對應各業(yè)務(wù)協(xié)議碼的業(yè)務(wù)出參。2. 當此函數(shù)返回值不等于0時，操作失敗，業(yè)務(wù)出參內(nèi)含有錯誤信息。用例：1、此人參保為城居醫(yī)保，做出院結(jié)算業(yè)務(wù)，城居為有卡模式。li_res = comminterface (“CC311003”, “門診住院號| 醫(yī)療類別|單據(jù)號”，“1|21|0|XX”,“manager”，“password”，“1234567890”，kc21_xml,kc22_xml ,返回結(jié)算信息)2、此人參保為職工醫(yī)保，做出院結(jié)算業(yè)務(wù)，沒有讀卡操作。li_res = comminterface (“CC311003”, “門診住院號| 醫(yī)療類別|單據(jù)號”，“0|21|醫(yī)保IC卡號|XX”,“manager”，“password”,“11111111111”，kc21_xml,kc22_xml,返回結(jié)算信息)3、此人為工傷患者，做出院結(jié)算業(yè)務(wù)，沒有讀卡操作。li_res = comminterface (“CC311003”, “門診住院號| 醫(yī)療類別|單據(jù)號”，“2|21|社保編號|XX” ,“manager”，“password” ，“2222222222”，kc21_xml,kc22_xml , 返回結(jié)算信息)第四章 HIS調(diào)用API接口函數(shù)流程說明4.1 門診部分4.1.1 門診結(jié)算門診特殊病與普通門診業(yè)務(wù)流程一樣，所以放在一起介紹。普通門診適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷門診特殊病適用險種職工醫(yī)療、城鎮(zhèn)居民步驟號觸發(fā)業(yè)務(wù)分步詳解1信息錄入錄入就診信息和處方明細信息。2選擇險種類型和醫(yī)療類別（普通門診或門診特殊?。?，根據(jù)API接口開發(fā)險種范圍錄入IC卡號、社會保障號或插入CPU卡。3預結(jié)算（可選）1. 生成kc21、kc22對應的XML字符串。調(diào)用接口函數(shù)，傳入“門診預結(jié)算(BC311002)”協(xié)議碼。a) 如果接口函數(shù)返回0即成功，HIS可繼續(xù)完成其他業(yè)務(wù)?？蓪⒎祷氐挠嬎憬Y(jié)果顯示到HIS前臺系統(tǒng)，供操作員參考。b) 如果接口函數(shù)返回值不為0即失敗，錯誤信息見業(yè)務(wù)返回信息，但HIS可繼續(xù)做其他業(yè)務(wù)（只影響計算結(jié)果的顯示）。4結(jié)算1. 寫入kc21、kc22，生成XML字符串。調(diào)用接口函數(shù)，傳入“門診結(jié)算(CC311002)”協(xié)議碼。a) 如果接口函數(shù)返回0即成功，HIS需更新接口表KC21、KC22中的CKC126等于1，表示已將KC21、KC22中的記錄傳到定點結(jié)算系統(tǒng)數(shù)據(jù)庫中，接下來完成其他的HIS操作即可。b) 如果接口函數(shù)返回值不為0即失敗，錯誤信息見業(yè)務(wù)返回信息，HIS事務(wù)回滾，終止HIS操作。注：如果HIS系統(tǒng)門診結(jié)算失敗而接口交易成功即接口函數(shù)返回0，HIS需要發(fā)起反交易請求，沖掉醫(yī)保的成功交易，即調(diào)用接口函數(shù)，傳入門診結(jié)算回退(DC311002)協(xié)議碼，做門診結(jié)算回退。具體處理見門診結(jié)算回退流程。5提交提交HIS數(shù)據(jù)庫。4.1.2 門診結(jié)算回退在查詢結(jié)算信息時，可不用讀卡，但是在結(jié)算回退時，針對有卡的險種必須插卡，否則不能結(jié)算回退。普通門診適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷門診特殊病適用險種職工醫(yī)療、城鎮(zhèn)居民步驟號觸發(fā)業(yè)務(wù)分步詳解1查詢查詢待作廢的結(jié)算信息。2處理HIS門診結(jié)算回退業(yè)務(wù)。3結(jié)算回退調(diào)用接口函數(shù)，傳入“門診結(jié)算回退(DC311002)”協(xié)議碼。1. 如果接口函數(shù)返回0即成功,接下來完成其他的HIS操作即可。2. 如果接口函數(shù)返回值不為0即失敗，錯誤信息見業(yè)務(wù)返回信息，HIS事務(wù)回滾，終止HIS操作。注：如果HIS系統(tǒng)門診結(jié)算回退失敗而接口交易成功，那么HIS需要將HIS中的結(jié)算信息作廢。4提交提交HIS數(shù)據(jù)庫。4.2 住院部分4.2.1 入院登記非醫(yī)保轉(zhuǎn)醫(yī)保業(yè)務(wù)可按入院登記步驟來操作。適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1信息錄入錄入入院登記信息。2處理HIS入院登記業(yè)務(wù)。3住院登記選擇險種類型，選擇醫(yī)療類別（普通住院），根據(jù)API接口開發(fā)險種范圍錄入IC卡號、社會保障號或插入CPU卡。將入院登記信息保存到接口表KC21中, 生成就診信息XML字符串。4住院登記調(diào)用接口函數(shù)，傳入“入院登記(CC311001)”協(xié)議碼。1. 如果接口函數(shù)返回0即成功，HIS可繼續(xù)完成其他業(yè)務(wù)。2. 如果接口函數(shù)返回值不為0即失敗，回滾HIS事務(wù)，終止HIS操作。注：如果HIS系統(tǒng)入院登記失敗，但接口交易成功，HIS系統(tǒng)需要重新辦理醫(yī)保住院登記，不用調(diào)用API接口函數(shù)（入院登記）即可。5提交提交HIS數(shù)據(jù)庫。4.2.2 住院登記信息修改辦理住院登記后，如果對科室、醫(yī)生、疾病等信息進行修改，或者患者基本信息發(fā)生變化，HIS需提供修改住院登記信息的功能，并實時傳輸?shù)蕉c結(jié)算系統(tǒng)數(shù)據(jù)庫中。如果需要修改患者基本信息，可通過讀卡功能獲取患者的最新信息，并更新到接口表KC21中。適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1查詢查詢住院登記信息2修改住院登記信息修改，修改KC21。3處理HIS住院登記信息修改業(yè)務(wù)。4生成就診信息XML字符串。不用生成費用明細字符串。5確定調(diào)用接口函數(shù)，傳入“住院錄費(BC311003)”協(xié)議碼，做住院登記信息修改業(yè)務(wù)。1. 如果接口函數(shù)返回0，即成功，HIS可繼續(xù)完成其他業(yè)務(wù)。2. 如果接口函數(shù)返回不為0，即失敗，HIS業(yè)務(wù)可繼續(xù)操作，待費用錄入時再將變更后的住院登記信息傳輸?shù)蕉c結(jié)算系統(tǒng)數(shù)據(jù)庫中。6提交提交HIS數(shù)據(jù)庫。4.2.3 住院費用錄入（或執(zhí)行醫(yī)囑）適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1費用錄入費用錄入（正記錄的費用錄入）2處理HIS費用錄入業(yè)務(wù)。3保存將劃價收費明細寫入KC22，單價和數(shù)量不能為負數(shù)，保存, 生成費用明細XML字符串，同時生成就診信息XML字符串。4保存調(diào)用接口函數(shù)，傳入“住院錄費(BC311003)”協(xié)議碼，將費用信息傳到社會保障系統(tǒng)數(shù)據(jù)庫中，并返回計算結(jié)果。1) 如果接口函數(shù)返回0即成功，HIS需置接口表kc22.ckc126為1，可繼續(xù)完成HIS中其他業(yè)務(wù)操作。2) 如果接口函數(shù)返回不為0，即失敗，HIS數(shù)據(jù)庫回滾。5提交提交HIS 數(shù)據(jù)庫4.2.4 住院費用明細修改適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1費用退費費用刪除（錄入的費用存在錯誤，需要將原費用明細刪除，再錄入正確的費用明細）2處理HIS費用退費業(yè)務(wù)。3保存如果整條費用明細退費，那么直接刪除KC22中的數(shù)據(jù)，不用生成費用明細XMl；如果是部分退費，那么KC22中先刪除原來的費用明細，再生成正記錄進行保存, 將正記錄生成費用明細XML字符串，同時生成就診信息XML字符串。例：原已傳輸過收費項目。紅色代表主鍵住院號處方號處方日期項目名稱項目編碼單價數(shù)量金額1234561234562010-12-07 8:00:00阿莫西林12345620.0010200.00現(xiàn)想退數(shù)量6，那么HIS應保存數(shù)量為4的數(shù)據(jù)到KC22，將新的費用明細生成XML。住院號處方號處方日期項目名稱項目編碼單價數(shù)量金額1234561234562010-12-07 8:10:01阿莫西林12345620.00480.00調(diào)用接口函數(shù)，傳入“住院費用明細修改(BC311004)”協(xié)議碼，將費用信息傳到社會保障系統(tǒng)數(shù)據(jù)庫中，并返回計算結(jié)果。ls_ywxym = “BC311004”/業(yè)務(wù)協(xié)議碼 住院退費預結(jié)算ls_ywrc = “1302012516300|ZY0100000000000001|21|123456|20101207150000|123456” /住院號|醫(yī)療類別|處方號|處方日期|醫(yī)院收費編碼ls_yllx = “0|21|0707110925|XX” /職工醫(yī)保|醫(yī)療類別（普通住院）|IC卡號ls_yblongin_name = “manager” /通過HIS登錄用戶獲取ls_yb_password = “neusoft” /通過HIS登錄用戶獲取ls_licence = “1111111111” /由東軟公司提供給HIS的職工醫(yī)療的授權(quán)碼ls_jzxx = “zy01000000000000010212010-6-302010-6-30test2010-6-301test123456” /就診信息xmlls_fymx = “ ZY01000000000000011234562010-12-07 下午 03:00:00123456阿莫西林120.00004.00080.00” /10盒阿莫西林退掉6盒為例，只需將4盒的阿莫西林生成費用明細XML/調(diào)用API函數(shù)li_res=comminterface(ls_ywxym,ls_ywrc,ls_yllx,ls_yblongin_name,ls_yb_password,ls_licence,ls_jzxx,ls_fymx,ref ls_ywcc)ls_ywcc = “200|100|100” /業(yè)務(wù)出參（統(tǒng)籌支出|現(xiàn)金支出|賬戶支出）/后續(xù)處理HIS將費用信息保存到HIS系統(tǒng)中后提交數(shù)據(jù)庫。1) 如果接口函數(shù)返回0即成功，HIS需置接口表kc22.ckc126為1，可繼續(xù)完成HIS中其他業(yè)務(wù)操作。2) 如果接口函數(shù)返回不為0，即失敗，回退HIS數(shù)據(jù)庫，KC22中的數(shù)據(jù)不進行刪除。注：如果調(diào)用API接口函數(shù)成功，HIS系統(tǒng)處理失敗，HIS數(shù)據(jù)庫回滾，如果是部分退費，還應將后收取的費用再調(diào)用“住院費用明細修改(BC311004)”退掉。即再退掉這一筆明細。住院號處方號處方日期項目名稱項目編碼單價數(shù)量金額1234561234562010-12-07 8:10:01阿莫西林12345620.00480.00HIS系統(tǒng)應能夠?qū)⒈竟P要退費的費用退掉，不調(diào)用API接口函數(shù)，因為定點結(jié)算系統(tǒng)中已退完。4提交提交HIS 數(shù)據(jù)庫4.2.5 住院結(jié)算適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1查詢查詢待結(jié)算人員信息。2選擇1. 選擇結(jié)算方式（普通住院、中途結(jié)算、年終結(jié)算）。3處理HIS住院結(jié)算業(yè)務(wù)。4將HIS系統(tǒng)中KC22未傳輸（ckc126=0）的費用明細生成費用明細XML字符串（如不存在未傳輸?shù)牟挥蒙少M用明細XML字符串），同時生成就診信息XML字符串。5預結(jié)算(可選)如果住院結(jié)算前需要先預覽結(jié)算結(jié)果，可以調(diào)用接口函數(shù)，傳入“住院錄費預結(jié)算(BC311003)”協(xié)議碼。1. 如果接口函數(shù)返回0即成功，HIS需將接口表kc22.ckc126=0的費用明細置為1，可繼續(xù)完成HIS中其他業(yè)務(wù)操作。2. 如果接口函數(shù)返回不為0，即失敗，HIS事務(wù)回滾，終止HIS操作。6結(jié)算如果預結(jié)算結(jié)果無誤，可調(diào)用接口函數(shù)，傳入“住院結(jié)算(CC311003)”協(xié)議碼。1) 如果接口函數(shù)返回0即成功，HIS需將接口表kc22.ckc126=0的費用明細置為1，表示已將KC22中的記錄傳到定點結(jié)算系統(tǒng)數(shù)據(jù)庫中，接下來完成其他的HIS操作即可。2) 如果接口函數(shù)返回值不為0即失敗，HIS事務(wù)回滾，終止HIS操作。注：如果HIS系統(tǒng)住院結(jié)算失敗而接口交易成功，HIS需要發(fā)起反交易請求，沖掉定點結(jié)算系統(tǒng)中的成功交易，即調(diào)用接口函數(shù)，傳入“住院結(jié)算回退DC311003”協(xié)議碼，做住院結(jié)算回退。具體處理見住院結(jié)算回退流程。注：再次出院結(jié)算時的單據(jù)號應換號，不能與上次結(jié)算的相同。7提交提交HIS 數(shù)據(jù)庫。4.2.6 住院結(jié)算回退在查詢結(jié)算信息時，可不用讀卡，但是在結(jié)算回退時，針對有卡的險種必須插卡，否則不能結(jié)算回退。適用險種職工醫(yī)療、城鎮(zhèn)居民、工傷步驟號觸發(fā)業(yè)務(wù)分步詳解1查詢查詢待作廢結(jié)算信息。2處理HIS住院結(jié)算回退業(yè)務(wù)。3結(jié)算回退調(diào)用接口函數(shù)，傳入“住院結(jié)算回退DC311003”協(xié)議碼。1. 如果接口函數(shù)返回