DB4403/T 259-2022 电子动物检疫合格证明数据接口规范

ICS35.200

CCSL78

DB4403

深圳市地方标准

DB4403/T259—2022

电子动物检疫合格证明数据接口规范

Datainterfacespecificationforelectroniccertificateofanimal

quarantine

2022-09-09发布2022-10-01实施

深圳市市场监督管理局发布

DB4403/T259—2022

目次

前言.....................................................................................................................................................................II

1范围.................................................................................................................................................................1

2规范性引用文件............................................................................................................................................1

3术语和定义....................................................................................................................................................1

4数据接口方式................................................................................................................................................1

5数据调用接口参数........................................................................................................................................1

附录A（资料性）动物检疫合格证明电子出证数据词典...........................................................................4

参考文献...............................................................................................................................................................9

I

DB4403/T259—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起

草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由深圳市市场监督管理局提出并归口。

本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、深圳市动物卫生监督所。

本文件主要起草人：徐立峰、周哲、刘佳、张碧华、苏巍、郑文科、刘浩、练晓、孙勇、苏晓润、

郭静文、林国墩、薛瑶。

II

DB4403/T259—2022

电子动物检疫合格证明数据接口规范

1范围

本文件规定了电子动物检疫合格证明的数据接口方式和数据调用接口参数。

本文件适用于企业对电子动物检疫合格证明数据的接口调用。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

下列术语和定义适用于本文件。

3.1

电子动物检疫合格证明electroniccertificateofanimalquarantine

动物卫生监督机构指派官方兽医对动物、动物产品实施检疫后，出具的电子化检疫证明。

4数据接口方式

4.1身份认证要求

调用方需申请对应appid（应用唯一标识）和appsecret（私钥）。

4.2接口传输要求

接口使用JSON传输数据，具备通用性和可扩展性。

4.3API接口说明

API接口应符合以下要求：

a)接口名称：电子动物检疫合格证明调用接口；

b)接口描述：调用方需申请对应appid和appsecret，可根据目的地企业统一社会信用代码和检

疫证签发日期查询对应的电子动物检疫合格证明申请；

c)接口地址：接口调用的地址；

示例1：/trace/api/api/quarantine/queryQuarantine

d)请求方式：POST；

e)接口标识符：/api/quarantine/queryQuarantine；

f)请求示例：请求数据的接口地址示例说明；

示例2：

body参数

{

"ddtydm":"92440300MA5GXLEU29",

"bz":"2022-06-28"

}

g）输入参数：访问接口所需的参数，见5.1；

h）返回参数：请求反馈的结果，见5.2。

5数据调用接口参数

1

DB4403/T259—2022

5.1输入参数

电子动物检疫合格证明调用接口输入参数及说明见表1。

表1电子动物检疫合格证明调用接口输入参数及说明

输入参数是否非空说明

ddtydm是目的地企业统一社会信用代码

body

bz是检疫证签发日期（日期格式yyyy-mm-dd）

nonce是随机串（不少于10位）

appid是分配每个调用方1个appid和1个appsecret

timestamp是时间戳

header计算方式：appid、appsecret、nonce、timestamp四个参数按

ASCII排序，即

signature是

appid=xxxxx&appsecret=xxxxxxx&nonce=xxxxxxxxxx×ta

mp=xxxxxxxx，计算MD5值转大写

5.2返回参数

电子动物检疫合格证明调用接口返回参数及说明见表2。

表2电子动物检疫合格证明调用接口返回参数及说明

返回参数是否非空说明

jyzh是检疫证号（10-11位检疫证号）

jyzlb是动物检疫合格证明类别代码见表A.1

zt是状态（1正常、3作废、4超期）

hz是货主

hzCode否货主企业动检证列表查看码

hztydm是货主统一社会信用代码

hzdh是货主联系电话

cpmc是产品名称

dwdm是动物代码（5位数字，见表A.2中动物代码）

cplxdm是产品类型代码（见表A.3中产品代码）

cd是产地

sl是数量

sldw是数量单位代码（见表A.4中分类代码2所对应的代码）

qqhdm是启运地区划代码

qdmc是启运地名称

result

dqhdm是到达地区划代码

ddmc是到达地名称

ddtydm是目的地企业统一社会信用代码

ddCode否目的地企业动检证列表查看码

cpsctydm是产品生产单位统一社会信用代码

cpscmc是产品生产单位名称

cpscdz是产品生产单位地址

cpjybz是产品检疫标志号

zddyxq是检疫合格证明到达有效期（见表A.4中分类代码5所对应的代码）

bz否备注

gfsyxm是官方兽医姓名

rq是检疫合格证明签发时间

ysfs否运输方式代码(见表A.4中分类代码3所对应的代码)

ysph否运输牌号

debh否牲畜耳标号

2

DB4403/T259—2022

表2电子动物检疫合格证明调用接口返回参数及说明（续）

返回参数是否非空说明

message是提示信息

success是成功标识，true代表成功，false代表失败

code是状态码200代表成功，状态码500代表失败

3

DB4403/T259—2022

附录A

（资料性）

动物检疫合格证明电子出证数据词典

A.1动物检疫合格证明类别代码

动物检疫合格证明类别代码表见表A.1。

表A.1动物检疫合格证明类别代码表

类别名称简称类别代码备注

动物检疫合格证明(动物A)动物A证JDA适用于跨省境出售或者运输动物

动物检疫合格证明(动物B)动物B证JDB适用于省内出售或者运输动物

适用于跨省境出售或者运输动其动

动物检疫合格证明(产品A)产品A证JCA

物产品

动物检疫合格证明(产品B)产品B证JCB适用于省内出售或者运输动物产品

A.2动物代码

动物代码表见表A.2。

表A.2动物代码表