ICS67.040

X00

備案號(hào)：60243-2018DB32

江蘇省地方標(biāo)準(zhǔn)

DB32/T3407—2018

食品安全電子追溯標(biāo)識(shí)解析服務(wù)數(shù)據(jù)

接口規(guī)范

Interfacespecificationofidentificationresolutionserviceforfoodsafetyelectronic

traceability

2018-06-25發(fā)布2018-07-10實(shí)施

江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布

DB32/T3407—2018

食品安全電子追溯標(biāo)識(shí)解析服務(wù)數(shù)據(jù)接口規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯標(biāo)識(shí)解析服務(wù)的功能要求和數(shù)據(jù)接口。

本標(biāo)準(zhǔn)適用于食品安全電子追溯標(biāo)識(shí)解析服務(wù)的接口實(shí)現(xiàn)。

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

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB12904商品條碼零售商品編碼與條碼表示

RFC1945超文本傳輸協(xié)議1.0(Hypertexttransferprotocol--HTTP/1.0)

RFC2616超文本傳輸協(xié)議1.1(Hypertexttransferprotocol--HTTP/1.1)

RFC4627JSON格式定義(Theapplication/JSONmediatypeforjavascriptobjectnotation)

RFC4825可擴(kuò)展標(biāo)記語言配置接入?yún)f(xié)議(Theextensiblemarkuplanguage(XML)configuration

accessprotocol(XCAP))

3術(shù)語和定義

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

3.1

標(biāo)識(shí)解析服務(wù)identificationresolutionservice

將物品的追溯標(biāo)識(shí)翻譯成物品所歸屬的數(shù)據(jù)目錄服務(wù)器URL地址的過程。

3.2

數(shù)據(jù)目錄服務(wù)datacatalogservice

以物品的追溯標(biāo)識(shí)為索引建立物品所流經(jīng)的信息查詢服務(wù)器URL地址列表的過程。

3.3

信息查詢服務(wù)informationqueryservice

向數(shù)據(jù)目錄服務(wù)器注冊(cè)追溯標(biāo)識(shí)，并以格式化的數(shù)據(jù)結(jié)構(gòu)向追溯代理提供追溯信息查詢的過程。

3.4

網(wǎng)元networkelement

由軟硬件共同組成的能實(shí)現(xiàn)網(wǎng)絡(luò)中的一種或多種邏輯功能的邏輯單元。

3.5

1

DB32/T3407—2018

IRS網(wǎng)元identificationresolutionservicenetworkelement

提供追溯標(biāo)識(shí)注冊(cè)和追溯標(biāo)識(shí)解析服務(wù)的網(wǎng)元。

3.6

IQS網(wǎng)元informationqueryservicenetworkelement

提供可視化追溯信息查詢服務(wù)的網(wǎng)元。

3.7

DCS網(wǎng)元datacatalogservicenetworkelement

以追溯標(biāo)識(shí)為單位提供追溯路徑的建立和查詢服務(wù)的網(wǎng)元。

3.8

追溯代理traceabilityproxy

以用戶發(fā)起的HTTP追溯查詢請(qǐng)求為觸發(fā)，代替追溯用戶調(diào)用IRS,DCS和IQS網(wǎng)元的多個(gè)接口完成追溯

查詢邏輯功能的網(wǎng)元。

3.9

EU網(wǎng)元endusernetworkelement

終端用戶所使用的具備追溯查詢能力的軟件系統(tǒng)的統(tǒng)稱。

3.10

CU網(wǎng)元captureunitnetworkelement

負(fù)責(zé)采集主數(shù)據(jù)、交易數(shù)據(jù)和事件數(shù)據(jù)并提交到IQS網(wǎng)元，完成數(shù)據(jù)采集功能的網(wǎng)元。

3.11

SP網(wǎng)元SupervisorPlatformNetworkElement

接收IQS網(wǎng)元上報(bào)的追溯數(shù)據(jù)，支撐政府監(jiān)管人員利用追溯數(shù)據(jù)開展對(duì)企業(yè)監(jiān)管的網(wǎng)元。

4縮略語

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

CU：捕獲單元(CaptureUnit)

DNS：域名服務(wù)(DomainNameService)

DCS：數(shù)據(jù)目錄服務(wù)(DataCatalogService)

EU：終端用戶(EndUser)

GTIN：全球貿(mào)易項(xiàng)目代碼(GlobalTradeItemNumber)

