ICS35.240.60

CCSX07

DB4403

深圳市地方標(biāo)準(zhǔn)

DB4403/T582—2025

肉品溯源數(shù)據(jù)接口規(guī)范

Specificationformeattraceabilitydatainterface

2025-01-15發(fā)布2025-02-01實施

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

DB4403/T582—2025

目次

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

1范圍................................................................................1

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

3術(shù)語和定義..........................................................................1

4縮略語..............................................................................1

5接口方法及調(diào)用說明..................................................................1

5.1接口傳輸要求及對接流程..........................................................1

5.2數(shù)據(jù)類型........................................................................2

5.3數(shù)據(jù)接口........................................................................3

附錄A（資料性）數(shù)據(jù)接口應(yīng)用示例......................................................8

A.1憑據(jù)Token接口的應(yīng)用示例........................................................8

A.2同步肉品溯源數(shù)據(jù)接口的應(yīng)用示例..................................................9

A.3查詢動檢證核驗結(jié)果接口的應(yīng)用示例...............................................11

A.4同步肉品溯源數(shù)據(jù)并核驗動檢證接口的應(yīng)用示例.....................................12

附錄B（資料性）動物代碼表...........................................................15

附錄C（資料性）產(chǎn)品代碼表...........................................................17

附錄D（資料性）產(chǎn)品類型代碼表.......................................................18

參考文獻(xiàn)..............................................................................19

I

DB4403/T582—2025

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》

的規(guī)定起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由深圳市市場監(jiān)督管理局提出并歸口。

本文件起草單位：深圳市標(biāo)準(zhǔn)技術(shù)研究院、深圳市市場監(jiān)督管理局、供廣深圳肉類智能交易市

場有限公司。

本文件主要起草人：李廣斌、陳利平、陳偉峰、周哲、劉浩、郭靜文、蘇曉潤、李思璁、鄭文

科、靳恒宇、李佩霖、陳瑜、吳岳、練曉、孫勇。

II

DB4403/T582—2025

肉品溯源數(shù)據(jù)接口規(guī)范

1范圍

本文件規(guī)定了調(diào)用肉品（批發(fā)）溯源系統(tǒng)的數(shù)據(jù)接口進(jìn)行數(shù)據(jù)交換的接口方法和調(diào)用說明。

本文件適用于調(diào)用肉品（批發(fā)）溯源系統(tǒng)的數(shù)據(jù)接口的集成開發(fā)。

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

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

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

數(shù)據(jù)接口datainterface

以電子文件的形式實現(xiàn)，計算機軟件系統(tǒng)之間傳送數(shù)據(jù)、交換信息的接口。

[來源：GB/T42940—2023,3.3]

3.2

數(shù)據(jù)對接方datadockingparty

數(shù)據(jù)接口調(diào)用者，與肉品（批發(fā)）溯源系統(tǒng)進(jìn)行數(shù)據(jù)交換的單位。

4縮略語

下列縮略語適用于本文件。

API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

JSON：對象簡譜（JavascriptObjectNotation）

5接口方法及調(diào)用說明

5.1接口傳輸要求及對接流程

5.1.1接口使用JSON傳輸數(shù)據(jù)，技術(shù)接口對接示意如圖1所示。肉品數(shù)據(jù)對接方系統(tǒng)獲取訪問令牌，

訪問驗證通過后，根據(jù)預(yù)先定義好的接口方法，進(jìn)行肉品溯源數(shù)據(jù)交換，數(shù)據(jù)接口應(yīng)用示例見附錄A。

注：肉品溯源數(shù)據(jù)主要包含分銷臺賬數(shù)據(jù)、動物檢疫合格證明（以下簡稱“動檢證”）數(shù)據(jù)等。

5.1.2數(shù)據(jù)交換分為三種方式：

a)數(shù)據(jù)對接方系統(tǒng)輸入?yún)?shù)，同步肉品溯源數(shù)據(jù)后，肉品（批發(fā)）溯源系統(tǒng)（以下簡稱“溯源

系統(tǒng)”）自動實時返回溯源數(shù)據(jù)同步結(jié)果；

