企业数据采集接口规范

广东省食品药品监督管理局 国家电子监管系统省局端系统

建设单位：监理单位：承建单位：

企业数据采集接口规范

广东省食品药品监督管理局 广州市信佰信息技术咨询有限公司 深圳市天驰医药信息技术开发有限公司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 格式响应示例：

0

4.2.2. 分页响应数据格式

JSON 格式响应示例[蓝色字体部分]： {"data":{

"data":[

{ }, {} ],

"dataId":"403", "pageCount":100, "total":2 },

"resultCode":0, "resultText":"" }

XML 格式响应示例[蓝色字体部分]：

0

2

100 0

4.3. 下载经营品种库

企业端调用此接口功能以实现企业内部药品信息与药监药品标准信息的一致性。 本功能仅提供药监系统中，企业已维护的本企业经营品种库范围内的药品标准信息及其更新信息。

4.3.1. 接入URL

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":"[1**********]573", "medicineGeneralName":"阿奇霉素颗粒", "packagSpecifications":"6袋/盒",

"productionEprice":"药品生产企业名称", "specifications":"0.1g(10万单位）" }, {

"doseType":"小容量注射液", "measureUnit":"盒",

"medicineCodeNumber":"[1**********]603", "medicineGeneralName":"甘草酸二铵注射液", "packagSpecifications":"5支/盒",

"productionEprice":"药品生产企业名称", "specifications":"10ml:50mg" }],

"dataId":"403", "pageCount":100, "total":2 },

"resultCode":0, "resultText":"" }

XML 格式响应示例：

0

药品本位码 注射用骨肽 注射用无菌粉末（冻干粉针） 10mg

10支/盒 支

生产企业名称

药品本位码

注射用阿奇霉素 注射用无菌粉末（冻干粉针） 0.5g

1支/支 支

生产企业名称

2

100 0

4.4. 下载往来企业库

企业端调用此接口功能以实现企业内部往来企业信息与药监企业标准信息的一致性。 本功能仅提供药监系统中，企业已维护的本企业往来企业库范围内的企业标准信息及其更新信息。

4.4.1. 接入URL

4.4.2. 接入方式

POST/GET

4.4.3. 请求

请求示例：

https://test20120401-1:8081/data/clientAccept/toContactsBusiness.do?dataId=0&resType=xml

4.4.4. 响应

本功能响应格式为分页响应数据格式。

响应结果集合数据对象描述[示例中蓝色字体部分]：

JSON 格式响应示例： {"data":

{"data":

[{

"enterPriceName":"阳江市中西医结合医院", "enterPriceType":"药品零售企业", "district":"阳江江城区",

"fullAddress":"广东省阳江市江城区建设路"}, {

"enterPriceName":"潮安县凤凰中心卫生院", "enterPriceType":"药品零售企业", "district":"潮州潮安县",

"fullAddress":"潮安县凤凰镇" }], "dataId":"0",

"pageCount":100, "total":2 },

"resultCode":0, "resultText":"" }

XML 格式响应示例：

0

封开县罗董镇中心卫生院 医疗机构

封开县罗董镇罗董街2号 广东省肇庆市封开县

石药集团欧意药业有限公司 药品生产企业

石家庄市中山西路276号 河北省石家庄市桥西区

2

100 0

4.5. 上传文件

企业端通过本功能接口上传已签名xml 数据文件。

根据企业经营性质，建议企业需上传数据业务类型如下： ● 药品生产企业用户

药品库存、不合格品记录、生产入库、采购入库、退货入库、批发销售出库、退货出库、毁损出库、抽检出库数据。

● 药品批发企业用户

药品库存、不合格品记录、采购入库、退货入库、批发销售出库、退货出库、毁损出库、抽检出库数据。

● 药品零售企业用户

药品库存、不合格品记录、采购入库、零售退货入库、零售销售出库、退货出库、毁损出库、抽检出库数据。

除药品库存需定期上传外，其它按实际发生上传。

