鄭州日信電子職工醫(yī)保接口(webservices)說(shuō)明
一、接口聲明
1、 所有方法中的sessionid均為public String login(long ddyljg, String mc)返回的32為字符串;
2、 所有方法中的參數(shù)CardInfo cardInfo 均為讀卡后的結(jié)構(gòu)體;
3、 建議讀卡后,立即調(diào)用validateCardInfo(String sessionid, CardInfo cardInfo)方法效驗(yàn)卡,保證卡信息的實(shí)時(shí)性和正確性,
如果返回值是負(fù)數(shù),比如-2,標(biāo)明是黑卡,磁卡已經(jīng)掛失或者作廢,不能再使用,也不能在醫(yī)保中登記。
4、 建議在調(diào)用門診結(jié)算、門診結(jié)算預(yù)覽、住院登記、住院結(jié)算預(yù)覽、住院結(jié)算前已經(jīng)讀卡,保證讀卡數(shù)據(jù)的正確性;。
5、 本版本門診或住院結(jié)算后暫不需要寫卡。
6、日期統(tǒng)一為string類型,格式為yyyy-MM-dd HH:mm:ss;
7、數(shù)據(jù)庫(kù)為ms sqlserver 2000;
8、實(shí)際的結(jié)構(gòu)以webservice生成的的為準(zhǔn)。
9、測(cè)試wsdl地址:http://125.40.47.218:8888/zgyb/services/YBService?wsdl
服務(wù)器時(shí)間段:上午8:00---下午19:00
10、對(duì)返回結(jié)構(gòu) ResultBean 的說(shuō)明:
code :int 返回狀態(tài),0為正確,非0值為發(fā)生錯(cuò)誤
請(qǐng)參看附錄一 固定返回值
value :long 存放整形返回值,具體是否使用參看方法說(shuō)明。
message :string 存放字符型返回值,需要返回字符型數(shù)據(jù)的方法使用此字段。發(fā)生錯(cuò)誤時(shí)存放錯(cuò)誤信息。
cardInfo :CardInfo 存放需要寫卡的數(shù)據(jù),具體是否使用參看方法說(shuō)明。
11、關(guān)于“中途結(jié)算”、“出院召回”功能。
中途結(jié)算 用于跨年度連續(xù)住院者,調(diào)用后程序會(huì)自動(dòng)結(jié)算當(dāng)前年度費(fèi)用,并插入新年度住院業(yè)務(wù),相應(yīng)的會(huì)產(chǎn)生新年度的流水號(hào)(ResultBean.value)。
出院召回 用于出院結(jié)算的回退,需要中心審批通過(guò)后方可使用。
二、接口功能說(shuō)明
1、 登陸
說(shuō)明 使用接口前必須登陸,參數(shù)為定點(diǎn)醫(yī)療機(jī)構(gòu)編號(hào)和名稱,>0返回一個(gè)32為的字符串。
方法 public String login(long ddyljg, String mc)
入?yún)?nbsp; ddyljg - 定點(diǎn)機(jī)構(gòu)編號(hào)
mc - 定點(diǎn)機(jī)構(gòu)名稱
返回值 * @return 32位字符串sessionid
* "-1" 定點(diǎn)醫(yī)療機(jī)構(gòu)編號(hào)不存在
* "-2" 名稱錯(cuò)誤
* "-3" 醫(yī)院已停機(jī)(醫(yī)保中心在做年度工作,暫停醫(yī)保工作)
2、 卡管理
說(shuō)明 卡刷新
方法 public CardInfo cardRefresh(String sessionid,CardInfo cardInfo)
返回值 * @return ResultBean
* code = 0 成功,cardInfo 字段存放需要寫卡的數(shù)據(jù)。
* 其它參看附錄一。
說(shuō)明 效驗(yàn)卡,主要效驗(yàn)CardInfo信息和數(shù)據(jù)庫(kù)信息是否一致、合法等。
方法 public ResultBean validateCardInfo(String sessionid, CardInfocardInfo)
返回值 * @return ResultBean
* 參看附錄一。
說(shuō)明 卡密碼是否啟用
方法 public boolean ickmmSfqy()
返回值 * @return --true 讀卡是需要輸入密碼 --false 不需要密碼
說(shuō)明 獲取統(tǒng)籌地區(qū)編碼信息
方法 public ResultBean getTcdqbm(String sessionid)
返回值 * @return ResultBean
* code = 0 時(shí) message 存放 統(tǒng)籌地區(qū)行政編碼|統(tǒng)籌地區(qū)醫(yī)保編碼
* 其它參看附錄一。
3、 醫(yī)療項(xiàng)目
說(shuō)明 下載醫(yī)療項(xiàng)目,以HIS系統(tǒng) 建立對(duì)應(yīng)關(guān)系,對(duì)應(yīng)BH。
方法 public List getYlxm(String sessionid)
返回值 Ylxm_ZG集合(數(shù)組)
4、 門診
說(shuō)明 是否啟用慢性病門診
方法 public int isMxbmz(String sessionid)
返回值 * 1 :是 允許醫(yī)院端使用慢性病門診功能
* 0 :否
* -1 :客戶端未登錄。
說(shuō)明 門診結(jié)算預(yù)覽
方法 public Mzjsyl_ZG mzjsyl(String sessionid, CardInfo cardInfo, List< Mzmx_ZG> mzmxList, String mzlx, String jsxs)
入?yún)?nbsp; sessionid - sessionid
cardInfo - 卡信息
mzmxList - 門診明細(xì)(zxbh,dj,sl, ylfy不能為空,zffy,tyzf程序會(huì)自動(dòng)計(jì)算)
mzlx - 門診類型(普通門診、慢性病門診)
jsxs - 結(jié)算形式(帳戶|現(xiàn)金)
返回值 * @return Mzjsyl_ZG
* code = 0 數(shù)據(jù)有效
* code = -11 慢性病門診,但未開通。
* 其它參看附錄一。
說(shuō)明 門診結(jié)算
方法 public ResultBean mzjs(String sessionid, CardInfo cardInfo, Mzzz_ZG mzzz,List< Mzmx_ZG> mzmxList)
入?yún)?nbsp; sessionid - sessionid
cardInfo - 卡信息
mzzz - 門診總帳
mzmxList - 門診明細(xì),每條明細(xì)的費(fèi)用計(jì)算根據(jù)MxlrCalc來(lái)取得,也可以不計(jì)算,但zxbh,dj,sl, ylfy不能為空,zffy,tyzf程序會(huì)自動(dòng)計(jì)算)
返回值 *@return ResultBean
* code = 0 成功,value 存放流水號(hào),cardInfo字段存放需
* 要寫卡的數(shù)據(jù)
* code = -11 慢性病門診,但未開通。
* 其它參看附錄一。
說(shuō)明 門診單據(jù)撤銷
方法 public ResultBean mzdjCx(String sessionid, CardInfo cardInfo,long lsh)
入?yún)?nbsp; sessionid - sessionid
cardInfo - 卡信息
lsh - 流水號(hào)
返回值 *@return ResultBean
* code = 0 成功,value 存放沖銷流水號(hào),cardInfo字段存放
* 需要寫卡的數(shù)據(jù)
* code = -11 非法流水號(hào)。
* code = -12 醫(yī)院已結(jié)算。
* code = -13 已經(jīng)沖銷。
* 其它參看附錄一。
|
|