b)數(shù)據(jù)對接方系統(tǒng)主動進(jìn)行動檢證核驗結(jié)果查詢；

1

DB4403/T582—2025

c)數(shù)據(jù)對接方系統(tǒng)輸入?yún)?shù)，同步肉品溯源數(shù)據(jù)后，溯源系統(tǒng)自動實時返回溯源數(shù)據(jù)同步結(jié)果

和動檢證核驗結(jié)果。

注：Token指邀請、登錄系統(tǒng)的臨時令牌。

圖1技術(shù)接口對接示意圖

5.2數(shù)據(jù)類型

數(shù)據(jù)接口應(yīng)支持的數(shù)據(jù)類型包括:

a)字符型；

b)整數(shù)型；

c)浮點型；

d)布爾型；

e)日期型；

f)對象型。

2

DB4403/T582—2025

5.3數(shù)據(jù)接口

5.3.1憑據(jù)Token調(diào)用接口

接口說明

接口說明如下：

a)接口名稱：接口訪問授權(quán)調(diào)用接口；

b)接口描述：用于獲取業(yè)務(wù)接口的訪問調(diào)用憑據(jù)；

c)HTTP請求方式：GET；

d)接口標(biāo)識符：GetToken。

接口輸入?yún)?shù)及說明

憑據(jù)Token調(diào)用接口的輸入?yún)?shù)及說明見表1。

表1憑據(jù)Token調(diào)用接口的輸入?yún)?shù)及說明

輸入?yún)?shù)數(shù)據(jù)類型是否非空說明

appId字符型是應(yīng)用碼

Params

appSecret字符型是應(yīng)用授權(quán)碼

接口返回參數(shù)及說明

憑據(jù)Token調(diào)用接口的返回參數(shù)及說明見表2。

表2憑據(jù)Token調(diào)用接口的返回參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

success布爾型是調(diào)用結(jié)果，若為“true”，表示成功；若為“false”，表示

失敗

message字符型是提示信息

data

code整數(shù)型是成功則返回代碼“0”；失敗則返回錯誤碼“500”

result字符型是授權(quán)訪問令牌Token

timestamp整數(shù)型是時間戳

5.3.2同步肉品溯源數(shù)據(jù)的調(diào)用接口

接口說明

接口說明如下：

a)接口名稱：同步肉品溯源數(shù)據(jù)的調(diào)用接口；

b)接口描述：用于同步數(shù)據(jù)對接方系統(tǒng)的肉品溯源數(shù)據(jù)；

c)HTTP請求方式：POST；

d）接口標(biāo)識符：ImportData。

接口輸入?yún)?shù)及說明

同步肉品溯源數(shù)據(jù)調(diào)用接口的輸入?yún)?shù)及說明見表3。

3

DB4403/T582—2025

表3同步肉品溯源數(shù)據(jù)調(diào)用接口的輸入?yún)?shù)及說明

輸入?yún)?shù)數(shù)據(jù)類型是否非空說明

Headers對象型是X-Access-Token：授權(quán)訪問令牌Token

salesDocumentNo字符型是分銷憑證編號

productBarcode字符型否產(chǎn)品編碼

productName字符型是產(chǎn)品名稱

productCategoryCode字符型是產(chǎn)品分類編碼，由“動物代碼+產(chǎn)品代碼+產(chǎn)品類型代碼”組

成，例如商品豬胴體中溫肉分類編碼為1010610110102，動物

代碼、產(chǎn)品代碼、產(chǎn)品類型代碼分別見附錄B、附錄C及附錄

D

productImg字符型否產(chǎn)品圖片的網(wǎng)址，多個網(wǎng)址以“，”分隔

batchCode字符型是批次編碼，批次唯一標(biāo)識，可用“檢疫合格證編號+軌道號+分

割流水號”表示

batch字符型否批次

batchWeight浮點型是批次總重量

batchUnit字符型否批次單位（KG，G，默認(rèn)KG）

batchInNo字符型否批次進(jìn)貨單號

batchInWeight浮點型是批次進(jìn)貨重量

