企业数据采集接口规范
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
广东省食品药品监督管理局
国家电子监管系统省局端系统
企业数据采集接口规范
建设单位：广东省食品药品监督管理局
监理单位：广州市信佰信息技术咨询有限公司
承建单位：深圳市天驰医药信息技术开发有限公司
2012年12月12日
修改情况记录：
目录
1. 概述 (4)
1.1. 接口内容 (4)
1.2. 实现方式 (4)
1.3. 安全控制 (4)
2. 术语与缩写解释 (4)
3. 系统入口 (5)
4. 接口详细说明 (5)
4.1. 接口功能列表 (5)
4.2. 响应数据格式公共约定 (5)
4.3. 下载经营品种库 (7)
4.4. 下载往来企业库 (10)
4.5. 上传文件 (12)
4.6. 下载文件处理情况 (14)
附录一企业上传xml数据文件格式 (16)
库存记录 (16)
不合格药品记录 (17)
生产入库 (17)
采购入库 (18)
批发退货入库 (18)
零售退货入库 (19)
批发出库 (20)
零售出库 (20)
退货出库 (21)
毁损出库 (21)
抽检出库 (22)
附录二xml数字签名 (23)
附录三附件说明 (24)
1.概述
本文档描述《广东省食品药品监督管理局国家电子监管系统省局端系统》平台与广东省内药品流通相关企业内部系统之间的接口规范。
1.1. 接口内容
提供企业经营品种库药品标准数据及其更新信息下载；
提供企业往来企业库企业标准数据及其更新信息下载；
接收企业上传已数字签名xml格式数据文件；
提供企业上传文件处理情况。
1.2. 实现方式
标准HTTPS GET/POST。
1.3. 安全控制
要求客户端数字证书以实现服务器端与客户端双向身份验证。
备注：目前仅支持网证通数字证书，且必须在药监局已备案。
2.术语与缩写解释
3.系统入口
服务器IP及端口号如下，完整连接请参照具体接口功能请求路径模板
测试服务器入口：
生产服务器入口：
部署调整中，请联系技术支持人员。
4.接口详细说明
4.1. 接口功能列表
4.2. 响应数据格式公共约定
描述所有功能或特定类别的响应数据格式模板，具体功能响应描述部分不再重复介绍本部分已定义数据格式。
4.2.1.通用数据格式
JSON格式响应示例：{"data":"","resultCode":0,"resultText":""}
XML格式响应示例：
4.2.2.分页响应数据格式
JSON格式响应示例[蓝色字体部分]：
{"data":{
"data":[
{ },
{}
],
"dataId":"403",
"pageCount":100,
"total":2
},
"resultCode":0,
"resultText":""
}
XML格式响应示例[蓝色字体部分]：
4.3. 下载经营品种库
企业端调用此接口功能以实现企业内部药品信息与药监药品标准信息的一致性。
本功能仅提供药监系统中，企业已维护的本企业经营品种库范围内的药品标准信息及其更新信息。
4.3.1.接入URL
https://服务器IP及端口号/data/clientAccept/ toOperationCommodity.do
4.3.2.接入方式
POST/GET
4.3.3.请求
请求示例：
https://test20120401-1:8081/data/clientAccept/toOperationCommodity.do?dataId=0& resType=xml
4.3.4.响应
本功能响应格式为分页响应数据格式。
JSON格式响应示例：
{"data":{
"data":[
{ "doseType":"颗粒剂",
"measureUnit":"盒",
"medicineCodeNumber":"15503690274573",
"medicineGeneralName":"阿奇霉素颗粒",
"packagSpecifications":"6袋/盒",
"productionEprice":"药品生产企业名称",
"specifications":"0.1g(10万单位）"
},
{
"doseType":"小容量注射液",
"measureUnit":"盒",
"medicineCodeNumber":"84627325991603",
"medicineGeneralName":"甘草酸二铵注射液",
"packagSpecifications":"5支/盒",
"productionEprice":"药品生产企业名称",
"specifications":"10ml:50mg"
}],
"dataId":"403",
"pageCount":100,
"total":2
},
"resultCode":0,
"resultText":""
}
XML格式响应示例：