IQS：信息查詢服務(wù)(InformationQueryService)

IRS：標(biāo)識(shí)解析服務(wù)(IdentificationResolutionService)

JSON：JS對(duì)象標(biāo)記(JavaScriptObjectNotation)

RFID：射頻識(shí)別(RadioFrequencyIdentification)

SP：監(jiān)管平臺(tái)(SupervisorPlatform)

URL：統(tǒng)一資源定位符(UniformResourceLocator)

2

DB32/T3407—2018

URN：統(tǒng)一資源名稱(UniformResourceName)

XML：可擴(kuò)展標(biāo)記語言(ExtensibleMarkupLanguage)

5功能要求

5.1系統(tǒng)架構(gòu)

5.1.1總則

食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺(tái)、監(jiān)管平臺(tái)和查詢平臺(tái)組成。企業(yè)應(yīng)確保食品鏈的可追溯性，

并通過建設(shè)符合本框架規(guī)定的相關(guān)接口的企業(yè)平臺(tái)，加入食品安全電子追溯系統(tǒng)。食品安全電子追溯系

統(tǒng)的系統(tǒng)架構(gòu)見圖1。

查詢平臺(tái)監(jiān)管平臺(tái)

Web/APPIRS解析食品質(zhì)量安全監(jiān)管平臺(tái)

EU追溯代理IRS網(wǎng)元各市監(jiān)管平臺(tái)

/微信服務(wù)查詢接口

網(wǎng)元……

IRS標(biāo)識(shí)管理

數(shù)據(jù)交換接口

DCS接口

查詢接口

DCS網(wǎng)元SP網(wǎng)元

IQS

查詢接口

DCS標(biāo)識(shí)管理接口

DCS事件登記接口數(shù)據(jù)上報(bào)接口

IQS網(wǎng)元

IQS數(shù)據(jù)傳輸接口

CU網(wǎng)元

企業(yè)平臺(tái)

圖1食品安全電子追溯系統(tǒng)結(jié)構(gòu)

5.1.2網(wǎng)元要求

IRS網(wǎng)元應(yīng)對(duì)外提供追溯標(biāo)識(shí)注冊(cè)和追溯標(biāo)識(shí)解析服務(wù)。

DCS網(wǎng)元應(yīng)以追溯標(biāo)識(shí)為單位提供追溯路徑的建立和查詢的服務(wù)。DCS網(wǎng)元應(yīng)以追溯標(biāo)識(shí)為標(biāo)

識(shí)確保物品的可追溯性。

IQS網(wǎng)元應(yīng)提供追溯信息捕獲、查詢服務(wù)和數(shù)據(jù)上報(bào)服務(wù)的功能。

CU網(wǎng)元應(yīng)通過條碼識(shí)讀設(shè)備和RFID讀寫器等數(shù)據(jù)采集設(shè)備實(shí)現(xiàn)采集一維碼、二維碼、RFID

標(biāo)簽等信息的功能。

EU網(wǎng)元功能應(yīng)信息終端設(shè)備上實(shí)現(xiàn)；EU網(wǎng)元應(yīng)向用戶提供追溯的交互式人機(jī)界面。

SP網(wǎng)元應(yīng)部署在監(jiān)管部門的服務(wù)器系統(tǒng)上，SP網(wǎng)元應(yīng)實(shí)現(xiàn)支撐利用追溯數(shù)據(jù)開展對(duì)企業(yè)的監(jiān)

管功能。

追溯代理應(yīng)以用戶發(fā)起的追溯請(qǐng)求為觸發(fā)，代替用戶完成追溯系統(tǒng)的內(nèi)部業(yè)務(wù)處理。

5.2基本服務(wù)功能

3

DB32/T3407—2018

IRS網(wǎng)元應(yīng)提供但不限于以下功能：

a)追溯標(biāo)識(shí)注冊(cè)功能；

b)追溯標(biāo)識(shí)解析功能。

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

6.1基本要求

食品安全電子追溯系統(tǒng)的各個(gè)網(wǎng)元之間應(yīng)通過Internet公共以太網(wǎng)接口互聯(lián)互通。各網(wǎng)元的物理接

口上承載的協(xié)議棧應(yīng)為HTTP或HTTPS協(xié)議棧，數(shù)據(jù)接口應(yīng)使用基于HTTP/HTTPS協(xié)議的JSON格式的消息體

