药监网多系统融合技术标准零售企业版.docx
《药监网多系统融合技术标准零售企业版.docx》由会员分享,可在线阅读,更多相关《药监网多系统融合技术标准零售企业版.docx(102页珍藏版)》请在咨信网上搜索。
1、药监网多系统融合技术标准零售企业版1022020年5月29日文档仅供参考中国药品电子监管网多系统融合技术标准(零售药店版)V2.0中信二十一世纪(中国)科技有限公司二二四年九月一、总则(一)背景为加强药品电子监管工作与药品零售企业日常工作的业务融合程度,促进电子监管码在企业进销存管理的应用,提高企业管理效率,并避免出现多次扫描、多次报送的情况,充分发挥电子监管码全国统一管理及技术标准的优势,中国药品电子监管网(以下简称电子监管网)发布本技术标准,开放电子监管的数据采集、报送、查询等能力,用于药品零售企业或者相关系统开发商,将药品电子监管工作融入药品零售企业相关日常业务管理信息系统,实现传统扫码
2、或者填报业务与电子监管码业务的融合。(二)文档内容本文主要规定了电子监管网”多系统融合”技术接口标准,主要用于说明电子监管网多系统融合技术标准的接口格式、使用方法,指导各药品零售企业或者相关系统开发商进行对应软件的研制、升级、开发和实施。(三)适用范围本技术标准仅适用于药品零售环节使用。生产、批发、使用环节多系统融合技术标准请关注中国药品电子监管网官方网站()资料下载栏目。二、接口概述(一)名词解释企业:在电子监管网入网的零售企业,持有中国药品电子监管网分配的数字证书。开发商:为企业提供信息系统的软件开发商或者系统集成商企业。企业用户数字证书:(本规范中简称为UKEY)中国药品电子监管网入网企
3、业所必须配备的,用于企业用户身份识别以及保障系统安全的硬件设备,分为PC版和移动版两种。PC版采用USB接口方式,移动版采用PSAM卡方式,移动版数字证书技术标准及申请方法参见电子监管网或国家总局发布的相关指导意见和技术标准。开发商技术授权数字证书:(本规范中简称为SKEY)为保证电子监管网的系统安全性,多系统融合技术接口在应用时必须包含电子监管网颁发的技术授权数字证书,确保接口安全可控,该证书是采用pfx格式的文件数字证书。往来单位:与本企业有直接业务往来且从事药品相关服务的企、事业单位,如:药品的生产、批发、物流企业。(二)参数格式说明入参说明:inputjson格式举例1:查询本企业往来
4、单位信息(带分页自定义查询接口)partnerName:福建多赢医药有限公司,partnerCustomNo:3,partnerCapitalName:,partnerSeqNo:,copCode:,beginDate: -01-01 00:00:00 ,endDate: -01-31 23:59:59,curPage:1,pageSize:50,orderBy:,orderType:1举例2:经过监管码批量查询药品信息piatsCodeList:code:8159993 ,code:8159993 ,code:出参说明:详见各接口出参(三)支持环境多系统融合的接口以SDK的形式提供,SDK支
5、持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文件中加入
6、相应内容接口。(四)获取及使用约束多系统融合接口技术标准与测试用SDK可经过电子监管网网站免费下载,用于前期测试开发使用;为确保电子监管网数据的安全性以及质量,电子监管网对多系统融合接口使用情况需进行管控,确保接口不会被滥用。相关开发商如需正式开通该接口,需联系电子监管网进行认证,经过认证后方可申请正式版SDK并获得开发商技术授权数字证书。认证结果将经过电子监管网进行公示,企业可自由选择经过认证的开发商进行多系统融合项目实施。多系统融合接口在最终客户使用时,软件中必须包括开发商技术授权数字证书。该证书每最终用户一个,而且与电子监管网用户身份(即企业用户数字证书中的身份)唯一绑定,不得重复绑定。
7、该证书在开发商经过认证后,可经过电子监管网进行申请获得,并将证书放置于SDK同一文件路径下。多系统融合接口调用时,其部署软件的硬件设备上,必须带有电子监管网颁发的企业用户数字证书,否则无法进行调用。三、接口函数接口函数一览表如下:函数名函数功能安全认证接口actSKEY激活开发商技术授权数字证书actNewToken重新获取令牌上行接口uploadInOutBillInfo上传入出库单deleteMyEntPartner删除本企业往来单位modMyEntPartner管理本企业往来单位下行接口queryCodeRelationFromOneCode经过单个监管码查询关联关系queryDrugI
8、nfoFromCodeList经过监管码批量查询药品信息queryMyEntDetailInfo查询本企业基本信息queryCodeRelationFromBillCode经过单个入出库单号查询码关联关系及药品信息queryStoreInfoFromBillDate经过日期批量查询本企业入库单信息queryDrugInfoFromBillCode经过单个入出库单号查询药品信息queryBillProcess查询本企业入出库单处理状态queryUperEntChkOutInfoWithCode查询上游企业出库单据信息(有监管码)queryUperEntChkOutInfoList查询上游企业出库
9、单据信息(无监管码)queryMyEntPartnerList查询本企业往来单位信息(带分页自定义查询接口)autoQueryMyEntPartnerList查询本企业往来单位信息(增量查询接口)queryAllEntPartnerList查询全部往来单位信息queryMyEntPartnerDetail查询本企业往来单位详细信息queryDrugProductList查询药品目录信息(一)安全接口1.激活开发商技术授权数字证书函数名称:actSKEY (String inputjson)返回值:json函数说明:激活开发商的技术授权数字证书,获取电子监管网返回的令牌号,令牌号及数字签名是判定
10、企业合法访问电子监管网的重要依据,需注意开发商的技术授权数字证书只能被激活一次,服务端返回”1202:SKey未启用”时,客户端需要调用此接口激活集成商SKey软证书。适用场景:零售企业经过开发商平台向电子监管网请求数据之前,需要先进行激活开发商技术授权数字证书的操作,并获取电子监管网下发的令牌号。请求参数:参数字段名称字段类型字段长度备注UKeyPassword企业数字证密码String8零售入网企业UKey证书密码SKeyPassword开发商数字证书密码String8服务开发商SKey证书密码输出参数:参数字段名称字段类型字段长度备注retCode返回代码String8返回代码,详见附件
11、:返回值列表retMessage返回信息String100返回信息简介retDetail返回详细信息String600返回信息详情resObjtoken令牌号string100电子监管网返回的一串供企业鉴权所用的序列号入参示例:UKeyPassword:88888888,SKeyPassword:88888888出参示例: retCode: 1000, retMessage: , retDetail: , resObj: token :” 5cf16b7ba85a404a9e99353fd7fb67de”2.重新获取令牌函数名称:actNewToken (String inputjson)返回
12、值:json函数说明:为了数据安全起见,零售企业申请的令牌会在一定时间内会失效,需要企业定期重新获取令牌。适用场景:电子监管网下发的令牌号是有生命周期的,如果在访问任何业务接口的时候,返回 ”1301:令牌失效”时,客户端就需要调用此接口,重新获取令牌号。请求参数:参数字段名称字段类型字段长度备注UKeyPassword企业数字证书密码String8零售入网企业UKey证书密码SKeyPassword开发商数字证书密码String8服务开发商SKey证书密码输出参数:参数字段名称字段类型字段长度备注retCode返回代码string8返回代码,详见附件:返回值列表retMessage返回信息s
13、tring100返回信息简介retDetail返回详细信息string600返回信息详情resObjtoken令牌号string100电子监管网返回的一串供企业鉴权所用的序列号入参示例:UKeyPassword:88888888,SKeyPassword:88888888出参示例: retCode: 1000, retMessage: 无, retDetail: 无, resObj: token :” 5cf16b7ba85a404a9e99353fd7fb67de”(二)上行接口1.上传入出库单函数名称:uploadInOutBillInfo(String inputjson)返回值:jso
14、n函数说明:用户上传入出库单的源文件(需包含文件完整路径,确保sdk包可实现对该文件的加密和上传操作),以及单据相关信息,经过客户端上传单据文件到电子监管网指定文件服务器,并在服务端进行单据处理。上传文件格式根据单据类型不同而不同,详见附录43。适用场景:零售企业经过文件形式,向电子监管网上传入出库单据。请求参数:参数字段名称字段类型字段长度是否必填项备注operFlag操作标志string2是固定传2fileContent上传文件的字节流string是单据的文件用base64转码之后的字节流,用户默认传空uploadInBillInfobillCode单据号string20是单据已经被保存,
15、需要修改时用的保存号码。初始创立时为空dataType单据类型string32否详见附录字典表单据类型drugType药品类型tinyint否详见附录字典表药品类型partnerIdRecv收货单位idstring60否收货单位的entSeqNo,如果是零售出库此处务必填空值partnerIdSend发货单位idstring60否发货单位的entSeqNouploadFileName文件名string60是需要传本地入出库单文件的全路径,由SDK包负责加密、压缩上传,文件格式详见4.3billInOutDate单据创立时间String20是单据被保存的时间,格式为:yyyy-MM-dd HH:
16、mm:ssoperIcName单据提交者姓名string60否提交人全名entSeqNoRecv收货企业名称string250否收货企业名称,如果是零售出库此处务必填空值entSeqNoSend发货企业名称string250否发货企业名称输出参数:参数字段名称字段类型字段长度备注retCode返回代码string8返回代码,详见附件:返回值列表retMessage返回信息string100返回信息简介retDetail返回详细信息string600返回信息详情入参示例:operFlag:1,fileContent:,uploadInBillInfo:billCode:5555,billId:5
17、555,dataType:201,drugType:,partnerIdRecv:bc6aa2329f3a412cbd022b1eb13e9fa2,partnerIdSend:00909518,uploadFileName:D: AutoUpUploadPath入出库文件.xml,billInOutDate: -01-0609:08:11,operIcName:,corpSeqNo:,corpName:,entSeqNoRecv:3 3,entSeqNoSend:3 3,partnerIdDest:,entSeqNoDest:出参示例: retCode: 1000, retMessage: 无
18、, retDetail: 无,2.删除本企业往来单位函数名称:deleteMyEntPartner(String inputjson)返回值:json 函数说明:删除本企业的往来单位适用场景:零售企业如果不需要在与某家企业作为往来单位,能够调用此接口,解除本企业与该往来单位企业之间的关系,这样在查询本企业往来单位列表的时候,就不会显示该条企业信息。请求参数:参数字段名称字段类型字段长度是否必填项备注partnerListspartnerSeqNo往来单位idstring60是电子监管网上的往来单位id输出参数:参数字段名称字段类型字段长度备注retCode 返回代码string8返回代码,详见
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 药监网多 系统 融合 技术标准 零售 企业版
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,个别因单元格分列造成显示页码不一将协商解决,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【精***】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【精***】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。