医疗保障信息平台
河南省定点医药机构医保药品追溯信息采集工作接口规范
修订记录
序号 版本号 日期 更改内容 修订人 审核人3501、3501A、3502、3502A、V1.1.692024/04/233505、3505A增加追潮码节点 郝振钧 符强信息新增交易：3513-销售药品追V1.1.692024/04/23潮信息查询：3512-入库药品 聂峻民 姜校丰追溯信息查询
目录
第1章范围第2章规范性引用文件，第3章接口列表...第4章接口报文格式4.1接口输入报文格式定义4.2接口输出报文格式定义，4.3交易状态码说明， 54.4重点说明.第5章接口说明.5.1医药机构服务，5.1.1进销存管理第6章通用上传下载示例代码 256.1A.1JAVA实现调用上传下载交易示例代码 25第7章接口调用示例代码. 327.1B.1报文输入示例-人员信息获取 327.2B.2报文输出示例-人员信息获取.
第1章范围
本规范规适用于河南省定点医药机构医保药品耗材追溯信息采集工作接口规范的说明.
第2章规范性引用文件
下列文件对于本文件的应用是必不可少的.凡是注日期的引用文件，仅所注日期的版本适用于本文件.凡是不注日期的引用文件，其最新版本（包括的修改单）适用于本文件.
XJ-K01-2020医疗保障信息平台定点医药机构接口规范.
第3章接口列表
基线版本提供的接口列表如下：
表1接口列表
接口编号 一级分类 二级分类 接口名称 调用方式 描述3501 商品盘存上传 实时 通过此交易上传商品盘存信息3501A 3-医药机 5-进销存管理商品盘存上传 实时 通过此交易批量上传商品盘存信息3502 构管理 商品库存变更 实时 通过此交易上传商品的库存变化3502A 3505 商品库存变更 商品销售 实时 实时 通过此交易批量上传商品的库存变化3505A 商品销售 实时 通过此交易批量上传商品销售信息 通过此交易上传商品销售信息3506 商品销售退货 实时 通过此交易上传商品销售退货信息商品销售退货 实时 通过此交易批量上传商品销售退货信3506A 息3512 入库药品追溯信息查询 实时 通过此交易查询定点医药机构入库药品追溯信息查询3513 销售药品追溯信息查询 实时 药品追溯信息查询 通过此交易查询定点医药机构销售库
表2接口列表
第4章接口报文格式
4.1接口输入报文格式定义
报文采用JSON格式，交易参数定义如下：
序号 数据元标识 数据元名称 类型 长度 代码是否必 备注1 infno 交易编号 字符型 标识 填 Y 交易编号详见接口列表4 定点医药机构编号（12）时间（14）2 msgid 发送方报文ID 字符型 30 Y 顺序号（4）时间格式：yyddHHmmss3 ndtrtarea_admvs 就医地医保区划字符型 6 Y 如果交易输入中含有人员编号，此4 insuplc_adndvs 参保地医保区划 字符型 6 项必填，可通过【1101】人员信息获取交易取得5 recer_sys_code 接收方系统代码 字符型 10 Y 用于多套系统接入，区分不同系统 使用6 der_no 设备编号 字符型 1007 dev_safe_info 设备安全信息 字符型 20008 cainfo 数字签名信息 字符型 10249 signtype 签名类型 字符型 10 例如：“Y1.0”，版本号由医保下 建议使用SM2、SM310 infver 接口版本号 字符型 6 Y 发通知.经办人类别 1-经办人：2-自助终端：3-移动终11 opter_type 3 Y Y12 opter 经办人 字符型 30 Y 按地方要求传入经办人姓名/终端 按地方要求传入经办人/终端编号13 opter_nane 经办人姓名 字符型 50 Y 名称交易时间 日期时14 inf_time 间型 19 Y15 fixmedins_code 定点医药机构编 号 字符型 14 Y定点医药机构名16 fixmedins_nane 称 字符型 200 Y17 sign_no 交易签到流水号 字符型 30 通过签到【9001】交易获取18 enc_type app_id 加密方式 集道id 字符型 字符型 32 不加密传空，加密传SM420 19 input 交易输入 字符型 40000 6 Y21 px_ecToken 电子凭证密码核 字符型 50 用于调用电子凭证相应交易保存验token token使用
4.2接口输出报文格式定义
报文采用JSON格式，交易参数定义如下：
表4交易输出参数定义
代码是否序 号 数据元标识 数据元名称 类型 长度 标识非空 备注
