医保接口说明.doc

16佳木斯市医疗保险接口文档前言为了解决各医院医疗保险重复录入和及时冲减库存，特提供此接口，此接口采用web Service机制编写，His直接调用web service 提供的服务，读卡部分采用Com机制编写，用于读本地设备 com需要注册，注册完成后可以直接使用；所有方法返回字符串”0”都是调用方法失败，否则成功，读卡Com文件名称RReadCard.dll 注册com 用 Regsvr32 文件名 来注册；web service 提供的服务，WSDL地址及其授权号码 找医保局索要，关于各节点字节或字符字样指最大字节数/字符数 不足按实际字节填写，不能补位。双鸭山：1-12:11111/socialwebservice/n_socialwebservice.asmx佳木斯：11-115:11111/socialwebservice/n_socialwebservice.asmx 16-120:11111/socialwebservice/n_socialwebservice.asmx 一、接口流程二、接口服务函数说明 1、string of_readcard () 功能：读卡方法 参数说明：无参 返回值：返回以逗号分割的信息串，若第一个逗号之前为小于0的数值，则读卡失败否则返回读卡信息；调用位置：读卡验证信息前调用；备注：此方法有Com提供，读写本地设备 第一个逗号之前返回参数的个数，第一个逗号和第二逗号之间为IC卡号 第二个逗号后为人员编号或身份证号，如何IC卡号和人员编号或身份证号相等为逻辑存储卡 否则为金宝卡。3,A8510004600004,8510004600004,000000若是型号为MT3-KB（规格：MT3-MD-R313-KB-SB）读卡器上带有密码键盘请调用of_readpass方法，接收键盘输入的密码，然后通过方法webservice 的of_veritypassword验证密码输是否正确 关于of_veritypassword详见12。String of_readpass(int ai_type)功能：返回键盘输入的密码参数说明：入参 ai_type 若为1 提示请输入密码 2 提示再次输入密码例如:String Ls_pass/变量ls_code (个人编号) of_Getaccountinfo 获取String ls_code Int li_errLs_pass = of_readpass ()ls_parameters = + + ls_code + + ls_pass + li_err = of_veritypassword(ls_parameters, ls_result, ls_message)if li_err = 0 then /错误提示end ifof_getreport(string as_hospcode)功能：申报表打印参数说明：入参 as_hospcode 医院代码String of_setdevicetype()功能：调去读卡器设置以下由WEB SERVICE提供2、integer of_getaccountinfo (string as_icno, string as_insurance, string as_hospcode, string as_date, ref string as_result, ref string as_message) 功能：根据卡号读信息方法 参数说明：入参： as_icno 读卡得到的卡号及其他信心的xml字符串，详见as_icno详细说明 As_Insurance 险种1、职工医疗 3、职工意外 4、工伤保险 6、离休人员 9、居民保险 as_hospcode 授权代码 此代码向医保局索要 as_date 验证时间 即系统时间 格式YYYY-MM-DD出参：as_result 读信息结果，详见as_result 详细说明 as_message 返回状态错误说明，其他web service 服务都提供此说明 返回值：返回”0”失败，否则成功调用位置：读卡后调用；as_icno详细说明节点描述备注说明IdcardIC卡号读卡得到第一个逗号和第二个逗号之间的数据Code代码或身份证读卡得到的第二个逗号后的数据Insurance保险类别1、职工医疗 3、职工意外 4、工伤保险 6、离休人员 9、居民保险Hospcode医院代码人民医院为 00053sysdate发生日期格式 YYYY-MM-DDXml格式 066660060000106666006000011999072015-01-01备注：所有XML参数传递都遵照此格式as_result 详细说明节点描述备注说明姓名姓名卡号卡号社会保障号社会保障号个人编号个人编号原号码原号码身份证号身份证号性别性别1、男 2、女出生日期出生日期人员类别人员类别03 退休 05 在职 04 离休 06 老工人及老兵 11 异地在职 12 异地退休保险类别保险类别1、职工医疗 3、意外 4、工伤 9、居民医院代码医院代码行政区划行政区划单位编号单位编号单位名称单位名称单位状态单位状态卡密码卡密码在院标志在院标志1 在院 0、不在院职工职务职工职务缴费类型缴费类型参保状态参保状态1、有效 可以看病 否则不能慢性病疾病代码慢性病疾病代码慢性病疾病名称慢性病疾病名称慢性病标志慢性病标志1、是 0、否慢性病限额慢性病限额慢性病比例慢性病比例大额标志大额标志1、是 0、否工伤部位工伤部位门诊统筹起付线累计门诊统筹起付线累计门诊统筹支付累计门诊统筹支付累计门诊统筹医疗费累计门诊统筹医疗费累计门诊慢性病起付线累计门诊慢性病起付线累计门诊慢性病支付累计门诊慢性病支付累计门诊慢性病医疗费累计门诊慢性病医疗费累计住院次数累计住院次数累计基本统筹累计基本统筹累计基本医疗费累计基本医疗费累计大额统筹累计大额统筹累计大额医疗费累计大额医疗费累计账户金额账户金额账户支付账户支付账户余额账户余额意外伤害支付累计意外伤害支付累计意外伤害医疗费累计意外伤害医疗费累计享受待遇截止时间享受待遇截止时间初始化标志初始化标志1、是 0、否3、integer of_calccloud (string as_parameters, ref string as_xmlstring, ref string as_result, ref string as_message) 功能：结算方法，门诊、住院均适用 参数说明： 入参：as_parameters 结算要传入的参数 各节点说明详见as_parameters 详细说明 as_xmlstring 结算要传入的费用明细（适用门诊 住院此参数传入null） 各节点说明详见as_ as_xmlstring详细说明出参：as_result 结算结果，详见as_result详细说明as_message 错误信息说明 返回值：返回”0”失败，否则成功传入参数 as_parameters 详细说明 各节点说明如下节点描述备注说明ickhIc卡号不能为空 ；20字节pdh凭单号在调用结算方法时of_calccloud 可以为空在调用存盘方法of_save时不能为空，此凭单号由of_calccloud 的返回(在as_result中)； 20字节yybh医院编号/授权代码不能为空； 8字节grbh个人编号不能为空； 20字节bxlb保险类别 不能为空1、职工医疗 3、职工意外 4、工伤 9、居民jbbm疾病代码门诊慢性病 门诊特检 门诊肾透析 住院 不能为空，其他可以为空；16字节 需要作对照fzbm辅助疾病可以为空；16字节pdlx凭单类型不能为空 1、门诊 2、住院；1字节sfyzh是否用账户个人账户顶付个人负担部分 1、可以支付，0、 不能支付；1字节ywbz意外标志是否是意外伤害 1、是 0、否 双鸭山填0；1字节ysbm医师编码可以为空；7字节ysmc医师名称可以为空；20字节zwksmc中文科室名称住院不能为空 其他可以为空；20字节fsrq发生日期不能为空 格式YYYY-MM-DDsnbz上年标志不能为空 填写0；1字节zljg治疗结果住院不能为空 1、好转 2、治愈 5 死亡zyts住院天数住院不能为空 门诊可以填写0；3字节dbzbz单病种标志双鸭山填写 0；1字节zyh住院号本医院病历号 住院不能为空 门诊为空；10字节zyxh住院序号指病人在本医院住过几次院 住院不能为空 门诊为空；10字节czy操作员不能为空；10字节cyrq出院日期住院不能为空 门诊可以为空 格式YYYY-MM-DD；10字节cyks出院科室住院不能为空 门诊不填写；4字节cybf出院病房住院不能为空 门诊不填写；4字节fph发票号在调用结算方法时of_calcclou可以为空 His的单据号/发票号在调用存盘方法of_saves时不能为空； 20字节Ryrq入院日期住院不能为空 门诊可以为空 格式YYYY-MM-DD；10字节Zzzybm转诊编码此节点HIS填写空串”Yyjb医院级别此节点HIS填写空串”Babm病案编号病案号 fdjsbz分段结算标志分段结算标志 0 不是 1 是qfxye起付线累计金额分段结算起付线已付累计金额 填写0bz备注备用入出参数 as_xmlstring 详细说明(门诊费用节点)节点名称描述备注Id流水号本次序列号, 纯数字字符11位Xh流水序号本次序列号产生的数量序号，数值流水号5位Xmbm项目代码药品/诊疗项目代码（医保），字符16位 需要对照Mc名称项目名称，字符80字节Gg规格药品规格，字符30Jx剂型4字节Dw单位10字节Dj 单价数值10，小数4位Sl数量数值10，小数2位Je金额数值10，小数2位Zhzf账户支付数值10，小数2位 填写0Grfd个人负担数值10，小数2位 填写0Rq日期格式yyyy-mm-ddTflag三特标志1字节 填写0Xmh项目号4字节 填写1069Sp_tag审批标志1字节 填写0Glxe项目限额10字节 小数2位 填写0Dflag目录标志1字节 填写0出参as_result 详细说明节点名称描述备注凭单号凭单号医院编号医院编号总费用总费用自费费用自费费用三特自负三特自负乙类自负乙类自负特检自负特检自负特治自负特治自负外医自负外医自负住院次数累计住院次数累计起付线起付线封顶线以上封顶线以上账户支付账户支付账户余额账户余额基本统筹支付基本统筹支付大额统筹支付大额统筹支付基本医疗费基本医疗费大额医疗费大额医疗费基本统筹累计基本统筹累计大额统筹累计大额统筹累计单病种统筹单病种统筹差额差额一段统筹支付一段统筹支付可选使用一段比例自付一段比例自付可选使用二段统筹支付二段统筹支付可选使用二段比例自付二段比例自付可选使用三段统筹支付三段统筹支付可选使用三段比例自付三段比例自付可选使用四段统筹支付四段统筹支付可选使用四段比例自付四段比例自付可选使用五段统筹支付五段统筹支付可选使用五段比例自付五段比例自付可选使用六段统筹支付六段统筹支付可选使用六段比例自付六段比例自付可选使用七段统筹支付七段统筹支付可选使用七段比例自付七段比例自付可选使用一段起始一段起始可选使用一段截止一段截止可选使用二段起始二段起始可选使用二段截止二段截止可选使用三段起始三段起始可选使用三段截止三段截止可选使用四段起始四段起始可选使用四段截止四段截止可选使用五段起始五段起始可选使用五段截止五段截止可选使用六段起始六段起始可选使用六段截止六段截止可选使用七段起始七段起始可选使用七段截止七段截止可选使用出参as_message 详细说明如果返回正确，此返回结果值对应医保表结构结果，可选4、integer of_setiteminfo_ex (string as_parameters, ref string as_result, ref string as_message) 功能：住院费用明细传入方法 参数说明：入参：as_parameters 住院费用明细xml字符串 ； 出参：as_result 住院费用明细xml字符串；as_message 遵照xml格式的字符串 ； 返回值：返回”0”失败 否则成功as_parameters和as_result字符串各节点说明节点名称描述备注Input001住院号字符10位Input002住院序号数值10Input003单据号字符20 主键之一Input004项目编码字符16Input005序号数值5 主键之一Input006日期 格式YYYY-MM-DDInput007项目名称字符100Input008规格 字符30Input009剂型 字符4Input010单位 字符10Input011数量 10位 小数2Input012单价10位 小数2Input013金额10位 小数2Input014三特标志字符1可以为空Input015审批标志 1审批 0 未审批Input016NULL字符1Input017目录内标志 NULL字符1Input018适应症标志 NULL字符1Input019所退费流水号NULL字符20Input020授权代码不能为空Input021保险类别不能为空 医疗填写1 工伤填写4 意外填写 3Input022医师代码字符10主键之一Input023医师名称字符100Input024单据类型填写04 字符4Input025项目类别填写11 字符2Input026结算分类1 基本 3 意外 4 工伤5、integer of_save (string as_parameters, ref string as_xmlstring, ref string as_result, ref string as_message)功能：保存方法 参数说明：入参：as_parameters各节点说明详见as_parameters 详细说明； 出参：as_xmlstring 各节点说明 详见as_xmlstring详细说明；as_result 各节点说明详见as_result 详细说明； as_message 描述出错信息； 返回值：返回”0”失败，否则成功；as_parameters 详细说明详见 3 的as_parameters 详细说明as_xmlstring详细说明 出院明细清单 可选使用 如有需要联系医保开发商as_result 详细说明 出院结算清单 可选使用如有需要联系医保开发商6、integer of_blankoutvoucher (string as_parameters, ref string as_xmlstring, ref string as_result, ref string as_message)功能：门诊及住院红冲方法 参数说明：入参：as_parameters 详见 as_parameters详细说明； 出参：as_xmlstring备用； as_result 备用； as_message 对错误的说明；返回值：返回”0”失败，否则成功；as_parameters详细说明节点描述备注说明ickhIc卡号不能为空 ；20字节pdh凭单号不能为空结算时返回的凭单号yybh医院编号/授权代码不能为空； 8字节grbh个人编号不能为空； 20字节bxlb保险类别 不能为空1、职工医疗 3、职工意外 4、工伤 9、居民jbbm疾病代码可为空fzbm辅助疾病可为空pdlx凭单类型可为空sfyzh是否用账户可为空ywbz意外标志可为空ysbm医师编码可为空ysmc医师名称可为空zwksmc中文科室名称可为空fsrq发生日期可为空snbz上年标志可为空zljg治疗结果可为空zyts住院天数可为空dbzbz单病种标志可为空zyh住院号本医院病历号 住院不能为空 门诊为空；10字节zyxh住院序号指病人在本医院住过几次院 住院不能为空 门诊为空；10字节czy操作员不能为空；10字节cyrq出院日期可为空cyks出院科室可为空cybf出院病房可为空fph发票号不能为空； His的单据号/发票号Ryrq入院日期可以为空Zzzybm转诊编码此节点HIS填写空串”Yyjb医院级别此节点HIS填写空串”Babm病案编号病案号 可以为空fdjsbz分段结算标志可以为空qfxye起付线累计金额可以为空bz备注备用7、integer of_healthstart (string as_parameters, ref string as_result, ref string as_message)功能：康复档案传入方法 参数说明：入参 ：as_parameters出参 ：as_result 备用 as_message 对错误信息说明 返回值：返回”0”失败，否则成功调用位置：在建立病人健康档案时调用，无此档案使用康复项目将不予报销 节点中文描述备注ShbzhSfzhXmDwbhCsrqJbbmKfkssjKfjzsjkfjsbzKflxXfbbzSfyeKsxm1Kfxm2XtsjKfbmKfxhKfksYsYybhPdhBxlbXzqhdmRylbLxdhLxrCsbzZfbz社会保障号身份证号姓名单位编号出生日期疾病编码康复开始时间康复截止时间康复结束标志康复类型新发病标志是否婴儿康复项目康复项目系统时间康复编码康复序号康复科室医师医院编号凭单编号保险类别行政区划人员类别联系电话联系人传输标志作废标志读卡获取读卡获取读卡获取读卡获取读卡获取初始化01-是 0-否1-是 0-否读卡获取读卡获取读卡获取读卡获取初始化08、integer of_setinhosp_ex (string as_parameters, ref string as_result, ref string as_message)功能：入院登记传入方法 参数说明：入参：as_ parameters 详见 as_ parameters详细说明 出参：as_result 备用 as_message 对错误信息说明 返回值：返回”0”失败，否则成功as_ parameters详细说明节点名称描述备注Input001住院号 不能为空 字符7位Input002住院序号 不能为空 数值10位Input003姓名 字符30位Input004性别 不能为空 字符1位1、男 2、女Input005出生日期不能为空 格式YYYY-MM-DDInput006社会保障号 不能为空 字符20位Input007单位编号 不能为空 字符10位Input008医院编号 不能为空 字符10位Input009人员类别 不能为空 字符2位Input010入院日期不能为空 格式YYYY-MM-DDInput011科别 不能为空 对照 字符20位Input012病房 不能为空 字符20位 对照可以为空Input013年龄不能为空 数值5位Input014入院诊断 不能为空 字符11位Input015行政区划 字符10位不能为空字符10位Input016备注0Input017转院标志 不能为空 字符1 初始化0Input018意外伤害不能为空 字符1 初始化0Input019保险类别不能为空 字符1； 医疗保险填写1； 工伤填写4 ；意外填写3Input020身份证号不能为空 18字节Input021病案号不能为空 最大20字节9、integer of_setouthospital (string as_parameters, ref string as_result, ref string as_message)功能：退院方法 参数说明：入参：as_parameters 详见 as_parameters 详细说明 出参：as_result 备用 as_message 错误信息说明 返回值：返回”0”失败，否则成功 as_parameters 详细说明节点描述备注说明IckhIc卡号Pdh凭单号可以为空Yybh医院编号/授权代码不能为空； 8字节Grbh个人编号不能为空； 20字节Bxlb保险类别 不能为空1、职工医疗 3、职工意外 4、工伤 9、居民Jbbm疾病代码可为空Fzbm辅助疾病可为空Pdlx凭单类型可为空sfyzh是否用账户可为空ywbz意外标志可为空Ysbm医师编码可为空ysmc医师名称可为空zwksmc中文科室名称可为空Fsrq发生日期可为空Snbz上年标志可为空Zljg治疗结果可为空Zyts住院天数可为空dbzbz单病种标志可为空Zyh住院号本医院病历号 住院不能为空 门诊为空；10字节Zyxh住院序号指病人在本医院住过几次院 住院不能为空 门诊为空；10字节Czy操作员不能为空；10字节Cyrq出院日期可为空Cyks出院科室可为空Cybf出院病房可为空Fph退院指令当为0时 退上传住院费用明细 为1时 费用明细及其入院登记全部退掉Ryrq入院日期可以为空Zzzybm转诊编码可以为空Yyjb医院级别可以为空Babm病案编号可以为空fdjsbz分段结算标志可以为空Qfxye 起付线累计金额可以为0Bz备注可以为空11、integer of_getexamine (string as_type, string as_code, ref string as_sresult, ref string as_smessage)功能：获取各类字典目录参数说明: 入参 as_type 调取类型代码 1、药品字典 2、诊疗项目字典 3、疾病字典 4、剂型 5、医师 6、科室 7、备用 8、备用 9、人员类别 10、备用 11、行政区划 12、备用 as_code ：医院代码；可以为空出参：as_sresult 详见 各种节点说明 as_smessage 错误信息说明返回值：返回”0”失败，否则成功12、integer of_getinsurance (string as_icno, ref string as_sresult, ref string as_smessage)功能：获取保险类别 只使用职工医疗和居民医疗保险 如果此人是工伤保险或职工意外保险不适用参数说明: 入参as_icno卡号 as_result 身份证号/医疗保险号 出参：as_sresult 1、职工医疗 9、居民医疗 as_smessage 错误信息说明返回值：返回”0”失败，否则成功补充说明：医疗保险和工伤保险及职工意外保险同时并存 此方法只能选择调用，建议HIS先做一险种列表框，当操作选择工伤或职工意外时，此方法不用调用，否则调用此方法获取此人是职工医疗保险或居民医疗保险 反向把取到的值放回到列表框中，HIS再从列表框取出 做相应处理 列表框险种 1、职工医疗保险； 3、职工意外伤害保险； 4、工伤保险； 6、离休人员保险； 9、居民医疗保险 其他在本接口是无效保险标志。13、integer of_sum (string as_parameters, ref string as_sresult, ref string as_smessage)功能：获取已上传的住院费用明细数量及金额参数说明: 入参as_ parameters 详细说明 出参：as_sresult 详细说明 as_smessage 错误信息说明返回值：返回”0”失败，否则成功详细说明 parameters入参及sresult出参节点名称描述备注ZYH住院号主键ZYXH住院序号主键YYBH医院编号主键SL数量JE金额药品 as_sresult Xml字符串各节点说明节点名称描述备注CZM操作码主键GJM国际码对照码GBM国标码辅助码DFM地方码辅助码XMBM项目编码一级项目归类码GFBZ甲类标志标志为1甲类 否则自费GZYP乙类标志标志为1乙类 ZZBZ目录标志标志为1正在使用目录ZWTYM名称BXFW限额HXSJBZ备用HJ_TAG适应症标志CZMLB操作码类别分类码TYM_PYM拼音码诊疗项目 Xml字符串各节点说明节点名称描述备注CZM操作码主键对照码GJM国际码GBM国标码辅助码DFM地方码辅助码FLAG正在使用目录标志一级项目归类码TJTZBZ特检特治标志0、常规 2、特检 3、特治 4、自费 5、限额 6、一般诊疗 7、康复项目 8、工伤项目XMBM项目编码一级项目归类码MC名称GLXE限额CZMLB操作码类别PYM拼音码疾病字典 Xml字符串各节点说明 节点名称描述备注CZM操作码主键对照码GJM国际码辅助码