甘肃省医疗器械追溯监管系统数据接口文档.docx
附件2甘肃省医疗器械追溯监管系统数据接口文档(V24)目录目录2API访问说明3上报器械的发货单信息7上报器械的收货单信息12上传器械的使用（销售）信息16上报器械追溯库存信息19获取上报数据校验失败日志23基本数据集25AP1.访问说明1.获取AP1.访问令牌（秘钥获取：登录甘肃药品智慧监管企业服务平台-点击UDI追溯-企业追溯接口信息-UD1.追溯授权码）PostUTF-8想要专业的梯子?DuaINet设置JSONMJiftB(t1SeaeW*C96f82<J9d7433e8eetxJ0efGa0e910f"seaetKcr92c7ga252354c005977257cc0377c7a549C冷c40e0c480cc80cacb7g7c955b2281.a56eca4daaMiaee3cca4t5<W675a2737a451ba90c7ai4506dd4)Header设置WJiapp1.caton)so,charset*UTF-8Header谪家女，好失ResponseText0巨。ResponseTextm&目t1.侬1。2注S"code-200."message，倒关答求成功匚a）接口信息接口地址测试地址：:9000/gateway-router/api/entrance?s_k=UDI-getToken正式地址：:9000/gateway-router/api/entrance?s_k=PROD-UDI-getToken请求方式POST输入参数参数名理约束说明RawJSON必填授权ID与密钥与管理员联系获取，格式如下（"secret1.d":"x×x×"secretKey":"xxx×"输出参数参数名类型说明codeString返回值msgString返回信息dataObject返回对象data.expiresinInteger有效期（秒）data.tokenpString(50)TimeString(50)token更新时间data.tokenStringtoken接口描述获取请求认证的访问令牌，如有效期内重复请求令牌不会发生改变b）调用示例POST*GhOS用IIokemtyPegIteadorOuwyBodyUiEM执行小后app1.ication)onBOdrIK叨'管HSMItMtfMt-U1.KeyMBkieM1 2 %<rwt1.d:f3",3 rceUCy:e,".4 XC)调用成功(”msg：操作成功，"code”:200,"data":"expires-7200,“SkenUpString(50)Time":"2020-10-2711:24:26”,“token":"xxxx.xxx.XXXXXXXXXXXXX-xxx_xxxxx”)d）调用失败"code":"500”,"msg":"请求失败e）认证失败"msg”:认证失败，无法访问系统资源,“code”:4012.接口资源AP1.a）接口信息Goog1.e提供的广告为什么壶示此广告？停Header加密数据参数名eyJyzxEionsizxzDnRfavvQioiiyMDiyMDUyMZE1的KyMSMnb)接口名称测试地址:9000/gateway-router/api/entrance?s_k=DI-P1.0AD1C:9000/gateway-router/api/entrance?s_k=Prod-Udi-UP1.oad接口描述用于请求对应AP1.资源输入参数参数名类型约束说明RawJSONBase64加密("body":"Base64加密数据"Header参数参数名类型说明参数名AuthorizationString必填Bearer空格token输出参数参数名类型说明codeString返回值msgString返回信息dataObject返回数据c）调用成功(”msg：操作成功，"code”:200,"data”:详见下面事例d）调用失败(“msg：操作失败”，“code”:500)上报器械的发货单信息1 .场景：上报医疗器械唯一标识库中的器械发货的相关数据信息.测试环境请求UR1.：:9000/gateway-router/api/entrance?s_k=UDI-UP1.OAD正式环境请求UR1.：:9000/gateway-router/api/entrance?s_k=PROD-DI-UP1.OADHTTP请求方式：POSTo2 .参数说明：字段名变量名必填类型描述事件编号event_id是String(32)事件编号,UUID,唯一性,区分是否为重复推送数据上报企业名称qymc是String(200)上报企业统一社会信用代码tyshxydm是String(32数据文件内容业务类型sub_type是String(32)发货单数据对应的业务类型必填（“fhd”）时间戳timestamp是String(32)时间戳，格式为YYYYMMddHHmmSSSSS,时区为GMT+8,例如：20190821164206080订货单编号DHDBH是String(50)发货单编号FHDBH是String(50)发货机构名称FHJGMC是String(200)统一社会信用代码（发货机构）Tyshxydmfiijg是String(32)发货地址编号（行政区域代码至区县FHDZBH是String(18)详见A.5发货地址FHDZ是String(200)发货类型FH1.X是String(8)详见A.1收货机构名称SHJGMC是String(200)统一社会信用代码（收货机构）Tyshxydmshjg是String(32)收货地址编号行政区域代码至区县SHDZBH是String(18)收货地址SUDZ是String(200)配送单位名称Ympsdwmc是String(200)统一社会信用代码（配送单位）Tyshxydmympsdw是String(18)产品标识D1.码Sydycpbs是String(32)产品名称/通用名称CPMCTYMC是String(IOO)商品名称SPMC是String(IOO)规格型号是String(50)发货数量FHS1.是Integer生产企业名称SCQYMC是String(200)统一社会信用代码（生产企业）Tyshxydmscqy是String(18)注册证或备案证编号Zczhbazbh是String(50)生产日期SCRQ是String(32)mYYYY-MM-DDv格式的字符串失效日期Ymyxqjzrq是String(32)rtYYYY-MM-DDw格式的字符串生产批号SCPH是String(20)产品类型CP1.X是String(20)1:器械，2:体外诊断试剂医疗器械是否为包类产品/组套类产品Sfwb1.zt1.cp是String(IO)1：是,0：否追溯码信息字段名变量名必填类型描述器械UDI信息QXUDI是String(64)上一级器械IDI信息Syjqxidi是String(64)包装层级BZCJ是String(200)3 .请求报文格式示例json:"req":"event_id”:"事件编号,"sub_type":"fhd'；"qymc":”企业名称”，"tyshxydm":"统一社会行用代码”,"timestamp":"时间戳"，"dataSet":"fhd1.nfo":,CPMCTYMC":"产品名称/通用名称”，"SYDYCPBS":1'产品标识D1.码”,"DHDBH":“订货单编号，"Tyshxydmscqy":"统一社会信用代码（生产企业）"，USHDZBH”:“收货地址编号行政区域代码至区县汽"SCRQ":"生产日期，例："2023-10-23""Tyshxydmshjg":"统一社会信用代码（收货机构）”，"FH1.X":“发货类型”,"SCPH":"生产批号”，"GGXH":"规格型号"，"SHJGMC":"收货机构名称，"FHDBH":"发货单编号”,“FHDZBH":“发货地址编号行政区域代码至区县”，"SPMC”:“商品名称”，"SCQYMC":"生产企业名称”，"TYSHXYDMFHJG":"统一社会信用代码（发货机构）”，"Tyshxydmympsdw":"统一社会信用代码（配送单位）”,FHDZ":"发货地址，“FHJGMC":“发货机构名称，"FHS1.”:发货数量，例：80"Ympsdwmc":"配送单位名称,"YMYXQJZRQ"失效日期，例："2023-10-23""ZCZHBAZBH":"注册证或备案证编号”，"CP1.X":'产品类型”，“SFWB1.ZT1.CP":"医疗器械是否为包类产品/组套类产品”,"UDIINFO":（"BZCT,包装层级”,"QXUDI":"器械UDI信息”，“SYJQXUDF:"上一级器械UDI信息”）14.返回结果字段名变量名示例值描述返回状态码status00:成功1:失败返回信息messageOK业务详细body见报文业务执行状编码buzstatus0业务执行结果描述buzmessage执行成功0：执行成功1005:接口数据类型不匹配1006:接口不存在匹配相应数据类型的
