数据对接接口说明

1.试剂管理平台接口概述

试剂管理平台（以下简称“平台”）集试剂采购、审批、库房管理、废弃物处置、结算、资料查询、安全教育宣传于一体的、量身定制的信息化管理平台。“平台”以“方便师生，寓管理于服务，以服务促管理”作为指导思想，通过简化、优化采购、审批等各环节流程，透明、规范采购，实现试剂全程可追溯、全过程闭环管理。

为保证“平台”供货商产品数据更新的及时性，现将其中部分功能数据对接接口的方式向供货商提供，具体接口如下表所示：

，并获取一个秘钥（userKey）。接口成功部署后，可通过访问

http://ip:port/services/frontWebService?wsdl获取接口的详细描述。

2.数据对接方法

2.1.String sayHi(String name)

这是一个测试方法，返回"hello, " + name的字符串,测试地址为：

http://ip:port/services/frontWebService/sayHello?name=J

2.2.String submit(String xmlData, String sign)

主要的业务处理方法，后面所说的xml报文，即该方法的xmlData参数，sign 为xmlData+userKey的md5密文。返回值为xml格式的字符串。

3.XML报文定义规则

3.1.请求报文

3.2.

若无特殊说明，业务处理成功后，返回如下xml报文:

3.3.失败返回报文

若无特殊说明，业务处理失败后，返回如下xml报文:

4.1.通用功能

4.1.1.文件上传(FUNC_ID= 1001)

4.1.2.文件下载(FUNC_ID= 1002)

4.2.产品信息

用于供货商上传产品数据，平台将以产品数据中“品牌”+“货号”+“包装规格”作为某条产品的唯一标识，如出现重复的将以最后一次上传为准。

数据接口开放时间为每天的08:00-22:00。

新上传的数据会在第二天生效，即上传后的第2天用户才可以搜索到。

上传的产品中不得存在管控品，包括易制毒、易制爆、剧毒和精神麻醉品，如因此产生的一切责任由供货商自己负责。

4.2.1.产品上传(FUNC_ID= 1201)

请求报文中节点描述如下：

4.2.2.产品更新(FUNC_ID= 1211)

请求报文中节点描述如下：

4.2.3.产品下架(FUNC_ID= 1231)

请求报文中节点描述如下：

4.3.1.采购人列表(FUNC_ID= 1801)

4.3.2.订单列表(FUNC_ID= 1811)

4.4.现货信息

接口允许以GET方式访问，格式如下：

参数说明：

{"flag":1,"msg":"成功","amount":[{"wh":"北京","stock":"10"},{"wh":"上海","stock":"50"}]}

flag：用于判断是否成功，成功为1，失败为0；

message：系统返回的消息，如果flag=1则message可为空，否则需返回失败的原因；

amount：不同地区库房的库存数，wh为库房所在地区，stock为库存数。

接口返回示例：