batchInPrice浮點型是批次進(jìn)貨單價，單價的單位為“元/KG”或“元/G”

batchInDate日期型是批次進(jìn)貨日期，按“年-月-日”的格式輸入。示例：2024-01-

01

BodybatchOutPrice浮點型是批次銷售單價，單位重量的人民幣價格，單位為“元

/(KG,G)”

batchOutDate日期型是批次銷售日期，按“年-月-日”的格式輸入。示例：2024-01-

01

batchOutWeight浮點型是批次銷售重量

batchCheckReport字符型否批次檢驗報告圖片網(wǎng)址，多個網(wǎng)址以英文“，”分隔

animalCertNo字符型否動物檢疫合格證編號

animalCertType字符型否動物檢疫合格證類型（da：動物A證，db：動物B證）

quarantineCertNo字符型是產(chǎn)品檢疫合格證編號

quarantineCertType字符型否產(chǎn)品檢疫合格證類型（ca：產(chǎn)品A證，cb：產(chǎn)品B證）

producerBaseName字符型否生產(chǎn)/養(yǎng)殖基地名稱

producerBaseAddr字符型否生產(chǎn)/養(yǎng)殖基地地址

supplierEntName字符型是市場供貨企業(yè)名稱，多個名稱以英文“;”間隔

supplierEntUnifCode字符型是市場供貨企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文“;”間隔

butcherEntName字符型是屠宰企業(yè)名稱

butcherEntUnifCode字符型是屠宰企業(yè)統(tǒng)一社會信用代碼

flowtoEntName字符型是流向企業(yè)名稱，多個名稱以英文“;”間隔

flowtoEntUnifCode字符型是流向企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文“;”間隔

qrcodeUrl字符型否分銷溯源二維碼網(wǎng)址

4

DB4403/T582—2025

表3同步肉品溯源數(shù)據(jù)調(diào)用接口的輸入?yún)?shù)及說明（續(xù)）

輸入?yún)?shù)數(shù)據(jù)類型是否非說明

空

animalCertSerial字符型否動物檢疫合格證流水號

quarantineCertSerial字符型否產(chǎn)品檢疫合格證流水號

exHz字符型否附加供貨企業(yè)，多個企業(yè)以英文“;”間隔

exButcher字符型否附加屠宰企業(yè)，多個企業(yè)以英文“;”間隔

exFlowto字符型否附加流向，多個流向以英文“;”間隔

BodyexAnimalCertUrl字符型否附加動物檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文“;”間隔

exQuarantineCertUrl字符型否附加產(chǎn)品檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文“;”間隔

exAnimalCertNo字符型否附加動物檢疫合格證編號，多個編號以英文“;”間隔

exQuarantineCertNo字符型否附加產(chǎn)品檢疫合格證編號，多個編號以英文“;”間隔

meatQualityNo字符型否肉品品質(zhì)檢驗證編號，多個編號以英文“;”間隔

meatQualityUrl字符型否肉品品質(zhì)檢驗證網(wǎng)址，多個網(wǎng)址以英文“;”間隔

接口返回參數(shù)及說明

同步肉品溯源數(shù)據(jù)調(diào)用接口的返回參數(shù)及說明見表4。

表4同步肉品溯源數(shù)據(jù)調(diào)用接口的返回參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

success布爾型是調(diào)用結(jié)果，若為“true”，表示成功；若為“false”，表

示失敗

message字符型是提示信息

data

code整數(shù)型是成功則返回代碼“0”；失敗則返回錯誤碼“500”

result字符型是返回結(jié)果信息

timestamp整數(shù)型是時間戳

5.3.3查詢動檢證核驗結(jié)果的調(diào)用接口

接口說明

接口說明如下：

a）接口名稱：查詢動檢證核驗結(jié)果的調(diào)用接口；

b）接口描述：用于數(shù)據(jù)對接方系統(tǒng)主動發(fā)起查詢動檢證在溯源系統(tǒng)的核驗情況；

c）HTTP請求方式：POST；

d）接口標(biāo)識符：QueryVerifyResults。

