DB4403-T 259-2022 電子動物檢疫合格證明數(shù)據(jù)接口規(guī)范

ICS35.200

CCSL78

DB4403

深圳市地方標準

DB4403/T259—2022

電子動物檢疫合格證明數(shù)據(jù)接口規(guī)范

Datainterfacespecificationforelectroniccertificateofanimal

quarantine

2022-09-09發(fā)布2022-10-01實施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/T259—2022

電子動物檢疫合格證明數(shù)據(jù)接口規(guī)范

1范圍

本文件規(guī)定了電子動物檢疫合格證明的數(shù)據(jù)接口方式和數(shù)據(jù)調用接口參數(shù)。

本文件適用于企業(yè)對電子動物檢疫合格證明數(shù)據(jù)的接口調用。

2規(guī)范性引用文件

本文件沒有規(guī)范性引用文件。

3術語和定義

下列術語和定義適用于本文件。

3.1

電子動物檢疫合格證明electroniccertificateofanimalquarantine

動物衛(wèi)生監(jiān)督機構指派官方獸醫(yī)對動物、動物產(chǎn)品實施檢疫后，出具的電子化檢疫證明。

4數(shù)據(jù)接口方式

4.1身份認證要求

調用方需申請對應appid（應用唯一標識）和appsecret（私鑰）。

4.2接口傳輸要求

接口使用JSON傳輸數(shù)據(jù)，具備通用性和可擴展性。

4.3API接口說明

API接口應符合以下要求：

a)接口名稱：電子動物檢疫合格證明調用接口；

b)接口描述：調用方需申請對應appid和appsecret，可根據(jù)目的地企業(yè)統(tǒng)一社會信用代碼和檢

疫證簽發(fā)日期查詢對應的電子動物檢疫合格證明申請；

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

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

d)請求方式：POST；

e)接口標識符：/api/quarantine/queryQuarantine；

f)請求示例：請求數(shù)據(jù)的接口地址示例說明；

示例2：

body參數(shù)

{

"ddtydm":"92440300MA5GXLEU29",

"bz":"2022-06-28"

}

g）輸入?yún)?shù)：訪問接口所需的參數(shù)，見5.1；

h）返回參數(shù)：請求反饋的結果，見5.2。

5數(shù)據(jù)調用接口參數(shù)

1

DB4403/T259—2022

5.1輸入?yún)?shù)

電子動物檢疫合格證明調用接口輸入?yún)?shù)及說明見表1。

表1電子動物檢疫合格證明調用接口輸入?yún)?shù)及說明

輸入?yún)?shù)是否非空說明

ddtydm是目的地企業(yè)統(tǒng)一社會信用代碼

body

bz是檢疫證簽發(fā)日期（日期格式y(tǒng)yyy-mm-dd）

nonce是隨機串（不少于10位）

appid是分配每個調用方1個appid和1個appsecret

timestamp是時間戳

header計算方式：appid、appsecret、nonce、timestamp四個參數(shù)按

ASCII排序，即

signature是

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

mp=xxxxxxxx，計算MD5值轉大寫

5.2返回參數(shù)

電子動物檢疫合格證明調用接口返回參數(shù)及說明見表2。

表2電子動物檢疫合格證明調用接口返回參數(shù)及說明

返回參數(shù)是否非空說明

jyzh是檢疫證號（10-11位檢疫證號）

jyzlb是動物檢疫合格證明類別代碼見表A.1

zt是狀態(tài)（1正常、3作廢、4超期）

hz是貨主

hzCode否貨主企業(yè)動檢證列表查看碼

hztydm是貨主統(tǒng)一社會信用代碼

hzdh是貨主聯(lián)系電話

cpmc是產(chǎn)品名稱

dwdm是動物代碼（5位數(shù)字，見表A.2中動物代碼）

cplxdm是產(chǎn)品類型代碼（見表A.3中產(chǎn)品代碼）

cd是產(chǎn)地

sl是數(shù)量

sldw是數(shù)量單位代碼（見表A.4中分類代碼2所對應的代碼）

qqhdm是啟運地區(qū)劃代碼

qdmc是啟運地名稱

result

dqhdm是到達地區(qū)劃代碼

ddmc是到達地名稱

ddtydm是目的地企業(yè)統(tǒng)一社會信用代碼

ddCode否目的地企業(yè)動檢證列表查看碼

cpsctydm是產(chǎn)品生產(chǎn)單位統(tǒng)一社會信用代碼

cpscmc是產(chǎn)品生產(chǎn)單位名稱

