成都市基本醫(yī)療保險基礎(chǔ)數(shù)據(jù)采集接口規(guī)范

#/16成都市基本醫(yī)療保險基礎(chǔ)數(shù)據(jù)采集接口規(guī)

范Version1.1久遠(yuǎn)銀海2019年01月、變更說明1、編號修訂日期版本號修訂人說明012019-01-231.0>進(jìn)銷存數(shù)據(jù)米集接口規(guī)范文檔發(fā)布022019-02-211.1>針對進(jìn)銷存盤盈、盤損、科室備用藥品進(jìn)行接口規(guī)范調(diào)整>>2、《成都市基本醫(yī)療保險基礎(chǔ)數(shù)據(jù)采集應(yīng)用編程規(guī)范》（以下簡稱數(shù)據(jù)采集接口規(guī)范）的使用對象為定點(diǎn)醫(yī)療機(jī)構(gòu)（HIS）供應(yīng)商或其它應(yīng)用軟件供應(yīng)商。矚慫潤厲釤瘞睞櫪廡賴。數(shù)據(jù)采集接口規(guī)范適用于包括醫(yī)師、科室、設(shè)備、藥品、進(jìn)銷存等在內(nèi)的定點(diǎn)醫(yī)療機(jī)構(gòu)監(jiān)管型及公眾服務(wù)型相關(guān)數(shù)據(jù)資源的采集及管理。（本規(guī)范，不含對我市醫(yī)保政策和業(yè)務(wù)經(jīng)辦流程的介紹）聞創(chuàng)溝燴鐺險愛氌譴凈。應(yīng)用模式數(shù)據(jù)采集接口交易使用HTTP通信協(xié)議，傳輸數(shù)據(jù)格式遵循SOAP協(xié)議，通過webservice發(fā)布服務(wù)。WebService技術(shù)，能使得運(yùn)行在不同機(jī)器上的不同應(yīng)用無須借助附加的、專門的第三方軟件或硬件，就可相互交互數(shù)據(jù)殘騖樓諍錈瀨濟(jì)溆塹籟。環(huán)境要求硬件環(huán)境無。網(wǎng)絡(luò)環(huán)境指標(biāo)指標(biāo)值廣域網(wǎng)帶寬M56k網(wǎng)絡(luò)連接客戶端直接訪問醫(yī)保中心網(wǎng)絡(luò)數(shù)據(jù)交互規(guī)范1．服務(wù)器地址：內(nèi)網(wǎng)【測試】服務(wù)器地址：62/yhjypt/services/drugsManageService7wsdl內(nèi)網(wǎng)【生產(chǎn)】服務(wù)器地址：29/yhjypt/services/drugsManageService?wsdl調(diào)用方法名：drugsManageCall測試交易訪問用戶交易訪問驗(yàn)證碼cs0001yhcs0001正式交易訪問用戶正式訪問驗(yàn)證碼測試通過后再分配授權(quán)2．交互數(shù)據(jù)格式交互數(shù)據(jù)格式使用XML數(shù)據(jù)流。字符集utf-8傳入?yún)?shù)作為提供WebService服務(wù)方法的參數(shù)傳入，返回?cái)?shù)據(jù)使用XML數(shù)據(jù)流。3．請求調(diào)用的XML數(shù)據(jù)流格式<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?>謀蕎摶篋飆鐸懟類蔣薔。<data>vjybm>交易服務(wù)編碼v/jybm>vjyfwyh>交易訪問用戶v/yhfwyh>vjyyhyzm>交易訪問驗(yàn)證碼v/jyyhyzm>vakb020>定點(diǎn)機(jī)構(gòu)編碼v/akb020>vdatarow>vrow>vyka094>醫(yī)保項(xiàng)目編碼v/yka094>vyka095>醫(yī)院項(xiàng)目名稱v/yka095>vake005>醫(yī)院對碼流水號v/ake005>vyke940>流水號v/yke940>vyke936>是否拆零標(biāo)志v/yke936>vykf276>采購價格v/ykf276>vykf278>采購數(shù)量v/ykf278>v/row>v/datarow>v/data>4.服務(wù)返回的XML數(shù)據(jù)流格式服務(wù)返回的數(shù)據(jù)流格式為：v?xmlversion=\"1.0\"encoding=\"UTF-8\"?>vresult>vmessage>v/message>vcode>1v/code>v/result>返回錯誤信息：result.message返回錯誤代碼：result.codecode描述1表示執(zhí)行成功-1表示執(zhí)行失敗99表示本次成功但是部分?jǐn)?shù)據(jù)失敗根據(jù)交易內(nèi)容不同，返回值中會增加相應(yīng)的節(jié)點(diǎn)，詳情請看【交易服務(wù)明細(xì)說明】。