接口輸入?yún)?shù)及說明

查詢動檢證核驗結(jié)果的調(diào)用接口的輸入?yún)?shù)及說明見表5。

5

DB4403/T582—2025

表5查詢動檢證核驗結(jié)果調(diào)用接口的輸入?yún)?shù)及說明

輸入?yún)?shù)數(shù)據(jù)類型是否非空說明

Headers對象型是X-Access-Token：授權(quán)訪問令Token

salesDocumentNo字符型不能同時為分銷憑證編號

BodybatchCode字符型空批次編碼

quarantineCertNo字符型產(chǎn)品檢疫合格證編號

接口返回參數(shù)及說明

查詢動檢證核驗結(jié)果的調(diào)用接口的返回參數(shù)及說明見表6。

表6查詢動檢證核驗結(jié)果調(diào)用接口的返回參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

success布爾型是調(diào)用結(jié)果，若為“true”，表示成功；若為“false”，表示

失敗

message字符型是提示信息

data

code整數(shù)型是成功則返回代碼“0”；失敗則返回錯誤碼“500”

result對象型是返回結(jié)果信息，結(jié)果信息參數(shù)及說明見表7

timestamp整數(shù)型是時間戳

表7查詢動檢證核驗結(jié)果調(diào)用接口返回的結(jié)果信息參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

salesDocumentNo字符型是分銷憑證編號

batchCode字符型是批次編碼，批次唯一標(biāo)識，可用“檢疫合格證編號

+軌道號+分割流水號”表示

animalCertNo字符型否動物檢疫合格證編號

quarantineCertNo字符型是產(chǎn)品檢疫合格證編號

resultverifyStatus整數(shù)型是核驗狀態(tài)

verifyResult字符型是成功顯示“核驗通過”，失敗顯示“核驗不通過”

verifyRemark字符型否核驗結(jié)果備注說明

verifySlStatus整數(shù)型是數(shù)量核驗狀態(tài)

verifySlResult字符型是數(shù)量核驗結(jié)果

verifySlRemark字符型否數(shù)量核驗結(jié)果備注說明

5.3.4同步肉品溯源數(shù)據(jù)并核驗動檢證的調(diào)用接口

接口說明

接口說明如下：

a)接口名稱：同步肉品溯源數(shù)據(jù)并核驗動檢證的調(diào)用接口；

b）接口描述：用于數(shù)據(jù)對接方系統(tǒng)同步肉品溯源數(shù)據(jù)并返回核驗的動檢證結(jié)果，核驗結(jié)果自動

實時返回；

c)HTTP請求方式：POST；

6

DB4403/T582—2025

d)接口標(biāo)識符：ImportAndVerifyData。

接口輸入?yún)?shù)及說明

同步肉品溯源數(shù)據(jù)并核驗動檢證的調(diào)用接口輸入?yún)?shù)與同步肉品溯源數(shù)據(jù)的調(diào)用接口輸入?yún)?shù)一

致（見），調(diào)用接口的輸入?yún)?shù)及說明見表3。

接口返回參數(shù)及說明

同步肉品溯源數(shù)據(jù)并核驗動檢證調(diào)用接口的返回參數(shù)及說明見表8。

表8同步肉品溯源數(shù)據(jù)并核驗動檢證調(diào)用接口的返回參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

success布爾型是調(diào)用結(jié)果，若為“true”，表示成功；若為“false”，表示

失敗

message字符型是提示信息

data

code整數(shù)型是成功則返回代碼“0”；失敗則返回錯誤碼“500”

result對象型是返回結(jié)果信息，結(jié)果信息參數(shù)及說明見表9

timestamp整數(shù)型是時間戳

表9同步肉品溯源數(shù)據(jù)并核驗動檢證調(diào)用接口返回的結(jié)果信息參數(shù)及說明

返回參數(shù)數(shù)據(jù)類型是否非空說明

ImportResult字符型是提示具體導(dǎo)入成功/失敗信息

salesDocumentNo字符型是分銷憑證編號

animalCertNo字符型否動物檢疫合格證編號

