DB4403-T 259-2022电子动物检疫合格证明数据接口规范-（高清版）

ICS35.200CCSL78

DB4403深 圳 市 地 方 标 准DB4403/T259—2022电子动物检疫合格证明数据接口规范Datainterfacespecificationforelectroniccertificateofanimalquarantine2022-09-092022-09-092022-10-01深圳市市场监督管理局发布DB4403/T259—2022DB4403/T259—2022DB4403/T259—2022DB4403/T259—2022目 次前言 II范围 1规范性引用文件 1术语和定义 1数据接口方式 1数据调用接口参数 1附录A（资料性）动物检疫合格证明电子出证数据词典 4参考文献 9II前 言本文件按照GB/T1.1—2020《标准化工作导则第1草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由深圳市市场监督管理局提出并归口。本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、深圳市动物卫生监督所。本文件主要起草人：徐立峰、周哲、刘佳、张碧华、苏巍、郑文科、刘浩、练晓、孙勇、苏晓润、郭静文、林国墩、薛瑶。IIII电子动物检疫合格证明数据接口规范范围本文件规定了电子动物检疫合格证明的数据接口方式和数据调用接口参数。本文件适用于企业对电子动物检疫合格证明数据的接口调用。规范性引用文件本文件没有规范性引用文件。术语和定义下列术语和定义适用于本文件。3.1电子动物检疫合格证明electroniccertificateofanimalquarantine动物卫生监督机构指派官方兽医对动物、动物产品实施检疫后，出具的电子化检疫证明。数据接口方式身份认证要求身份认证要求调用方需申请对应appid（应用唯一标识）和appsecret（私钥）。接口传输要求接口使用JSON传输数据，具备通用性和可扩展性。APIAPI接口应符合以下要求：接口名称：电子动物检疫合格证明调用接口；appidappsecret，可根据目的地企业统一社会信用代码和检疫证签发日期查询对应的电子动物检疫合格证明申请；接口地址：接口调用的地址；示例1：/trace/api/api/quarantine/queryQuarantine请求方式：POST；接口标识符：/api/quarantine/queryQuarantine；请求示例：请求数据的接口地址示例说明；示例2：body参数{"ddtydm":"92440300MA5GXLEU29","bz":"2022-06-28"}g）输入参数：访问接口所需的参数，见5.1；h）返回参数：请求反馈的结果，见5.2。5数据调用接口参数1输入参数电子动物检疫合格证明调用接口输入参数及说明见表1。表1电子动物检疫合格证明调用接口输入参数及说明输入参数是否非空说明bodyddtydm是目的地企业统一社会信用代码bz是检疫证签发日期（日期格式yyyy-mm-dd）headernonce是随机串（不少于10位）appid是分配每个调用方1个appid和1个appsecrettimestamp是时间戳signature是计算方式：appid、appsecret、nonce、timestamp四个参数按ASCII排序，即appid=xxxxx&appsecret=xxxxxxx&nonce=xxxxxxxxxx×tamp=xxxxxxxx，计算MD5值转大写返回参数电子动物检疫合格证明调用接口返回参数及说明见表2。表2电子动物检疫合格证明调用接口返回参数及说明返回参数是否非空说明resultjyzh是检疫证号（10-11位检疫证号）jyzlb是动物检疫合格证明类别代码见表A.1zt是状态（1正常、3作废、4超期）hz是货主hzCode否货主企业动检证列表查看码hztydm是货主统一社会信用代码hzdh是货主联系电话cpmc是产品名称dwdm是动物代码（5位数字，见表A.2中动物代码）cplxdm是产品类型代码（见表A.3中产品代码）cd是产地sl是数量sldw是数量单位代码（见表A.4中分类代码2所对应的代码）qqhdm是启运地区划代码qdmc是启运地名称dqhdm是到达地区划代码ddmc是到达地名称ddtydm是目的地企业统一社会信用代码ddCode否目的地企业动检证列表查看码cpsctydm是产品生产单位统一社会信用代码cpscmc是产品生产单位名称cpscdz是产品生产单位地址cpjybz是产品检疫标志号zddyxq是（见表A.45bz否备注gfsyxm是官方兽医姓名rq是检疫合格证明签发时间ysfs否运输方式代码(见表A.4中分类代码3所对应的代码)ysph否运输牌号debh否牲畜耳标号22表2电子动物检疫合格证明调用接口返回参数及说明（续）返回参数是否非空说明message是提示信息success是成功标识，true代表成功，false代表失败code是状态码200代表成功，状态码500代表失败33附录A（资料性）动物检疫合格证明电子出证数据词典动物检疫合格证明类别代码动物检疫合格证明类别代码表见表A.1。表A.1动物检疫合格证明类别代码表类别名称简称类别代码备注动物检疫合格证明(动物A)动物A证JDA适用于跨省境出售或者运输动物动物检疫合格证明(动物B)动物B证JDB适用于省内出售或者运输动物动物检疫合格证明(产品A)产品A证JCA适用于跨省境出售或者运输动其动物产品动物检疫合格证明(产品B)产品B证JCB适用于省内出售或者运输动物产品动物代码动物代码表见表A.2。表A.2动物代码表分类名称动物代码动物名称备注家畜10100猪禁用a家畜10101生猪禁用家畜10102仔猪-家畜10103种公猪禁用家畜10104种母猪禁用家畜10105藏猪禁用家畜10106商品猪新增b家畜10107种猪新增家畜10199其他猪-家畜10200牛禁用家畜10201肉牛-家畜10202奶牛-家畜10203役用牛禁用家畜10204种公牛-家畜10205黄牛禁用家畜10206牦牛禁用家畜10207水牛禁用家畜10299其他牛-家畜10300羊禁用家畜10301绵羊-家畜10302山羊-家畜10303奶山羊-44表A.2动物代码表（续）分类名称动物代码动物名称备注家畜10304种羊-家畜10305滩羊禁用家畜10399其他羊-家畜10400马-家畜10500驴-家畜10600骡-家畜10700兔-家畜10800猫禁用家畜10900犬禁用家畜11000鹿禁用家畜11100骆驼-家畜19900其他家畜-家禽20100鸡禁用家禽20101肉鸡-家禽20102蛋鸡-家禽20103雏鸡-家禽20104种鸡-家禽20105藏鸡禁用家禽20199其他鸡-家禽20200鸭禁用家禽20201肉鸭-家禽20202蛋鸭-家禽20203雏鸭-家禽20204种鸭-家禽20299其他鸭-家禽20300鹅禁用家禽20301肉鹅-家禽20302蛋鹅-家禽20303雏鹅-家禽20304种鹅-家禽20399其他鹅-家禽20400鸽-家禽20500鹌鹑-家禽29900其他家禽-蜂30100蜜蜂-蜂39900其他蜂禁用水生动物40100淡水鱼-水生动物40200海水鱼-水生动物40300虾-水生动物40400蟹-水生动物40500贝-水生动物49900其他水生动物-实验动物50100鼠禁用55表A.2动物代码表（续）分类名称动物代码动物名称备注实验动物50101小鼠-实验动物50102大鼠-实验动物50103豚鼠新增实验动物50104地鼠新增实验动物50199其他鼠-实验动物50200实验用兔-实验动物50300实验用犬新增实验动物50400猴新增实验动物50500实验用鸡（不含蛋、胚）新增实验动物59900其他实验动物-特种畜禽60100狐禁用特种畜禽60200狸禁用特种畜禽60300貂（非食用）更名c特种畜禽60400貉（非食用）更名特种畜禽60500羊驼-特种畜禽60600火鸡新增特种畜禽60700珍珠鸡新增特种畜禽60800雉鸡新增特种畜禽60900鹧鸪新增特种畜禽61000番鸭新增特种畜禽61100绿头鸭新增特种畜禽61200鸵鸟新增特种畜禽61300鸸鹋新增特种畜禽61400银狐（非食用）新增特种畜禽61500北极狐（非食用）新增特种畜禽61601梅花鹿新增特种畜禽61602马鹿新增特种畜禽61603驯鹿新增特种畜禽69900其他养殖动物禁用野生动物70100野生哺乳类动物-野生动物70200野生禽鸟类动物-野生动物79900其他野生动物-犬80000犬新增猫90000猫新增a 不再使用的代码和名称；b 新增的代码和名称；c 变更的名称。A.3动物产品代码A.3动物产品代码动物产品代码表见表A.3。6A.4通用代码通用代码表见表A.4。A.4通用代码通用代码表见表A.4。表A.4通用代码表7表A.3动物产品代码表分类名称产品代码产品名称备注肉产品100肉类产品禁用肉产品101胴体更名肉产品102分割肉-副产品200可食用副产品禁用副产品201脏器-副产品202毛/绒禁用副产品203脂-副产品204血液-副产品205骨-副产品206蹄-副产品207头-副产品208角-副产品209筋-副产品210商品蛋-副产品211乳类-副产品298其他副产品新增副产品299非食用副产品禁用生皮/原毛/绒300生皮-生皮/原毛/绒301原毛新增生皮/原毛/绒302绒新增其它产品401精液-其它产品402卵-其它产品403胚胎-其它产品404种蛋-代码分类代码名称备注101养殖场-102屠宰场-103动物交易市场-104养殖户/村-105养殖小区-106其它-107冷库/产品销售场所-108动物产品加工厂-109无害化处理场-201头-202只-203车禁用204千克(公斤)-表A.4通用代码表(续）代码分类代码名称备注205吨禁用206斤禁用207张-208枚-209剂-210万粒-211羽-212匹-213箱-214尾-301道路更名302水路-303铁路-304航空-305其它禁用402饲养-401屠宰-403育肥禁用405种用-408乳用-404役用-406宠用-409实验-410展览-411演出-412比赛-407其它-413交易（销售）禁用414种猪禁用415仔猪禁用501壹-50