4.5.1. 接入URL

4.5.2. 接入方式

POST

4.5.3. 请求

请求示例：

HTML 格式请求表单源码：

4.5.4. 响应

本功能响应格式为简单通用数据格式。

JSON 格式响应示例：

{"data":"622","resultCode":0,"resultText":""}

XML 格式响应示例：

0 622

4.6. 下载文件处理情况

基于服务器端并发性能考虑，企业上传的文件不实时处理并反馈处理结果。文件上传成功时，系统仅反馈文件唯一标识。经过一个固定的周期，系统后台服务处理完成后，企业端可依据该唯一标识从服务器获取文件处理情况。

4.6.1. 接入URL

4.6.2. 接入方式

POST/GET

4.6.3. 请求

请求示例：

https://test20120401-1:8081/data/clientAccept/toDowloadFileDeal.do?fid=622&resType=xml

4.6.4. 响应

本功能响应格式为通用数据格式。

JSON 格式响应示例： {"data":

{"dealDesc":"","dealResult":"","dealStatus":"0","dealTime":"","fileId":"622","other":""}, "resultCode":0, "resultText":"" }

XML 格式响应示例：

0

622

0

附录一 企业上传xml 数据文件格式

企业数据采集接口接收的xml 数据文件分为库存记录、不合格药品记录、生产入库、采购入库、批发退货入库、零售退货入库、批发出库、零售出库、退货出库、毁损出库、抽检出库这11种业务类型。

重点提示：

各业务类型表单或明细条目属性描述中标记为[标准化数据字段]的属性，表示应为药品标准数据或企业标准数据唯一标识。 各业务类型xml 数据文件中根节点xmlns 属性值最后部分为对应xml 架构文件名称，可从本文档同一目录下的“xml 架构”子目录获取对应的xml 架构文件。

库存记录

xsd 架构文件名称：yjj_qyjk_kc.xsd

表单属性说明：

不合格药品记录

xsd 架构文件名称：yjj_qyjk_bhg.xsd

明细条目属性说明：

生产入库

xsd 架构文件名称：yjj_qyjk_scrk.xsd

表单属性说明：

明细条目属性说明：

采购入库

xsd 架构文件名称：yjj_qyjk_cgrk.xsd

表单属性说明：

明细条目属性说明：

批发退货入库

xsd 架构文件名称：yjj_qyjk_pfthrk.xsd

零售退货入库

xsd 架构文件名称：yjj_qyjk_lsthrk.xsd

表单属性说明：

批发出库

xsd 架构文件名称：yjj_qyjk_pfck.xsd

表单属性说明：

零售出库

xsd 架构文件名称：yjj_qyjk_lsck.xsd

表单属性说明：

明细条目属性说明：

退货出库

xsd 架构文件名称：yjj_qyjk_thck.xsd

明细条目属性说明：

毁损出库

xsd 架构文件名称：yjj_qyjk_hsck.xsd

抽检出库

xsd 架构文件名称：yjj_qyjk_cjck.xsd 表单属性说明：

附录二 xml 数字签名

为保障企业上报数据的安全，便于确认企业上报原始文档未被修改，企业通过“企业数据采集接口”上报的xml 文件必须经过数字签名。 本接口可接受的xml 文件数字签名遵循W3C 推荐规范- XML 签名的语法和处理规范[]。

补充约定如下： 采用封装签名（Enveloping ）格式，签名和原始xml 文件内容在同一个XML 文档中，原始xml 文件内容作为签名的内部节点；

签名文件必须附带数字证书信息, 签名文件中证书信息相关部分必须设置，且按如下所示指定顺序提供/>。

示例:

Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />

Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />

pHdUADSXDNMmM7py0zuNlx6gQKE=