傳輸數(shù)據(jù)。IRS網(wǎng)元和其它各個(gè)網(wǎng)元之間應(yīng)通過數(shù)據(jù)接口進(jìn)行消息交互，實(shí)現(xiàn)IRS網(wǎng)元的功能。這些具體

接口包括：

a)IRS解析查詢接口；

b)IRS標(biāo)識(shí)管理接口。

6.2接口原語

基于服務(wù)的方式定義數(shù)據(jù)接口的使用方法。服務(wù)響應(yīng)流程使用了“請(qǐng)求-Request”“指示

-Indication”“響應(yīng)-Response”“確認(rèn)-Confirm”四條服務(wù)原語，原語的順序見圖2。

客戶端服務(wù)器

請(qǐng)求-RequestHTTP

Request消息

指示-Indication

響應(yīng)-Response

HTTP

Response消息

確認(rèn)-Confirm

圖2服務(wù)響應(yīng)流程

IRS網(wǎng)元的服務(wù)接口分為：

a)IRS標(biāo)識(shí)管理接口；

b)IRS解析查詢接口。

IRS標(biāo)識(shí)管理接口應(yīng)包括：

a)DCS網(wǎng)元登陸接口；

b)DCS網(wǎng)元注冊(cè)接口；

c)IRS標(biāo)識(shí)注冊(cè)接口；

4

DB32/T3407—2018

d)IRS標(biāo)識(shí)更新接口；

e)IRS標(biāo)識(shí)刪除接口。

IRS解析查詢接口只包括IRS標(biāo)識(shí)解析接口的一個(gè)接口。

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

IRS網(wǎng)元接口中所使用到的數(shù)據(jù)類型見表1。

表1數(shù)據(jù)類型說明

類型名類型描述類型約束

String文本字符串內(nèi)容為所有的有效字符

Number數(shù)字類型內(nèi)容由從0-9的數(shù)字字符，和+-字符組成

List<>列表類型每一項(xiàng)均為一個(gè)子數(shù)據(jù)項(xiàng)，子數(shù)據(jù)項(xiàng)編碼方式與父數(shù)據(jù)項(xiàng)編碼方式相同；

每項(xiàng)不超過305個(gè)文本字符，有具體規(guī)定的參見具體規(guī)定

Datatime時(shí)間類型固定格式字符串，格式為YYYY-MM-DDhh:mm:ss

6.4調(diào)用方式

6.4.1請(qǐng)求

請(qǐng)求接口應(yīng)通過RFC1945或RFC2616中規(guī)定的HTTP請(qǐng)求，使用Get或者Post方法調(diào)用食品電子追溯

目錄服務(wù)接口。請(qǐng)求接口將請(qǐng)求參數(shù)按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中

發(fā)送給對(duì)方。

6.4.2響應(yīng)

請(qǐng)求接口調(diào)用成功或失敗以后，IRS網(wǎng)元應(yīng)以RFC4825中規(guī)定的XML或RFC4627中規(guī)定的JSON格式將

處理結(jié)果放置在HTTP的Response消息的Body中，返回給調(diào)用者。HTTP的Response消息應(yīng)符合RFC1945

或RFC2616中的要求。

6.5參數(shù)要求

6.5.1IRS標(biāo)識(shí)解析接口

基本要求

追溯代理網(wǎng)元應(yīng)通過IRS標(biāo)識(shí)解析接口向IRS網(wǎng)元發(fā)送需要解析的物品標(biāo)識(shí)，并從IRS網(wǎng)元獲得該被

追溯產(chǎn)品歸屬的DCS網(wǎng)元的URL地址信息。

該接口示例參見附錄B.1。

接口參數(shù)

該接口名稱為IRS_ID_Resolute。

IRS標(biāo)識(shí)解析請(qǐng)求接口參數(shù)見表2，IRS標(biāo)識(shí)解析響應(yīng)接口參數(shù)見表3。

5

DB32/T3407—2018

表2IRS標(biāo)識(shí)解析請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_ID_Resolute是

ObjectCode1String255被查詢物品主標(biāo)識(shí)是

ObjectCode2String255被查詢物品附加標(biāo)識(shí)否

RoleString255固定取值為：是

EndUser或Supervisor，默

認(rèn)值為EndUser

GTINString14被查詢商品的GTIN，編碼規(guī)否

則參見GB12904

