ICS 35.200 CCS L 78 深 DB4403 圳 市 地 方 标 准 DB4403/T 259—2022 电子动物检疫合格证明数据接口规范 Data interface specification for electronic certificate of animal quarantine 2022-10-01 实施 2022-09-09 发布 深圳市市场监督管理局 发 布 DB4403/T 259—2022 目 次 前言.....................................................................................................................................................................II 1 范围.................................................................................................................................................................1 2 规范性引用文件............................................................................................................................................ 1 3 术语和定义.................................................................................................................................................... 1 4 数据接口方式................................................................................................................................................ 1 5 数据调用接口参数........................................................................................................................................ 1 附录 A（资料性） 动物检疫合格证明电子出证数据词典........................................................................... 4 参考文献...............................................................................................................................................................9 I DB4403/T 259—2022 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起 草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由深圳市市场监督管理局提出并归口。 本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、深圳市动物卫生监督所。 本文件主要起草人：徐立峰、周哲、刘佳、张碧华、苏巍、郑文科、刘浩、练晓、孙勇、苏晓润、 郭静文、林国墩、薛瑶。 II DB4403/T 259—2022 电子动物检疫合格证明数据接口规范 1 范围 本文件规定了电子动物检疫合格证明的数据接口方式和数据调用接口参数。 本文件适用于企业对电子动物检疫合格证明数据的接口调用。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 电子动物检疫合格证明 electronic certificate of animal quarantine 动物卫生监督机构指派官方兽医对动物、动物产品实施检疫后，出具的电子化检疫证明。 4 数据接口方式 4.1 身份认证要求 调用方需申请对应appid（应用唯一标识）和appsecret（私钥）。 4.2 接口传输要求 接口使用JSON传输数据，具备通用性和可扩展性。 4.3 API 接口说明 API接口应符合以下要求： a) 接口名称：电子动物检疫合格证明调用接口； b) 接口描述：调用方需申请对应 appid 和 appsecret，可根据目的地企业统一社会信用代码和检 疫证签发日期查询对应的电子动物检疫合格证明申请； c) 接口地址：接口调用的地址； 示例 1：https://jg.amr.sz.gov.cn/trace/api/api/quarantine/queryQuarantine d) e) f) 请求方式：POST； 接口标识符：/api/quarantine/queryQuarantine； 请求示例：请求数据的接口地址示例说明； 示例 2： body 参数 { "ddtydm": "92440300MA5GXLEU29", "bz": "2022-06-28" } g） 输入参数：访问接口所需的参数，见 5.1； h） 返回参数：请求反馈的结果，见 5.2。 5 数据调用接口参数 1 DB4403/T 259—2022 5.1 输入参数 电子动物检疫合格证明调用接口输入参数及说明见表1。 表1 body 电子动物检疫合格证明调用接口输入参数及说明 输入参数 是否非空 ddtydm 是 目的地企业统一社会信用代码 bz nonce appid timestamp 是 是 是 是 signature 是 检疫证签发日期（日期格式 yyyy-mm-dd） 随机串（不少于 10 位） 分配每个调用方 1 个 appid 和 1 个 appsecret 时间戳 计算方式：appid、appsecret、nonce、timestamp 四个参数按 ASCII 排序，即 appid=xxxxx&appsecret=xxxxxxx&nonce=xxxxxxxxxx&timesta mp=xxxxxxxx，计算 MD5 值转大写 header 5.2 说明 返回参数 电子动物检疫合格证明调用接口返回参数及说明见表2。 表2 返回参数 result 2 jyzh jyzlb zt hz hzCode hztydm hzdh cpmc dwdm cplxdm cd sl sldw qqhdm qdmc dqhdm ddmc ddtydm ddCode cpsctydm cpscmc cpscdz cpjybz zddyxq bz gfsyxm rq ysfs ysph debh 电子动物检疫合格证明调用接口返回参数及说明 是否非空 是 是 是 是 否 是 是 是 是 是 是 是 是 是 是 是 是 是 否 是 是 是 是 是 否 是 是 否 否 否 说明 检疫证号（10-11 位检疫证号） 动物检疫合格证明类别代码见表 A.1 状态（1 正常、3 作废、4 超期） 货主 货主企业动检证列表查看码 货主统一社会信用代码 货主联系电话 产品名称 动物代码（5 位数字，见表 A.2 中动物代码） 产品类型代码（见表 A.3 中产品代码） 产地 数量 数量单位代码（见表 A.4 中分类代码 2 所对应的代码） 启运地区划代码 启运地名称 到达地区划代码 到达地名称 目的地企业统一社会信用代码 目的地企业动检证列表查看码 产品生产单位统一社会信用代码 产品生产单位名称 产品生产单位地址 产品检疫标志号 检疫合格证明到达有效期（见表 A.4 中分类代码 5 所对应的代码） 备注 官方兽医姓名 检疫合格证明签发时间 运输方式代码(见表 A.4 中分类代码 3 所对应的代码) 运输牌号 牲畜耳标号 DB4403/T 259—2022 表2 返回参数 message success code 电子动物检疫合格证明调用接口返回参数及说明（续） 是否非空 是 是 是 说明 提示信息 成功标识，true 代表成功 ，false 代表失败 状态码 200 代表成功 ，状态码 500 代表失败 3 DB4403/T 259—2022 附 录 A （资料性） 动物检疫合格证明电子出证数据词典 A.1 动物检疫合格证明类别代码 动物检疫合格证明类别代码表见表A.1。 表 A.1 A.2 动物检疫合格证明类别代码表 类别名称 简称 类别代码 备注 动物检疫合格证明(动物 A) 动物 A 证 JDA 适用于跨省境出售或者运输动物 动物检疫合格证明(动物 B) 动物 B 证 JDB 动物检疫合格证明(产品 A) 产品 A 证 JCA 动物检疫合格证明(产品 B) 产品 B 证 JCB 适用于省内出售或者运输动物 适用于跨省境出售或者运输动其动 物产品 适用于省内出售或者运输动物产品 动物代码 动物代码表见表A.2。 表 A.2 4 动物代码表 分类名称 动物代码 动物名称 备注 家畜 10100 猪 禁用 家畜 10101 生猪 禁用 家畜 10102 仔猪 - 家畜 10103 种公猪 禁用 家畜 10104 种母猪 禁用 家畜 10105 藏猪 禁用 家畜 10106 商品猪 新增 家畜 10107 种猪 新增 家畜 10199 其他猪 - 家畜 10200 牛 禁用 家畜 10201 肉牛 - 家畜 10202 奶牛 - 家畜 10203 役用牛 禁用 家畜 10204 种公牛 - 家畜 10205 黄牛 禁用 家畜 10206 牦牛 禁用 家畜 10207 水牛 禁用 家畜 10299 其他牛 - 家畜 10300 羊 禁用 家畜 10301 绵羊 - 家畜 10302