Ym9uW9ePzi1f0F6vMtTMIpiUC2gNI0o2X8gYvF7yiuXLtUPqN4G1yavil/VTrbFvPxpfEZkdlxL7PU+9oYie4k4pF+fbQhxbkSr5v81t+JHtt37evQyTvWi+8gi7kU/ZbjpF4Msk7PuwrDUOez1e6bWBBvyIvet6UfMN3YXP92U=

CN=NETCA Individual ClassA CA, OU=Individual ClassA CA, O=NETCA Certificate Authority, C=CN

[***********][***********]00

MIID9zCCAt+gAwIBAgIQKGp5KavX8ujDBgo/bvee+DANBgkqhkiG9w0BAQUFADB3MQswCQYDVQQGEwJDTjEkMCIGA1UEChMb TkVUQ0EgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR0wGwYDVQQLExRJb mRpdmlkdWFsIENsYXNzQSBDQTEjMCEGA1UEAxMaTkVUQ0EgSW5kaXZ pZHVhbCBDbGFzc0EgQ0EwHhcNMTIwNDE4MTYwMDAwWhcNMTMwND E5MTU1OTU5WjBkMQswCQYDVQQGEwJDTjESMBAGA1UECBMJR3Vhbm dkb25nMSUwIwYDVQQDHhxOKk66bUuL1QAyADAAMQAxADAANAAyAD IAMQA2MRowGAYJKoZIhvcNAQkBFgt6c0BjbmNhLm5ldDCBnzANBgkqhkiG 9w0BAQEFAAOBjQAwgYkCgYEA1ydRUYSdoofmMeyrY2i/pwzjUaGYLWQyS1W2Z30+V/uSiRRR/QwpeiSOuJcnPAkjuvgiTMz4+eWzWn9rHS56I5RPJaf27juRQoA3Ej+xSahRZSWs2hv0rBXRikAStuwo4uk3hI+Tct98dN9EWBJLPJdYj7ZNMnY8wg+wG91C88kCAwEAAaOCARQwggEQMB8GA1UdIwQYMBaAFLFHZEQZX2XMQLsGS+l5BOAe7LVOMB0GA1UdDgQWBBS6/ou1RSKMmjcY8p2cNjRL/3aaxDBXBgNVHSAEUDBOMEwGCisGAQQBgZJIAQowPjA8BggrBgEFBQcCARYwaHR0cDovL3d3dy5jbmNhLm5ldC9jcy9rbm93bGVkZ2Uvd2hpdG VwYXBlci9jcHMvMBYGA1UdEQQPMA2BC3pzQGNuY2EubmV0MAwGA1U dEwEB/wQCMAAwDgYDVR0PAQH/BAQDAgbAMD8GA1UdHwQ4MDYwNKAyoDCGLmh0dHA6Ly9jbGFzc2FjYTEuY25jYS5uZXQvY3JsL0luZGl2aWR1YWxDQS5jcmwwDQYJKoZIhvcNAQEFBQADggEBAAYW3lOrOLP27xPsec3T vYYTjSdl8sTLaxy3UtFFt3Bgx0CgjiGyoDtacr+2xUk57VLK7XtmtZx/aN+GGjJUpiKni9em1KoxyXQDIrEMjhzS5VEkwlO0xrJsAASICtM9smGWe5yCVm3RGD5U7F9xi8l1BgIsaRWUVzQ2ObzXjA8AMviTmcqMEZGDmNVlyxRyg5yN9GqO WQBthDWZsdqU8wEoI4e+gHyMwCIs4baDtkrb1fyDrcxsuDKnSU0zcfgwpOzFLTht+Ibu4J00s95ciDjXCQ5h2Z2aW6r3cMf/ap5g9FvCm/A2DEAS2Hqws1fvALNJgPehnDdfhOiFz/2MiXY=

附录三 附件说明

子目录” XML架构”：当前支持的所有业务类型xml 数据文件架构。 子目录”原始数据文件示例”：当前支持的所有业务类型原始xml 数据文件示例。 子目录”签名数据文件示例”： 原始数据文件示例目录下原始xml 数据文件对应的已签名数据文件示例。