郑州日信电子职工医保接口(webservices)说明
一、接口声明
1、 所有方法中的sessionid均为public String login(long ddyljg, String mc)返回的32为字符串;
2、 所有方法中的参数CardInfo cardInfo 均为读卡后的结构体;
3、 建议读卡后,立即调用validateCardInfo(String sessionid, CardInfo cardInfo)方法效验卡,保证卡信息的实时性和正确性,
如果返回值是负数,比如-2,标明是黑卡,磁卡已经挂失或者作废,不能再使用,也不能在医保中登记。
4、 建议在调用门诊结算、门诊结算预览、住院登记、住院结算预览、住院结算前已经读卡,保证读卡数据的正确性;。
5、 本版本门诊或住院结算后暂不需要写卡。
6、日期统一为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 返回状态,0为正确,非0值为发生错误
请参看附录一 固定返回值
value :long 存放整形返回值,具体是否使用参看方法说明。
message :string 存放字符型返回值,需要返回字符型数据的方法使用此字段。发生错误时存放错误信息。
cardInfo :CardInfo 存放需要写卡的数据,具体是否使用参看方法说明。
11、关于“中途结算”、“出院召回”功能。
中途结算 用于跨年度连续住院者,调用后程序会自动结算当前年度费用,并插入新年度住院业务,相应的会产生新年度的流水号(ResultBean.value)。
出院召回 用于出院结算的回退,需要中心审批通过后方可使用。
二、接口功能说明
1、 登陆
说明 使用接口前必须登陆,参数为定点医疗机构编号和名称,>0返回一个32为的字符串。
方法 public String login(long ddyljg, String mc)
入参 ddyljg - 定点机构编号
mc - 定点机构名称
返回值 * @return 32位字符串sessionid
* "-1" 定点医疗机构编号不存在
* "-2" 名称错误
* "-3" 医院已停机(医保中心在做年度工作,暂停医保工作)
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 不需要密码
说明 获取统筹地区编码信息
方法 public ResultBean getTcdqbm(String sessionid)
返回值 * @return ResultBean
* code = 0 时 message 存放 统筹地区行政编码|统筹地区医保编码
* 其它参看附录一。
3、 医疗项目
说明 下载医疗项目,以HIS系统 建立对应关系,对应BH。
方法 public List getYlxm(String sessionid)
返回值 Ylxm_ZG集合(数组)
4、 门诊
说明 是否启用慢性病门诊
方法 public int isMxbmz(String sessionid)
返回值 * 1 :是 允许医院端使用慢性病门诊功能
* 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 医院已结算。
* code = -13 已经冲销。
* 其它参看附录一。
|
|