成都基本医疗保险基础数据采集接口规范Word格式文档下载.docx

成都基本医疗保险基础数据采集接口规范Word格式文档下载.docx

《成都基本医疗保险基础数据采集接口规范Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《成都基本医疗保险基础数据采集接口规范Word格式文档下载.docx（27页珍藏版）》请在冰点文库上搜索。

1．服务器地址：

内网【测试】服务器地址：

http:

//10.163.27.162/yhjypt/services/drugsManageService?

wsdl

内网【生产】服务器地址：

//10.163.27.129/yhjypt/services/drugsManageService?

调用方法名：

drugsManageCall

测试交易访问用户

交易访问验证码

cs0001

yhcs0001

正式交易访问用户

正式访问验证码

测试通过后再分配授权

2．交互数据格式

交互数据格式使用XML数据流。

字符集utf-8

传入参数作为提供WebService服务方法的参数传入，返回数据使用XML数据流。

3．请求调用的XML数据流格式

<

?

xmlversion="

1.0"

encoding="

UTF-8"

standalone="

yes"

?

>

data>

<

jybm>

交易服务编码<

/jybm>

<

jyfwyh>

交易访问用户<

/yhfwyh>

jyyhyzm>

交易访问验证码<

/jyyhyzm>

akb020>

定点机构编码<

/akb020>

<

datarow>

<

row>

<

yka094>

医保项目编码<

/yka094>

yka095>

医院项目名称<

/yka095>

ake005>

医院对码流水号<

/ake005>

yke940>

流水号<

/yke940>

yke936>

是否拆零标志<

/yke936>

ykf276>

采购价格<

/ykf276>

ykf278>

采购数量<

/ykf278>

/row>

……

/datarow>

/data>

4．服务返回的XML数据流格式

服务返回的数据流格式为：

xmlversion=\"

1.0\"

encoding=\"

UTF-8\"

result>

message>

/message>

code>

1<

/code>

/result>

返回错误信息：

result.message

返回错误代码：

result.code

code

描述

1

表示执行成功

-1

表示执行失败

99

表示本次成功但是部分数据失败

根据交易内容不同，返回值中会增加相应的节点，详情请看【交易服务明细说明】。

数据交易接口

1.交易服务列表

序号

交易服务名称

交易服务编号

数据上传周期说明（2019-02-21变更）

药品采购信息初始化

cdyp00000

首次上传使用，只能初始化使用

2

药品入库信息上传

cdyp00001

当日数据，次日上传，能够做到当日数据当日上传更佳

3

药品出库信息上传

cdyp00002

4

药品实际库存信息上传

cdyp00003

2.交易服务明细说明

※1.药品采购信息初始化上传

交易名称

药品采购信息初始化上传

交易分类

交易代码

交易说明

1、在两定机构首次上传药品采购信息之前，通过本交易将医疗机构现有的药品库存信息盘点之后作为采购信息一次性上传医保。

2、通过本交易上传之后该交易不再继续使用，后续的药品常规采购入库信息通过【药品入库信息上传交易（cdyp00001）】上传信息即可。

3、流水号<

yke940+ake005>

作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。

4、药品采购信息初始化上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。

5、一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:

数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。

2019-02-21变更

6、药品初始化的时候：

上传药品总量不包含医院科室的备用药品数量（科室备用药品或称之为科室暂存药品）

7、针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。

本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；

药品出库信息据实上传。

输入参数

交易输入xml

交易服务编码<

/jybm>

/jyfwyh>

交易访问验证码<

<

流水号<

交易输出

错误信息<

返回代码<

医疗机构目录编码<

aae013>

上传失败原因<

/aae013>

参数详细说明:

交易输入：

代码

名称

约束

类型

JYBM

交易服务编码

NotNull

VARCHAR2（20）

JYFWYH

交易访问用户

交易访问授权用户

JYYHYZM

AKB020

定点医疗机构编码

两定医疗机构编码

YKA094

医保项目编码

869药品编码

YKA095

医院项目名称

VARCHAR2（200）

医院内部该项目名称

AKE005

医院对码流水号

机构内部使用药品自编码/医院自编码

YKE940

流水号

VARCHAR2（50）

机构内部唯一标识码

YKE936

是否拆零标志

VARCHAR2（6）

0否；

1是

YKF276

采购价格

NUMBER（14,4）

