云南省医疗保障信息平台 定点医疗机构接口规范
接入指引
版本号 更改条款及内容 更改日期1.0.0建立文档 2021-5-211.0.1增加社保卡令牌的说明2021-07-041.0.2增加签到签退流程说明 2021-07-141.0.3调整药店、门诊和住院结算流程图 2021-08-27
1目标
云南省医保局发布的提供了医功能，同时接口支持但不限于：本地结算、省内异地结算、跨省异地结算. 保政策封装、两定医保实时支付交易、访问接口的安全控件、支持参保人员多种身份认证等
为保障两定医药机构顺利接入云南省医疗保障信息平台（简称医保系统），顺利完成接口开发、联调、测试以及验收，特编制该文档，以供参考.
2接入步骤和说明
1.1 医药机构专网验证
云南省医疗保障信息平台整体部署在医保专网，两定需要接入医保专网才能连接到医保系统.
测试、正式环境配置另行通知.
1.2 医药机构接口改造开发
两定根据省医保局下发的《云南省医疗保障信息平台定点医药机构接口规范》，进行内部系统接口改造，按照新接口规范标准要求调用医保接口动态库，需完全遵循接口规范传入参数值.
1.3申请联调测试
两定完成医保接口规范对接改造，且网络验证通过后，向地方医保局申请联调测试，地方医保局相关部门申请通过后，两定开始联调测试工作.
1.4 接口验收工作
两定完成医保接口服务的联调、测试工作后，向地方医保局提出验收申请，接口验收通过后才能正式上线.
接口验收申请以及验收表见附录1.
3关键流程说明
1.5 药店、门诊、住院结算流程通用说明
1. 药店、门诊、住院的结算流程都支持本地和异地结算；
2. 读取就诊介质信息：
方式一：扫描医保电子凭证调用电子凭证中心服务获取人员证件类型、证件号码、姓名、参保地医保区划，验证电子凭证令牌：
方式二：读取社保卡，验证卡密码，获取社会保障号、发卡地经办机构、卡识别码、卡号、社保卡令牌：
方式三：读取居民身份证，获取证件号码、姓名.
获取个人信息：
方式一：根据电子凭证令牌，获取人员医疗保险信息：参加的险种、个人账户余额、是否可以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等：
方式二：根据社保卡卡号、卡识别码、社会保障号，获取人员医疗保险信息：参加的险种、个人账户余额、是否可以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等：
方式三：身份证身份识别，调用基础信息中心和用户中心获取人员参保地信息，根据身份证号码和参保地获取人员医疗保险信息：参加的险种、个人账户余额、是否可以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等.
4.异地就医业务，接口通过参保地医保区划和就医地医保区划自动判断，系统自动归属结算信息.
为了交易安全，结算时都需要进行读取就诊介质和密码验证.
1.6 人员信息获取通用说明
1. 电子凭证
调用【1191】交易，入参【mdtrt_cert_type】传值01，入参还需要传入【businesstype】、【operatorid】、【operatomame】、【officeid】、【officename】即可通过扫描枪直接扫电子医保凭证，获取电子凭证令牌.
通过【1101】接口，入参【mdtrt_cert_type】传值01，【mdtrt_cert_no】传
值获取到的电子凭证号，【psn_cert_type】传值01，【certno】传值身份证号码，【psn_name】传入姓名，即可通过接口获取到该电子凭证的参保人信息.每个电子凭证令牌的默认有效时间是3分钟.
使用电子凭证办理业务，接口中的【mdtrt_cert_type】传值必须是01，【mdtrt_cert_no】传值必须是获取到的电子凭证令牌，不能随便填写.
2. 身份证
通过手工输入身份证号或通过读卡设备读取身份证获取身份证号码，通过【1101】接口，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号码，【psn_cert_type】传值01，【certno】传值身份证号码，即可通过接口获取到该参保人信息.通过身份证读卡器的流程：调用【1191】交易，入参【mdtrt_cert_type】传值02，即可通过身份证读卡器获取身份证号、姓名和证件类型.通过【1101】接口，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号，【psn_cert_type】传值证件类型，【certno】传值身份证号码，即可通过接口获取到该参保人信息.后续门诊结算交易（2207）或住院结算交易（2304）调用之前，需要先调用【1192】交易，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号，【psn_cert_type】传证件号码，【psn_name】传人员姓名，【infno】传2207或2304，【cardtoken】传空.
3. 社保卡
调用【1191】交易，入参【dtrt_cert_type】传值03，入参【cardtype】传0，即可通过读卡器获取社会保障号、社会保障卡卡号、卡识别码、人员姓名和社保卡令牌.
通过【1101】接口，入参【mdtrt_cert_type】传值03，【mdtrt_cert_no】传值社会保障卡卡号，【card_sn】传值社保卡识别码，【psn_cert_type】传值01，【certno】传值身份证号码，即可通过接口获取到该参保人信息.
电子社保卡
4.
调用【1191】交易，入参【dtrt_cert_type】传值03，入参【cardtype】传1，即可通过扫码获取社会保障号、社会保障卡卡号、卡识别码、人员姓名和社保卡令牌.
