2广东省药品检验检测接口文档.docx
《2广东省药品检验检测接口文档.docx》由会员分享,可在线阅读,更多相关《2广东省药品检验检测接口文档.docx(38页珍藏版)》请在冰豆网上搜索。
2广东省药品检验检测接口文档
附件2:
广东省“智慧食药监”项目
监管抽验数据接口文档
--药品
版本号:
V1.0.1
1
引言
2
2.1概述
2.2
本接口用于广东省“智慧食药监”基础平台项目的接口对接。
本文档为整体文档的食品相关接口部分。
2.3接口方式及介绍
2.4
本接口采用WEBSERVICE技术,服务端通过axis2方式发布数据上报接口,客户端通过调用服务端数据上报接口,将数据以JSON格式进行传递,同时服务器端返回给客户端接收情况。
在检验检测系统中,提供抽样单数据上报、检验报告数据上报、获取抽样单信息接口,需要对接的系统按照文档规定格式调用接口进行数据的上传或获取。
智慧食药监平台支持抽样单数据的单条及批量上传或获取,检验报告数据的单条及批量上传。
服务端各数据上报接口共享一个类,通过调用不同的方法实现上报不同的数据。
注:
因传输数据中可能存在特殊字符,可能导致乱码或破坏JSON格式,故约定传输数据均采用UTF-8字符集,并进行Base64编码。
返回的异常信息为了方便易读,不进行Base64编码。
示例:
编码前
{
"PLAN_CODE":
"GDSC1504130011",
"PLAN_NAME":
"2015年广东省食品抽样计划",
"INSPECTION_TASKTYPE":
"1"
}
编码后
{
"PLAN_CODE":
"R0RTQzE1MDQxMzAwMTEK",
"PLAN_NAME":
"MjAxNeW5tOW5v+S4nOecgemjn+WTgeaKveagt+iuoeWIkgo=",
"INSPECTION_TASKTYPE":
"MQ=="
}
2.5接口调用交互流程简图
2.6
2.6.1抽样数据上报流程
2.6.2
2.6.3获取抽样单信息并上报检验报告数据流程
2.6.4
3业务接口
4
4.1检验检测接口
4.2
4.2.1药品
4.2.2
4.2.2.1接口说明
4.2.2.2
4.2.2.2.1抽样单数据上报接口
4.2.2.2.2
1)接口地址:
2)
正式地址:
测试地址:
http:
//122.13.2.155:
8087/inspectinfo/services/datainfo.dataReport?
wsdl
3)服务类:
4)
com.service.datainfo.DataReport
5)命名空间
6)
http:
//loushang.ws/
7)方法
8)
//上报药品抽样信息
StringreportMedicineSampleInfo(String);
4.2.2.2.3抽样单信息获取接口
4.2.2.2.4
1)接口地址:
2)
正式地址:
测试地址:
http:
//122.13.2.155:
8087/inspectinfo/services/datainfo.dataReport?
wsdl
3)服务类:
4)
com.service.datainfo.DataReport
5)命名空间
6)
http:
//loushang.ws/
7)方法
8)
//获取药品抽样单信息
StringgetMedicineSampleInfo(String);
4.2.2.2.5检验报告数据上报接口
4.2.2.2.6
1)接口地址:
2)
正式地址:
测试地址:
http:
//122.13.2.155:
8087/inspectinfo/services/datainfo.dataReport?
wsdl
3)服务类:
4)
com.service.datainfo.DataReport
5)命名空间
6)
http:
//loushang.ws/
7)方法
8)
//上报药品检验报告信息
StringreportMedicineInspectInfo(String);
4.2.2.3接口参数
4.2.2.4
4.2.2.4.1抽样单数据上报接口
4.2.2.4.2
[{"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjI=",
"ORGINATION_ID":
"MTIzNDU2Nw==",
"LAST_UPDATE_TIME":
"MjAxNS0xMC0wOS0xNC0yMC0zNQ==",
"SAMPLE_DATE":
"MjAxNS0wOS0wOA==",
"INSPECTION_UNIT":
"5bm/5Lic55yB6aOf5ZOB6I2v5ZOB55uR552j566h55CG5bGA",
"PLAN_TYPE_IDS":
"MDEwMQ==",
"SOURCE_TYPE":
"MA==",
"SOURCE_IDS":
"NDAyODJkODE0ZTAxMjU5ODAxNGUwMTg0NmE1MTAwMTY=",
"SOURCE_DETAILS":
"MDE155uR552j5oq95qOA6K6h5YiS",
"INSPECT_ITEM":
"Mg==",
"SAMPLE_LINK":
"",
"SAMPLE_CHECK_PERSON":
"",
"SAMPLE_CHECK_RECEIVE_DATE":
"MjAxNS0wOS0wOA==",
"PRODUCTION_MEDICINE_NAME":
"5bCP5YS/5p+05qGC6Kej54Ot6aKX57KS",
"PRODUCTION_NAME":
"WFjliLboja/mnInpmZDlhazlj7g=",
"PRODUCTION_ADDRESS":
"5bm/5Lic55yBWFjluIJYWOi3r1hY5Y+3",
"PRODUCTION_BATCH_NO":
"MjAxNTA3MTEyMw==",
"PRODUCTION_PACK_NORMS":
"MTUwZy/nm5I=",
"PRODUCTION_PREPARATION_NORMS":
"M21sL+WJgg==",
"PRODUCTION_EFFECTIVE_DATE":
"MjAxOC0xMi0zMQ==",
"PRODUCTION_APPROVAL_NUMBER":
"",
"SAMPLE_DEPT_NAME":
"5bm/5Lic55yB6aOf5ZOB6I2v5ZOB55uR552j566h55CG5bGA",
"SAMPLE_DEPT_PERSON":
"",
"SAMPLE_DEPT_ADDRESS":
"5bm/5Lic55yB5bm/5bee5biC",
"SAMPLE_DEPT_TEL":
"",
"ENTERPRISE_NAME":
"5bq35YGl6I2v5ZOB5Yi26I2v5Y6C5bm/5Lic5YiG5Y6C",
"SAMPLE_ENT_PERSON":
"",
"ENTERPRISE_ADDRESS":
"5bm/5Lic55yBWFjluIJYWOi3r1hY5Y+3",
"ENTERPRISE_LINKMAN":
"",
"ENTERPRISE_PHONE":
"",
"ENTERPRISE_ZIP_CODE":
"",
"MEDICINE_STOCK":
"MQ==",
"MEDICINE_PREPARATION":
"MQ==",
"MEDICINE_SPECIAL":
"Mg==",
"MEDICINE_OUTER_PACKAGE":
"Mg==",
"MEDICINE_SAMPLE_SITE":
"",
"MEDICINE_SAVE_STATE_TEM":
"",
"MEDICINE_SAVE_STATE_WET":
"",
"MEDICINE_TEM_HUM":
"MQ==",
"MEDICINE_PACKAGE":
"",
"MEDICINE_SAMPLE_NUM":
"",
"MEDICINE_SAMPLE_EXPLAIN":
"",
"MEDICINE_COUNTRY_BASE":
"MQ==",
"MEDICINE_PROVINCE_BASE":
"MQ==",
"REMARK_NOTE":
"",
"REC_DATE":
"",
"REC_PERSON":
"",
"REC_COMMENT":
"",
"IS_PREPROCESS":
"",
"SENDING_UNIT":
"",
"SENDING_PERSON":
"",
"SENDING_DATE":
"",
"CANT_CODE":
"",
"PRODUCT_DRUG_NAME":
"",
"BAR_CODE":
"",
"PRODUCER_REGION_CODE":
"NDQwMDAw",
"PRODUCER_REGION":
"",
"ENTERPRISE_REGION_CODE":
"NDQwMDAw",
"ENTERPRISE_REGION":
"5bm/5Lic55yB5bm/5bee5biC",
"BASIC_UNIT":
"",
"TASK_TYPE":
"",
"BUSINESS_TYPE_ID":
"",
"BUSINESS_TYPE_DESC":
""
},
{"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjM=",
"ORGINATION_ID":
"MTIzNDU2Nw==",
"LAST_UPDATE_TIME":
"MjAxNS0xMC0wOS0xNC0yMC0zNQ==",
"SAMPLE_DATE":
"MjAxNS0wOS0wOA==",
"INSPECTION_UNIT":
"5bm/5Lic55yB6aOf5ZOB6I2v5ZOB55uR552j566h55CG5bGA",
"PLAN_TYPE_IDS":
"MDEwMQ==",
"SOURCE_TYPE":
"MA==",
"SOURCE_IDS":
"NDAyODJkODE0ZTAxMjU5ODAxNGUwMTg0NmE1MTAwMTY=",
"SOURCE_DETAILS":
"MDE155uR552j5oq95qOA6K6h5YiS",
"INSPECT_ITEM":
"Mg==",
"SAMPLE_LINK":
"",
"SAMPLE_CHECK_PERSON":
"",
"SAMPLE_CHECK_RECEIVE_DATE":
"MjAxNS0wOS0wOA==",
"PRODUCTION_MEDICINE_NAME":
"5bCP5YS/5p+05qGC6Kej54Ot6aKX57KS",
"PRODUCTION_NAME":
"WFjliLboja/mnInpmZDlhazlj7g=",
"PRODUCTION_ADDRESS":
"5bm/5Lic55yBWFjluIJYWOi3r1hY5Y+3",
"PRODUCTION_BATCH_NO":
"MjAxNTA3MTEyMw==",
"PRODUCTION_PACK_NORMS":
"MTUwZy/nm5I=",
"PRODUCTION_PREPARATION_NORMS":
"M21sL+WJgg==",
"PRODUCTION_EFFECTIVE_DATE":
"MjAxOC0xMi0zMQ==",
"PRODUCTION_APPROVAL_NUMBER":
"",
"SAMPLE_DEPT_NAME":
"5bm/5Lic55yB6aOf5ZOB6I2v5ZOB55uR552j566h55CG5bGA",
"SAMPLE_DEPT_PERSON":
"",
"SAMPLE_DEPT_ADDRESS":
"5bm/5Lic55yB5bm/5bee5biC",
"SAMPLE_DEPT_TEL":
"",
"ENTERPRISE_NAME":
"5bq35YGl6I2v5ZOB5Yi26I2v5Y6C5bm/5Lic5YiG5Y6C",
"SAMPLE_ENT_PERSON":
"",
"ENTERPRISE_ADDRESS":
"5bm/5Lic55yBWFjluIJYWOi3r1hY5Y+3",
"ENTERPRISE_LINKMAN":
"",
"ENTERPRISE_PHONE":
"",
"ENTERPRISE_ZIP_CODE":
"",
"MEDICINE_STOCK":
"MQ==",
"MEDICINE_PREPARATION":
"MQ==",
"MEDICINE_SPECIAL":
"Mg==",
"MEDICINE_OUTER_PACKAGE":
"Mg==",
"MEDICINE_SAMPLE_SITE":
"",
"MEDICINE_SAVE_STATE_TEM":
"",
"MEDICINE_SAVE_STATE_WET":
"",
"MEDICINE_TEM_HUM":
"MQ==",
"MEDICINE_PACKAGE":
"",
"MEDICINE_SAMPLE_NUM":
"",
"MEDICINE_SAMPLE_EXPLAIN":
"",
"MEDICINE_COUNTRY_BASE":
"MQ==",
"MEDICINE_PROVINCE_BASE":
"MQ==",
"REMARK_NOTE":
"",
"REC_DATE":
"",
"REC_PERSON":
"",
"REC_COMMENT":
"",
"IS_PREPROCESS":
"",
"SENDING_UNIT":
"",
"SENDING_PERSON":
"",
"SENDING_DATE":
"",
"CANT_CODE":
"",
"PRODUCT_DRUG_NAME":
"",
"BAR_CODE":
"",
"PRODUCER_REGION_CODE":
"NDQwMDAw",
"PRODUCER_REGION":
"",
"ENTERPRISE_REGION_CODE":
"NDQwMDAw",
"ENTERPRISE_REGION":
"5bm/5Lic55yB5bm/5bee5biC",
"BASIC_UNIT":
"",
"TASK_TYPE":
"",
"BUSINESS_TYPE_ID":
"",
"BUSINESS_TYPE_DESC":
""
}]
4.2.2.4.3抽样单信息获取接口
4.2.2.4.4
上传参数:
[{
"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjI=",
"ORGINATION_ID":
"MDAxMDMzMzQ=",
"BATCH_FLAG":
"MQ==",//编码前为1
"START_TIME":
"MjAxNS0wOS0yMS0wOS0xMC0xMA==",//编码前为2015-09-21-09-10-10
"END_TIME":
"MjAxNi0wOS0yMS0wOS0xMC0xMA=="//编码前为2016-09-21-09-10-10
}]
参数说明:
JSON中的KEY
描述
字段类型长度
备注
SAMPLE_BASE_NO
抽样单编号
Varchar2(100)
ORGINATION_ID
组织机构ID
Varchar2(100)
BATCH_FLAG
批量获取标志(值为0或1)
char
(1)
值为1表示批量获取到所有已送样到该机构且未出检验报告的抽样单信息
START_TIME
查询抽样单创建起始时间
char(20)
BATCH_FLAG=1时才有效(格式为yyyy-MM-dd-hh-mm-ss)
END_TIME
查询抽样单创建截止时间
char(20)
BATCH_FLAG=1时才有效(格式为yyyy-MM-dd-hh-mm-ss)
4.2.2.4.5检验报告数据上报接口
4.2.2.4.6
[
{"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjI=",
"ORGINATION_ID":
"MTIzNDU2Nw==",
"LAST_UPDATE_TIME":
"MjAxNS0xMC0wOS0xNC0yMC0zNQ==",
"SAMPLE_RECEIVER":
"5byg5bCP5Y2O",
"SAMPLE_RECEIVE_DATE":
"MjAxNS0wOS0wOQ==",
"SAMPLE_RECIVE_AMOUT":
"NTA=",
"SAMPLE_ARRIVE_DATE":
"MjAxNS0wOS0wOQ==",
"SAMPLE_SEALED_STATUS":
"5a6M5aW9",
"INSPECTION_REPORT":
{
"INSPECTION_NO":
"SkQwMDkxMjA5MA==",
"INSPECTION_NAME":
"5bCP5YS/5p+05qGC6Kej54Ot6aKX57KS",
"REPORT_NO":
"MjAxNTA5MDkwMDIz",
"REPORT_DATE":
"MjAxNS0wOS0wOQ==",
"INSPECTION_RESULT_CODE":
"MQ==",
"INSPECTION_UNIT":
"5bm/5Lic55yB6I2v5ZOB55uR552j5bGA",
"INSPECTION_CONCLUSION":
"5ZCI5qC8",
"REMARK":
"",
"SIGNER":
"5bCP546L",
"SIGN_DATE":
"MjAxNS0wOS0xMQ==",
"INSPECTION_OBJECT":
"",
"INSPECTION_BASIS":
"",
"INSPECTION_DATE":
"MjAxNS0wOS0xMQ==",
"INSPECTION_ITEMS":
[
{
"INSPECTION_ITEM":
"6ZOF",
"INSPECTION_RESULT":
"5ZCI5qC8",
"STANDARD_PROVISION":
"MTIz"
},{
"INSPECTION_ITEM":
"6ZOF",
"INSPECTION_RESULT":
"5ZCI5qC8",
"STANDARD_PROVISION":
"MTIz"
}
]
}
},
{"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjI=",
"ORGINATION_ID":
"",
"LAST_UPDATE_TIME":
"MjAxNS0xMC0wOS0xNC0yMC0zNQ==",
"SAMPLE_RECEIVER":
"5byg5bCP5Y2O",
"SAMPLE_RECEIVE_DATE":
"MjAxNS0wOS0wOQ==",
"SAMPLE_RECIVE_AMOUT":
"NTA=",
"SAMPLE_ARRIVE_DATE":
"MjAxNS0wOS0wOQ==",
"SAMPLE_SEALED_STATUS":
"5a6M5aW9",
"INSPECTION_REPORT":
{
"INSPECTION_NO":
"SkQwMDkxMjA5MA==",
"INSPECTION_NAME":
"5bCP5YS/5p+05qGC6Kej54Ot6aKX57KS",
"REPORT_NO":
"MjAxNTA5MDkwMDIz",
"REPORT_DATE":
"MjAxNS0wOS0wOQ==",
"INSPECTION_RESULT_CODE":
"MQ==",
"INSPECTION_UNIT":
"5bm/5Lic55yB6I2v5ZOB55uR552j5bGA",
"INSPECTION_CONCLUSION":
"5ZCI5qC8",
"REMARK":
"",
"SIGNER":
"5bCP546L",
"SIGN_DATE":
"MjAxNS0wOS0xMQ==",
"INSPECTION_OBJECT":
"",
"INSPECTION_BASIS":
"",
"INSPECTION_DATE":
"MjAxNS0wOS0xMQ==",
"INSPECTION_ITEMS":
[
{
"INSPECTION_ITEM":
"6ZOF",
"INSPECTION_RESULT":
"5ZCI5qC8",
"STANDARD_PROVISION":
"MTIz"
},{
"INSPECTION_ITEM":
"6ZOF",
"INSPECTION_RESULT":
"5ZCI5qC8",
"STANDARD_PROVISION":
"MTIz"
}
]
}
}
]
4.2.2.5接口返回值
4.2.2.6
4.2.2.6.1抽样单数据上报接口
4.2.2.6.2
1)正常状态:
2)
{
"ERRORCODE":
"MA==",
"ERRORMSG":
""
}
3)异常状态:
4)
{
"ERRORCODE":
"NDAwMDM=",
"ERRORMSG":
"5pyq55+l6ZSZ6K+v"
}
参数说明:
ERRORCODE
错误类型代码
ERRORMSG
具体错误内容
描述
备注
0
(空)
表述正常
40001
数据库操作异常
40002
参数格式有误
传参格式不正确
不符合JSON格式
40003
未知错误
其他类型的未知错误
4.2.2.6.3抽样单信息获取接口
4.2.2.6.4
1)正常状态:
2)
{"ERRORCODE":
"MA==",
"ERRORMSG":
[
{"SAMPLE_BASE_NO":
"R0QyMDE1MDcyMzAwMjI=",
"ORGINATION_ID":
"",
"LAST_UPDATE_TIME":
"MjAxNS0xMC0wOS0xNC0yMC0zNQ==",
"SAMPLE_DATE":
"MjAxNS0wOS0wOA==",
"INSPECTION_UNIT":
"5bm/5Lic55yB6aOf5ZOB6I2v5ZOB55uR552j566h55CG5bGA",
"PLAN_TYPE_IDS":
"MDEwMQ==",
"SOURCE_TYPE":
"MA==",
"SOURCE_IDS":
"NDAyODJkODE0ZTAxMjU5ODAxNGUwMTg0NmE1MTAwMTY=",
"SOURCE_DETAILS":
"MDE155uR552j5oq95qOA6K6h5YiS",
"INSPECT_ITEM":
"Mg==",
"SAMPLE_LINK":
"",
"SAMPLE_CHECK_P