跟是否拆零标志挂钩

YKF278

采购数量

允许负值（负值则默认为退货）

交易输出：

医疗机构目录编码

机构内部使用码

AAE013

上传失败原因

VARCHAR2

※2.药品入库信息上传

1、本交易为上传两定机构药品采购入库信息。

2、流水号<

3、药品入库信息上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。

4、一次调用最多只允许上传明细50条，超过限制数量提交不成功【注:

5、药品采购渠道除了正常采购药品之外还包括医院自制制剂、捐赠药品，非正常采购数据上传时随货单号、供应商名称、供应商许可证填写方式有所调整，变化内容详细参考本交易的《参数详细说明》内容

6、针对院外配送药品的管理，该药品可在《医保两定管理协同平台》对码的时候维护该类药品标志。

yke938>

随货单号<

/yke938>

yke939>

生产日期<

/yke939>

ykf273>

供应商名称<

/ykf273>

ykf274>

供应商许可证号<

/ykf274>

ykf275>

药品生产批号<

/ykf275>

ykf277>

采购发票号<

/ykf277>

ykf279>

采购入库时间<

/ykf279>

ykf280>

采购人姓名<

/ykf280>

ykf281>

药品有效期<

/ykf281>

上传失败原因<

YKE938

随货单号

VARCHAR2（70）

必填

2019-02-21变更：

1.上传医院制剂信息时，随货单号请填写“医院制剂”

2.上传捐赠药品信息时，随货单号填写“捐赠药品”

YKE939

药品生产日期

DATE

YYYY-MM-DD

YKF273

供应商名称

1.上传医院制剂信息时，供应商名称请填写“医疗机构名称”

2.上传捐赠药品信息时，填写“药品捐赠方名称”

YKF274

供应商许可证号

1.上传医院制剂信息时，供应商许可证号请填写“医院药品经营许可证”

2.上传捐赠药品信息时，填写“捐赠药品”

YKF275

药品生产批号

YKF277

采购发票号

Null

YKF279

采购入库时间

YKF280

采购人姓名

YKF281

药品有效期

※3.药品出库信息上传

1、本交易为上传两定机构药品出库信息。

3、药品出库信息的上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。

5、针对医院科室备用药品、盘盈/盘损药品等处理方式说明：

通过本交易来进行处理，对药品消耗原因进行了扩展：

06损坏撤销（填负数）

07变质撤销（填负数）

08过有效期撤销（填负数）

09盘盈（填负数）

10盘损（填正数）

11科室暂存药领用（填正数）：

针对科室领用备用药品填写

12科室暂存药领用撤销（填负数）

98其他撤销（填负数）

（在上传撤销或者销售退货时，填报的各项指标应与正向数据指标保持一致：

例如：

结算标志、开单科室编码、医执人员编码、姓名、人员编号、身份证号码等）

ykf282>

结算标志<

/ykf282>

yka097>

开单科室编码<

/yka097>

ykf008>

医执人员编码<

/ykf008>

aac003>

姓名<

/aac003>

aac001>

人员编号<

/aac001>

aac002>

身份证号码<

/aac002>

akc225>

单价<

/akc225>

akc226>

数量<

/akc226>

ykf284>

出库时间<

/ykf284>

ykf283>

出库经办人<

/ykf283>

yke925>

药品消耗原因<

/yke925>

上传失败原因<

定点机构编码

医保项目编码

流水号

是否拆零标志

YKF282

结算标志

0非成都市医疗保险参保病人

1成都市医疗保险参保病人

药品消耗原因【不为销售时】填0

YKA097

开单科室编码

《两定管理协同平台》填报的医院科室编码

药品消耗原因为销售时必填，否则选填

YKF008

医执人员编码

《两定管理协同平台》填报的医院医生编码

AAC003

姓名

患者姓名，必填

【药品消耗原因为销售时必填，否则选填】

AAC001

人员编号

参保人员必填

AAC002

身份证号码

VARCHAR2（18）

AKC225

单价

AKC226

数量

药品消耗原因为：

YKF284

出库时间

YKF283

出库经办人

YKE925

药品消耗原因

01销售

02损坏

03变质

04过有效期

05销售退货（此退货表示销售的退货，不是药品采购退货）

11科室暂存药领用（填正数）

99其他

98其他撤销（填负数）

机构内部使用药品自编码/医