quarantineCertNo字符型是產(chǎn)品檢疫合格證編號

result

VerifyResultverifyStatus整數(shù)型是核驗狀態(tài)

verifyResult字符型是成功顯示“核驗通過”，失敗顯示

“核驗不通過”

verifyRemark字符型否核驗結(jié)果備注說明

7

DB4403/T582—2025

附錄A

（資料性）

數(shù)據(jù)接口應(yīng)用示例

A.1憑據(jù)Token接口的應(yīng)用示例

A.1.1接口調(diào)用的示例代碼

憑據(jù)Token接口調(diào)用的示例代碼見圖A.1。

OkHttpClientclient=newOkHttpClient().newBuilder().build();

MediaTypemediaType=MediaType.parse("text/plain");

RequestBodybody=RequestBody.create(mediaType,"");

Requestrequest=newRequest.Builder()

.url("/mwtrace/api/api/GetToken?appId=XXX&appSecret=XXX")

.method("GET",body)

.build();

Responseresponse=client.newCall(request).execute();

圖A.1憑據(jù)Token接口調(diào)用的示例代碼

A.1.2接口調(diào)用成功的返回示例

憑據(jù)Token接口調(diào)用成功的返回示例見圖A.2。

{

"success":true,

"message":"",

"code":0,

"result":"XXX",

"timestamp":1724988940013

}

圖A.2憑據(jù)Token接口調(diào)用成功的返回示例

A.1.3接口調(diào)用失敗的返回示例

憑據(jù)Token接口調(diào)用失敗的返回示例見圖A.3。

8

DB4403/T582—2025

{

"success":false,

"message":"XXX",

"code":500,

"result":"XXX",

"timestamp":1724989006467

}

圖A.3憑據(jù)Token接口調(diào)用失敗的返回示例

A.2同步肉品溯源數(shù)據(jù)接口的應(yīng)用示例

A.2.1接口調(diào)用的示例代碼

同步肉品溯源數(shù)據(jù)接口調(diào)用的示例代碼見圖A.4。

OkHttpClientclient=newOkHttpClient().newBuilder().build();

MediaTypemediaType=MediaType.parse("application/json");

