成都基本医疗保险基础数据采集接口规范

成都市基本医疗保险基础数据采集接口规范Version1.1久远银海2019年01月1、 变更说明编号修订日期版本号修订人说明012019-01-231.0进销存数据采集接口规范文档发布022019-02-211.1针对进销存盘盈、盘损、科室备用药品进行接口规范调整2、概述《成都市基本医疗保险基础数据采集应用编程规范》 （以下简称数据采集接口规范）的使用对象为定点医疗机构（ HIS）供应商或其它应用软件供应商。数据采集接□规范适用于包括医师、科室、设备、药品、进销存等在内的定点医疗机构监管型及公众服务型相矢数据资源的采集及管理。 （本规范，不含对我市医保政策和业务经办流程的介绍）应用模式数据采集接口交易使用 HTTP通信协议，传输数据格式遵循 SOAP协议，通过webservice发布服务。WebService 技术，能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件，就可相互交互数据环境要求硬件环境网络环境指标指标值广域网带宽三56k网络连接 客户端直接访问医保中心网络数据交互规范1・服务器地址:内网【测试】服务器地址：62/yhjypt/services/drugsManageService?wsdl内网【生产】服务器地址：29/vhivpt/services/druqsManaqeService?wsdl调用方法名：drugsManageCall测试交易访问用户交易访问验证码cs0001yhcs0001正式交易访问用户正式访问验证码测试通过后再分配授权2.交互数据格式XML数据流。交互数据格式使用XML数据流。字符集XML数据流。传入参数作为提供WebService服务方法的参数传入‘返回数据使用3•请求调用的XML数据流格式<?xmlversion=n1.0nencoding=nUTF-8nstandalone=HyesH?><data><jybm>交易服务编码<jybm>交易服务编码</jybm><jyfwyh>交易访问用户</yhfwyh><jyyhyzm>交易访问验证码</jyyhyzm><akb020>定点机构编码</akb020><datarow><row><yka094>医保项目编码</yka094><yka095>医院项目名称</yka095><ake005>医院对码流水号 </ake005><yke940>流水号</yke940><yke936>是否拆零标志</yke936><ykf276>采购价格</ykf276>vykf278>采购数量 </ykf278></row></datarow>v/data>4.服务返回的XML数据流格式服务返回的数据流格式为：v?xmlversion=\H1.0\”encoding=VUTF-8V?><result><message></message><code>1</code></result>返回错误信息：result.message返回错误代码：result.codecode描述1表示执行成功-1表示执行失败99表示本次成功但是部分数据失败根据交易内容不同，返回值中会增加相应的节点，详情请看【交易服务明细说明】数据交易接口1・交易服务列表序号交易服务名称交易服务编号数据上传周期说明（2019・02・21变更）1药品采购信息初始化cdypOOOOO首次上传使用，只能初始化使用2药品入库信息上传cdypOOOOl当日数据，次日上传，能够做到当日数据当日上传更佳3药品出库信息上传cdyp000024药品实际库存信息上传cdyp000032交易服务明细说明探1•药品采购信息初始化上传父易名称药品采购信息初始化上传交易分类交易代码cdypOOOOO

