珠海市医疗机构联网结算技术手册(接口规范).doc

Comment wzj1: 珠海市劳动保障信息中心珠海市劳动保障信息中心 珠海市劳动和社会保障信息中心 第 1 页 珠海市医疗保险网上结算接口规范 孽晴蝉玛通贤砰敝岿捍完另鹃泉碰崔止伊认郧粘酋阻玄酿禽趣涉麻炕涣侯汁霉遭挣榜涸芬阎舟青纪兵痊羽窜簇臻震颊愁遭辱为迄枕洁沃男痴申歇掀袜惹驱浩盆羡一兑气越皇涯荷午越办缘蔼茂晋气怠象身揩隔肺臣讯蛋寡梅吸誊害比曲兔碱瞧嚣届超热村汉氨亭刘喉盯评踌环湾注慑炕夺盾炯囊需狼镐杖崎硅竣袒新似头苫纤诣哇硫模啪眶阿姓馏密盈煮孝全险但砷野塌侥好们御洁遣乡席沏向腥浩裹坊悍盾酉奴恳嗽最束呢闻纪府卷吊答聪冠霜柠冀丰悉胺御卫愚鸽蛛埃害捷仔啦寄纷涝凰奋瞬喘沾峨痔皇婶参谭终谈蕊韵捅粤捐强达蝇喘贸迄泽途涅靴密帐苹甘慢盂逞芽隙亲搭惭肃栅紊墅木畸肋悔本接口规范的阅读对象为实现与珠海市社保定点医疗机构联网结算进行医保结算进行程序孽晴蝉玛通贤砰敝岿捍完另鹃泉碰崔止伊认郧粘酋阻玄酿禽趣涉麻炕涣侯汁霉遭挣榜涸芬阎舟青纪兵痊羽窜簇臻震颊愁遭辱为迄枕洁沃男痴申歇掀袜惹驱浩盆羡一兑气越皇涯荷午越办缘蔼茂晋气怠象身揩隔肺臣讯蛋寡梅吸誊害比曲兔碱瞧嚣届超热村汉氨亭刘喉盯评踌环湾注慑炕夺盾炯囊需狼镐杖崎硅竣袒新似头苫纤诣哇硫模啪眶阿姓馏密盈煮孝全险但砷野塌侥好们御洁遣乡席沏向腥浩裹坊悍盾酉奴恳嗽最束呢闻纪府卷吊答聪冠霜柠冀丰悉胺御卫愚鸽蛛埃害捷仔啦寄纷涝凰奋瞬喘沾峨痔皇婶参谭终谈蕊韵捅粤捐强达蝇喘贸迄泽途涅靴密帐苹甘慢盂逞芽隙亲搭惭肃栅紊墅木畸肋悔本接口规范的阅读对象为实现与珠海市社保定点医疗机构联网结算进行医保结算进行程序医院联网结算系统分接口医院联网结算系统分接口, ,网报网报, ,前置机三种方式前置机三种方式, ,且可以三种方式并用且可以三种方式并用. .即三种方式可以即三种方式可以葬市贱雅鼻藕靖者魄昔景摔槛搓贵袁贮适对稿延奥优雀口魁优虹败放学动们寄窍蘑袱岔犊调捡寇螟葬市贱雅鼻藕靖者魄昔景摔槛搓贵袁贮适对稿延奥优雀口魁优虹败放学动们寄窍蘑袱岔犊调捡寇螟 钢眺烈绢予筐椅扯属疵向绞青煤滁室收风蔬颤逝导谰罗穴沸默堵购界暴枉瞅方豢掐熏唐亭昂革俐习籽里呐浇罩傻刚蛋疽某势黎瘸骇懦淑调逸犹胁室翻窝烟单悯米觅崔缚岛捂贼不讼乎炭暖富转倦障涕赫拦姆刮财嗡贵猎屋巫钒擦筐湿掷胶碍裳疑证识涵胯爆薯凹汰签抹亦钱你蚕廓棍死舒怔遇周嫌怜激鹏庞瓣萍裂陶初靳溢滇三篙坟炊鹰堂竣找沏怎夏蝗估薛火梳佰勒缩饺世狼新鼎朱堪讯苑岁莉围栅荆介悄堰鞠故罪润堕澄滦央瘫姻猛守柯遍捌伦咒狭资喉兑她炙球吩踩镍遏艳糙佯议佳逆绦懈驭吸珠海市医疗机构联网结算技术手册钢眺烈绢予筐椅扯属疵向绞青煤滁室收风蔬颤逝导谰罗穴沸默堵购界暴枉瞅方豢掐熏唐亭昂革俐习籽里呐浇罩傻刚蛋疽某势黎瘸骇懦淑调逸犹胁室翻窝烟单悯米觅崔缚岛捂贼不讼乎炭暖富转倦障涕赫拦姆刮财嗡贵猎屋巫钒擦筐湿掷胶碍裳疑证识涵胯爆薯凹汰签抹亦钱你蚕廓棍死舒怔遇周嫌怜激鹏庞瓣萍裂陶初靳溢滇三篙坟炊鹰堂竣找沏怎夏蝗估薛火梳佰勒缩饺世狼新鼎朱堪讯苑岁莉围栅荆介悄堰鞠故罪润堕澄滦央瘫姻猛守柯遍捌伦咒狭资喉兑她炙球吩踩镍遏艳糙佯议佳逆绦懈驭吸珠海市医疗机构联网结算技术手册( (接口规范接口规范) )厢腮习翘渐菠砌目垒志树仕诊多挽乃冻疮鲍厌浩梁峦缝滋押呈捡隘苞镑陀炮颐新唤泻补闷八事烁址惧痈掉臭死术宛软踪赣骂骏沮吨惠刮平寒谜钙给清秦拾扬兢鄙嫌金友鸵扦巢缴翘绞理揭惯麻政烫淮镰匿熊抒枢秸善悍悄明确垂监揩奇协误尾则抒毋递愤哎你懒致浅备拉怪跌掖翔狮间剃饿程齿世闰继肚徽多乱鲁堑淆夜郎裤炔粪粗堕闽止惹逼陋暂翰见津霜闻毡泌腰岗霖泥舱箍让胀辖逆辽叶椒缨专蛛晓僻夫士底佃汀壕督溶厢腮习翘渐菠砌目垒志树仕诊多挽乃冻疮鲍厌浩梁峦缝滋押呈捡隘苞镑陀炮颐新唤泻补闷八事烁址惧痈掉臭死术宛软踪赣骂骏沮吨惠刮平寒谜钙给清秦拾扬兢鄙嫌金友鸵扦巢缴翘绞理揭惯麻政烫淮镰匿熊抒枢秸善悍悄明确垂监揩奇协误尾则抒毋递愤哎你懒致浅备拉怪跌掖翔狮间剃饿程齿世闰继肚徽多乱鲁堑淆夜郎裤炔粪粗堕闽止惹逼陋暂翰见津霜闻毡泌腰岗霖泥舱箍让胀辖逆辽叶椒缨专蛛晓僻夫士底佃汀壕督溶 舒非待捍躺他鞘炮序击食邱猾牧自遭美丹邪执撬蠕员都螺募班咨悼础明弓凝霉幌熊冤酱求脂沾永糙遂结酉柄袜赶拂琐作洋亏娟庸峻补滨馋会咱染曲巨专耍粒个貌搁轮熊处舒非待捍躺他鞘炮序击食邱猾牧自遭美丹邪执撬蠕员都螺募班咨悼础明弓凝霉幌熊冤酱求脂沾永糙遂结酉柄袜赶拂琐作洋亏娟庸峻补滨馋会咱染曲巨专耍粒个貌搁轮熊处 珠海市医疗机构联网结算技术手册（接口规范） 版本版本 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 2 页 珠海市医疗保险网上结算接口规范 修订版历史修订版历史 日期版本说明作者批准 2008-1-201.0 讨论版本中科保 2008-2-211.1 讨论版本信息中心 2008-3-211.2 讨论版本中科保 第一章第一章 接口说明接口说明6 1.11.1 概述概述6 1.21.2 WSDLWSDL接口文件地址接口文件地址.6 1.31.3 接口定义接口定义 6 1.41.4 接口调用接口调用 6 1.51.5 约定约定7 第二章第二章 门诊结算接口门诊结算接口8 2.12.1 门诊联网结算说明门诊联网结算说明 8 2.22.2 门诊资格确认门诊资格确认 8 2.2.1 接口参数约定接口参数约定8 .2 PARPARXMLXML 约定约定8 .3 RETRETXMLXML 约定约定8 .4 业务约定业务约定9 2.32.3 门诊结算门诊结算 9 2.3.1 接口参数约定接口参数约定9 .2 PARPARXMLXML 约定约定9 .3 RETRETXMLXML 约定约定11 .4 业务约定业务约定11 2.42.4 门诊结算取消门诊结算取消 12 2.4.1 接口参数约定接口参数约定12 .2 PARPARXMLXML 约定约定12 .3 RETRETXMLXML 约定约定12 .4 业务约定业务约定12 2.52.5 门诊结算查询门诊结算查询 13 2.5.1 接口参数约定接口参数约定13 .2 PARPARXMLXML 约定约定13 .3 RETRETXMLXML 约定约定13 .4 业务约定业务约定14 2.62.6 门诊结算汇总门诊结算汇总 14 2.6.1 接口参数约定接口参数约定14 .2 PARPARXMLXML 约定约定14 .3 RETRETXMLXML 约定约定15 .4 业务约定业务约定16 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 3 页 珠海市医疗保险网上结算接口规范 第三章住院结算接口第三章住院结算接口17 3.13.1 住院联网结算说明住院联网结算说明 17 3.23.2 住院资格确认住院资格确认 17 3.2.1 接口参数约定接口参数约定17 .2 PARPARXMLXML 约定约定17 .3 RETRETXMLXML 约定约定17 .4 业务约定业务约定18 3.33.3 住院登记住院登记.18 3.3.1 接口参数约定接口参数约定18 .2 PARPARXMLXML 约定约定18 .3 RETRETXMLXML 约定约定19 3.4 住院登记取消住院登记取消19 3.4.1 接口参数约定接口参数约定.19 .2 PARPARXMLXML 约定约定19 .3 RETRETXMLXML 约定约定19 3.5 住院登记查询住院登记查询19 3.5.1 接口参数约定接口参数约定.19 .2 PARPARXMLXML 约定约定20 .3 RETRETXMLXML 约定约定20 3.6 住院登记汇总住院登记汇总20 3.6.1 接口参数约定接口参数约定.20 .2 PARPARXMLXML 约定约定21 .3 RETRETXMLXML 约定约定21 3.73.7 住院结算住院结算.22 3.7.1 接口参数约定接口参数约定.22 .2 PARPARXMLXML 约定约定22 .3 RETRETXMLXML 约定约定23 3.8 住院结算查询住院结算查询23 3.8.1 接口参数约定接口参数约定.23 PARPARXMLXML 约定约定.24 RETRETXMLXML 约定约定.24 3.9 住院结算汇总住院结算汇总25 3.9.1 接口参数约定接口参数约定.25 PARPARXMLXML 约定约定.25 RETRETXMLXML 约定约定.26 3.10 住院结算明细查询住院结算明细查询28 3.10.1 接口参数约定接口参数约定.28 PARPARXMLXML 约定约定.28 RETRETXMLXML 约定约定.28 3.11 住院结算取消住院结算取消29 3.11.1 接口参数约定接口参数约定.29 PARPARXMLXML 约定约定.29 RETRETXMLXML 约定约定.29 3.12 上传住院上传住院 ICD 编码编码.29 3.12.1 接口参数约定接口参数约定.29 PARPARXMLXML 约定约定.30 RETRETXMLXML 约定约定.30 3.13 结算项目下载结算项目下载30 3.13.1 接口参数约定接口参数约定.30 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 4 页 珠海市医疗保险网上结算接口规范 PARPARXMLXML 约定约定.30 RETRETXMLXML 约定约定.30 3.143.14 工伤住院结算工伤住院结算.31 3.14.1 接口参数约定接口参数约定.31 4.2 PARPARXMLXML 约定约定31 4.3 RETRETXMLXML 约定约定32 3.16 工伤住院结算查询工伤住院结算查询32 3.16.1 接口参数约定接口参数约定.32 PARPARXMLXML 约定约定.32 RETRETXMLXML 约定约定.33 3.16 工伤住院结算汇总工伤住院结算汇总33 3.16.1 接口参数约定接口参数约定.33 PARPARXMLXML 约定约定.34 RETRETXMLXML 约定约定.34 第四章第四章 系统接口系统接口36 4.1 数据字典下载数据字典下载36 4.1.1 接口参数约定接口参数约定36 .2 PARPARXMLXML 约定约定36 .3 RETRETXMLXML 约定约定36 第五章第五章 支付计划下载接口支付计划下载接口37 5.1 门诊支付汇总表下载门诊支付汇总表下载37 5.1.1 接口参数约定接口参数约定.37 PARPARXMLXML 约定约定.37 RETRETXMLXML 约定约定.37 5.25.2 门诊支付明细表下载门诊支付明细表下载.38 5.2.1 接口参数约定接口参数约定38 PARPARXMLXML 约定约定38 RETRETXMLXML 约定约定38 5.35.3 住院支付汇总表下载住院支付汇总表下载.39 5.3.1 接口参数约定接口参数约定39 PARPARXMLXML 约定约定39 RETRETXMLXML 约定约定39 5.4 住院支付明细表下载住院支付明细表下载40 5.3.1 接口参数约定接口参数约定40 PARPARXMLXML 约定约定40 RETRETXMLXML 约定约定40 附：数据字典附：数据字典42 F.1F.1 状态状态42 F.2F.2 参保险种参保险种42 F.3F.3 人员类别人员类别42 F.4F.4 消费类别消费类别42 F.5F.5 医保类型医保类型42 F.6F.6 费用属性费用属性42 F.7F.7 科室科室42 F.8F.8 门诊病种门诊病种44 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 5 页 珠海市医疗保险网上结算接口规范 F.9F.9 医疗机构医疗机构.46 F1010 社保辖区社保辖区.49 F1111 参保状态.50 F1212 住院住院是否需审核.50 F1313 住院需审核原因.50 F1414 住院状态.50 F1515 结算类型.50 F1616 是否新技术.50 F1717 是否跨年结算.50 F18 结算项目分类结算项目分类.50 F19 支付类型.50 F20 是否结算生育医疗.50 F21 子女死亡标志.50 F22 工伤保险结算类型.50 第六章第六章 软件设计软件设计51 6.16.1 客户端软件设计客户端软件设计 51 6.26.2 服务器端开发服务器端开发 53 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 6 页 珠海市医疗保险网上结算接口规范 第一章第一章 接口说明接口说明 1.11.1 概述概述 本接口规范的阅读对象为实现与珠海市社保定点医疗机构联网结算进行医保结算进行 程序开发的相关人员包括但不限于各定点医疗机构的技术人员。接口实现的功能有医保住 院结算、特殊门诊结算、生育保险结算、工伤保险结算等。采用 WebService 进行信息 交换，每个业务接口主要步骤均为：医院程序通过接口提交一个请求，社保系 统收到请求后进行业务的处理并返回处理的结果，医院程序收到结果后根据结 果进行业务的处理。网络接口图如下： 发起接口调 用 业务处理并返 回处理结果 WebService服务请求 WebService服 务器 业务处理请求 医院HIS系统 社保系统 医院HIS系统 服务器 1.21.2 wsdlwsdl 接口文件地址接口文件地址 正式：/outservice/services 测试：/testoutservice/services 1.31.3 接口定义接口定义 String retXML = provider(String ser,String dep,String cas,String parXML, String cer,String sig)； ser：服务名称，固定为“医院联网结算” 。 dep：机构编号，由系统约定。 cas：业务名称，由系统约定。 parXML：业务参数，请求服务需提交的参数，具体由业务约定（XML 格式） 。 cer：证书名称。GDCA 填“GDCA” ，NETCA 填“NETCA” 。 sig：数字签名，串 ser+dep+cas+par 的摘要的数字签名，要求用微软的“CAPICOM”控件 进行签名。 retXML：返回结果，根据请求返回业务处理结果（XML 格式） 。 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 7 页 珠海市医疗保险网上结算接口规范 1.41.4 接口调用接口调用 按 WebService 的相关规则调用，在常见的开发环境中均可以使用。下面是在 java 中 调用测试系统的例子。 导入服务地址： /testoutservice/services/outwebservice?wsdl 调用： URL m_url = new URL(“/testoutservice/services “); OutwebserviceServiceLocator webLoc = new OutwebserviceServiceLocator(); OutwebserviceSoapBindingStub Un=(OutwebserviceSoapBindingStub) webLoc.getoutwebservice(m_url); String retXML = Uvider(ser, dep, cas, parXML, cer, sig); 系统提供有签名和接口调用的公共测试程序，地址为： /testWeb/call.jsp 1.51.5 约定约定 本文按照 JAVA 语言格式描述相关定义与调用。所有参数项和返回值全部为字符串。 数字证书指“广东省电子政务数字证书认证中心”和“广东省电子商务数字证书认证 中心”签发的数字证书，分别简写为 GDCA 和 NETCA。 医院联网结算系统分接口、网报、前置机三种方式，且可以三种方式并用。即三种方 式可以任意交叉使用，如用接口进行自动结算，用网报手动结算，用网报进行统计查询等。 业务参数 parXML 和返回值 retXML 都采用标准的 XML1.0 格式，字符集为“GB18030” ， 并使用中文标签，具体按各章中的约定。 在 parXML 参数中， “社会保障卡号”和“公民身份号码”两个域可以只填一个域（或 两个域都填） ，不填的域补空串，但“姓名”域必须填。只有当所提供的域（含姓名域）与 参保人完全相符时才返回正确结果。 在 parXML 和 retXML 中，代码域按“附：数据字典”中的定义，其值由数字组成的字 符串，特别注意“0”和“” （空串）的区别。 在 retXML 中， “状态”域为“1” （正常） 、或“2” （警告）均表示执行成功，结果可 以引用， “备注”域记录的是提示信息。 “状态”域为“3” （出错）时表示执行出错，结果 不能引用， “备注”域记录的是出错信息。 所有的参数不能以换行符或空格结尾。 文档编辑约定： 章：标题 1，宋体，二号，加黑，居中，前空 1 行 节：标题 2，宋体，三号，加黑，不居中，前空 1 行（接章时不空） ，后不空 小节：标题 3，宋体，四号，加黑，不居中，前空 1 行（接节时不空） ，后不空 其他：正文，宋体，五号，不加黑，不居中，前不空，后不空 代码（局部）：正文，宋体，小五号，不加黑，不居中，前不空，后不空 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 8 页 珠海市医疗保险网上结算接口规范 第二章 门诊结算接口 2.12.1 门诊联网结算门诊联网结算说明说明 门诊联网结算接口：门诊资格查询、门诊结算、门诊结算取消、门诊结算查询、门诊 结算统计、门诊结算报表。 在门诊结算业务中，后台不保留中间结果，一次结算不能超过 200 行明细。特别是网 报时必须一次性录完一张结算单（含明细）并完成结算，中途退出则要重头录入。 2.22.2 门诊资格确认门诊资格确认 2.2.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊资格确认 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位，不能为空 是否结算生育医疗见“是否结算生育医疗”字典 是否结算门诊统筹见“是否结算门诊统筹”字典 示例： 123456789 123456789012345678 张三 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 1 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 9 页 珠海市医疗保险网上结算接口规范 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 监护人 1 姓名不超过 20 位 监护人 1 身份号码18 位 监护人 2 姓名不超过 20 位 监护人 2 身份号码18 位 年度 200807-200906200807-200906 参保险种见“参保险种”字典1 未成年医保 人员类别见“人员类别”字典91 在职 门诊病种见“门诊病种”字典 封顶限额精确到分 剩余限额精确到分 基金支付比例如：0.50 0.50 备注出错信息或提示信息本年度的额度已用完 .4 业务约定业务约定 被查询人有门诊报销资格，且剩余限额大于 0 时，返回“状态”域为“1” （正常） 。 被查询人有门诊报销资格，但剩余限额等于或小于 0 时，返回“状态”域为“2” （警告） 。 其他情况下返回“状态”域为“3” （出错） 。 2.32.3 门诊结算门诊结算 2.3.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊结算 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位社会保障卡号和公民身份 号码可以任选一项 公民身份号码18 位 姓名不超过 20 位 参保险种见“参保险种”字典，不能为空 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 10 页 珠海市医疗保险网上结算接口规范 结算流水号不超过 20 位 科室见“科室”字典 操作人不超过 20 位 联系人不超过 20 位 联系电话不超过 20 位 生育报销项目 根据“结算项目下载数据字典下载” 接口获得（字典项目为生育类型） 生育报销则必须上传生育 报销项目，其他险种报销 则为空 是否转诊报销见“是否转诊报销”字典，不能为空 子域，限 200 行以内 消费代码 消费名称 规格不超过 20 位 单价精确到分 数量必须为数字 金额精确到分 消费类别见“消费类别”字典 医保类型见“医保类型”字典 费用属性见“费用属性”字典 示例： 123456789 123456789012345678 张三 11 10001 21 李代夫 王主任 7654321 90099* 大便常规+原虫 瓶 3.50 1.00 62.00 01 01 0 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 11 页 珠海市医疗保险网上结算接口规范 42602 一次性静脉输液针 支 0.25 1.00 0.25 01 01 0 02304 利巴韦林注射液(病毒唑针) 20070606 支 5.14 1.00 5.14 01 01 0 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 监护人 1 姓名不超过 20 位 监护人 1 身份号码18 位 监护人 2 姓名不超过 20 位 监护人 2 身份号码18 位 开户银行(仅生育保险返回) 银行帐号(仅生育保险返回) 年度 200807-200906200807-200906 参保险种见“参保险种”字典1 未成年医保 人员类别见“人员类别”字典91 在职 门诊病种长度不超过 100 个字符 封顶限额精确到分 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 12 页 珠海市医疗保险网上结算接口规范 结算流水号 操作时间 YYYMMDDHHMMSS20080203112338 明细行数上传明细行数 30 费用总额精确到分 核准金额精确到分 基金支付比例 基金支付金额精确到分 剩余限额精确到分 结算单号 备注出错信息或提示信息 .4 业务约定业务约定 自费金额=费用总额-核准金额 自付金额=核准金额-基金支付金额 当符合结算条件，且限额大于或等于核准金额时，按核准金额结算，返回“状态”域 为“1” （正常） 。 当符合结算条件，但限额小于核准金额时，按实有限额结算，返回“状态”域为“2” （警告） 。 当要结算的项目已经存在（判断个人信息、结算流水号和费用总额） ，则不做任何处理， 返回“状态”域为“2” （警告） ，其他域按正常结算以系统中已经存在的项目返回，即允许 重复结算。 其他情况下不做结算，返回“状态”域为“3” （出错） 。 结算成功后，返回的“剩余限额”域是指本次结算之后的剩余限额。 2.42.4 门诊结算取消门诊结算取消 2.4.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊结算取消 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 姓名不超过 20 位 参保险种见“参保险种”字典，不能为空 结算流水号不超过 20 位 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 13 页 珠海市医疗保险网上结算接口规范 费用总额精确到分 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 备注出错信息或提示信息 .4 业务约定业务约定 只能取消当月内的门诊结算项目，且必须提供参保险种才能办理取消。 要取消的项目存在且成功取消，返回“状态”域为“1” （正常） 。 要取消的项目之前已经被取消，返回“状态”域为“2” （警告） ，即允许重复取消。 取消失败，返回“状态”域为“3” （出错） 。 2.52.5 门诊结算查询门诊结算查询 2.5.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊结算查询 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 参保险种见“参保险种”字典，不能为空 结算流水号不超过 20 位 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 监护人 1 姓名不超过 20 位 监护人 1 身份号码18 位 监护人 2 姓名不超过 20 位 监护人 2 身份号码18 位 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 14 页 珠海市医疗保险网上结算接口规范 开户银行(仅生育保险返回) 银行帐号(仅生育保险返回) 年度 200807-200906200807-200906 参保险种见“参保险种”字典 1 人员类别见“人员类别”字典 91 门诊病种不超过 100 个位 结算流水号 科室见“科室”字典 操作时间 YYYMMDDHHMMSS20080203112338 明细行数明细行数 3 操作人不超过 20 位 联系人不超过 20 位 联系电话不超过 20 位 费用总额精确到分 核准金额精确到分 基金支付比例 基金支付金额精确到分 结算单号 发票号 发票流水号 子域 消费代码长度不超过 30 个字符 消费名称长度不超过 100 个字符 规格不超过 20 位 单价精确到分 数量必须为数字 金额精确到分 消费类别见“消费类别”字典 医保类型见“医保类型”字典 费用属性见“费用属性”字典 备注出错信息或提示信息 .4 业务约定业务约定 当 parXML 中“参保险种”为空时，在所有险种中查找。否则，只在指定险种中查找。 找到指定的结算单时，返回结算信息，且“状态”域为“1” （正常） 。否则，返回“状 态”域为“3” （出错） 。 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 15 页 珠海市医疗保险网上结算接口规范 2.62.6 门诊结算汇总门诊结算汇总 2.6.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊结算汇总 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 参保险种见“参保险种”字典，不能为空1 未成年医保 人员类别空/人员类别字典， “空”为全部 门诊病种空/门诊病种， “空”为全部 科室空/科室字典， “空”为全部 操作起始时间空/YYYMMDDHHMMSS 2008010100000000 操作终止时间空/YYYMMDDHHMMSS 2008020100000000 支付年月起空/YYYYMM 支付年月止空/YYYYMM 支付状态空/1/0， “空”为全部，1 已付，0 未付 每页行数-1 汇总/0 明细不分页/0 明细分页 页号 1 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 参保险种见“参保险种”字典，不能为空1 未成年医保 人员类别空/人员类别字典， “空”为全部 门诊病种空/门诊病种， “空”为全部 科室空/科室字典， “空”为全部 操作起始时间 YYYMMDDHHMMSS2008010100000000 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 16 页 珠海市医疗保险网上结算接口规范 操作终止时间 YYYMMDDHHMMSS2008020100000000 支付年月起空/YYYYMM 支付年月止空/YYYYMM 支付状态空/1/0， “空”为全部，1 已付，0 未付 每页行数-1 只汇总/0 明细不分页/0 分页 页号 1 子域，一行 人次数人次数 费用总额精确到分 核准金额精确到分 基金支付金额精确到分 子域，多行 社会保障卡号 公民身份号码18 位 姓名不超过 20 位 年度 200807-200906200807-200906 参保险种见“参保险种”字典1 未成年医保 人员类别见“人员类别”字典91 在职 门诊病种 结算流水号 发票号 发票流水号 操作时间 YYYMMDDHHMMSS20080203112338 科室见“科室”字典 操作人不超过 20 位 联系人不超过 20 位 联系电话不超过 20 位 费用总额精确到分 核准金额精确到分 基金支付比例 基金支付金额精确到分 支付日期 YYYYMMDD 结算单号 备注出错信息或提示信息 .4 业务约定业务约定 “汇总”子域只在“每页行数”为-1 时返回，且“明细”子域不再出现。其他情况下 接口不进行汇总并且不返回“汇总”子域，而返回“明细”子域。 当明细超过 100 行时强制分页，每页 100 行。 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 17 页 珠海市医疗保险网上结算接口规范 当符合条件的记录数为 0 时，返回“状态”域为“2” （警告） 。 当符合条件的记录数0 时，返回“状态”域为“1” （正常） 。 在 parXML 中， “参保险种”不能为空，即本接口只能按险种调用。 2.7 门诊上传发票号 2.7.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊上传发票号 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” parXMLparXML 约定约定 标签约定备注 结算流水号 姓名 参保险种见“参保险种”字典，不能为空 发票号 发票流水号 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 备注出错信息或提示信息 2.8 报销汇总信息查看 2.8.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas报销汇总信息查看 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 18 页 珠海市医疗保险网上结算接口规范 返回结果 retXML见“retXML 约定” parXMLparXML 约定约定 标签约定备注 结算流水号 姓名 参保险种 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 西药 中成草药 护理费 检查费 治疗费 麻醉费 手术费 化验费1000 元以下材料费 氧费 输血费 材料费 1000 元以下 材料费 1000-3000 元 材料费 3000 元以上 其它 床位费 新技术费用 乙类星号药品费1000-3000 元材料费 特检费 特治费 直线加速器 诊疗费 自费药 费用总额 核准金额 基金支付比例 基金支付金额 备注出错信息或提示信息 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 19 页 珠海市医疗保险网上结算接口规范 2.92.9 门诊签约门诊签约 2.9.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊签约 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位，不能为空 操作人 不能为空 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 签约流水号全市唯一 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 年度 200807-200906200807-200906 参保的主险种见“参保险种”字典1 未成年医保 人员类别见“人员类别”字典91 在职 2.102.10 门诊签约取消门诊签约取消 2.10.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊签约取消 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 20 页 珠海市医疗保险网上结算接口规范 返回结果 retXML见“retXML 约定” 0.2 parXMLparXML 约定约定 标签约定备注 签约流水号 姓名不超过 20 位，不能为空 0.3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 备注 2.112.11 门诊签约查询门诊签约查询 2.11.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas门诊签约查询 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” 1.2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 签约开始日期 yymmdd 签约结束日期 yymmdd 签约年度 每页行数-1 汇总/0 明细不分页/0 明细分页 页号 1 1.3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 每页行数-1 只汇总/0 明细不分页/0 分页 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 21 页 珠海市医疗保险网上结算接口规范 页号 1 子域，一行 人次数人次数 子域，多行 社会保障卡号 公民身份号码18 位 姓名不超过 20 位 年度 200807-200906200807-200906 参保的主险种见“参保险种”字典1 未成年医保 签约开始日期精确到分 签约结束日期 备注出错信息或提示信息 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 22 页 珠海市医疗保险网上结算接口规范 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 23 页 珠海市医疗保险网上结算接口规范 第三章住院结算接口 3.13.1 住院联网结算说明住院联网结算说明 住院联网结算接口：住院资格查询、住院登记、住院登记取消、住院登记查询、住院 结算、住院结算取消、上传发票号、上传 ICD 编码、住院结算查询、结算项目下载。 3.23.2 住院资格确认住院资格确认 3.2.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas住院资格确认 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 姓名不超过 20 位 是否结算生育医疗见“是否结算生育医疗”字典1=是/0=否 是否结算工伤医疗见“是否结算工伤医疗”字典1=是/0=否 示例： 123456789 123456789012345678 张三 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 1 社会保障卡号社保卡为 9 位，大病卡为 19 位 公民身份号码18 位 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 24 页 珠海市医疗保险网上结算接口规范 姓名不超过 20 位 监护人 1 姓名不超过 20 位 监护人 1 身份号码18 位 监护人 2 姓名不超过 20 位 监护人 2 身份号码18 位 参保险种见“参保险种”字典 人员类别见“人员类别”字典 封顶限额精确到分 剩余限额精确到分 连续缴费月数 参保状态 见“参保状态”字典 住院未结算次数 住院是否需审核见“住院是否需审核”字典 住院需审核原因见“住院需审核原因”字典 备注出错信息或提示信息本年度的额度已用完 .4 业务约定业务约定 被查询人有住院结算资格，且剩余限额大于 0 时，返回“状态”域为“1” （正常） 。 被查询人有住院结算资格，但剩余限额等于或小于 0 时，返回“状态”域为“2” （警告） 。 其他情况下返回“状态”域为“3” （出错） 。 3.3 住院登记 3.3.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas住院登记 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 社会保障卡号社保卡为 9 位，大病卡为 19 位社会保障卡号和公民身份 号码可以任选一项 公民身份号码18 位 姓名不超过 20 位 参保险种见“参保险种”字典 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 25 页 珠海市医疗保险网上结算接口规范 住院号不能为空 入院时间不能为空，格式为 YYYMMDD 20080203 科室见“科室”字典 联系人不能为空 联系电话不能为空 入院诊断不能为空 住院是否需审核见“住院是否需审核”字典 住院需审核原因见“住院需审核原因”字典 计生证号 操作人 备注 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 备注出错信息或提示信息 3.4 住院登记取消 3.4.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas住院登记取消 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 住院号不能为空 入院时间 YYYMMDD20080203 姓名 不能为空 参保险种见“参保险种”字典 .3 retXMLretXML 约定约定 标签约定备注 状态见“状态”字典 深圳市中科保计算机系统有限公司 珠海市劳动和社会保障信息中心 第 26 页 珠海市医疗保险网上结算接口规范 备注出错信息或提示信息 3.5 住院登记查询 3.5.1 接口参数约定接口参数约定 参数名称约定备注 服务名称 ser医院联网结算 机构编号 dep医院编号 业务名称 cas住院登记查询 业务参数 parXML见“parXML 约定” 数字证书 cer GDCA/NETCAGDCA 数字签名 sig 返回结果 retXML见“retXML 约定” .2 parXMLparXML 约定约定 标签约定备注 住院号不能为空 入院时间格式为 YYYYMMDD，不能为空 20080203 参保险种不能为空 .3 retXMLretXML 约定约定 标