cpscdz是產(chǎn)品生產(chǎn)單位地址

cpjybz是產(chǎn)品檢疫標志號

zddyxq是檢疫合格證明到達有效期（見表A.4中分類代碼5所對應的代碼）

bz否備注

gfsyxm是官方獸醫(yī)姓名

rq是檢疫合格證明簽發(fā)時間

ysfs否運輸方式代碼(見表A.4中分類代碼3所對應的代碼)

ysph否運輸牌號

debh否牲畜耳標號

2

DB4403/T259—2022

表2電子動物檢疫合格證明調用接口返回參數(shù)及說明（續(xù)）

返回參數(shù)是否非空說明

message是提示信息

success是成功標識，true代表成功，false代表失敗

code是狀態(tài)碼200代表成功，狀態(tài)碼500代表失敗

3

DB4403/T259—2022

附錄A

（資料性）

動物檢疫合格證明電子出證數(shù)據(jù)詞典

A.1動物檢疫合格證明類別代碼

動物檢疫合格證明類別代碼表見表A.1。

表A.1動物檢疫合格證明類別代碼表

類別名稱簡稱類別代碼備注

動物檢疫合格證明(動物A)動物A證JDA適用于跨省境出售或者運輸動物

動物檢疫合格證明(動物B)動物B證JDB適用于省內(nèi)出售或者運輸動物

適用于跨省境出售或者運輸動其動

動物檢疫合格證明(產(chǎn)品A)產(chǎn)品A證JCA

物產(chǎn)品

動物檢疫合格證明(產(chǎn)品B)產(chǎn)品B證JCB適用于省內(nèi)出售或者運輸動物產(chǎn)品

A.2動物代碼

動物代碼表見表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奶山羊-

4

DB4403/T259—2022

表A.2動物代碼表（續(xù)）

分類名稱動物代碼動物名稱備注

家畜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鼠禁用

5

DB4403/T259—2022

表A.2動物代碼表（續(xù)）

分類名稱動物代碼動物名稱備注

實驗動物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其他養(yǎng)殖動物禁用

野生動物70100野生哺乳類動物-

野生動物70200野生禽鳥類動物-

野生動物79900其他野生動物-

犬80000犬新增

貓90000貓新增

a不再使用的代碼和名稱；

b新增的代碼和名稱；

c變更的名稱。

A.3動物產(chǎn)品代碼

動物產(chǎn)品代碼表見表A.3。

6

DB4403/T259—2022

表A.3動物產(chǎn)品代碼表

分類名稱產(chǎn)品代碼產(chǎn)品名稱備注

肉產(chǎn)品100肉類產(chǎn)品禁用

肉產(chǎn)品101胴體更名

肉產(chǎn)品102分割肉-

副產(chǎn)品200可食用副產(chǎn)品禁用

副產(chǎn)品201臟器-

副產(chǎn)品202毛/絨禁用

副產(chǎn)品203脂-

副產(chǎn)品204血液-

副產(chǎn)品205骨-

副產(chǎn)品206蹄-

副產(chǎn)品207頭-

副產(chǎn)品208角-

副產(chǎn)品209筋-

副產(chǎn)品210商品蛋-

副產(chǎn)品211乳類-

副產(chǎn)品298其他副產(chǎn)品新增

副產(chǎn)品299非食用副產(chǎn)品禁用

生皮/原毛/絨300生皮-

生皮/原毛/絨301原毛新增

生皮/原毛/絨302絨新增

其它產(chǎn)品401精液-

其它產(chǎn)品402卵-

其它產(chǎn)品403胚胎-

其它產(chǎn)品404種蛋-

A.4通用代碼

通用代碼表見表A.4。

表A.4通用代碼表

代碼分類代碼名稱備注

101養(yǎng)殖場-

102屠宰場-

103動物交易市場-

104養(yǎng)殖戶/村-

105養(yǎng)殖小區(qū)-

106其它-

107冷庫/產(chǎn)品銷售場所-

108動物產(chǎn)品加工廠-

109無害化處理場-

201頭-

202只-

203車禁用

204千克(公斤)-

7

DB4403/T259—2022

表A.4通用代碼表(續(xù)）

代碼分類代碼名稱備注

205噸禁用

206斤禁用

207張-

208枚-

209劑-

210萬粒-

211羽-

212匹-

213箱-

214尾-

301道路更名

302水路-

303鐵路-

304航空-

305其它禁用

402飼養(yǎng)-

401屠宰-

403