RequestBodybody=RequestBody.create(mediaType,"[{

\"salesDocumentNo\":\"分銷憑證編號\",

\"productBarcode\":\"產(chǎn)品編碼\",

\"productName\":\"產(chǎn)品名稱\",

\"productCategoryCode\":\"產(chǎn)品分類編碼，由動物代碼+產(chǎn)品代碼+產(chǎn)品類型代碼表組成，例如商品豬胴體中溫肉分類編碼為

1010610110102，詳細(xì)分類代碼見附錄\",

\"productImg\":\"\",

\"batchCode\":\"批次編碼，批次唯一標(biāo)識，例如（檢疫合格證號+軌道號+分割流水號）\",

\"batch\":\"批次\",

\"batchWeight\":\"批次總重量\",

\"batchUnit\":\"批次單位(KG，G，默認(rèn)KG)\",

\"batchInNo\":\"批次進(jìn)貨單號\",

\"batchInWeight\":\"批次進(jìn)貨重量，\",

\"batchInPrice\":\"（元/KG,元/G）\",

\"batchInDate\":\"批次進(jìn)貨日期\",

\"batchOutPrice\":\"（元/KG,元/G）\",

\"batchOutDate\":\"批次銷售日期\",

\"batchOutWeight\":\"批次銷售重量\",

\"batchCheckReport\":\"\",

\"animalCertNo\":\"動物檢疫合格證編號\",

\"animalCertType\":\"動物檢疫合格證類型（da：動物A證，db：動物B證）\",

\"quarantineCertNo\":\"產(chǎn)品檢疫合格證編號\",

\"quarantineCertType\":\"產(chǎn)品檢疫合格證類型（ca：產(chǎn)品A證，cb：產(chǎn)品B證）\",

\"producerBaseName\":\"生產(chǎn)/養(yǎng)殖基地名稱\",

圖A.4同步肉品溯源數(shù)據(jù)接口調(diào)用的示例代碼

9

DB4403/T582—2025

\"producerBaseAddr\":\"生產(chǎn)/養(yǎng)殖基地地址\",

\"butcherEntName\":\"屠宰企業(yè)名稱\",

\"butcherEntUnifCode\":\"屠宰企業(yè)統(tǒng)一社會信用代碼\",

\"supplierEntName\":\"市場供貨企業(yè)名稱，以英文;間隔\",

\"supplierEntUnifCode\":\"市場供貨企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文;間隔\",

\"flowtoEntName\":\"流向企業(yè)名稱，多個以英文;間隔\",

\"flowtoEntUnifCode\":\"流向企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文;間隔\"，

\"qrcodeUrl\":\"分銷溯源二維碼網(wǎng)址\",

\"animalCertSerial\":\"動物檢疫合格證流水號\",

\"quarantineCertSerial\":\"產(chǎn)品檢疫合格證流水號\",

\"exHz\":\"附加供貨企業(yè)，多個企業(yè)以英文;間隔\",

\"exButcher\":\"附加屠宰企業(yè)，多個企業(yè)以英文;間隔\",

\"exFlowto\":\"附加流向，多個流向以英文;間隔\",

\"exAnimalCertUrl\":\"附加動物檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"exQuarantineCertUrl\":\"附加產(chǎn)品檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"exAnimalCertNo\":\"附加動物檢疫證編號，多個編號以英文;間隔\",

\"exQuarantineCertNo\":\"附加產(chǎn)品檢疫證編號，多個編號以英文;間隔\",

\"meatQualityNo\":\"肉品品質(zhì)檢驗證編號，多個編號以英文;間隔\",

\"meatQualityUrl\":\"肉品品質(zhì)檢驗證網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"delFlag\":\"刪除標(biāo)記，默認(rèn)0為不刪除，1為刪除，若僅刪除數(shù)據(jù)可只傳分銷號（salesDocumentNo）和本刪除標(biāo)記\",}]");

Requestrequest=newRequest.Builder()

.url("/mwtrace/api/api/ImportData")

.method("POST",body)

.addHeader("X-Access-Token","XXX")

.addHeader("Content-Type","application/json")

.build();

Responseresponse=client.newCall(request).execute();

圖A.4同步肉品溯源數(shù)據(jù)接口調(diào)用的示例代碼（續(xù)）

A.2.2接口調(diào)用成功的返回示例

同步肉品溯源數(shù)據(jù)接口調(diào)用成功的返回示例見圖A.5。

{

"success":true,

"message":"第X條，數(shù)據(jù)導(dǎo)入成功；第X條，數(shù)據(jù)導(dǎo)入成功；",

"code":0,

"result":"數(shù)據(jù)導(dǎo)入完成，成功X條，失敗X條",

"timestamp":1724989852669

}

圖A.5同步肉品溯源數(shù)據(jù)接口調(diào)用成功的返回示例

A.2.3接口調(diào)用失敗的返回示例

同步肉品溯源數(shù)據(jù)接口調(diào)用失敗的返回示例見圖A.6。

10

DB4403/T582—2025

{

"success":false,

"message":"****",

"code":500,

"result":"****",

"timestamp":1724989006467

}

圖A.6同步肉品溯源數(shù)據(jù)接口調(diào)用失敗的返回示例

A.3查詢動檢證核驗結(jié)果接口的應(yīng)用示例

A.3.1接口調(diào)用的示例代碼

查詢動檢證核驗結(jié)果接口調(diào)用的示例代碼見圖A.7。

OkHttpClientclient=newOkHttpClient().newBuilder().build();

MediaTypemediaType=MediaType.parse("application/json");