數(shù)據(jù)交易接口交易服務(wù)列表序號交易服務(wù)名稱交易服務(wù)編號數(shù)據(jù)上傳周期說明（2019-02-21變更）1藥品米購信息初始化cdypOOOOO首次上傳使用，只能初始化使用2藥品入庫信息上傳cdypOOOOl當(dāng)日數(shù)據(jù)，次日上傳，能夠做到當(dāng)日數(shù)據(jù)當(dāng)日上傳更佳3藥品出庫信息上傳cdyp000024藥品實(shí)際庫存信息上傳cdypOOOO3交易服務(wù)明細(xì)說明探1■藥品采購信息初始化上傳交易名稱藥品采購信息初始化上傳交易分類交易代碼cdypOOOOO交易說明1、在兩定機(jī)構(gòu)首次上傳藥品米購信息之前，通過本交易將醫(yī)療機(jī)構(gòu)現(xiàn)有的藥品庫存信息盤點(diǎn)之后作為米購信息一次性上傳醫(yī)保。2、通過本交易上傳之后該交易不再繼續(xù)使用，后續(xù)的藥品常規(guī)采購入庫信息通過【藥品入庫信息上傳父易（cdypOOOOl）］上傳信息即可。3、流水號vyke94O+akeOO5＞作為定點(diǎn)機(jī)構(gòu)內(nèi)部使用主鍵，如果已經(jīng)存在于醫(yī)保系統(tǒng)中，本次上傳對該條數(shù)據(jù)做失敗處理，系統(tǒng)返回錯誤信息【數(shù)據(jù)重復(fù)上傳】。4、藥品采購信息初始化上傳，前提是兩定機(jī)構(gòu)必須在【醫(yī)保兩定管理協(xié)同平臺】系統(tǒng)中已完成機(jī)構(gòu)藥品與醫(yī)保藥品目錄的對碼工作，否則上傳失敗。5、一次調(diào)用最多只允許上傳明細(xì)5O條，超過限制數(shù)量提交不成功【注:數(shù)據(jù)提交成功后，該批次上傳數(shù)據(jù)中校驗(yàn)成功的數(shù)據(jù)提交保存，校驗(yàn)失敗數(shù)據(jù)返回失敗原因】。2O19-O2-21變更6、藥品初始化的時候：上傳藥品總量不包含醫(yī)院科室的備用藥品數(shù)量（科室備

用藥品或稱之為科室暫存藥品）7、針對院外配送藥品的管理，該藥品可在《醫(yī)保兩定管理協(xié)同平臺》對碼的時候維護(hù)該類藥品標(biāo)志。本規(guī)范定義的藥品采購信息初始化、藥品入庫信息醫(yī)療機(jī)構(gòu)可自由選擇是否上傳數(shù)據(jù)；藥品出庫信息據(jù)實(shí)上傳。輸入?yún)?shù)交易輸入xml<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?>vdata>vjybm>交易服務(wù)編碼</jybm>vjyfwyh>交易訪問用戶v/jyfwyh>vjyyhyzm>交易訪問驗(yàn)證碼v/jyyhyzm>vakb020>定點(diǎn)機(jī)構(gòu)編碼</akb020><datarow><row>vyka094>醫(yī)保項(xiàng)目編碼v/yka094>vyka095>醫(yī)院項(xiàng)目名稱v/yka095>vake005>醫(yī)院對碼流水號</ake005><yke940>流水號</yke940>vyke936>是否拆零標(biāo)志v/yke936>vykf276>采購價格</ykf276><ykf278>采購數(shù)量v/ykf278></row></datarow></data>交易輸出<?xmlversion=\"1.0\"encoding=\"UTF-8\"?><result><message>錯誤信息v/message><code>返回代碼</code><datarow>