OIDString255被查詢商品的OID編碼否

HandleString255被查詢商品的Handle編碼否

表3IRS標(biāo)識(shí)解析響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

DCSURLString255被追溯的資源編碼所歸屬的是

DCSURL

SrvListList<Item>見表A.1DCS信息列表,Item類型定否

義見表A.1

6.5.2DCS網(wǎng)元登陸接口

基本要求

DCS網(wǎng)元應(yīng)先通過DCS網(wǎng)元登陸接口對(duì)DCS網(wǎng)元進(jìn)行認(rèn)證，并由IRS網(wǎng)元授予DCS網(wǎng)元相應(yīng)的權(quán)限。

IRS網(wǎng)元在對(duì)DCS網(wǎng)元的用戶名和密碼認(rèn)證通過以后，應(yīng)將會(huì)話ID返回給DCS，后續(xù)DCS通過會(huì)話ID與IRS

網(wǎng)元進(jìn)行數(shù)據(jù)交互。IRS網(wǎng)元應(yīng)刪除長(zhǎng)期不用的空閑會(huì)話ID，空間會(huì)話ID的保留時(shí)間由IRS網(wǎng)元的管理

策略決定。該接口示例參見附錄B.2。

接口參數(shù)

該接口名稱為IRS_DCS_Login，DCS網(wǎng)元登陸請(qǐng)求接口參數(shù)見表4，DCS網(wǎng)元登陸響應(yīng)接口參數(shù)見表

5。

表4DCS網(wǎng)元登陸請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_DCS_Login是

NameString255IRS授予DCS的用戶名是

PasswordString255DCS設(shè)置的密碼是

6

DB32/T3407—2018

表5DCS網(wǎng)元登陸響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

SeidString32會(huì)話編號(hào)，由IRS統(tǒng)一分配，是

每次登陸分配一個(gè)全局唯一

的會(huì)話ID

6.5.3DCS網(wǎng)元注冊(cè)接口

接口描述

DCS網(wǎng)元應(yīng)通過DCS網(wǎng)元注冊(cè)接口向IRS網(wǎng)元注冊(cè)DCS網(wǎng)元的基礎(chǔ)信息。該接口應(yīng)由DCS網(wǎng)元發(fā)起，由

IRS網(wǎng)元處理并返回響應(yīng)給DCS網(wǎng)元。

該接口示例參見附錄B.3。

接口參數(shù)

該接口名稱為IRS_DCS_Reg。

DCS網(wǎng)元注冊(cè)請(qǐng)求接口參數(shù)見表6，DCS網(wǎng)元注冊(cè)響應(yīng)接口參數(shù)見表7。

表6DCS網(wǎng)元注冊(cè)請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_DCS_Reg是

SeidString32會(huì)話編號(hào)，IQS在登錄過程是

中獲取

NodeString255DCS的標(biāo)識(shí)，用于唯一識(shí)別是

DCS

StructureString32所注冊(cè)的標(biāo)識(shí)規(guī)則是

SrvListList<Item>見表A.1服務(wù)資源列表，Item類型定是

義見表A.1

表7DCS網(wǎng)元注冊(cè)響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

6.5.4IRS標(biāo)識(shí)注冊(cè)接口

接口描述

DCS網(wǎng)元應(yīng)通過IRS注冊(cè)接口實(shí)現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元請(qǐng)求標(biāo)識(shí)注冊(cè)。該接口示例參見附錄B.4。

7

DB32/T3407—2018

接口參數(shù)

接口名稱為IRS_ID_Reg，IRS標(biāo)識(shí)注冊(cè)請(qǐng)求接口參數(shù)見表8，IRS標(biāo)識(shí)注冊(cè)響應(yīng)接口參數(shù)見表9。

表8IRS標(biāo)識(shí)注冊(cè)請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_ID_Reg是

SeidString32會(huì)話編號(hào)，IQS在登錄過程是

中獲取

CodeListList<String>每項(xiàng)不超過255所注冊(cè)的標(biāo)識(shí)列表，可包含是

多個(gè)標(biāo)識(shí)

StructureString32所注冊(cè)的標(biāo)識(shí)規(guī)則是

255發(fā)起標(biāo)識(shí)注冊(cè)的DCS的URL

DCSURLString是

地址

表9IRS標(biāo)識(shí)注冊(cè)響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

6.5.5IRS標(biāo)識(shí)更新接口

