政策公告 广东省
粤港澳大湾区内地临床急需进口港澳药械流通管理系统企业数据采集接口对接指南
粤港澳大湾区内地临床急需进口港澳药械流通管理系统
企业数据采集接口对接指南
广东省药品监督管理局
2021年8月
目 录
1 文档介绍................................................................... 1
1.1 编写目的........................................................... 1
1.2 编写范围........................................................... 1
1.3 使用对象........................................................... 1
1.4 参考文档........................................................... 1
1.5 名词解释........................................................... 1
2 系统介绍................................................................... 2
2.1 系统建设背景....................................................... 2
2.2 业务目标........................................................... 2
2.3 系统结构及功能描述................................................. 2
2.4 业务规则........................................................... 3
2.4.1 用户身份验证............................................... 3
2.4.2 数据校验................................................... 3
2.4.3 数据报送................................................... 4
3 系统入口................................................................... 4
4 接口功能................................................................... 4
5 对接步骤................................................................... 5
5.1 前期准备........................................................... 5
5.2 内部系统开发....................................................... 5
5.3 系统联调........................................................... 5
本文为需要与企业数据采集接口进行对接的开发人员提供必要的业务及对接步骤说明。
本文编写范围主要包括系统介绍、系统入口、接口功能、对接步骤。
药械委托经营企业管理人员、药械使用单位管理人员、药械信息系统开发人员。
《粤港澳大湾区临床急需进口药械流通管理系统企业数据采集接口规范》
名词术语 | 解释 |
粤港澳大湾区临床急需进口药械流通管理系统企业端 | 粤港澳大湾区临床急需进口药械流通管理系统面向企业的功能与服务 |
企业数据采集接口 | 粤港澳大湾区临床急需进口药械流通管理系统用于采集企业药械流通数据的数据接口 |
企业专属网页 | 粤港澳大湾区临床急需进口药械流通管理系统企业端的登录入口 |
企业内部系统 | 企业内部实现与企业数据采集接口交互的软件系统 |
粤港澳大湾区内地港澳居民对医疗有迫切需求。粤港澳大湾区总面积5.6万平方公里,常住人口7000万人,地区生产总值超过10万亿元,其中粤港澳大湾区内地9市占了广东省总面积的30.6%、人口的54.2%、生产总值的83.3%。粤港澳大湾区内地的港澳居民人口众多,便捷就医呼声强烈,《工作方案》让安全有效的创新医疗产品更便捷地在粤港澳大湾区内地指定医疗机构使用,解决了粤港澳大湾区内地的港澳居民因医疗需求频繁往来粤港澳三地的实际问题,更好地保障港澳居民身体健康和生命安全。
按照2020年11月25日《粤港澳大湾区药品医疗器械监管创新发展工作方案》的要求,完善粤港澳大湾区临床急需进口药械流通管理系统,对大湾区临床急需药械进行采购、进口、进销、使用全过程管理,实现在湾区九市内来源可溯、去向可追、风险可控、责任可究。
提供合理有效的服务接口供企业内部系统调用,实现企业内部系统与粤港澳大湾区临床急需进口药械流通管理系统的数据对接,方便企业及时报送粤港澳大湾区临床急需进口药械流通监管数据。
粤港澳大湾区临床急需进口药械流通管理系统面向企业使用的功能主要分为企业数据采集接口和粤港澳大湾区临床急需进口药械流通管理系统企业端两部分。
企业数据采集接口作为粤港澳大湾区临床急需进口药械流通管理系统接收企业报送粤港澳大湾区临床急需进口药械流通数据入口之一,主要提供企业内部系统直连报送业务数据的服务。本次升级将为委托配送企业、使用单位提供临床急需进口药械流通数据的报送接口,由这些单位将药械进口信息、药械追溯码及箱包关系信息、药械收货信息、药械发货信息、药械库存信息、药械使用信息报送至粤港澳大湾区临床急需进口药械流通管理系统。
粤港澳大湾区临床急需进口药械流通管理系统企业端以网站方式提供,通过广东省药品监督管理局的企业专属网页登录进入,主要用于通过粤港澳大湾区临床急需进口药械流通管理系统企业端检索和维护从数据采集接口报送的业务数据,查看上传文件的处理情况等功能。
系统根据数字证书验证用户身份有效性,企业用户必须具备有效的数字证书才能访问系统。
数据校验是指将企业报送业务数据需符合以下校验规则,无法匹配的视为校验不通过:
1. 药械批件的校验
以药械批件号完全匹配作为药械批件的匹配依据;
2. 药械品种的校验
药品以药品名称(中文)+剂型+规格+包装规格+生产厂商完全匹配作为品种的匹配依据;
医疗器械以医疗器械名称(中文)+型号+规格+包装规格(如有)+生产厂商完全匹配作为品种的匹配依据;
3. 药械收/发货机构的校验
以药械收/发货机构统一社会信用代码完全匹配作为收发货单位的匹配依据;
4. 追溯码重复校验
企业报送业务数据中,追溯码完全匹配作为匹配依据;
进口信息中已经存在的追溯码不能再次导入;
单次导入事件中存在重复的追溯码不能再次导入;
对于校验不通过的数据,系统不予入库,企业需重新上传。
企业通过接口上传的文件必须经过数字签名,以保障数据有效性及合法性;
企业通过接口上传的数据中数量不允许出现负数;
企业通过接口上传的数据中数据类型为字典值的数据必须使用接口规范中的字典值;
企业如发现数据错误,需通过登录粤港澳大湾区临床急需进口药械流通管理系统企业端进行数据删除操作,删除成功后重新报送正确的数据。
l 练习环境服务器入口
企业专属网页(大湾区临床急需进口药械流通管理系统企业端的入口):
https://lx.gdfda.gov.cn/eportal/
企业数据采集接口:
https://lx.gdfda.gov.cn:8443/{请求入口}
l 生产环境服务器入口
企业专属网页(大湾区临床急需进口药械流通管理系统企业端的入口):
https://qy.gdfda.gov.cn/
企业数据采集接口:
https://qy.gdfda.gov.cn:8443/{请求入口}
功能名称 | 请求入口 | 描述 |
药品文件报送 | https://qy.gdfda.gov.cn:8443/data/clientAccept/toUploadYpFile.do | 用于上传已通过数字签名的XML格式药品数据文件,进口、发货、收货、使用、库存记录均通过该接口上传。 |
医疗器械文件报送 | https://qy.gdfda.gov.cn:8443/data/clientAccept/toUploadQxFile.do | 用于上传已通过数字签名的XML格式医疗器械数据文件,进口、发货、收货、使用、库存记录均通过该接口上传。 |
https://qy.gdfda.gov.cn:8443/data/clientAccept/toDowloadYpFileDeal.do | 用于查询已报送的药品文件处理情况 | |
医疗器械文件处理情况下载 | https://qy.gdfda.gov.cn:8443/data/clientAccept/toDowloadQxFileDeal.do | 用于查询已报送的医疗器械文件处理情况 |
1) 准备数字证书
获取有效的数字证书;
登录一次企业专属网页,系统自动完成用户数据初始化。
2) 阅读技术文档
阅读本开发指南及《粤港澳大湾区临床急需进口药械流通管理系统企业数据采集接口规范》,了解系统开发范围及相关业务、技术细节。
为实现与企业数据采集接口对接,企业内部系统需要实现的主要功能如下:
l 标准HTTPS数据通讯[服务器端及企业端数字证书双向认证];
l 企业内部系统业务单据[进口、发货、收货、使用、库存等],需按照接口规范要求以HTTPS标准格式整合数据文件
l 接口数字签名
涉及企业数据采集接口的具体技术规范请查阅《粤港澳大湾区临床急需进口药械流通管理系统企业数据采集接口规范》。
测试企业内部系统与企业数据采集接口交互的准确性和有效性。
测试人员通过企业内部系统与企业数据采集接口测试入口交互,并登录企业专属网页进入粤港澳大湾区临床急需进口药械流通管理系统企业端检查通过接口报送的数据,从而验证对接是否成功。
相关推荐
CIO提供以下相关文库下载、合规服务以及线上培训课程学习。
2024-09-03
2024-08-28
2024-08-27
2024-07-31
2024-07-24