vrow>vyka094>醫(yī)保項(xiàng)目編碼</yka094>vake005>醫(yī)療機(jī)構(gòu)目錄編碼</ake005>vyke940>流水號</yke940>vaaeO13>上傳失敗原因</aaeO13></row></datarow>v/result>參數(shù)詳細(xì)說明：交易輸入：代碼名稱約束類型說明JYBM交易服務(wù)編碼NotNullVARCHAR2(20)JYFWYH交易訪問用戶NotNullVARCHAR2(20)交易訪問授權(quán)用戶JYYHYZM交易訪問驗(yàn)證碼NotNullVARCHAR2(20)交易訪問驗(yàn)證碼AKB020定點(diǎn)醫(yī)療機(jī)構(gòu)編碼NotNullVARCHAR2(20)兩定醫(yī)療機(jī)構(gòu)編碼YKA094醫(yī)保項(xiàng)目編碼NotNullVARCHAR2(20)869藥品編碼YKA095醫(yī)院項(xiàng)目名稱NotNullVARCHAR2(200)醫(yī)院內(nèi)部該項(xiàng)目名稱AKE005醫(yī)院對碼流水號NotNullVARCHAR2(20)機(jī)構(gòu)內(nèi)部使用藥品自編碼/醫(yī)院自編碼YKE940流水號NotNullVARCHAR2(50)機(jī)構(gòu)內(nèi)部唯一標(biāo)識碼YKE936是否拆零標(biāo)志NotNullVARCHAR2(6)0否；1是YKF276米購價格NotNullNUMBER(14,4)跟是否拆零標(biāo)志掛鉤YKF278采購數(shù)量NotNullNUMBER(14,4)允許負(fù)值（負(fù)值則默認(rèn)為退貨）交易輸出：代碼名稱約束類型說明AKB020定點(diǎn)醫(yī)療機(jī)構(gòu)編碼VARCHAR2(20)兩定醫(yī)療機(jī)構(gòu)編碼YKA094醫(yī)保項(xiàng)目編碼VARCHAR2(20)869藥品編碼AKE005醫(yī)療機(jī)構(gòu)目錄編碼VARCHAR2(20)機(jī)構(gòu)內(nèi)部使用碼YKE940流水號VARCHAR2(50)機(jī)構(gòu)內(nèi)部唯一標(biāo)識碼AAE013上傳失敗原因VARCHAR2探2?藥品入庫信息上傳交易名稱藥品入庫信息上傳交易分類