接口描述

DCS網(wǎng)元應(yīng)通過IRS標(biāo)識(shí)更新接口向IRS網(wǎng)元發(fā)起請(qǐng)求標(biāo)識(shí)更新請(qǐng)求，修改IRS數(shù)據(jù)庫(kù)中標(biāo)識(shí)的相關(guān)

信息。該接口示例參見附錄B.5。

接口參數(shù)

接口名稱為IRS_ID_Upd，IRS標(biāo)識(shí)更新請(qǐng)求接口參數(shù)見表10，IRS標(biāo)識(shí)更新響應(yīng)接口參數(shù)見表11。

表10IRS標(biāo)識(shí)更新請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_ID_Upd是

會(huì)話編號(hào)，IQS在登錄過程

SeidString32是

中獲取

CodeString255所需要更新的標(biāo)識(shí)id是

StructureString32所更新標(biāo)識(shí)的標(biāo)識(shí)規(guī)則是

發(fā)起標(biāo)識(shí)更新的DCS的URL

DCSURLString255是

地址

8

DB32/T3407—2018

表11IRS標(biāo)識(shí)更新響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

6.5.6IRS標(biāo)識(shí)刪除接口

接口描述

DCS網(wǎng)元與IRS網(wǎng)元之間可通過IRS標(biāo)識(shí)刪除接口，實(shí)現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元發(fā)起請(qǐng)求刪除，刪除某個(gè)

指定標(biāo)識(shí)的相關(guān)信息。

該接口示例參見附錄B.6。

接口參數(shù)

接口名稱為IRS_ID_Del。

IRS標(biāo)識(shí)刪除請(qǐng)求接口參數(shù)見表12,IRS標(biāo)識(shí)刪除響應(yīng)接口參數(shù)見表13。

表12IRS標(biāo)識(shí)刪除請(qǐng)求接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

MessageNameString32取值為IRS_ID_Del是

SeidString32會(huì)話編號(hào)，IQS在登錄過程是

中獲取

DeleteContentString255所需刪除的標(biāo)識(shí)內(nèi)容是

255發(fā)起標(biāo)識(shí)刪除的DCS的URL

DCSURLString是

地址

表13IRS標(biāo)識(shí)刪除響應(yīng)接口參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

StatusString32返回結(jié)果，定義見表A.3是

9

DB32/T3407—2018

10

DB32/T3407—2018

AA

附錄A

（規(guī)范性附錄）

特殊數(shù)據(jù)類型參數(shù)

Item類型的參數(shù)見表A.1，Item類型參數(shù)的字段取值見表A.2，Status類型參數(shù)見表A.3。

表A.1Item類型參數(shù)

最大長(zhǎng)度

參數(shù)名稱類型說明是否必選

Byte

ItemNameString32項(xiàng)目名稱，取值見表A.2是

ItemValueString255項(xiàng)目值，取值見表A.2是

表A.2Item類型字段取值

ItemName取值ItemValue取值說明

BackupDCSURLString備份的DCS服務(wù)器的URL，當(dāng)主服務(wù)器不可達(dá)時(shí)，訪問

備份DCS服務(wù)器

RecordTimeDatatime追溯查詢請(qǐng)求被處理的時(shí)間，IQS可以利用該消息與DCS

時(shí)間進(jìn)行同步

TranslatedCodeString按照內(nèi)置的翻譯規(guī)則，將被解析的標(biāo)識(shí)翻譯成一個(gè)新標(biāo)

識(shí)

StructureString該編碼的編碼結(jié)構(gòu)信息

表A.3Status類型參數(shù)

Status取值Status含義說明

Succ查詢成功成功處理該請(qǐng)求

UnknowErr未知錯(cuò)誤內(nèi)部出現(xiàn)不可預(yù)見的異常

CodeNotExist編碼不存在被查詢的編碼不存在

StructureErr編碼結(jié)構(gòu)不符合規(guī)則編碼結(jié)構(gòu)不符合編碼組織規(guī)定的編碼規(guī)則

DCSErrDCS狀態(tài)異常該編碼所對(duì)應(yīng)的DCS狀態(tài)出現(xiàn)異常

TooShort編碼太短編碼太短，解析不成功

TooLong編碼太長(zhǎng)編碼太長(zhǎng)，含未知信息

11

DB32/T3407—2018

BB

附錄B

（資料性附錄）