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