数据对接接口说明

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

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

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

分类 通用功能 功能 文件上传 文件下载 产品上传 产品信息 产品更新 产品下架 订单信息 现货信息 订货人列表 订单列表 状态 暂缓开通 暂缓开通 已开通 已开通 已开通 暂缓开通 暂缓开通 由供货商提供，平台拉取数据 任何供货商若要使用本数据对接接口，需要向系统维护商申请一个用户ID，并获取一个秘钥（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. 请求报文

version 报文版本号，201802 user_id func_id seq_id seq_datetime 用户ID，需要向系统维护商申请 功能代码，后面有详细描述 报文流水号 报文发起时间，格式YYYY-MM-DD HH24:MM:SS 3.2. 成功返回报文 若无特殊说明，业务处理成功后，返回如下xml报文:

ok

3.3. 失败返回报文

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

type 错误代码 msg 错误信息 4. 接口功能描述 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)

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

节点名称 <供货商编号/> <产品> <品牌/> <货号/> <包装规格/> <中文品名/> <英文品名/> <质量等级/> <目录价/> <折扣价/> <交货期/> <搜索关键词/> <链接地址/> 数据类型 varchar(10) varchar(30) varchar(30) varchar(100) varchar(200) varchar(200) varchar(30) numeric(14,2) numeric(14,2) varchar(12) varchar(20) varchar(20) varchar(50) varchar(100) 是否必填 Y Y Y Y Y Y Y 描述 向平台索取 供货商网站的详细产品说明页地址 4.2.2. 产品更新 (FUNC_ID= 1211)

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

节点名称 <供货商编号/> <产品> <品牌/> <货号/> <包装规格/> <中文品名/> <英文品名/> <质量等级/> <目录价/> <折扣价/> <交货期/> <搜索关键词/> <链接地址/> 数据类型 varchar(10) varchar(30) varchar(30) varchar(100) varchar(200) varchar(200) varchar(30) numeric(14,2) numeric(14,2) varchar(12) varchar(20) varchar(20) varchar(50) varchar(100) 是否必填 Y Y Y Y Y Y Y 描述 向平台索取 供货商网站的详细产品说明页地址 4.2.3. 产品下架 (FUNC_ID= 1231)

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

节点名称 <供货商编号/> <产品> 数据类型 varchar(10) 是否必填 Y 描述 向平台索取 <品牌/> <货号/> <包装规格/> varchar(30) varchar(30) varchar(100) Y Y Y 4.3. 订单信息 4.3.1. 采购人列表 (FUNC_ID= 1801) 4.3.2. 订单列表(FUNC_ID= 1811)

4.4. 现货信息

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

参数说明：

参数 参数名 供货商加密编码 查询传入参数 说明 提供现货接口厂商请联系平台接口负责人获取加密编码： 联系人：雷明春 电话： 邮箱： UrlDecode后为（样例）Acros,,5GR 传入参数为一个字符串，顺序为产品属性的：品牌、货号、包装规格，逗号分割 C S 接口返回（json）： {\"flag\":1,\"msg\":\"成功\北京\上海\

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

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

amount：不同地区库房的库存数，wh为库房所在地区，stock为库存数。 接口返回示例：