交易说明1・在两定机构首次上传药品米购信息之前， 通过本交易将医疗机构现有的药品库交易说明存信息盘点之后作为米购信息一次性上传医保。2・通过本交易上传之后该交易不再继续使用， 后续的药品常规采购入库信息通过【药品入库信息上传交易( cdypOOOOl)］上传信息即可o3、流水号<yke940+ake005>作为定点机构内部使用主键'如果已经存在于医保系输入参数4、药品采购信息初始化上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。5・一次调用最多只允许上传明细 50条，超过限制数量提交不成功【注：数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更6、药品初始化的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品或称之为科室暂存药品)7、针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。交易输入xml<?xmlversion=n1.0nencoding=”UTF・8”standalone=输入参数4、药品采购信息初始化上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。5・一次调用最多只允许上传明细 50条，超过限制数量提交不成功【注：数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更6、药品初始化的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品或称之为科室暂存药品)7、针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。交易输入xml<?xmlversion=n1.0nencoding=”UTF・8”standalone=nyesH?><data><jybm>交易服务编码</jybm><jyfwyh>交易访问用户</jyfWyh><jyyhyzm>交易访问验证码</jyyhyzm><akb020>定点机构编码v/akb020><datarow><row><yka094>医保项目编码</yka094><yka095>医院项目名称 </yka095><ake005>医院对码流水号</ake005><yke940>流水号 v/yke940><yke936>是否拆零标志 v/yke936><ykf276>采购价格</ykf276><ykf278>采购数量</ykf278></row></datarow></data>交易输出<?xmlversion=\n1.0Vencoding=VUTF-8\,,?><result><message>错误信息</message><code>返回代码</code><datarow><row><yka094>医保项目编码 </yka094><ake005>医疗机构目录编码</ake005><yke940>流水号</yke940><aae013>上传失败原因 </aae013></row></datarow></result>参数详细说明：交易输入：代码名称约束类型说明JYBM交易服务编码NotNullVARCHAR2(20)JYFWYH交易访问用户NotNullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码NotNullVARCHAR2(20)交易访问验证码AKB020定点医疗机构编码NotNullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码NotNullVARCHAR2(20)869药品编码

YKA095医院项目名称NotNullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号NotNullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号NotNullVARCHAR2(50)机构内部唯一标识码YKE936是否拆零标志NotNullVARCHAR2(6)0否；1是YKF276采购价格NotNullNUMBER(14,4)跟是否拆零标志挂钩YKF278米购数量NotNullNUMBER(14,4)允许负值（负值则默认为退货）交易输出：代码名称约束类型说明AKB020定点医疗机构编码VARCHAR2(20)两定医疗机构编码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR2探2药品入库信息上传交易名称药品入库信息上传交易分类交易代码cdypOOOOl交易说明1、 本交易为上传两定机构药品采购入库信息。2、 流水号＜yke940+ake005＞作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品入库信息上传，前提是两定机构必须在【医保两定管理协冋平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。4、 一次调用最多只允许上传明细 50条，超过限制数量提交不成功【注：数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更5、 药品采购渠道除了正常采购药品之外还包括医院自制制剂、捐赠药品，非正常采购数据上传时随货单号、供应商名称、供应商许可证填写方式有所调整，变化内容详细参考本交易的 《参数详细说明》内容6、针对院外配送药品的管

规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入v?xmlversion="1.0"encoding=MUTF-8"standalone="yes"?>xml <data><jybm>交易服务编码</jybm><jyfwyh>交易访问用户v/jyfwyh><jyyhyzm> 交易访问验证码</jyyhyzm><akb020>定点机构编码</akb020><datarow><row><yka094>医保项目编码</yka094><yka095>医院项目名称</yka095><ake005>医院对码流水号</ake005><yke940>流水号</yke940><yke938>随货单号</yke938><yke939>生产日期</yke939><yke936>是否拆零标志</yke936><ykf273>供应商名称</ykf273><ykf274>供应商许可证号 v/ykf274><ykf275>药品生产批号</ykf275><ykf276>采购价格</ykf276><ykf277>采购发票号</ykf277><ykf278>采购数量</ykf278><ykf279>采购入库时间</ykf279><ykf280>采购人姓名</ykf280><ykf281>药品有效期</ykf281></row>

