一、医疗机构接入步骤说明
1.1 医药机构医保专网验证
江西省医疗保障信息平台整体部署在医保专网，两定机构需打通医保专网才能连接到医保系统以及两定API接口服务。
_测试地址：_
10.74.127.233
_格式参考__:_
http://10.74.127.233/hsa-mbs-fsi-local/api/fsiPsnInfoService/queryPsnInfo
开放IP地址为：
开放端口为：
正式环境地址另行通知。
1.2 医药机构接口改造开发
两定医药机构根据省医保局下发的接口规范文档,见《江西医疗保障信息平台定点基线版医药机构接口规范》，进行医药机构内部系统接口改造，按照新接口规范标准要求，调用医保API接口服务，需完全遵循接口规范进行接口入参传值。
1.3 申请联调测试
两定医药机构完成医保接口规范对接改造，且网络验证通过后，向地方医保局申请联调测试，地方医保局API接口负责人将配合两定医药机构完成接口联调测试工作。
1.4 接口验收工作
两定医药机构完成所有医保API接口服务联调测试通过后，向地方医保局申请接口验收，地方API接口负责人将对提交验收申请的医疗机构进行接口核验，核验通过后完成接口验收。
接口验收申请以及验收表见附录1。
二、API接口调用服务说明
2.1 API****接口调用地址
API接口调用服务地址示例为:
http:// {IP__地址或域名:端口}/ {应用账户编码}/{服务开放路径}
示例：
正式具体IP地址或域名、端口、应用账户编码、服务开放路径以医保局提供为准。
2.2 API****接口调用方式
示例报文：
{
"infno": "1101",
"msgid": "H00000000001202001041235391234",
"insuplc_admdvs":"100000",
"mdtrtarea_admvs":"100000",
"recer_sys_code":"MBS_LOCAL",
"dev_no":"",
"dev_safe_info":"",
"cainfo": "",
"infver": "V1.0",
"opter_type": "1",
"opter": "01",
"opter_name": "张三",
"inf_time": "2020-01-04 12:35:39",
"fixmedins_code": "100001",
"fixmedins_name": "第一人民医院",
"sign_no": "79faf82271944fe38c4f1d99be71bc9c",
"input": {
"data": {
"psn_cert_type": "2",
"certno": "510000202001010000",
"psn_name": "李四",
"begntime": "2020-01-01"
}
}
}
交易状态码说明
交易状态码(infcode)为4位编码，具体规格如下：
表格 交易报文状态说明
| 序号 | STATUS值 | 值说明 | 备注 |
|---|---|---|---|
| 1 | 0 | 成功 | |
| 2 | -1 | 失败 | |
| 3 | -9 | 未登录 |
三、关键业务流程说明
3.1 药店、门诊、住院结算流程通用说明
1、药店、门诊、住院的结算流程都支持本地和异地结算，医疗类别详见《江西省定点医药机构接口规范V1.0》中的字典表中医疗类别(med_type)或通过【1901】交易进行查询，异地结算接口调用方式同本地参保人，医院HIS系统可通过【1101】人员信息获取交易返回的“insuplc_admdvs（参保地医保区划）”判断是否为异地人员（跨省异地非36开头均为跨省异地人员，省内异地需前四位）。
2、读取就诊介质信息与医保身份识别：
可以通过电子凭证的、社会保障卡进行获取人员基本信息，通过证件类型、证件号码等信息获取人员医疗保险信息：参加的险种、个人账户余额、是否可以享受统筹待遇、医疗人员类别（在职、退休、离休、城乡）、参保地医保区划等。
3、为了交易安全，使用社会保障卡结算时需要进行密码验证。
3.2 人员信息获取通用说明
1、电子凭证
通过扫描枪直接扫电子医保凭证，获取电子凭证号，通过【1101】接口，入参【mdtrt_cert_type】传值01，【mdtrt_cert_no】传值获取到的电子凭证号，即可通过接口获取到该电子凭证的参保人信息。每个电子凭证号只能被使用一次。
使用电子凭证办理业务，接口中的【mdtrt_cert_type】传值必须是01，【mdtrt_cert_no】传值必须是获取到的电子凭证号，不能随便填写。
2、社保卡
本地以及省内异地读卡：通过读卡设备获取到社保卡的身份证号码，通过【1101】接口，入参【mdtrt_cert_type】传值02，【mdtrt_cert_no】传值身份证号码，即可通过接口获取到该参保人信息。
跨省异地就医读卡：通过读卡设备获取到社保卡的卡号、识别码以及身份证号码，通过【1101】接口，入参【mdtrt_cert_type】传值03，【mdtrt_cert_no】传值社保卡卡号，【card_sn】传值社保卡识别码，【psn_cert_type】传值1，【certno】传值身份证号码，即可通过接口获取到该参保人信息。
3、港澳台及其它证件
通过【1101】接口，入参【mdtrt_cert_type】传值03，【mdtrt_cert_no】传值证件号码，【card_sn】传值证件号码，【psn_cert_type】传值99，【certno】传值证件号码，即可通过接口获取到该参保人信息。
3.3 药店结算流程说明
流程图
图 1 药店结算
流程说明
1、参保人出示身份证、医保电子凭证等身份证明，零售药店应验证其身份；
2、药店端上传相关信息，发起药店结算，如果是慢特病购药，需要传入慢特病病种等信息；
3、结算时因电脑死机、网络中断、或超时等原因导致药店端结算系统无法获得医保中心结算结果，同时无法判断医保中心端是否存在本次结算结果的情况下，应提示结算失败，并发起冲正交易，如果系统结算正常返回，展示结算信息并打印结算单；
4、药店结算适用于药店购药、门诊慢特病两类医疗类别，支持本地结算、省内异地结算、跨省异地结算。
3.4 门诊结算流程说明
流程图
图 2 门诊结算
流程说明
1、参保人出示身份证、医保电子凭证等身份证明，医疗机构应验证其身份；
2、在窗口进行挂号后，由科室上传就诊信息，按照费用批次上传明细；如果是慢特病购药，需要传入慢特病病种信息；
3、医疗机构按照费用批次发起门诊结算，一次挂号可以结算多个批次费用；
4、结算时因电脑死机、网络中断、或超时等原因导致医院端结算系统无法获得医保中心结算结果，同时无法判断医保中心端是否存在本次结算结果的情况下，应提示结算失败，并发起冲正交易，如果系统结算正常返回，展示结算信息并打印结算单；
5、门诊结算适用于普通门诊、门诊挂号、门诊统筹、门诊慢特病等门诊类医疗类别，结算支持本地结算、省内异地结算、跨省异地结算。
6、门诊慢性病结算时只能单病种结算。
3.5 住院结算流程说明
流程图
图 3 住院结算
流程说明
1、参保人出示身份证、医保电子凭证等身份证明，医疗机构应验证其身份；
2、医疗机构为参保人办理入院后，上传费用明细(每次上传费用明细处方数量<=100条)，2301费用明细上传(init_feedetl_sn原费用流水号退单时传入被退单的费用明细流水号，cnt数量传入负数，上传负数量时被退费明细必须已经上传)；
3、医疗机构核实住院信息后，为参保人办理出院；需要变更住院信息、诊断信息时，调用住院信息变更交易【2403】进行变更；
4、办理出院后，不允许再上传费用明细，医疗机构发起住院结算；
5、结算时因电脑死机、网络中断、或超时等原因导致医院端结算系统无法获得医保中心结算结果，同时无法判断医保中心端是否存在本次结算结果的情况下，应提示结算失败，并发起冲正交易，如果系统结算正常返回，展示结算信息并打印结算单；
6、住院结算适用于普通住院，转院住院、生育住院等住院类医疗类别，支持本地结算、省内异地结算、跨省异地结算。
3.6 医药机构费用结算对总账
流程图
图 4 医药机构费用结算对总账
流程说明
1、医药机构向地方医保局提交对账信息；
2、地方医保局核对费用信息后，返回对账结果；
3、如果总账不平时，使用医药机构费用结算对明细账交易获取差异结算信息；
4、定点医药机构处理明细对账的差异信息后，再次进行对总账。
3.7 医药机构费用结算对明细账
流程图
图 5 医药机构费用结算对明细账
流程说明
1、医药机构需要提前上传费用明细信息，再发次明细对账；
2、地方医保局比对医药机构上传的费用信息后，将结果信息生成文件，并返回下载该文件的所需信息；
3、医药机构下载明细对账结果文件，并进行分析；
4、医药机构根据返回的信息，进行问题处理。
3.8 医药机构费用结算对账操作说明
通过【3201】医药机构费用结算对总账，当总账对平时，无需进行明细对账，当总账对账不平时按以下方式进行明细对账:
1、通过【9101】上传明细数据，将明细对账数据(结算ID、就诊ID、人员编号、医疗费总额、基金支付总额、个人账户支出、退费结算标志)保存为txt文本，各字段之间需用Tab隔开;
2、将保存好的txt文件直接压缩(不放文件夹内)为zip文件，并通过工具将zip文件转换为数组形式(C#为sbyte数组，其它为byte数组);
3、复制转换后的数组数据放到【9101】入参[in]内，再调用接口，返回出参[file_qury_no];
4、将【9101】出参[file_qury_no]内容放到【3202】中的入参[file_Gury_nol]中，再调用接口，返回出参[file_gury_no]和[filename];
5、将【3202】出参内容[file_gury_no]和[filename]放到【9102】入参内的[file_qury_no]和[filename] .
6、通过调用【9102】下载费用对账明细数据，用于医疗机构处理对账不平数；
7、对明细账完成后，通过【3201】完成对总账。
医疗机构费用结算对账业务流程：
四、接口列表
基线版本提供的105个接口列表如下：
表 1 接口列表
| 接口编号 | 一级分类 | 二级分类 | 接口名称 | 调用方式 | 描述 |
|---|---|---|---|---|---|
| 1101 | 1-基础信息 | 1-人员信息 | 人员基本信息获取 | 实时 | 通过此交易获取人员信息。 |
| 1201 | 2-定点医药机构信息 | 医药机构信息获取 | 实时 | 通过此交易获取医药机构基本信息。 | |
| 1301 | 3-目录下载 | 西药中成药目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | |
| 1302 | 中药饮片目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1303 | 医疗机构制剂目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1304 | 民族药品目录查询 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1305 | 医疗服务项目目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1306 | 医用耗材目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1307 | 疾病与诊断目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1308 | 手术操作目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1309 | 门诊慢特病种目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1310 | 按病种付费病种目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1311 | 日间手术治疗病种目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1312 | 医保目录信息查询 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1313 | 肿瘤形态学目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1314 | 中医疾病目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1315 | 中医证候目录下载 | 实时 | 根据本地最大版本号信息获取大于本地版本的目录信息。 | ||
| 1316 | 医疗目录与医保目录匹配信息查询 | 实时 | 通过此交易查询医疗目录与医保目录匹配信息。 | ||
| 1317 | 医药机构目录匹配信息查询 | 实时 | 通过此交易查询医药机构目录匹配信息。 | ||
| 1318 | 医保目录限价信息查询 | 实时 | 通过此交易查询医保目录限价信息。 | ||
| 1319 | 医保目录先自付比例信息查询 | 实时 | 通过此交易查询医保目录先自付比例信息。 | ||
| 1901 | 9-其他信息 | 字典表查询 | 实时 | 通过此交易查询字典表。 | |
| 2001 | 2-医保服务 | 0-待遇检查 | 人员待遇享受检查 | 实时 | 通过此交易检查人员的待遇享受情况，返回待遇信息。 |
| 2101 | 1-药店结算 | 药店预结算 | 实时 | 通过此交易进行药店购药，药店门诊慢特病购药的预结算。 | |
| 2102 | 药店结算 | 实时 | 通过此交易进行药店购药，药店门诊慢特病购药的结算（含费用明细上传）。 | ||
| 2103 | 药店结算撤销 | 实时 | 通过此交易撤销药店结算（含费用明细撤销）。 | ||
| 2201 | 2-门急诊结算 | 门诊挂号 | 实时 | 通过此交易进行门诊挂号。 | |
| 2202 | 门诊挂号撤销 | 实时 | 通过此交易进行门诊挂号的撤销。 | ||
| 2203 | 门诊就诊信息上传 | 实时 | 通过此交易上传门诊就诊及诊断信息。 | ||
| 2204 | 门诊费用明细信息上传 | 实时 | 通过此交易上传门诊费用明细信息。 | ||
| 2205 | 门诊费用明细信息撤销 | 实时 | 通过此交易撤销门诊费用明细信息。 | ||
| 2206 | 门诊预结算 | 实时 | 通过此交易进行门诊结算的预结算。 | ||
| 2207 | 门诊结算 | 实时 | 通过此交易进行门诊结算的正式结算。 | ||
| 2208 | 门诊结算撤销 | 实时 | 通过此交易撤销门诊结算。 | ||
| 2301 | 3-住院结算 | 住院费用明细上传 | 实时 | 通过此交易上传住院费用明细信息。 | |
| 2302 | 住院费用明细撤销 | 实时 | 通过此交易撤销住院费用明细信息。 | ||
| 2303 | 住院预结算 | 实时 | 通过此交易进行住院结算的预结算。 | ||
| 2304 | 住院结算 | 实时 | 通过此交易进行住院结算的正式结算。 | ||
| 2305 | 住院结算撤销 | 实时 | 通过此交易撤销住院结算。 | ||
| 2401 | 4-住院办理 | 入院办理 | 实时 | 通过此交易进行入院登记办理。 | |
| 2402 | 出院办理 | 实时 | 通过此交易进出院办理。 | ||
| 2403 | 入院信息变更 | 实时 | 通过此交易进行入院信息变更。 | ||
| 2404 | 入院撤销 | 实时 | 通过此交易进行入院撤销。 | ||
| 2405 | 出院撤销 | 实时 | 通过此交易进出院撤销。 | ||
| 2406 | 就医特殊属性上传 | 实时 | 通过此交易维护人员就医特殊属性 | ||
| 2407 | 就医特殊属性查询 | 实时 | 通过此交易查询人员就医特殊属性 | ||
| 2501 | 5-人员备案 | 转院备案 | 实时 | 通过此交易上传转院备案信息。 | |
| 2502 | 转院备案撤销 | 实时 | 通过此交易撤销上传的转院备案信息。 | ||
| 2503 | 人员慢特病备案 | 实时 | 通过此交易上传人员慢特病备案信息。 | ||
| 2504 | 人员慢特病备案撤销 | 实时 | 通过此交易撤销医保局还未处理的人员慢特病备案信息。 | ||
| 2505 | 人员定点备案 | 实时 | 通过此交易上传人员定点备案信息。 | ||
| 2506 | 人员定点备案撤销 | 实时 | 通过此交易撤销医保局还未审核的人员定点备案信息。 | ||
| 2507 | 人员意外伤害备案 | 实时 | 通过此交易上传人员意外伤害备案信息 | ||
| 2601 | 6-事务补偿业务 | 冲正交易 | 实时 | 定点医药机构发起某项交易时，因网络中断或超时等原因导致无法获取接收方状态，导致多方数据不一致或已确认接收方数据多时，可通过冲正取消接收方相应数据，保持双方数据一致。 | |
| 3101 | 3-医药机构管理 | 1-明细审核 | 明细审核事前分析服务 | 实时 | 通过此交易进行事前的明细审核分析。 |
| 3102 | 明细审核事中分析服务 | 实时 | 通过此交易进行事中的明细审核分析。 | ||
| 3201 | 2-医药机构费用结算业务 | 医药机构费用结算对总账 | 实时 | 对通过此交易进行医药机构费用结算对总账。 | |
| 3202 | 医药机构费用结算对明细账 | 实时 | 通过此交易，在医药机构费用结算总账不平时，进行对明细账。 | ||
| 3301 | 3-目录对照 | 目录对照上传 | 实时 | 通过此交易上传目录对照信息。 | |
| 3302 | 目录对照撤销 | 实时 | 通过此交易删除上传的目录对照信息。 | ||
| 3401 | 4-科室管理 | 科室信息上传 | 实时 | 通过此交易上传科室信息。 | |
| 3401A | 批量科室信息上传 | 实时 | 通过此交易批量上传科室信息。 | ||
| 3402 | 科室信息变更 | 实时 | 通过此交易变更科室信息。 | ||
| 3403 | 科室信息撤销 | 实时 | 通过此交易撤销科室信息。 | ||
| 3501 | 5-进销存管理 | 商品盘存上传 | 实时 | 通过此交易上传商品盘存信息。 | |
| 3502 | 商品库存变更 | 实时 | 通过此交易上传商品的库存变化。 | ||
| 3503 | 商品采购 | 实时 | 通过此交易上传商品采购信息。 | ||
| 3504 | 商品采购退货 | 实时 | 通过此交易上传商品采购退货信息。 | ||
| 3505 | 商品销售 | 实时 | 通过此交易上传商品销售信息。 | ||
| 3506 | 商品销售退货 | 实时 | 通过此交易上传商品销售退货信息。 | ||
| 3507 | 商品信息删除 | 实时 | 通过此交易删除某一批次商品信息。 | ||
| 4101 | 4-信息采集上传 | 1-医疗保障基金结算清单 | 医疗保障基金结算清单信息上传 | 定时/每天 | 通过此交易上传医疗保障基金结算清单信息。 |
| 4201 | 2-自费病人就医信息 | 自费病人费用明细信息上传 | 实时 | 通过此交易上传自费病人费用明细信息。 | |
| 4301 | 3-门急诊业务 | 门急诊诊疗记录 | 定时/每天 | 通过此交易上传门急诊诊疗记录。 | |
| 4302 | 急诊留观手术及抢救信息 | 定时/每天 | 通过此交易上传急诊留观手术及抢救信息。 | ||
| 4401 | 4-住院业务 | 住院病案首页信息 | 定时/每天 | 通过此交易上传住院病案首页信息。 | |
| 4402 | 住院医嘱记录 | 定时/每天 | 通过此交易上传住院医嘱记录。 | ||
| 4501 | 5-临床辅助业务 | 临床检查报告记录 | 定时/每天 | 通过此交易上传临床检查记录。 | |
| 4502 | 临床检验报告记录 | 定时/每天 | 通过此交易上传临床检验记录。 | ||
| 4503 | 细菌培养报告记录 | 定时/每天 | 通过此交易上传细菌培养报告记录。 | ||
| 4504 | 药敏记录报告记录 | 定时/每天 | 通过此交易上传药敏记录报告记录。 | ||
| 4505 | 病理检查报告记录 | 定时/每天 | 通过此交易上传病理检查报告记录。 | ||
| 4506 | 非结构化报告记录 | 定时/每天 | 通过此交易上传非结构化报告记录。 | ||
| 4601 | 6-医疗管理业务 | 输血信息 | 定时/每天 | 通过此交易上传输血信息。 | |
| 4602 | 护理操作生命体征测量记录 | 定时/每天 | 通过此交易上传护理操作生命体征测量记录。 | ||
| 4701 | 7-电子病历 | 电子病历上传 | 定时/每天 | 通过此交易上传电子病历信息。 | |
| 5101 | 5-信息查询 | 1-基础信息查询 | 科室信息查询 | 实时 | 通过此交易获取当前医疗机构的科室基本信息。 |
| 5102 | 医执人员信息查询 | 实时 | 通过此交易获取当前医药机构的医师、护士、药师人员信息。 | ||
| 5201 | 2-医保服务查询 | 就诊信息查询 | 实时 | 根据人员信息获取该人员在本机构一段时间内的就诊信息。 | |
| 5202 | 诊断信息查询 | 实时 | 根据就诊信息获取该人员当次就诊的诊断信息。 | ||
| 5203 | 结算信息查询 | 实时 | 根据条件信息获取该人员在本机构一段时间内的结算信息。 | ||
| 5204 | 费用明细查询 | 实时 | 根据人员就诊信息获取该笔结算的明细信息。 | ||
| 5205 | 人员慢特病用药记录查询 | 实时 | 根据人员信息获取该人员在一段时间内的门诊慢特病用药信息。 | ||
| 5206 | 人员累计信息查询 | 实时 | 根据人员信息获取该人员的累计信息。 | ||
| 5301 | 3-医药机构服务查询 | 人员慢特病备案查询 | 实时 | 根据个人信息获取该人员当前有效的慢特病备案信息。 | |
| 5302 | 人员定点信息查询 | 实时 | 通过此交易获取该人员当前的定点信息。 | ||
| 5303 | 在院信息查询 | 实时 | 通过此交易获取当前定点医疗机构的在院病人信息。 | ||
| 5304 | 转院信息查询 | 实时 | 通过此交易获取该人员在本机构一段时间内的转院信息。 | ||
| 5401 | 4-检查检验互认结果查询 | 项目互认信息查询 | 实时 | 通过此交易在开医技医嘱时获取项目互认的结果。 | |
| 5402 | 报告明细信息查询 | 实时 | 通过此交易在根据互认结果列表获取诊断明细。 | ||
| 9001 | 9-其他 | 0-签到签退 | 签到 | 实时 | 通过此交易进行调用方签到。 |
| 9002 | 签退 | 实时 | 通过此交易进行调用方签退。 | ||
| 9101 | 1-上传下载 | 文件上传 | 实时 | 通过此交易上传文件。 | |
| 9102 | 文件下载 | 实时 | 通过此交易下载【1301-1319】目录信息下载、【5204】费用明细查询、【3202】医药机构费用结算对明细账交易生成的文件。 |
五、附录-阿里csb加密签名调用方法
目前定点医药机构接口服务使用的是公开访问的形式，实际生产环境采用阿里云csb网关请求头签名加密方式，后续测试环境及生产环境都将使用阿里云csb网关加密签名方式进行接口调用，请个医院务必重视。
示例中的_api_access_key及secretKey 供测试使用，最终_api_access_key及secretKey的会单独发送医院；_api_version默认使用 1.0.0 。
该方式仅修改请求头参数，请求体与之前保持不变。
_api_signature需要根据算法规则获取，以下为阿里云csb网关签名算法及调用示例：
1.请求头参数 ：
_api_timestamp: _api_timestamp;
_api_name: _api_name;
_api_signature: signature;
_api_version: _api_version;
_api_access_key: _api_access_key;
Content-Type:application/json;
2.请求地址：
3._api_name对应服务：
结算类接口服务_api_name: api-powersi-test-pri
药品和医用耗材接口_api_name: tps-commonInterface-test-pri
4.请求头示例：
_api_timestamp: 1614571088086;
_api_name: api-powersi-test-pri;
_api_signature: FajyYobnEBm8irmtbMu3+gk6vgg=;
_api_version: 1.0.0;
_api_access_key: 043a6d5927174ab5a7681b193b9fe0e3;
Content-Type:application/json;
- _api_signature js算法规则示例：
var _api_timestamp = Math.round(new Date().getTime()/1000).toString();
var _api_name = “api-powersi-test-pri”;
var _api_version = “1.0.0”;
var _api_access_key = “043a6d5927174ab5a7681b193b9fe0e3”;
var secretKey = “ZugfjXENyvGIQYdB+hFB+s9JL0A=”;
var param = “_api_access_key=”+_api_access_key+”&_api_name=”+_api_name+”&_api_timestamp=”+_api_timestamp+”&_api_version=”+_api_version;
var signature = CryptoJS.enc.Base64.stringify(CryptoJS.HmacSHA1(param, secretKey));
console.log(signature);