《成都市基本医疗保险基础数据采集接口规范.doc》由会员分享，可在线阅读，更多相关《成都市基本医疗保险基础数据采集接口规范.doc（17页珍藏版）》请在三一办公上搜索。
1、成都市基本医疗保险基础数据采集接口规范Version1.1久远银海2019年01月1、 变更说明编号修订日期版本号修订人说明012019-01-231.0 进销存数据采集接口规范文档发布022019-02-211.1 针对进销存盘盈、盘损、科室备用药品进行接口规范调整2、 概述成都市基本医疗保险基础数据采集应用编程规范（以下简称数据采集接口规范）的使用对象为定点医疗机构（HIS）供应商或其它应用软件供应商。矚慫润厲钐瘗睞枥庑赖。数据采集接口规范适用于包括医师、科室、设备、药品、进销存等在内的定点医疗机构监管型及公众服务型相关数据资源的采集及管理。（本规范，不含对我市医保政策和业务经办流程的介绍
2、）聞創沟燴鐺險爱氇谴净。应用模式数据采集接口交易使用HTTP通信协议，传输数据格式遵循SOAP协议，通过webservice发布服务。Web Service技术，能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件，就可相互交互数据残骛楼諍锩瀨濟溆塹籟。环境要求硬件环境无。网络环境指标指标值广域网带宽56k网络连接客户端直接访问医保中心网络数据交互规范1 服务器地址：内网【测试】服务器地址：http:/10.163.27.162/yhjypt/services/drugsManageService?wsdl酽锕极額閉镇桧猪訣锥。内网【生产】服务器地址：http:/10.163
3、.27.129/yhjypt/services/drugsManageService?wsdl彈贸摄尔霁毙攬砖卤庑。调用方法名：drugsManageCall测试交易访问用户交易访问验证码cs0001yhcs0001正式交易访问用户正式访问验证码测试通过后再分配授权2 交互数据格式交互数据格式使用XML数据流。字符集utf-8传入参数作为提供WebService服务方法的参数传入，返回数据使用XML数据流。3 请求调用的XML数据流格式謀荞抟箧飆鐸怼类蒋薔。 交易服务编码 交易访问用户 交易访问验证码定点机构编码医保项目编码 医院项目名称 医院对码流水号 流水号 是否拆零标志 采购价格 采购数
4、量 4 服务返回的XML数据流格式 服务返回的数据流格式为：1 返回错误信息：result.message 返回错误代码：result.code code描述1表示执行成功-1表示执行失败99表示本次成功但是部分数据失败根据交易内容不同，返回值中会增加相应的节点，详情请看【交易服务明细说明】。数据交易接口1. 交易服务列表序号交易服务名称交易服务编号数据上传周期说明（2019-02-21变更）1药品采购信息初始化cdyp00000首次上传使用，只能初始化使用2药品入库信息上传cdyp00001当日数据，次日上传，能够做到当日数据当日上传更佳3药品出库信息上传cdyp000024药品实际库存信息
5、上传cdyp000032. 交易服务明细说明1.药品采购信息初始化上传交易名称药品采购信息初始化上传交易分类交易代码cdyp00000交易说明1、 在两定机构首次上传药品采购信息之前，通过本交易将医疗机构现有的药品库存信息盘点之后作为采购信息一次性上传医保。2、 通过本交易上传之后该交易不再继续使用，后续的药品常规采购入库信息通过【药品入库信息上传交易（cdyp00001）】上传信息即可。3、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。4、 药品采购信息初始化上传，前提是两定机构必须在【医保两定管理协同平台】系统中
6、已完成机构药品与医保药品目录的对码工作，否则上传失败。5、 一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更6、 药品初始化的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品或称之为科室暂存药品)7、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入xml 交易服务编码交易访问用户交易访问验证码定点机构编码医保项目编
7、码 医院项目名称 医院对码流水号 流水号 是否拆零标志 采购价格 采购数量 交易输出 错误信息返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明JYBM交易服务编码Not NullVARCHAR2(20)JYFWYH交易访问用户Not NullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码Not NullVARCHAR2(20)交易访问验证码AKB020定点医疗机构编码 Not NullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码Not NullVARCHAR2(20)869药品编码YKA095医
8、院项目名称Not NullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号Not NullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号Not NullVARCHAR2(50)机构内部唯一标识码YKE936是否拆零标志Not NullVARCHAR2(6)0 否；1 是YKF276采购价格Not NullNUMBER(14,4)跟是否拆零标志挂钩YKF278采购数量Not NullNUMBER(14,4)允许负值（负值则默认为退货）交易输出：代码名称约束类型说明AKB020定点医疗机构编码 VARCHAR2(20)两定医疗机构编码YKA094
9、医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR22.药品入库信息上传交易名称药品入库信息上传交易分类交易代码cdyp00001交易说明1、 本交易为上传两定机构药品采购入库信息。2、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品入库信息上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败
10、。4、 一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更5、 药品采购渠道除了正常采购药品之外还包括医院自制制剂、捐赠药品，非正常采购数据上传时随货单号、供应商名称、供应商许可证填写方式有所调整，变化内容详细参考本交易的参数详细说明内容6、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入xml 交易服务编码交易访问用户交易访问
11、验证码定点机构编码医保项目编码 医院项目名称 医院对码流水号 流水号 随货单号 生产日期 是否拆零标志 供应商名称 供应商许可证号 药品生产批号 采购价格 采购发票号 采购数量 采购入库时间 采购人姓名 药品有效期 交易输出 错误信息 返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明JYBM交易服务编码Not NullVARCHAR2(20)JYFWYH交易访问用户Not NullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码Not NullVARCHAR2(20)交易访问验证码AKB020定点医疗机构编码 Not
12、 NullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码Not NullVARCHAR2(20)869药品编码YKA095医院项目名称Not NullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号Not NullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号Not NullVARCHAR2(50)机构内部唯一标识码YKE938随货单号Not NullVARCHAR2(70)必填2019-02-21变更：1.上传医院制剂信息时，随货单号请填写“医院制剂”2.上传捐赠药品信息时，随货单号填写“捐赠药品”YKE939药品生产日期
13、Not NullDATEYYYY-MM-DDYKE936是否拆零标志Not NullVARCHAR2(6)0 否；1 是YKF273供应商名称Not NullVARCHAR2(200)2019-02-21变更：1.上传医院制剂信息时，供应商名称请填写“医疗机构名称”2.上传捐赠药品信息时，填写“药品捐赠方名称”YKF274供应商许可证号Not NullVARCHAR2(50)2019-02-21变更：1.上传医院制剂信息时，供应商许可证号请填写“医院药品经营许可证”2.上传捐赠药品信息时，填写“捐赠药品”YKF275药品生产批号Not NullVARCHAR2(50)YKF276采购价格Not
14、 NullNUMBER(14,4)YKF277采购发票号NullVARCHAR2(50)YKF278采购数量Not NullNUMBER(14,4)允许负值（负值则默认为退货）YKF279采购入库时间Not NullDATEYYYY-MM-DDYKF280采购人姓名Not NullVARCHAR2(20)YKF281药品有效期 NullDATEYYYY-MM-DD交易输出：代码名称约束类型说明AKB020定点医疗机构编码 VARCHAR2(20)两定医疗机构编码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用药品自编
15、码/医院自编码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR23.药品出库信息上传交易名称药品出库信息上传交易分类交易代码cdyp00002交易说明1、 本交易为上传两定机构药品出库信息。2、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品出库信息的上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。4、 一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校
16、验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更5、 针对医院科室备用药品、盘盈/盘损药品等处理方式说明：通过本交易来进行处理，对药品消耗原因进行了扩展：06损坏撤销（填负数）07变质撤销（填负数）08过有效期撤销（填负数）09 盘盈（填负数）10 盘损（填正数）11 科室暂存药领用（填正数）：针对科室领用备用药品填写12 科室暂存药领用撤销（填负数）98其他撤销（填负数）（在上传撤销或者销售退货时，填报的各项指标应与正向数据指标保持一致：例如：结算标志、开单科室编码、医执人员编码、姓名、人员编号、身份证号码等）6、 针对院外配送药品的管理，该药品可在医保两定管理协同
17、平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入xml 交易服务编码交易访问用户交易访问验证码定点机构编码医保项目编码 医院项目名称 医院对码流水号 流水号 是否拆零标志 结算标志 开单科室编码 医执人员编码 姓名 人员编号 身份证号码 单价 数量 出库时间 出库经办人 药品消耗原因 交易输出 错误信息 返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明JYBM交易服务编码Not NullVARCHAR2(20)JYFWYH交易访问用户Not
18、 NullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码Not NullVARCHAR2(20)交易访问验证码AKB020定点机构编码 Not NullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码 Not NullVARCHAR2(20)869药品编码YKA095医院项目名称Not NullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号Not NullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号 Not NullVARCHAR2(50)机构内部唯一标识码YKE936是否拆零标志 Not NullV
19、ARCHAR2(6)0 否；1 是YKF282结算标志Not NullVARCHAR2(6)0 非成都市医疗保险参保病人1 成都市医疗保险参保病人药品消耗原因【不为销售时】填0YKA097开单科室编码Not NullVARCHAR2(20)两定管理协同平台填报的医院科室编码药品消耗原因为销售时必填，否则选填YKF008医执人员编码Not NullVARCHAR2(20)两定管理协同平台填报的医院医生编码药品消耗原因为销售时必填，否则选填AAC003姓名 Not NullVARCHAR2(50)患者姓名，必填【药品消耗原因为销售时必填，否则选填】AAC001人员编号 NullVARCHAR2(2
20、0)参保人员必填AAC002身份证号码 NullVARCHAR2(18)参保人员必填AKC225单价 Not NullNUMBER(14,4)AKC226数量 Not NullNUMBER(14,4)药品消耗原因为：YKF284出库时间 Not NullDATEYYYY-MM-DDYKF283出库经办人 Not NullVARCHAR2(20)YKE925药品消耗原因 Not NullVARCHAR2(6)01销售 02损坏 03变质 04过有效期05销售退货（此退货表示销售的退货，不是药品采购退货）06损坏撤销（填负数）07变质撤销（填负数）08过有效期撤销（填负数）09 盘盈（填负数）10
21、 盘损（填正数）11 科室暂存药领用（填正数）12 科室暂存药领用撤销（填负数）99其他 98其他撤销（填负数）交易输出：代码名称约束类型说明AKB020定点医疗机构编码 VARCHAR2(20)两定医疗机构编码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR24.药品实际库存信息上传交易名称药品实际库存信息上传交易分类交易代码cdyp00003交易说明1、 本交易为上传两定机构药品在本机构内当前的
22、实际库存信息。2、 数据上传时如果出现相同记录（相同记录指：YKA094/AKE005/AAE036三指标值都相同），则后面上传的结果会覆盖之前上传的结果本次上传成功。3、 一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更：4、 药品实际库存上传的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品又称之为科室暂存药品)5、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选
23、择是否上传数据；药品出库信息据实上传。输入参数交易输入xml 交易服务编码交易访问用户交易访问验证码定点机构编码 流水号 医保项目编码 医院项目名称 医院对码流水号是否拆零标志 库存日期 数量 交易输出 错误信息 返回代码 流水号 医保项目编码 医疗机构目录编码 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明JYBM交易服务编码Not NullVARCHAR2(20)JYFWYH交易访问用户Not NullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码Not NullVARCHAR2(20)交易访问验证码AKB020定点机构编码 Not NullVARCHAR
24、2(20)两定医疗机构编码YKE940流水号 Not NullVARCHAR2(50)机构内部唯一标识码YKA094医保项目编码 Not NullVARCHAR2(20)869药品编码YKA095医院项目名称Not NullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号Not NullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE936是否拆零标志 Not NullVARCHAR2(6)0 否；1 是AAE036库存日期Not NullDATEYYYY-MM-DDAKC226数量 Not NullNUMBER(14,4)交易输出：代码名称约束类型说明A
25、KB020定点医疗机构编码 VARCHAR2(20)两定医疗机构编码YKE940流水号 VARCHAR2(50)机构内部唯一标识码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用码AAE036库存日期DATEAAE013上传失败原因VARCHAR23. 药品进销存上传数据量的计算说明（以最小计价单位来计算）举例说明：药品对码基础信息如下序号药品名称药品包装数量包装单位最小计价单位1阿莫西林胶囊50盒粒药品进销存上传信息如下方案药品名称是否拆零标志数量1阿莫西林胶囊是10药品采购信息2阿莫西林胶囊否10药品采购信息方案1：阿莫西林胶囊数量 = 10粒方案2：阿莫西林胶囊数量 = 10*50=500粒