</datarow></data>交易输出v?xmlversion=\"1.0Vencoding=\nUTF-8V?><result><message>错误信息</message><code>返回代码</code><datarow><row>vyka094>医保项目编码 v/yka094><ake005> 医疗机构目录编码</ake005><yke940>流水号 </yke940><aae013> 上传失败原因 </aae013></row></datarow></result>参数详细说明：交易输入：代码名称约束类型说明JYBM交易服务编码NotNullVARCHAR2(20)JYFWYH交易访问用户NotNullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码NotNullVARCHAR2(20)交易访问验证码AKB020定点医疗机构编码NotNullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码NotNullVARCHAR2(20)869药品编码YKA095医院项目名称NotNullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号NotNullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号NotNullVARCHAR2(50)机构内部唯一标识码YKE938随货单号NotNullVARCHAR2(70)必填2019-02-21变更：1•上传医院制剂信息时，随货单号请填写“医院制剂”2.上传捐赠药品信息时，随货单号填写“捐

赠药品”YKE939药品生产日期NotNullDATEYYYY-MM-DDYKE936是否拆零标志NotNullVARCHAR2(6)0否；1是YKF273供应商名称NotNullVARCHAR2(200)2019-02-21变更：1•上传医院制剂信息时，供应商名称请填与“医疗机构名称”2.上传捐赠药品信息时，填写“药品捐赠方名称”YKF274供应商许可证号NotNullVARCHAR2(50)2019-02-21变更：1•上传医院制剂信息时，供应商许可证号请填写“医院药品经营许可证”2.上传捐赠药品信息时，填写“捐赠药品”YKF275药品生产批号NotNullVARCHAR2(50)YKF276采购价格NotNullNUMBER(14,4)YKF277采购发票号NullVARCHAR2(50)YKF278米购数量NotNullNUMBER(14,4)允许负值（负值则默认为退货）YKF279米购入库时间NotNullDATEYYYY-MM-DDYKF280采购人姓名NotNullVARCHAR2(20)YKF281药品有效期NullDATEYYYY-MM-DD交易输出：代码名称约束类型说明AKB020定点医疗机构编码VARCHAR2(20)两定医疗机构编码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR2探3•药品出库信息上传交易名称药品出库信息上传交易分类交易代码cdyp00002交易说明1、 本父易为上传两定机构药品出库信息。2、 流水号＜yke940+ake005＞作为定点机构内部使用主键，如果已经存在于医

保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品出库信息的上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。4、 一次调用最多只允许上传明细 50条，超过限制数量提交不成功【注：数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更5、针对医院科室备用药品、盘盈/盘损药品等处理方式说明：通过本交易来进行处理，对药品消耗原因进行了扩展：06损坏撤销（填负数）07变质撤销（填负数）08过有效期撤销（填负数）09盘盈（填负数）10盘损（填正数）门科室暂存药领用（填正数）：针对科室领用备用药品填写12科室暂存药领用撤销（填负数）98其他撤销（填负数）（在上传撤销或者销售退货时，填报的各项指标应与正向数据指标保持一致：例如：结算标志、开单科室编码、医执人员编码、姓名、人员编号、身份证号码等）6、针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入xml<?xmlversion=M1.0Mencoding="UTF-8"standalone="yes"?><data><jybm> 交易服务编码</jybm><jyfwyh>交易访问用户</jyfWyh><jyyhyzm> 交易访问验证码</jyyhyzm><akb020>定点机构编码v/akb020><datarow>

<row><yka094>医保项目编码</yka094><yka095>医院项目名称</yka095><ake005>医院对码流水号</ake005><yke940>流水号</yke940><yke936>是否拆零标志</yke936><ykf282>结算标志</ykf282><yka097>开单科室编码</yka097><ykf008>医执人员编码</ykf008><aac003>姓名 </aac003><aacOO1>人员编号</aac001><aac002>身份证号码</aac002><akc225>单价 </akc225><akc226>数量 </akc226><ykf284>出库时间</ykf284><ykf283>出库经办人</ykf283><yke925>药品消耗原因</yke925></row></datarow></data>交易输出<?xmlversion=V1.OVencoding=VUTF-8\n?>交易输出<result><message>错误信息</message><code>返回代码</code><datarow><row>vyka094>医保项目编码 v/yka094><ake005> 医疗机构目录编码v/ake005>