RequestBodybody=RequestBody.create(mediaType,"[

{\"salesDocumentNo\":\"XXX\",\"batchCode\":\"XXX\",\"quarantineCertNo\":\"XXX\"}]");

Requestrequest=newRequest.Builder()

.url("/mwtrace/api/api/QueryVerifyResults")

.method("POST",body)

.addHeader("X-Access-Token","XXX")

.addHeader("Content-Type","application/json")

.build();

Responseresponse=client.newCall(request).execute();

圖A.7查詢動檢證核驗結(jié)果接口調(diào)用的示例代碼

A.3.2接口調(diào)用成功的返回示例

查詢動檢證核驗結(jié)果接口調(diào)用成功的返回示例見圖A.8。

{

"success":true,

"message":"",

"code":0,

"result":

[{

"verifySlRemark":"",

"verifySlStatus":0,

"verifyStatus":0,

"verifyRemark":"",

"batchCode":"XXX",

"quarantineCertNo":"XXX",

"verifyResult":"核驗通過",

"verifySlResult":"數(shù)量核驗通過",

"salesDocumentNo":"XXX"

}],

"timestamp":1724990253246

}

圖A.8查詢動檢證核驗結(jié)果接口調(diào)用成功的返回示例

A.3.3接口調(diào)用失敗的返回示例

查詢動檢證核驗結(jié)果接口調(diào)用失敗的返回示例見圖A.9。

11

DB4403/T582—2025

{

"success":false,

"message":"XXX",

"code":500,

"result":"XXX",

"timestamp":1724989006467

}

圖A.9查詢動檢證核驗結(jié)果接口調(diào)用失敗的返回示例

A.4同步肉品溯源數(shù)據(jù)并核驗動檢證接口的應(yīng)用示例

A.4.1接口調(diào)用的示例代碼

同步肉品溯源數(shù)據(jù)并核驗動檢證接口調(diào)用的示例代碼見圖A.10。

OkHttpClientclient=newOkHttpClient().newBuilder().build();

MediaTypemediaType=MediaType.parse("application/json");

RequestBodybody=RequestBody.create(mediaType,@"[{

\"salesDocumentNo\":\"分銷憑證編號\",

\"productBarcode\":\"產(chǎn)品編碼\",

\"productName\":\"產(chǎn)品名稱\",

\"productCategoryCode\":\"產(chǎn)品分類編碼，由動物代碼+產(chǎn)品代碼+產(chǎn)品類型代碼表組成，例如商品豬胴體中溫肉分類編碼為

1010610110102，詳細(xì)分類代碼見附錄\",

\"productImg\":\"產(chǎn)品圖片的網(wǎng)址，多個網(wǎng)址以,分隔\",

\"batchCode\":\"批次編碼，批次唯一標(biāo)識，例如（檢疫合格證號+軌道號+分割流水號），必填\",

\"batch\":\"批次\",

\"batchWeight\":\"批次總重量\",

\"batchUnit\":\"批次單位(KG，G，默認(rèn)KG)\",

\"batchInNo\":\"批次進(jìn)貨單號\",\r\n

\"batchInWeight\":\"批次進(jìn)貨重量\",

\"batchInPrice\":\"批次進(jìn)貨單價，人民幣（元/KG,元/G）\",

\"batchInDate\":\"批次進(jìn)貨日期\",

\"batchOutPrice\":\"批次銷售單價，人民幣（元/KG,元/G）\",

\"batchOutDate\":\"批次銷售日期\",

\"batchOutWeight\":\"批次銷售重量\",

\"batchCheckReport\":\"批次檢驗報告，產(chǎn)品報告圖片或文件的網(wǎng)址，多張圖片以英文,分隔\",

\"animalCertNo\":\"動物檢疫合格證編號\",

\"animalCertType\":\"動物檢疫合格證類型（da：動物A證，db：動物B證）\",

\"quarantineCertNo\":\"產(chǎn)品檢疫合格證編號\",

\"quarantineCertType\":\"產(chǎn)品檢疫合格證類型（ca：產(chǎn)品A證，cb：產(chǎn)品B證）\",

\"producerBaseName\":\"生產(chǎn)/養(yǎng)殖基地名稱\",

\"producerBaseAddr\":\"生產(chǎn)/養(yǎng)殖基地地址\",

\"butcherEntName\":\"屠宰企業(yè)名稱\",

圖A.10同步肉品溯源數(shù)據(jù)并核驗動檢證接口調(diào)用的示例代碼

12

DB4403/T582—2025

\"butcherEntUnifCode\":\"屠宰企業(yè)統(tǒng)一社會信用代碼\",

\"supplierEntName\":\"市場供貨企業(yè)名稱，多個名稱以英文;間隔\",

\"supplierEntUnifCode\":\"市場供貨企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文;間隔\",

\"flowtoEntName\":\"流向企業(yè)名稱，多個名稱以英文;間隔\",

\"flowtoEntUnifCode\":\"流向企業(yè)統(tǒng)一社會信用代碼，多個代碼以英文;間隔\"，

\"qrcodeUrl\":\"分銷溯源二維碼網(wǎng)址\",

\"animalCertSerial\":\"動物檢疫合格證流水號\",

\"quarantineCertSerial\":\"產(chǎn)品檢疫合格證流水號\",

\"exHz\":\"附加供貨企業(yè)，多個企業(yè)以英文;間隔\",

\"exButcher\":\"附加屠宰企業(yè)，多個企業(yè)以英文;間隔\",

\"exFlowto\":\"附加流向，多個流向以英文;間隔\",

\"exAnimalCertUrl\":\"附加動物檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"exQuarantineCertUrl\":\"附加產(chǎn)品檢疫合格證圖片網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"exAnimalCertNo\":\"附加動物檢疫證編號，多個編號以英文;間隔\",

\"exQuarantineCertNo\":\"附加產(chǎn)品檢疫證編號，多個編號以英文;間隔\",

\"meatQualityNo\":\"肉品品質(zhì)檢驗證編號，多個編號以英文;間隔\",

\"meatQualityUrl\":\"肉品品質(zhì)檢驗證網(wǎng)址，多個網(wǎng)址以英文;間隔\",

\"delFlag\":\"刪除標(biāo)記，默認(rèn)0為不刪除，1為刪除，若僅刪除數(shù)據(jù)可只傳分銷號（salesDocumentNo）和本刪除標(biāo)記\",}]");

Requestrequest=newRequest.Builder()

.url("/mwtrace/api/api/ImportAndVerifyData")

.method("POST",body)

.addHeader("X-Access-Token","XXX")

.addHeader("Content-Type","application/json")

.build();

Responseresponse=client.newCall(request).execute();

圖A.10同步肉品溯源數(shù)據(jù)并核驗動檢證接口調(diào)用的示例代碼（續(xù)）

A.4.2接口調(diào)用成功的返回示例

同步肉品溯源數(shù)據(jù)并核驗動檢證接口調(diào)用成功的返回示例見圖A.11。

13

DB4403/T582—2025

{

"success":true,

"message":"數(shù)據(jù)導(dǎo)入完成，導(dǎo)入成功X條（其中核驗通過X條，核驗不通過X條），導(dǎo)入失敗X條",

"code":0,

"result":

{

"ImportResult":"第X條，數(shù)據(jù)導(dǎo)入成功；",

"VerifyResult":

[{

"salesDocumentNo":"XXX",

"animalCertNo":null,

"quarantineCertNo":"XXX",

"verifyStatus":1,

"verifyResult":"XXX",

"verifyRemark":"XXX"

}]

},

"timestamp":1724997777051

}

圖A.11查詢動檢證核驗結(jié)果接口調(diào)用成功的返回示例

A.4.3接口調(diào)用失敗的返回示例

同步肉品溯源數(shù)據(jù)并核驗動檢證接口調(diào)用失敗的返回示例見圖A.12。

{

"success":false,

"message":"XXX",

"code":500,

"result":"XXX",

"timestamp":1724997777051

}

圖A.12查詢動檢證核驗結(jié)果接口調(diào)用失敗的返回示例

14

DB4403/T582—2025

附錄B

（資料性）

動物代碼表

表B.1規(guī)定了動物名稱對應(yīng)的代碼。

表B.1動物代碼表

一級代碼一級名稱二級名稱三級名稱三級代碼

豬10100

生豬10101

仔豬10102

種公豬10103

豬種母豬10104

藏豬10105

商品豬10106

種豬10107

其他豬10199

牛10200