3.2.1.1 交易对象
交易发送方:定点医药机构。
交易接收方:医保电子处方中心。
3.2.1.2 接口描述
通过此交易,参保人可使用医保电子凭证身份验证的方式(使用社保卡、身份证时须验证医保电子凭证密码,按照《医保电子凭证密码核验认证服务接入规范》接入),线下流转授权定点医药机构查询待取药的电子处方列表信息及电子处方令牌(用于后续处方下载及业务验证);通过3.2.4接口下载其中一张电子处方后,列表中其他电子处方授权状态失效(即一次仅能下载参保人授权和确认的那一张处方)。
在原版本“医保电子处方线下流转授权”接口的基础上新增了身份登记流水号:regSn入参,支持按人工核验的方式进行医保电子处方线下流转授权,仅需要根据身份介质场景不同传递不同入参即可。
3.2.1.3 请求方式
POST->/CSB
请求头中 api_name 参考 电子处方两定对接指南(新版).pdf 最后里面的服务名
3.2.1.4 出入参说明
请求报文头参数详见接口规则的通用请求报文头参数说明
3.2.1.4.1 请求入参
输入
序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否必填 | 说明 |
---|---|---|---|---|---|---|---|
1 | fixmedinsCode | 定点医药机构编号 | 字符型 | 20 | Y | 取药机构 | |
2 | psnName | 人员姓名 | 字符型 | 40 | Y | ||
3 | psnCertType | 人员证件类型 | 字符型 | 6 | Y | Y | 参照人员证件类型
(psn_cert_type) |
4 | certno | 证件号码 | 字符型 | 50 | Y | ||
5 | ecToken | 电子凭证令牌 | 字符型 | 64 | Y | 通过医保电子凭证二维码解码、刷脸、凭证密码验密等方式获取 | |
6 | ipInfo | 终端 IP | 字符型 | 64 | Y | ||
7 | opter | 操作人 ID | 字符型 | 20 | Y | ||
8 | opterName | 操作人姓名 | 字符型 | 50 | Y | ||
9 | optinsNo | 操作机构 | 字符型 | 20 | Y | ||
10 | outFlag | 异地处方查询标志位 | 字符型 | 3 | Y | N | 0-否,1-是,默认 否 |
11 | outPoolareaNo | 异地处方医保区划(省级区划) | 字符型 | 6 | N | 就医开具处方时的医保区划编号(省级区划,如:350000),outFlag 为 1 时必填 | |
12 | insuPlcNo | 参保地编号 | 字符型 | 6 | N | outFlag为 1 时必填 | |
13 | regSn | 身份登记流水号 | 字符型 | 40 | N | 1. 通过人工核验身份登记时 必填,(ecToken和regSn 不能同时使用,必须传其一,另外一个传空)。 2. 该字段通过《医疗保障 平台-SSCard.dll 动态库说明》文档中读社保卡基本信息和处方信息(新增)接口获取 |
3.2.1.4.2 响应出参
输出(列表)
序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否非空 | 说明 |
---|---|---|---|---|---|---|---|
1 | authRxno | 医保处方授权编号 | 字符型 | 30 | Y | ||
2 | epcToken | 电子处方访问令牌 | 字符型 | 100 | Y | ||
3 | expiresIn | 令牌过期时间 | 日期型 | Y | yyyy-MM-dd HH:mm:ss | ||
4 | fixmedinsCode | 定点医疗机构编号 | 字符型 | 20 | Y | 开方机构 | |
5 | fixmedinsName | 定点医疗机构名称 | 字符型 | 200 | Y | ||
6 | prscTime | 开方时间 | 日期时间型 | Y | yyyy-MM-dd HH:mm:ss | ||
7 | deptName | 科室名称 | 字符型 | 50 | Y | ||
8 | diseCodg | 病种编码 | 字符型 | 30 | N | ||
9 | diseName | 病种名称 | 字符型 | 500 | N | ||
10 | valiEndTime | 处方有效截止时间 | 日期时间型 | Y | yyyy-MM-dd HH:mm:ss | ||
11 | rxExraAttrCode | 处方附加属性代码 | 字符型 | 3 | Y | N | 01-双通道处方,02-门 诊统筹处方, 03-其他 |
12 | rxExraAttrName | 处方附加属性名称 | 字符型 | 20 | N |