药监网多系统融合技术标准--零售企业版

中国药品电子监管网多系统融合技术标准（零售药店版）V2.0中信二十一世纪（中国）科技有限公司二〇一九年十月一、总则（一）背景为加强药品电子监管工作与药品零售企业日常工作的业务融合程度，促进电子监管码在企业进销存管理的应用，提高企业管理效率，并避免出现多次扫描、多次报送的情况，充分发挥电子监管码全国统一管理及技术标准的优势，中国药品电子监管网（以下简称电子监管网）发布本技术标准，开放电子监管的数据采集、报送、查询等能力，用于药品零售企业或者相关系统开发商，将药品电子监管工作融入药品零售企业相关日常业务管理信息系统，实现传统扫码或者填报业务与电子监管码业务的融合。（二）文档内容本文主要规定了电子监管网“多系统融合”技术接口标准，主要用于说明电子监管网多系统融合技术标准的接口格式、使用方法，指导各药品零售企业或者相关系统开发商进行对应软件的研制、升级、开发和实施。（三）适用范围本技术标准仅适用于药品零售环节使用。生产、批发、使用环节多系统融合技术标准请关注中国药品电子监管网官方网站（）资料下载栏目。二、接口概述（一）名词解释企业：在电子监管网入网的零售企业，持有中国药品电子监管网分配的数字证书。开发商：为企业提供信息系统的软件开发商或者系统集成商企业。企业用户数字证书：（本规范中简称为UKEY）中国药品电子监管网入网企业所必需配备的，用于企业用户身份识别以及保障系统安全的硬件设备，分为PC版和移动版两种。PC版采用USB接口方式，移动版采用PSAM卡方式，移动版数字证书技术标准及申请方法参见电子监管网或国家总局发布的相关指导意见和技术标准。开发商技术授权数字证书：（本规范中简称为SKEY）为保证电子监管网的系统安全性，多系统融合技术接口在应用时必须包含电子监管网颁发的技术授权数字证书，确保接口安全可控，该证书是采用pfx格式的文件数字证书。往来单位：与本企业有直接业务往来且从事药品相关服务的企、事业单位，如：药品的生产、批发、物流企业。（二）参数格式说明入参说明：inputjson格式举例1：查询本企业往来单位信息（带分页自定义查询接口）{{partnerName:福建多赢医药有限公司,partnerCustomNo:3,partnerCapitalName:,partnerSeqNo:,copCode:,beginDate:2014-01-0100:00:00,endDate:2014-01-3123:59:59,curPage:1,pageSize:50,orderBy:,orderType:1}举例2：通过监管码批量查询药品信息{piatsCodeList:[{code:81599932000000086443},{code:81599932000000086443},{code:88217080001262580459}]}出参说明：详见各接口出参（三）支持环境多系统融合的接口以SDK的形式提供，SDK支持Windows平台和Android平台。在Windows平台下支持两种开发环境，.NetFramework平台提供基于C#语言接口，以动态库形式提供的，该接口由dll组成。.NetFramework开发者在编译时将库dll拷贝到自己的项目bin目录在引用dll文件即可。Java平台提供Java语言开发的jar文件。Java开发需将jar添加到项目类库中使用。在Android平台下，Java语言接口是以静态库和动态库的形式提供的，该接口由jar文件和so文件组成。开发者首先将so文件拷贝到工程文件的jni目录下，将jar文件拷贝到工程文件的lib目录下，然后在Android.mk文件中加入相应内容接口。（四）获取及使用约束多系统融合接口技术标准与测试用SDK可通过电子监管网网站免费下载，用于前期测试开发使用；为确保电子监管网数据的安全性以及质量，电子监管网对多系统融合接口使用情况需进行管控，确保接口不会被滥用。相关开发商如需正式开通该接口，需联系电子监管网进行认证，通过认证后方可申请正式版SDK并获得开发商技术授权数字证书。认证结果将通过电子监管网进行公示，企业可自由选择通过认证的开发商进行多系统融合项目实施。多系统融合接口在最终客户使用时，软件中必须包括开发商技术授权数字证书。该证书每最终用户一个，并且与电子监管网用户身份（即企业用户数字证书中的身份）唯一绑定，不得重复绑定。该证书在开发商通过认证后，可通过电子监管网进行申请获得，并将证书放置于SDK同一文件路径下。多系统融合接口调用时，其部署软件的硬件设备上，必须带有电子监管网颁发的企业用户数字证书，否则无法进行调用。三、接口函数接口函数一览表如下：函数名函数功能安全actSKEY激活开发商技术授权数字证书认证接口actNewToken重新获取令牌上行接口uploadInOutBillInfo上传入出库单deleteMyEntPartner删除本企业往来单位modMyEntPartner管理本企业往来单位下行接口queryCodeRelationFromOneCode通过单个监管码查询关联关系queryDrugInfoFromCodeList通过监管码批量查询药品信息queryMyEntDetailInfo查询本企业基本信息queryCodeRelationFromBillCode通过单个入出库单号查询码关联关系及药品信息queryStoreInfoFromBillDate通过日期批量查询本企业入库单信息queryDrugInfoFromBillCode通过单个入出库单号查询药品信息queryBillProcess查询本企业入出库单处理状态queryUperEntChkOutInfoWithCode查询上游企业出库单据信息（有监管码）queryUperEntChkOutInfoList查询上游企业出库单据信息（无监管码）queryMyEntPartnerList查询本企业往来单位信息（带分页自定义查询接口）autoQueryMyEntPartnerList查询本企业往来单位信息（增量查询接口）queryAllEntPartnerList查询全部往来单位信息queryMyEntPartnerDetail查询本企业往来单位详细信息queryDrugProductList查询药品目录信息（一）安全接口1.激活开发商技术授权数字证书函数名称：actSKEY(Stringinputjson)返回值：json函数说明：激活开发商的技术授权数字证书，获取电子监管网返回的令牌号，令牌号及数字签名是判定企业合法访问电子监管网的重要依据，需注意开发商的技术授权数字证书只能被激活一次,服务端返回“1202：SKey未启用”时，客户端需要调用此接口激活集成商SKey软证书。适用场景：零售企业通过开发商平台向电子监管网请求数据之前，需要先进行激活开发商技术授权数字证书的操作，并获取电子监管网下发的令牌号。请求参数：参数字段名称字段类型字段长度备注UKeyPassword企业数字证密码String8零售入网企业UKey证书密码SKeyPassword开发商数字证书密码String8服务开发商SKey证书密码输出参数：参数字段名称字段类型字段长度备注retCode返回代码String8返回代码，详见附件：返回值列表retMessage返回信息String100返回信息简介retDetail返回详细信息String600返回信息详情resObjtoken令牌号string100电子监管网返回的一串供企业鉴权所用的序列号入参示例：{UKeyPassword:88888888,SKeyPassword:88888888}出参示例：{retCode:1000,retMessage:,retDetail:,resObj:{token:”5cf16b7ba85a404a9e99353fd7fb67de”}}2.重新获取令牌函数名称：actNewToken(Stringinputjson)返回值：json函数说明：为了数据安全起见，零售企业申请的令牌会在一定时间内会失效，需要企业定期重新获取令牌。适用场景：电子监管网下发的令牌号是有生命周期的，如果在访问任何业务接口的时候，返回“1301：令牌失效”时，客户端就需要调用此接口，重新获取令牌号。请求参数：参数字段名称字段类型字段长度备注UKeyPassword企业数字证书密码String8零售入网企业UKey证书密码SKeyPassword开发商数字证书密String8服务开发商SKey证书密码码输出参数：参数字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情resObjtoken令牌号string100电子监管网返回的一串供企业鉴权所用的序列号入参示例：{UKeyPassword:88888888,SKeyPassword:88888888}出参示例：{retCode:1000,retMessage:无,retDetail:无,resObj:{token:”5cf16b7ba85a404a9e99353fd7fb67de”}}（二）上行接口1.上传入出库单函数名称：uploadInOutBillInfo(Stringinputjson)返回值：json函数说明：用户上传入出库单的源文件（需包含文件完整路径，确保sdk包可实现对该文件的加密和上传操作），以及单据相关信息，通过客户端上传单据文件到电子监管网指定文件服务器，并在服务端进行单据处理。上传文件格式根据单据类型不同而不同，详见附录43。适用场景：零售企业通过文件形式，向电子监管网上传入出库单据。请求参数：参数字段名称字段类型字段长度是否必填项备注operFlag操作标志string2是固定传2fileContent上传文件的字节流string是单据的文件用base64转码之后的字节流，用户默认传空uploadInBillInfobillCode单据号string20是单据已经被保存，需要修改时用的保存号码。初始创建时为空dataType单据类型string32否详见附录字典表单据类型drugType药品类型tinyint否详见附录字典表药品类型partnerIdRecv收货单位idstring60否收货单位的entSeqNo，如果是零售出库此处务必填空值partnerIdSend发货单位idstring60否发货单位的entSeqNouploadFileName文件名string60是需要传本地入出库单文件的全路径，由SDK包负责加密、压缩上传，文件格式详见4.3billInOutDate单据创建时间String20是单据被保存的时间，格式为：yyyy-MM-ddHH:mm:ssoperIcName单据提交者姓名string60否提交人全名entSeqNoRecv收货企业名称string250否收货企业名称，如果是零售出库此处务必填空值entSeqNoSend发货企业名称string250否发货企业名称输出参数：参数字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情入参示例：{operFlag:1,fileContent:,uploadInBillInfo:[{billCode:5555,billId:5555,dataType:201,drugType:,partnerIdRecv:bc6aa2329f3a412cbd022b1eb13e9fa2,partnerIdSend:00000000000000909518,uploadFileName:D:\\AutoUp\\UploadPath\\入出库文件.xml,billInO