交易代碼cdypOOOOl交易說明1、本交易為上傳兩定機(jī)構(gòu)藥品采購入庫信息。2、流水號vyke940+ake005＞作為定點(diǎn)機(jī)構(gòu)內(nèi)部使用主鍵，如果已經(jīng)存在于醫(yī)保系統(tǒng)中，本次上傳對該條數(shù)據(jù)做失敗處理，系統(tǒng)返回錯誤信息【數(shù)據(jù)重復(fù)上傳】3、藥品入庫信息上傳，前提是兩定機(jī)構(gòu)必須在【醫(yī)保兩定管理協(xié)同平臺】系統(tǒng)中已完成機(jī)構(gòu)藥品與醫(yī)保藥品目錄的對碼工作，否則上傳失敗。4、一次調(diào)用最多只允許上傳明細(xì)50條，超過限制數(shù)量提交不成功【注:數(shù)據(jù)提交成功后，該批次上傳數(shù)據(jù)中校驗(yàn)成功的數(shù)據(jù)提交保存，校驗(yàn)失敗數(shù)據(jù)返回失敗原因】2019-02-21變更5、藥品采購渠道除了正常采購藥品之外還包括醫(yī)院自制制劑、捐贈藥品，非正常采購數(shù)據(jù)上傳時隨貨單號、供應(yīng)商名稱、供應(yīng)商許可證填寫方式有所調(diào)整，變化內(nèi)容詳細(xì)參考本交易的《參數(shù)詳細(xì)說明》內(nèi)容6、針對院外配送藥品的管理，該藥品可在《醫(yī)保兩定管理協(xié)同平臺》對碼的時候維護(hù)該類藥品標(biāo)志。本規(guī)范定義的藥品采購信息初始化、藥品入庫信息醫(yī)療機(jī)構(gòu)可自由選擇是否上傳數(shù)據(jù)；藥品出庫信息據(jù)實(shí)上傳。輸入?yún)?shù)交易輸入xml<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><data>vjybm>交易服務(wù)編碼v/jybm>vjyfwyh>交易訪問用戶v/jyfwyh>vjyyhyzm>交易訪問驗(yàn)證碼v/jyyhyzm>vakb020>定點(diǎn)機(jī)構(gòu)編碼v/akb020>vdatarow>vrow>vyka094>醫(yī)保項(xiàng)目編碼v/yka094>vyka095>醫(yī)院項(xiàng)目名稱v/yka095>vake005>醫(yī)院對碼流水號v/ake005>

vyke940>流水號v/yke940>vyke938>隨貨單號v/yke938>vyke939>生產(chǎn)日期v/yke939>vyke936>是否拆零標(biāo)志v/yke936>vykf273>供應(yīng)商名稱v/ykf273>vykf274>供應(yīng)商許可證號</ykf274>vykf275>藥品生產(chǎn)批號v/ykf275><ykf276>采購價格</ykf276><ykf277>采購發(fā)票號</ykf277><ykf278>采購數(shù)量</ykf278><ykf279>采購入庫時間</ykf279><ykf280>采購人姓名</ykf280>vykf281>藥品有效期v/ykf281>v/row>v/datarow></data>交易輸出v?xmlversion=\"1.0\"encoding=\"UTF-8\"?>vresult><message>錯誤信息v/message><code>返回代碼</code><datarow><row>vyka094>醫(yī)保項(xiàng)目編碼</yka094>vake005>醫(yī)療機(jī)構(gòu)目錄編碼</ake005><yke940>流水號</yke940><aae013>上傳失敗原因</aae013></row>

v/datarow>v/result>參數(shù)詳細(xì)說明：交易輸入：代碼名稱約束類型說明JYBM交易服務(wù)編碼NotNullVARCHAR2(20)JYFWYH交易訪問用戶NotNullVARCHAR2(20)交易訪問授權(quán)用戶JYYHYZM交易訪問驗(yàn)證碼NotNullVARCHAR2(20)交易訪問驗(yàn)證碼AKB020定點(diǎn)醫(yī)療機(jī)構(gòu)編碼NotNullVARCHAR2(20)兩定醫(yī)療機(jī)構(gòu)編碼YKA094醫(yī)保項(xiàng)目編碼NotNullVARCHAR2(20)869藥品編碼YKA095醫(yī)院項(xiàng)目名稱NotNullVARCHAR2(200)醫(yī)院內(nèi)部該項(xiàng)目名稱AKE005醫(yī)院對碼流水號NotNullVARCHAR2(20)機(jī)構(gòu)內(nèi)部使用藥品自編碼/醫(yī)院自編碼YKE940流水號NotNullVARCHAR2(50)機(jī)構(gòu)內(nèi)部唯一標(biāo)識碼YKE938隨貨單號NotNullVARCHAR2(70)必填2019-02-21變更：上傳醫(yī)院制劑信息時，隨貨單號請?zhí)顚憽搬t(yī)院制劑”上傳捐贈藥品信息時，隨貨單號填寫'捐贈藥品”YKE939藥品生產(chǎn)日期NotNullDATEYYYY-MM-DDYKE936是否拆零標(biāo)志NotNullVARCHAR2(6)0否；1是YKF273供應(yīng)商名稱NotNullVARCHAR2(200)2019-02-