成都基本医疗保险基础数据采集接口规范.docx
- 文档编号:12304235
- 上传时间:2023-04-18
- 格式:DOCX
- 页数:27
- 大小:24.22KB
成都基本医疗保险基础数据采集接口规范.docx
《成都基本医疗保险基础数据采集接口规范.docx》由会员分享,可在线阅读,更多相关《成都基本医疗保险基础数据采集接口规范.docx(27页珍藏版)》请在冰豆网上搜索。
成都基本医疗保险基础数据采集接口规范
成都市基本医疗保险基础数据采集接口规范
Version1.1
久远银海
2019年01月
1、变更说明
编号
修订日期
版本号
修订人
说明
01
2019-01-23
1.0
Ø进销存数据采集接口规范文档发布
02
2019-02-21
1.1
Ø针对进销存盘盈、盘损、科室备用药品进行接口规范调整
Ø
Ø
2、概述
《成都市基本医疗保险基础数据采集应用编程规范》(以下简称数据采集接口规范)的使用对象为定点医疗机构(HIS)供应商或其它应用软件供应商。
数据采集接口规范适用于包括医师、科室、设备、药品、进销存等在内的定点医疗机构监管型及公众服务型相关数据资源的采集及管理。
(本规范,不含对我市医保政策和业务经办流程的介绍)
应用模式
数据采集接口交易使用HTTP通信协议,传输数据格式遵循SOAP协议,通过webservice发布服务。
WebService技术,能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件,就可相互交互数据
环境要求
硬件环境
无。
网络环境
指标
指标值
广域网带宽
≧56k
网络连接
客户端直接访问医保中心网络
数据交互规范
1.服务器地址:
内网【测试】服务器地址:
http:
//10.163.27.162/yhjypt/services/drugsManageService?
wsdl
内网【生产】服务器地址:
http:
//10.163.27.129/yhjypt/services/drugsManageService?
wsdl
调用方法名:
drugsManageCall
测试交易访问用户
交易访问验证码
cs0001
yhcs0001
正式交易访问用户
正式访问验证码
测试通过后再分配授权
2.交互数据格式
交互数据格式使用XML数据流。
字符集utf-8
传入参数作为提供WebService服务方法的参数传入,返回数据使用XML数据流。
3.请求调用的XML数据流格式
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
……
4.服务返回的XML数据流格式
服务返回的数据流格式为:
xmlversion=\"1.0\"encoding=\"UTF-8\"?
>
1
返回错误信息:
result.message
返回错误代码:
result.code
code
描述
1
表示执行成功
-1
表示执行失败
99
表示本次成功但是部分数据失败
根据交易内容不同,返回值中会增加相应的节点,详情请看【交易服务明细说明】。
数据交易接口
1.交易服务列表
序号
交易服务名称
交易服务编号
数据上传周期说明(2019-02-21变更)
1
药品采购信息初始化
cdyp00000
首次上传使用,只能初始化使用
2
药品入库信息上传
cdyp00001
当日数据,次日上传,能够做到当日数据当日上传更佳
3
药品出库信息上传
cdyp00002
4
药品实际库存信息上传
cdyp00003
2.交易服务明细说明
※1.药品采购信息初始化上传
交易名称
药品采购信息初始化上传
交易分类
交易代码
cdyp00000
交易说明
1、在两定机构首次上传药品采购信息之前,通过本交易将医疗机构现有的药品库存信息盘点之后作为采购信息一次性上传医保。
2、通过本交易上传之后该交易不再继续使用,后续的药品常规采购入库信息通过【药品入库信息上传交易(cdyp00001)】上传信息即可。
3、流水号
4、药品采购信息初始化上传,前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作,否则上传失败。
5、一次调用最多只允许上传明细50条,超过限制数量提交不成功【注:
数据提交成功后,该批次上传数据中校验成功的数据提交保存,校验失败数据返回失败原因】。
2019-02-21变更
6、药品初始化的时候:
上传药品总量不包含医院科室的备用药品数量(科室备用药品或称之为科室暂存药品)
7、针对院外配送药品的管理,该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。
本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据;药品出库信息据实上传。
输入参数
交易输入xml
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
……
交易输出
xmlversion=\"1.0\"encoding=\"UTF-8\"?
>
返回代码
……
参数详细说明:
交易输入:
代码
名称
约束
类型
说明
JYBM
交易服务编码
NotNull
VARCHAR2(20)
JYFWYH
交易访问用户
NotNull
VARCHAR2(20)
交易访问授权用户
JYYHYZM
交易访问验证码
NotNull
VARCHAR2(20)
交易访问验证码
AKB020
定点医疗机构编码
NotNull
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
NotNull
VARCHAR2(20)
869药品编码
YKA095
医院项目名称
NotNull
VARCHAR2(200)
医院内部该项目名称
AKE005
医院对码流水号
NotNull
VARCHAR2(20)
机构内部使用药品自编码/医院自编码
YKE940
流水号
NotNull
VARCHAR2(50)
机构内部唯一标识码
YKE936
是否拆零标志
NotNull
VARCHAR2(6)
0否;1是
YKF276
采购价格
NotNull
NUMBER(14,4)
跟是否拆零标志挂钩
YKF278
采购数量
NotNull
NUMBER(14,4)
允许负值(负值则默认为退货)
交易输出:
代码
名称
约束
类型
说明
AKB020
定点医疗机构编码
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
VARCHAR2(20)
869药品编码
AKE005
医疗机构目录编码
VARCHAR2(20)
机构内部使用码
YKE940
流水号
VARCHAR2(50)
机构内部唯一标识码
AAE013
上传失败原因
VARCHAR2
※2.药品入库信息上传
交易名称
药品入库信息上传
交易分类
交易代码
cdyp00001
交易说明
1、本交易为上传两定机构药品采购入库信息。
2、流水号
3、药品入库信息上传,前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作,否则上传失败。
4、一次调用最多只允许上传明细50条,超过限制数量提交不成功【注:
数据提交成功后,该批次上传数据中校验成功的数据提交保存,校验失败数据返回失败原因】。
2019-02-21变更
5、药品采购渠道除了正常采购药品之外还包括医院自制制剂、捐赠药品,非正常采购数据上传时随货单号、供应商名称、供应商许可证填写方式有所调整,变化内容详细参考本交易的《参数详细说明》内容
6、针对院外配送药品的管理,该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。
本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据;药品出库信息据实上传。
输入参数
交易输入xml
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
……
交易输出
xmlversion=\"1.0\"encoding=\"UTF-8\"?
>
返回代码
……
参数详细说明:
交易输入:
代码
名称
约束
类型
说明
JYBM
交易服务编码
NotNull
VARCHAR2(20)
JYFWYH
交易访问用户
NotNull
VARCHAR2(20)
交易访问授权用户
JYYHYZM
交易访问验证码
NotNull
VARCHAR2(20)
交易访问验证码
AKB020
定点医疗机构编码
NotNull
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
NotNull
VARCHAR2(20)
869药品编码
YKA095
医院项目名称
NotNull
VARCHAR2(200)
医院内部该项目名称
AKE005
医院对码流水号
NotNull
VARCHAR2(20)
机构内部使用药品自编码/医院自编码
YKE940
流水号
NotNull
VARCHAR2(50)
机构内部唯一标识码
YKE938
随货单号
NotNull
VARCHAR2(70)
必填
2019-02-21变更:
1.上传医院制剂信息时,随货单号请填写“医院制剂”
2.上传捐赠药品信息时,随货单号填写“捐赠药品”
YKE939
药品生产日期
NotNull
DATE
YYYY-MM-DD
YKE936
是否拆零标志
NotNull
VARCHAR2(6)
0否;1是
YKF273
供应商名称
NotNull
VARCHAR2(200)
2019-02-21变更:
1.上传医院制剂信息时,供应商名称请填写“医疗机构名称”
2.上传捐赠药品信息时,填写“药品捐赠方名称”
YKF274
供应商许可证号
NotNull
VARCHAR2(50)
2019-02-21变更:
1.上传医院制剂信息时,供应商许可证号请填写“医院药品经营许可证”
2.上传捐赠药品信息时,填写“捐赠药品”
YKF275
药品生产批号
NotNull
VARCHAR2(50)
YKF276
采购价格
NotNull
NUMBER(14,4)
YKF277
采购发票号
Null
VARCHAR2(50)
YKF278
采购数量
NotNull
NUMBER(14,4)
允许负值(负值则默认为退货)
YKF279
采购入库时间
NotNull
DATE
YYYY-MM-DD
YKF280
采购人姓名
NotNull
VARCHAR2(20)
YKF281
药品有效期
Null
DATE
YYYY-MM-DD
交易输出:
代码
名称
约束
类型
说明
AKB020
定点医疗机构编码
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
VARCHAR2(20)
869药品编码
AKE005
医疗机构目录编码
VARCHAR2(20)
机构内部使用药品自编码/医院自编码
YKE940
流水号
VARCHAR2(50)
机构内部唯一标识码
AAE013
上传失败原因
VARCHAR2
※3.药品出库信息上传
交易名称
药品出库信息上传
交易分类
交易代码
cdyp00002
交易说明
1、本交易为上传两定机构药品出库信息。
2、流水号
3、药品出库信息的上传,前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作,否则上传失败。
4、一次调用最多只允许上传明细50条,超过限制数量提交不成功【注:
数据提交成功后,该批次上传数据中校验成功的数据提交保存,校验失败数据返回失败原因】。
2019-02-21变更
5、针对医院科室备用药品、盘盈/盘损药品等处理方式说明:
通过本交易来进行处理,对药品消耗原因进行了扩展:
06损坏撤销(填负数)
07变质撤销(填负数)
08过有效期撤销(填负数)
09盘盈(填负数)
10盘损(填正数)
11科室暂存药领用(填正数):
针对科室领用备用药品填写
12科室暂存药领用撤销(填负数)
98其他撤销(填负数)
(在上传撤销或者销售退货时,填报的各项指标应与正向数据指标保持一致:
例如:
结算标志、开单科室编码、医执人员编码、姓名、人员编号、身份证号码等)
6、针对院外配送药品的管理,该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。
本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据;药品出库信息据实上传。
输入参数
交易输入xml
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
……
交易输出
xmlversion=\"1.0\"encoding=\"UTF-8\"?
>
返回代码
……
参数详细说明:
交易输入:
代码
名称
约束
类型
说明
JYBM
交易服务编码
NotNull
VARCHAR2(20)
JYFWYH
交易访问用户
NotNull
VARCHAR2(20)
交易访问授权用户
JYYHYZM
交易访问验证码
NotNull
VARCHAR2(20)
交易访问验证码
AKB020
定点机构编码
NotNull
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
NotNull
VARCHAR2(20)
869药品编码
YKA095
医院项目名称
NotNull
VARCHAR2(200)
医院内部该项目名称
AKE005
医院对码流水号
NotNull
VARCHAR2(20)
机构内部使用药品自编码/医院自编码
YKE940
流水号
NotNull
VARCHAR2(50)
机构内部唯一标识码
YKE936
是否拆零标志
NotNull
VARCHAR2(6)
0否;1是
YKF282
结算标志
NotNull
VARCHAR2(6)
0非成都市医疗保险参保病人
1成都市医疗保险参保病人
药品消耗原因【不为销售时】填0
YKA097
开单科室编码
NotNull
VARCHAR2(20)
《两定管理协同平台》填报的医院科室编码
药品消耗原因为销售时必填,否则选填
YKF008
医执人员编码
NotNull
VARCHAR2(20)
《两定管理协同平台》填报的医院医生编码
药品消耗原因为销售时必填,否则选填
AAC003
姓名
NotNull
VARCHAR2(50)
患者姓名,必填
【药品消耗原因为销售时必填,否则选填】
AAC001
人员编号
Null
VARCHAR2(20)
参保人员必填
AAC002
身份证号码
Null
VARCHAR2(18)
参保人员必填
AKC225
单价
NotNull
NUMBER(14,4)
AKC226
数量
NotNull
NUMBER(14,4)
药品消耗原因为:
YKF284
出库时间
NotNull
DATE
YYYY-MM-DD
YKF283
出库经办人
NotNull
VARCHAR2(20)
YKE925
药品消耗原因
NotNull
VARCHAR2(6)
01销售
02损坏
03变质
04过有效期
05销售退货(此退货表示销售的退货,不是药品采购退货)
06损坏撤销(填负数)
07变质撤销(填负数)
08过有效期撤销(填负数)
09盘盈(填负数)
10盘损(填正数)
11科室暂存药领用(填正数)
12科室暂存药领用撤销(填负数)
99其他
98其他撤销(填负数)
交易输出:
代码
名称
约束
类型
说明
AKB020
定点医疗机构编码
VARCHAR2(20)
两定医疗机构编码
YKA094
医保项目编码
VARCHAR2(20)
869药品编码
AKE005
医疗机构目录编码
VARCHAR2(20)
机构内部使用药品自编码/医
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 成都 基本医疗保险 基础 数据 采集 接口 规范