vyke940>流水号 v/yke940><aaeO13> 上传失败原因 </aae013>v/row>v/datarow>v/result>参数详细说明：交易输入：代码名称约束类型说明JYBM交易服务编码NotNullVARCHAR2(20)JYFWYH交易访问用户NotNullVARCHAR2(20)交易访问授权用户JYYHYZM交易访问验证码NotNullVARCHAR2(20)交易访问验证码AKB020定点机构编码NotNullVARCHAR2(20)两定医疗机构编码YKA094医保项目编码NotNullVARCHAR2(20)869药品编码YKA095医院项目名称NotNullVARCHAR2(200)医院内部该项目名称AKE005医院对码流水号NotNullVARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号NotNullVARCHAR2(50)机构内部唯一标识码YKE936是否拆零标志NotNullVARCHAR2(6)0否；1是YKF282结算标志NotNullVARCHAR2(6)0非成都市医疗保险参保病人1成都市医疗保险参保病人药品消耗原因【不为销售时】填0YKA097开单科室编码NotNullVARCHAR2(20)《两定管理协同平台》填报的医院科室编码药品消耗原因为销售时必填，否则选填YKF008医执人员编码NotNullVARCHAR2(20)《两定管理协同平台》填报的医院医生编码药品消耗原因为销售时必填，否则选填AAC003姓名NotNullVARCHAR2(50)患者姓名，必填【药品消耗原因为销售时必填，否则选填】AAC001人员编号NullVARCHAR2(20)参保人员必填AAC002身份证号码NullVARCHAR2(18)参保人员必填AKC225单价NotNullNUMBER(14,4)AKC226数量NotNullNUMBER(14,4)药品消耗原因为：

YKF284出库时间NotNullDATEYYYY-MM-DDYKF283出库经办人NotNullVARCHAR2(20)YKE925药品消耗原因NotNullVARCHAR2(6)01销售02损坏03变质04过有效期05销售退货（此退货表示销售的退货，不是药品采购退货）06损坏撤销（填负数）07变质撤销（填负数）08过有效期撤销（填负数）09盘盈（填负数）10盘损（填正数）科室暂存药领用（填正数）科室暂存药领用撤销（填负数）99其他98其他撤销（填负数）交易输出：代码名称约束类型说明AKB020定点医疗机构编码VARCHAR2(20)两定医疗机构编码YKA094医保项目编码VARCHAR2(20)869药品编码AKE005医疗机构目录编码VARCHAR2(20)机构内部使用药品自编码/医院自编码YKE940流水号VARCHAR2(50)机构内部唯一标识码AAE013上传失败原因VARCHAR2探4•药品实际库存信息上传交易名称药品实际库存信息上传交易分类交易代码cdyp00003交易说明1、 本父易为上传两定机构药品在本机构内当刖的实际库存信息。2、 数据上传时如果出现相同记录（相同记录指： YKA094/AKE005/AAE036三指标值都相冋），则后面上传的结果会覆盖之前上传的结果本次上传成功。

3、 一次调用最多只允许上传明细 50条，超过限制数量提父不成功【注：数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。2019-02-21变更：4、 药品实际库存上传的时候：上传药品总量不包含医院科室的备用药品数量（科室备用药品又称之为科室暂存药品）5、 针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。 本规范定义的药品米购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入xml<?xmlversion=H1.0"encoding="UTF-8"standalone="yes"?><data><jybm> 交易服务编码</jybm><jyfwyh>交易访问用户v/jyfwyh><jyyhyzm> 交易访问验证码</jyyhyzm><akb020>定点机构编码</akb020><datarow><row><yke940> 流水号 </yke940><yka094>医保项目编码 </yka094><yka095> 医院项目名称 </yka095><ake005> 医院对码流水号</ake005><yke936> 是否拆零标志 v/yke936><aae036> 库存日期 </aae036><akc226> 数量 v/akc226></row></datar