技术规范标准_药品电子监管网多系统融合技术标准

中国药品电子监管网多系统融合技术标准（零售药店版）V2.0中信二十一世纪（中国）科技有限公司二一九二一九年六月一、总则（一）背景为加强药品电子监管工作与药品零售企业日常工作的业务融合程度，促进电子监管码在企业进销存管理的应用，提高企业管理效率，并避免出现多次扫描、多次报送的情况，充分发挥电子监管码全国统一管理及技术标准的优势，中国药品电子监管网（以下简称电子监管网）发布本技术标准，开放电子监管的数据采集、报送、查询等能力，用于药品零售企业或者相关系统开发商，将药品电子监管工作融入药品零售企业相关日常业务管理信息系统，实现传统扫码或者填报业务与电子监管码业务的融合。（二）文档内容本文主要规定了电子监管网“多系统融合”技术接口标准，主要用于说明电子监管网多系统融合技术标准的接口格式、使用方法，指导各药品零售企业或者相关系统开发商进行对应软件的研制、升级、开发和实施。（三）适用范围本技术标准仅适用于药品零售环节使用。生产、批发、使用环节多系统融合技术标准请关注中国药品电子监管网官方网站（）资料下载栏目。二、接口概述（一）名词解释企业：在电子监管网入网的零售企业，持有中国药品电子监管网分配的数字证书。开发商：为企业提供信息系统的软件开发商或者系统集成商企业。企业用户数字证书：（本规范中简称为UKEY）中国药品电子监管网入网企业所必需配备的，用于企业用户身份识别以及保障系统安全的硬件设备，分为PC版和移动版两种。PC版采用USB接口方式，移动版采用PSAM卡方式，移动版数字证书技术标准及申请方法参见电子监管网或国家总局发布的相关指导意见和技术标准。开发商技术授权数字证书：（本规范中简称为SKEY）为保证电子监管网的系统安全性，多系统融合技术接口在应用时必须包含电子监管网颁发的技术授权数字证书，确保接口安全可控，该证书是采用pfx格式的文件数字证书。往来单位：与本企业有直接业务往来且从事药品相关服务的企、事业单位，如：药品的生产、批发、物流企业。（二）参数格式说明入参说明：inputjson格式举例1：查询本企业往来单位信息（带分页自定义查询接口）partnerName:福建多赢医药有限公司,partnerCustomNo:3,partnerCapitalName:,partnerSeqNo:,copCode:,beginDate: 2014-01-01 00:00:00 ,endDate:2014-01-31 23:59:59,curPage:1,pageSize:50,orderBy:,orderType:1举例2：通过监管码批量查询药品信息piatsCodeList:code:81599932000000086443,code:81599932000000086443,code:88217080001262580459出参说明：详见各接口出参（三）支持环境多系统融合的接口以SDK的形式提供，SDK支持Windows平台和Android平台。在Windows平台下支持两种开发环境，.Net Framework平台提供基于C#语言接口，以动态库形式提供的，该接口由dll组成。.Net Framework开发者在编译时将库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 (String inputjson)返回值：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 (String inputjson)返回值：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(String inputjson)返回值：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-dd HH: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: AutoUpUploadPath入出库文件.xml,billInOutDate:2015-01-0609:08:11,operIcName:,corpSeqNo:,corpName:,entSeqNoRecv:320000000000084823,entSeqNoSend:320000000000084823,partnerIdDest:,entSeqNoDest:出参示例： retCode: 1000, retMessage: 无, retDetail: 无,2.删除本企业往来单位函数名称：deleteMyEntPartner(String inputjson)返回值：json 函数说明：删除本企业的往来单位适用场景：零售企业如果不需要在与某家企业作为往来单位，可以调用此接口，解除本企业与该往来单位企业之间的关系，这样在查询本企业往来单位列表的时候，就不会显示该条企业信息。请求参数：参数字段名称字段类型字段长度是否必填项备注partnerListspartnerSeqNo往来单位idstring60是电子监管网上的往来单位id输出参数：参数字段名称字段类型字段长度备注retCode 返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retObjentPartnerResponseentName往来单位名称string250企业在电子监管网上的名称partnerSeqNo往来单位idstring32往来单位序号入参示例：partnerLists:partnerSeqNo:fe004a0313bb4325bbc5b26b05f93ce8 出参示例： retCode: 1000, retMessage: 无, retDetail: 无,3.管理本企业往来单位函数名称：modMyEntPartner(String inputjson)返回值：json函数说明：新增或维护本企业往来单位。适用场景：零售企业需要新增一个往来单位，或者修改本企业现有往来单位的自定义编码。请求参数：参数字段名称字段类型字段长度是否必填项备注entPartnerpartnerCustomNo往来单位自定义编号string20否初始由系统自动设置，用户可以改partnerName往来单位名称string250否企业中文名称entSeqNo电子监管网企业idstring20否电子监管网上的企业id，通常从往来单位接口中获取partnerSeqNo往来单位idstring20是企业本地服务系统中的往来单位idaddress往来单位地址string250否企业地址详细信息postalCode邮编string20否企业所在地区邮编notes备注string600否备注信息partnerCapitalName企业名称拼接string250否企业名称的全拼字母，且大写contactName联系人string20否企业联系人名称faxNo传真string20否企业传真电话号码mobileNo移动电话string20否企业联系人手机电话telNo联系电话string20否企业常用座机电话saveFlag保存标志string2是1修改往来单位, 2修改自定义编号, 3添加本企业往来单位输出参数：参数字段名称字段类型字段长度备注retCode返回代码String8返回代码，详见附件：返回值列表retMessage返回信息String100返回信息简介retDetail返回详细信息String600返回信息详情retObjentPartnerResponseentName企业名称string250企业在电子监管网上的名称partnerSeqNo往来单位idstring32电子监管网往来单位id入参示例： entPartner: partnerCustomNo: fe004a0313bb4325bbc5b26b05f93ce8, partnerName: 北京紫光制药有限公司, entSeqNo: 889966228, partnerSeqNo: fe004a0313bb4325bbc5b26b05f93ce8, address: , postalCode: , notes: , partnerCapitalName: beijingziguangzhiyaoyouxiangongsi, contactName: , faxNo: , mobileNo: , telNo: , saveFlag: 3 出参示例： retCode: 1000, retMessage: 无, retDetail: 无, resObj: entPartnerResponse:“entName” : 金象大药房（望京店）, “errormessage”: 无,“partnerSeqNo” : 无,（三）下行接口1.通过单个入库单号查询码关联关系及药品信息函数名称：queryCodeRelationFromBillCode (String inputjson)返回值：json函数说明：通过本企业已上传（企业上传的入库单需等待电子监管网处理结束后，才能查询）的单据号，查询出本入库单对应的监管码关联关系和药品信息。适用场景：零售企业在入库时一般都是整箱入库，但是零售出库时，往往都是以中、小包装销售出库，通过入库单查询关联关系，可以方便企业在销售出库前，在本地进行核注核销校验。请求参数：参数字段名称字段类型字段长度是否必填项备注billCode单据编号string20是本企业的入库单据号输出参数：参数字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情resObjentChkInInfobillCode单据编号string100本企业已上传的入库单号billType单据类型string32详见附录字典表单据类型billFileName单据文件名string100企业上传单据时填的文件名billTypeName单据类型名称string32详见附录字典表单据类型entSendName发货企业名称string250上游发货企业名称entSendId发货企业入网编号string60发货企业入网编号entRecvName收货企业名称string250本企业名称entRecvId收货企业入网编号string60收货企业入网编号storeInDate入库日期string20格式为：yyyy-MM-dd HH:mm:ssprocessString处理日期string20格式为：yyyy-MM-dd HH:mm:ssupdateDate单据最后更新时间string20格式为：yyyy-MM-dd HH:mm:ssdrugInfosdrugInfoListprodSeqNo药品标识string32电子监管网药品idproductCode药品通用代码string60药品通用代码prepnUnit制剂单位编码String32例如：毫克、支、片subTypeNo药品子标识string32电子监管网药品子类idprodName药品商品名string250企业制定的药品商品名drugType药品类型tinyint详见附录字典表药品类型drugTypeName药品类型名称string60详见附录字典表药品类型productEntName生产企业名称string250药品生产企业名称produceBatchNo生产批号string32药品生产企业定义的批次号produceDate生产日期string20格式为：yyyy-MM-dd HH:mm:ssvalidEndDate药品有效期至string20格式为：yyyy-MM-dd HH:mm:sspkgRatio包装比例string20例如1:10:10approveNo批准文号string20药品批准文号prepnSpec制剂规格string100例如：100mg 10packageSpec包装规格string100例如：6毫升/瓶leastPkgAmount按最小包装单位统计数量int以最小包装统计的单位数量leastPrepnAmount按最小制剂单位统计数量int以最小制剂统计的单位数量codeInfoscodeInfoListcode监管码string2020位监管码parentCode父码tinyint20位监管码codeLevel监管码级别tinyint监管码隶属于第几级包装级别，例如2表示第二级入参示例： billCode: 201412191241365001出参示例： retCode: 1000, retMessage: 无, retDetail: 无, resObj: entChkInInfo: billCode: 000000000002020143334, billType: PurchaseWareHouseIn , billFileName: 2014111113242012.xml, billTypeName: 生产入库单, entSendName: 国药集团北京分工公司, entSendId: 1005203201, entRecvName : 金象大药房（望京店）, entRecvId: 1005203201, storeInDate: 2014-11-11 15:11:23, processDate: 2012-14-11 16:15:23, “drugInfos”: drugInfoList: subTypeNo: 1005203201, prodName: 板蓝根冲剂, drugType 10, drugTypeName: 中药制剂, productEntName: 北京同仁堂制药厂, produceBatchNo: 12313232, produceDate: 2014-12-21 12:13:34, validEndDate: 2014-01-21 17:11:23, leastPkgAmount: 20, leastPrepnAmount: 22, “codeInfos”: codeInfoList : code: 000000000002020143334, parentCode: 0000000000020141334, codeLevel: 2 , updateDate: 2014-06-23 12:11:23, 2.通过单个入出库单号查询药品信息 函数名称：queryDrugInfoFromBillCode(String inputjson)返回值：json函数说明：通过本企业已上传（企业上传的入出库单需等待电子监管网处理结束后，才能查询）的单据号，查询单据对应药品信息。适用场景：企业在销售出库时，核对单据中药品与实际入出库药品是否相符。请求参数：参数字段名称字段类型字段长度是否必填项备注billCode单据编号String20是本企业的入出库单据号输出参数：参数字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情resObjentChkInInfobillCode单据编号string100企业上传电子监管网时填的单据号billType单据类型string32详见附录字典表单据类型billFileName单据文件名string100企业上传单据时的文件名billTypeName单据类型名称string32详见附录字典表单据类型entSendName发货企业名称string250上游发货企业中文名称entSendId发货企业入网编号string60电子监管网企业入网编号entRecvName收货企业名称string250收货企业名称entRecvId收货企业入网编号string60电子监管网企业入网编号storeInDate入库日期string20格式为：yyyy-MM-dd HH:mm:ssprocessString处理日期string20格式为：yyyy-MM-dd HH:mm:ssupdateDate单据最后更新时间string20格式为：yyyy-MM-dd HH:mm:ssdrugInfosdrugInfoListprodSeqNo药品标识string32电子监管网药品idproductCode药品通用代码string60药品通用代码prepnUnit制剂单位编码String32例如毫克、支、片subTypeNo药品子标识string32电子监管网药品子类idprodName药品商品名称string250电子监管网上的药品商品名称drugType药品类型tinyint详见附录字典表药品类型drugTypeName药品类型名称string60详见附录字典表药品类型productEntName生产企业名称string250药品生产企业中文名produceBatchNo生产批号string32药品生产企业定义的批次号produceDate生产日期string20格式为：yyyy-MM-dd HH:mm:ssvalidEndDate药品有效期至string20格式为：yyyy-MM-dd HH:mm:sspkgRatio包装比例string20例如1:10:10approveNo批准文号string20药品批准文号prepnSpec制剂规格string100例如100mg 10packageSpec包装规格string100例如6毫升/瓶leastPkgAmount按最小包装单位统计数量int以最小包装统计的单位数量leastPrepnAmount按最小制剂单位统计数量int以最小制剂统计的单位数量入参示例： billCode: 201412191241365001出参示例：retCode: 1000, retMessage: 无, retDetail: 无, resObj: entChkInInfo: billCode: 000000000002020143334, billType: PurchaseWareHouseIn , billFileName: 201412233232012.xml, billTypeName: 生产入库单, entSendName: 国药集团北京分公司, entSendId: 820a9168229e4dc5a41bdfb7fde314f3, entRecvName : 金象大药房（望京店）, entRecvId: 820a9168229e4dc5a41bdfb7fde314f3, storeInDate: 2014-03-21 14:23:34, processDate: 2012-06-15 15:11:23, “drugInfos”: drugInfoList: subTypeNo: 1005203201, prodName: 板蓝根冲剂, drugType 10, drugTypeName: 中药制剂, productEntName: 北京同仁堂制药厂, produceBatchNo: 201412313232, produceDate: 2014-08-11 14:23:34, validEndDate: 2014-09-21 15:11:23, leastPkgAmount: 20, leastPrepnAmount: 22, , updateDate: 2014-12-08 15:11:23 3.通过时间段批量查询本企业入出库单信息函数名称：queryStoreInfoFromBillDate（string inputJson）返回值：json函数说明：通过本企业已上传到药监网入出库单据的上传时间，批量查询出该时间段内所有本企业已上传的历史入出库单基础信息。适用场景：企业需要查询自己上传的所有历史入出库单号，然后再通过单号获取单据中的关联关系或药品信息。请求参数：参数字段名称字段类型字段长度是否必填项备注说明beginDate更新时间开始string20是根据单据创建时间查询，单据限制1个月内，格式为：yyyy-MM-dd HH:mm:ssendDate更新时间结束string20是billType单据类型string32是详见附录字典表单据类型curPage当前页int是需要校验每页不得超过50条pageSize每页记录数int是输出参数：参数字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情resObjentChkInInfoListbillCode单据编号string100企业上传单据时填的单据号billType单据类型string32详见附录字典表单据类型billFileName单据文件名string100企业上传单据时填的文件名billTypeName单据类型名称string32详见附录字典表单据类型entSendName发货企业名称string250上游发货企业中文名称entSendId发货企业标识string60电子监管网企业入网编号entRecvName收货企业名称string250收货企业名称entRecvId收货企业标识string60电子监管网企业入网编号storeInDate入库日期string20格式为：yyyy-MM-dd HH:mm:ssprocessString处理日期string20格式为：yyyy-MM-dd HH:mm:ssupdateDate单据最后更新时间string20格式为：yyyy-MM-dd HH:mm:sspageResponsetotalPages总页数int页数totalRecords总条目数int总记录数入参示例： beginDate: 2014-12-01 00:00:00, endDate: 2014-12-31 23:59:59, curPage: 1, pageSize: 5, billType: 201出参示例： retCode: 1000, retMessage: 无, retDetail: 无, resObj: entChkInInfoList: billCode: 1005203201, billType: PurchaseWareHouseIn , billFileName: xxxxx2012.xml, billTypeName: 生产入库单, entSendName: 同仁堂制药厂, entSendId: 1005203201, entRecvName : 国药集团北京分公司, entRecvId: 1005203201, storeInDate: 2013 10-12 05:03:20, processDate: 2013-12-11 04:20:32, updateDate: 2013-12-21 12:34:56, pageResponse: totalPages: 12, totalRecords: 50 4.查询本企业入出库单处理状态函数名称：queryBillProcess（string inputJson）返回值：json函数说明：该接口用作处理状态的查询，根据开始时间、截至时间、单据类型、药品类型、单据号码、处理状态等信息，查询出入出库单的属性。适用场景：企业上传入出库单后，需要查询当前单据处理结果，一旦单据处理完毕，才可以进行通过单据取码关联关系的后续业务流程。请求参数：参数字段名称字段类型字段长度是否必填项备注说明chkInoutProcessRequestdataType单据类型String32是A：全部、PurchaseWareHouseIn：采购入库，其余详见字典表单据类型entStoreInoutId单据编号String32否入出库单据号beginDate更新时间开始string20是根据单据创建时间查询，单据限制1个月内，格式为：yyyy-MM-ddendDate更新时间结束string20是processFlag处理状态,string32是A:所有状态, 0:未处理, 1:待处理, 3:处理成功, 4:处理失败pageResquestcurPage当前页int是需要确保每页不得超过50条pageSize每页记录数int是输出参数：字段名称字段类型字段长度备注retCode返回代码string8返回代码，详见附件：返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情resObjuperEntChk