接入指引
为保障两定医药机构顺利接入甘肃省医疗保障信息平台（简称医保系统），并按时、按质、按量完成接口开发、联调、测试以及验收，特编制该文档，以供参考.
一、医疗机构接入步骤说明
1.1医药机构医保专网验证
甘肃省医疗保障信息平台整体部署在医保专网，两定机构需打通医保专网才能连接到医保系统以及两定API接口服务.
测试、正式环境地址另行通知.
格式参考：
浏试环境网关域名地址为：xXxxxxxxXx
开放1P地址为：Xx.XX.XXXx.XXX
开放端口为：xX
调用时，域名地址与IP地址需要绑定配置HOST.
1.2医药机构接口改造开发
两定医药机构根据省医保局下发的接口规范文档，见附件一《医疗保障信息平台定点基线版医药机构接口规范》，进行医药机构内部系统接口改造，按照新接口规范标准要求，调用医保API接口服务，需完全遵循接口规范进行接口入参传值.
1.3申请联调测试
两定医药机构完成医保接口规范对接改造，且网络验证通过后，向地方医保局申请联调测试，地方医保局API接口负责人将配合两定医药机构完成接口联调测试工作.
1.4接口验收工作
两定医药机构完成医保API接口服务联调测试通过后，向地方医保局申请接口验收，地方API接口负责人将对提交验收申请的医疗机构进行接口核验，核验通过后完成接口验收.
接口验收申请以及验收表见附录1.
二、API接口调用服务说明
2.1API接口调用地址
API接口调用服务地址示例为：http：//{IP地址或域名：端口）/（应用账户编码）/（服务开放路径）
具体IP地址或域名、端口、应用账户编码、服务开放路径以医保局提供为准.
2.2API接口调用方式
Http请求方法：postHttp MIME 类型:Content-Type: application/json
服务请求头定义：
数据元标识 数据元名称 代码是否号 类型 长度 标识 必填 备注在创建账户时自动生成应用编码和xtif-paasid 应用编码 字符型 100 密钥（secretKey私钥）.Sha256加密生成的签名xtif-signaturex-tif-signature签名 字符型 300 sha256 (xtift imestampsecretKey x-tif-noncextiftinestanp)xtif-timestanp时间] 时间藏 当前unix 时间藏（秒）.非重复的随机字符串（十分钟内不能tif-nonce 校验码 字符型 100 重复）.
2.3API接口响应内容
API接口服务响应分为两类，一类是正常响应，一类是异常响应.正常响应时，API接口服务直接把结果透传给调用者，不做任何操作.异常响应时，API接口服务会返回（errcode:xxx ，message:xxx}结构的 json数据.Code字段为状态码，message为异常信息.
常见异常响应有：
解释响应结果
[errcode“：401 “message²：“缺少服务调用的请求头！”} 请求中缺少服务调用所需的请求头.[errcode“：401 ~message”：“签名时间截超时!} 时间截超时，默认为30分钟.[errcode :401 message”:“非法用户!°) 请求头中携带的AK不是合法的AK[errcode “:401 message”:“签名不-致！) 签名不一致，请检查您的签名方式
三、关键业务流程说明
3.1药店、门诊、住院结算流程通用说明
1、药店、门诊、住院的结算流程都支持本地和异地结算：
2、读取就诊介质信息：
姓名、参保地医保区划，验证电子凭证密码： 方式一：扫描医保电子凭证调用电子凭证中心服务获取人员证件类型、证件号码、
方式二：读取社保卡，验证卡密码，获取社会保障号、发卡地经办机构、卡识别码、卡号：
方式三：读取居民身份证，获取证件号码、姓名.
3、医保身份识别：
方式一：电子凭证的身份识别，通过证件类型、证件号码、参保地医保区划获取人员医疗保险信息：参加的险种、个人账户余额、是否可以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等：
区划、卡号、社会保障号获取人员医疗保险信息：参加的险种、个人账户余额、是否可 方式二：社保卡身份识别，调用持卡库服务做卡鉴权，根据卡识别码、发卡地行政以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等：
方式三：身份证身份识别，调用基础信息中心和用户中心获取人员参保地信息，根据身份证号码和参保地获取人员医疗保险信息：参加的险种、个人账户余额、是否可以 享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等.
4、异地就医业务，接口通过参保地医保区划和就医地医保区划自动判断，系统自动归属结算信息，完成医保接口改造工作即完成异地就医接口改造，异地读卡操作另见3.2人员信息获取通用说明.
5、为了交易安全，结算时都需要进行读取就诊介质和密码验证.
3.2人员信息获取通用说明
1、电子凭证
通过扫描枪直接扫电子医保凭证，获取电子凭证号，通过【1101】接口，入参【ndtrt_cert_type】传值01，【mdtrt_cert_no】传值获取到的电子凭证号，即可通过接口获取到该电子凭证的参保人信息.每个电子凭证号只能被使用一次.
使用电子凭证办理业务，接口中的【mdtrt_cert_type】传值必须是01，【mdtrt_cert_no】传值必须是获取到的电子凭证号，不能随便填写.
2、身份证
通过手工输入身份证号或通过读卡设备读取身份证获取身份证号码，通过【1101】接口，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号码，即可通过接口获取到该参保人信息.
3、社保卡
