广东省食品药品监督管理局国家电子监管系统省局端系统企业数据采集接口规范建设单位:广东省食品药品监督管理局监理单位:广州市信佰信息技术咨询有限公司承建单位:深圳市天驰医药信息技术开发有限公司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格式响应示例:<?xml version="1.0" encoding="utf-8"?> <result><resultCode>0</resultCode><resultText></resultText><data> </data></result>4.2.2.分页响应数据格式JSON格式响应示例[蓝色字体部分]:{"data":{"data":[{ },{}],"dataId":"403","pageCount":100,"total":2},"resultCode":0,"resultText":""}XML格式响应示例[蓝色字体部分]:<?xml version="1.0" encoding="utf-8"?><result><resultCode>0</resultCode><resultText></resultText><data><data><med></med><med></med></data><total>2</total><pageCount>100</pageCount><dataId>0</dataId></data></result>4.3. 下载经营品种库企业端调用此接口功能以实现企业内部药品信息与药监药品标准信息的一致性。
本功能仅提供药监系统中,企业已维护的本企业经营品种库范围内的药品标准信息及其更新信息。
4.3.1.接入URLhttps://服务器IP及端口号/data/clientAccept/ toOperationCommodity.do4.3.2.接入方式POST/GET4.3.3.请求请求示例:https://test20120401-1:8081/data/clientAccept/toOperationCommodity.do?dataId=0& resType=xml4.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格式响应示例:<?xml version="1.0" encoding="utf-8"?><result><resultCode>0</resultCode><resultText></resultText><data><data><med><medicineCodeNumber>药品本位码</medicineCodeNumber><medicineGeneralName>注射用骨肽</medicineGeneralName><doseType>注射用无菌粉末(冻干粉针)</doseType><specifications>10mg</specifications><packagSpecifications>10支/盒</packagSpecifications><measureUnit>支</measureUnit><productionEprice>生产企业名称</productionEprice></med><med><medicineCodeNumber>药品本位码</medicineCodeNumber><medicineGeneralName>注射用阿奇霉素</medicineGeneralName><doseType>注射用无菌粉末(冻干粉针)</doseType><specifications>0.5g</specifications><packagSpecifications>1支/支</packagSpecifications><measureUnit>支</measureUnit><productionEprice>生产企业名称</productionEprice></med></data><total>2</total><pageCount>100</pageCount><dataId>0</dataId></data></result>4.4. 下载往来企业库企业端调用此接口功能以实现企业内部往来企业信息与药监企业标准信息的一致性。
本功能仅提供药监系统中,企业已维护的本企业往来企业库范围内的企业标准信息及其更新信息。
4.4.1.接入URLhttps://服务器IP及端口号/data/clientAccept/toContactsBusiness.do4.4.2.接入方式POST/GET4.4.3.请求请求示例:https://test20120401-1:8081/data/clientAccept/toContactsBusiness.do?dataId=0&re sType=xml4.4.4.响应本功能响应格式为分页响应数据格式。
响应结果集合数据对象描述[示例中蓝色字体部分]:JSON格式响应示例:{"data":{"data":[{"enterPriceName":"阳江市中西医结合医院","enterPriceType":"药品零售企业","district":"阳江江城区","fullAddress":"广东省阳江市江城区建设路"},{"enterPriceName":"潮安县凤凰中心卫生院","enterPriceType":"药品零售企业","district":"潮州潮安县","fullAddress":"潮安县凤凰镇"}],"dataId":"0","pageCount":100,"total":2},"resultCode":0,"resultText":""}XML格式响应示例:<?xml version="1.0" encoding="utf-8"?><result><resultCode>0</resultCode><resultText></resultText><data><data><enter><enterPriceName>封开县罗董镇中心卫生院</enterPriceName><enterPriceType>医疗机构</enterPriceType><fullAddress>封开县罗董镇罗董街2号</fullAddress><district>广东省肇庆市封开县</district></enter><enter><enterPriceName>石药集团欧意药业有限公司</enterPriceName><enterPriceType>药品生产企业</enterPriceType><fullAddress>石家庄市中山西路276号</fullAddress><district>河北省石家庄市桥西区</district></enter></data><total>2</total><pageCount>100</pageCount><dataId>0</dataId></data></result>4.5. 上传文件企业端通过本功能接口上传已签名xml数据文件。