DB32T 3411-2018食品安全電子追溯信息查詢服務數據接口規(guī)范

ICS67.040X00備案號：江蘇省地DB32方標準DBT3411—2018Interfacespecificationsofinformationqueryserviceforfoodsafetyelectronicraceability江蘇省質量技術監(jiān)督局發(fā)布IDB32/T3411—2018 DB32/T3411—2018 H 40 IDB32/T3411—2018前言本標準按照GB/T1.1—2009給出的規(guī)則起草。本標準由江蘇省食品藥品監(jiān)督管理局提出并歸口。本標準起草單位：江蘇省質量和標準化研究院、復旦大學無錫研究院、中科院計算機網絡中心、無錫捷瑪科技物聯有限公司。本標準主要起草人：胡冶、崔兆明、王俊宇、劉毅、曹云、楊博、劉佳、周廣軍、王瑜、錢侃、王開疆、吳雙力、田野。1DB32/T3411—2018食品安全電子追溯信息查詢服務數據接口規(guī)范1范圍本標準規(guī)定了食品安全電子追溯信息查詢服務的功能要求、數據接口。本標準適用于食品安全電子追溯信查查詢服務的接口實現。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T17295國際貿易計量單位代碼DB32/TXXXX-2018食品安全電子追溯標識解析服務數據接口規(guī)范RFC2616超文本傳輸協(xié)議1.1(Hypertexttransferprotocol--HTTP/1.1)RFC4627JSON格式定義(Theapplication/JSONmediatypeforjavascriptobjectnotation)configurationaccessprotocol(XCAP))3術語和定義下列術語和定義適用于本文件。3.1信息查詢服務informationqueryservice提供追溯信息傳輸、查詢和數據上報功能的服務。3.2網元networkelement由軟硬件共同組成的能實現網絡中的一種或多種邏輯功能的邏輯單元。3.3IQS網元informationqueryservicenetworkelement提供信息查詢服務的網元。3.4IRS網元identificationresolutionservicenetworkelement提供追溯標識注冊和追溯標識解析服務的網元。2DB32/T3411—20183.5DCS網元datacatalogservicenetworkelement提供追溯路徑的建立和查詢服務的網元。3.6EU網元endusernetworkelement終端用戶所使用的具備追溯查詢能力的軟件系統(tǒng)的統(tǒng)稱。3.7CU網元captureunitnetworkelement負責采集數據、上傳的網元。3.8SP網元supervisorplatformnetworkelement負責接收IQS網元上報的追溯數據，并利用追溯數據進行監(jiān)管行為的網元。3.9追溯代理traceabilityproxy以用戶發(fā)起的HTTP追溯查詢請求為觸發(fā)，代替追溯用戶調用IRS,DCS和IQS網元的多個接口完成追溯查詢邏輯功能的網元。4縮略語下列縮略語適用于本文件。CU：捕獲單元(CaptureUnit)DNS：域名服務(DomainNameService)DCS：數據目錄服務(DataCatalogService)EU：終端用戶(EndUser)IQS：信息查詢服務(InformationQueryService)IRS：標識解析服務(IdentificationResolutionService)JSON：JS對象標記(JavaScriptObjectNotation)RFID：射頻識別(RadioFrequencyIdentification)SP：監(jiān)管平臺(SupervisorPlatform)URL：統(tǒng)一資源定位符(UniformResourceLocator)URN：統(tǒng)一資源名稱(UniformResourceName)XML：可擴展標記語言(ExtensibleMarkupLanguage)5信息查詢服務功能要求5.1系統(tǒng)架構3DB32/T3411—2018食品安全電子追溯系統(tǒng)應由企業(yè)平臺、監(jiān)管平臺和查詢平臺組成，食品安全電子追溯系統(tǒng)的系統(tǒng)架構見DB32/TXXXX。信息查詢服務由IQS網元實現，IQS網元架構圖見圖1。圖1IQS網元構架5.2信息查詢服務基本功能信息查詢服務應提供但不限于以下功能：a)傳輸服務——通過數據傳輸接口接收企業(yè)平臺(CU網元)傳輸的追溯數據；b)查詢服務——通過查詢接口與查詢平臺交互實現追溯數據的查詢。6信息查詢服務接口要求6.1基本要求食品安全電子追溯系統(tǒng)的各個網元之間應通過Internet公共以太網接口互聯互通。IQS網元與其他網元的物理接口上承載的協(xié)議棧應為HTTP或HTTPS協(xié)議棧，數據接口應使用基于HTTP/HTTPS協(xié)議的JSON格式的消息體傳輸數據。IQS接口分為：a)數據傳輸接口；b)查詢接口。6.1.1IQS傳輸接口食品生產經營企業(yè)信息管理系統(tǒng)通過該接口和IQS網元交互，使用傳輸服務。IQS傳輸接口分為：a)主數據傳輸接口；b)事件傳輸接口；c)資源文件傳輸接口。4DB32/T3411—20186.1.2IQS查詢接口查詢平臺通過該接口和IQS網元交互，使用查詢服務。6.2接口原語基于服務的方式定義數據接口的使用方法。服務響應流程使用了“請求-Request”“指示-Indication”“響應-Response”“確認-Confirm”四條服務原語，原語的順序見圖2。圖2服務響應流程6.3基本數據類型IQS網元接口基本數據類型見表1。表1基本數據類型類型名類型描述類型約束String文本字符串內容為所有的有效字符List<>列表類型每一項均為一個子數據項，子數據項編碼方式與父數據項編碼方式相同。Time時間類型UTC時間表示法：YYYY-MM-DDTHH:mm:ss.SSSZ本地時間表示法：YYYY-MM-DDTHH:mm:ss.SSS±zoneoffsetfloat浮點數類型內容為浮點數類型字符整數類型內容為整形字符file文件流類型內容為對文件的操作定義Boolean數值類型alse6.4接口調用方式6.4.1請求5DB32/T3411—2018請求接口應符合RFC2616中對HTTP請求的規(guī)定，使用Get或者POST方法調用接口，并將請求參數按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中發(fā)送給對方。6.4.2響應接口調用成功后，應由IQS網元進行處理，處理方式應符合RFC4825對XML的規(guī)定或RFC4627對JSON格式的規(guī)定，處理結束后應將處理結果放置在HTTP的Response消息的Body中，返回給調用者。HTTP的Response消息應符合RFC2616中的規(guī)定。7主數據傳輸接口7.1接口基本功能提供食品生產經營企業(yè)提供向IQS提交靜態(tài)數據的功能。注：靜態(tài)數據包括食品生產企業(yè)的企業(yè)基本信息、原料基本信息、供貨廠商基本信息、生產流程基本信息、產成品基本信息、銷售商基本信息、原料及產生品檢驗信息等。7.2接口定義接口名稱：vocabularyCapture。主數據傳輸接口請求參數及響應參數見表2、表7。表2主數據傳輸接口請求參數參數名稱類型最大長度Byte是否必填描述EPCISMasterDataBodyEPCISMasterDataDocumentType255是主數據結構，EPCISMasterDataDocumentType定義見表3表3EPCISMasterDataDocumentType數據結構參數名稱類型最大長度Byte是否必填描述VocabularyLiList<VocabularyListType>單個標識最大55是主數據列表，VocabularyListType定義見表4VocabularyListType數據參數參數名稱類型最大長度Byte是否必填描述typeString255是主數據類型參數名稱類型最大長度Byte是否必填描述VocabularyElementListList<VocabularyElementListType>單個標識最大255是主數據內容列表，VocabularyElementListType定義見表56DB32/T3411—2018表5VocabularyElementListType數據參數參數名稱類型最大長度Byte是否必填描述String255是主數據主鍵attributeList<attributeType>單個標識最大255是主數據屬性，attributeType定義見表6表6attributeType數據參數參數名稱類型最大長度Byte是否必填描述String255是屬性名稱/編碼valueString255是屬性內容表7主數據傳輸接口返回參數參數名稱類型最大長度Byte是否必填描述StatusString255是返回數據傳輸結果success：傳輸成功，false：傳輸失敗7.3接口調用靜態(tài)數據不隨生產活動而變化，靜態(tài)數據因企業(yè)其他活動發(fā)生改變時調用該接口。接口調用方向：由CU網元向IQS網元提出請求。注：調用示例可參見附錄F。8事件傳輸接口8.1接口基本功能提供食品生產經營企業(yè)提供向IQS提交動態(tài)數據的功能。注：動態(tài)數據包括與企業(yè)生產化活動相關的數據，如原輔料及產成品進銷存數量、生產投料等數據8.2接口定義接口名稱：Capture。事件傳輸請求參數及響應參數見表8、表9。表8事件傳輸接口請求參數參數名稱類型最大長度Byte是否必填描述7DB32/T3411—2018eventList<EPCISEvent>單個標識最大255是事件數據結構，EPCISEvent定義見附錄A表9事件傳輸接口響應參數參數名稱類型最大長度Byte是否必填描述StatusString255是返回數據傳輸結果success：提交成功，falser：提交失敗8.3接口調用接口調用方向：由CU網元向IQS網元提出請求。注：調用示例可參見附錄G。9資源文件傳輸接口9.1接口基本功能提供食品生產經營企業(yè)向IQS上傳資源文件的的功能，資源文件應包含圖片、視頻、文檔文件等。9.2接口定義接口名稱：resUpload。資源文件傳輸接口請求參數及響應參數見表10、表11。表10資源文件傳輸接口請求參數參數名稱類型最大長度Byte是否必填描述filePathfile255是待上傳文件表11資源文件傳輸接口響應參數參數名稱類型最大長度Byte是否必填描述statusString255是返回值，用于表示狀態(tài)：success上傳成功，false上傳失敗fileURLString255否返回值為success時，本字段存放可用于訪問的文件URL；否則為空9.3接口調用接口調用方向：由CU網元向IQS網元提出請求。注：調用示例可參見附錄H。8DB32/T3411—201810查詢接口10.1接口基本功能提供從IQS查詢符合條件的靜態(tài)數據和動態(tài)數據的功能。10.2接口定義接口名稱：poll。查詢接口請求參數：見表12、表13。表12查詢接口請求參數參數名稱類型最大長度Byte是否必填描述queryNameString255是查詢名稱，可使用項目見表13paramsQueryParams255是查詢參數，根據不同的查詢名稱，參數也不同，見表14表13queryName參數queryName值aramsSimpleEventQuery匿名事件查詢，params定義見附錄BSimpleMasterDataQuery匿名主數據查詢，params定義見附錄CAuthenticatedEQuery認證用戶事件查詢，params定義見附錄DAuthenticatedMDQuery認證用于主數據查詢，params定義見附錄E表14查詢接口返回參數參數名稱類型是否必填描述queryNameString1-255本參數與請求參數中的queryName一致resultsBodyQueryResultsBody1-255返回的查詢結果，本參數的類型由請求參queryName決定：當queryName為SimpleEventQuery和AuthenticatedEQuery時，本參數的數據類型定義見附錄A；當queryName為SimpleMasterDataQuery和AuthenticatedMDQuery時，本參數的數10.3接口調用接口調用方向：由CU網元、EU網元、SP網元通過追溯代理向IQS網元提出請求。注：調用示例可參見附錄I。9DB32/T3411—2018附錄A(規(guī)范性附錄)EPCISEvent定義A.1ObjectEvent子類數據結構EPCISEvent是一個對于所有IQS事件的基礎類型，ObjectEvent是其一個子類，用于記錄對象事件數據，結構見表A.1。表A.1ObjectEvent子類數據結構字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255否這個事件被IQS記錄的日期時間，在事件提交到IQS傳輸接口時必須忽略，由IQS自動記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應是字符串，以‘+’或者‘-’14)的數字，接著是一個冒號，后面是兩若前兩位是14，后兩位必須是00epcListList<EPC>單個標識最大255否單件追溯標識數組，EPC定義見A.5.1，epcList與quantityList兩者至少存在1項quantityListList<QuantityElement>單個標識最大255否批次追溯標識數組，QuantityElement定義見A.5.2，epcList與quantityList兩者actionAction255是事件導致的物品狀態(tài)變化，ADD：增加;DELETE：移除；OBSERVE：不變bizStepBusinessStepID255否業(yè)務步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務位置標識bizLocationBusinessLocationID255否事件發(fā)生后，物品所在業(yè)務位置標識bizTransactionLList<BusinessTransaction>單個標識最大255否與事件相關的事務單據數組，BusinessTransaction定義見A.5.3sourceListList<Source>單個標識最大255否在整個事務中開始的位置，Source定義見A.5.4DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述destinationListList<Destination>單個標識最大255否在整個事務中結束的位置，Destination定義ilmdILMD255否物品主數據補充，定義見A.5.6IotextensionList<EvtElementList>單個標識最大255否存放事件的詳細信息，EvtElementList定義A.2AggregationEvent子類數據結構定義EPCISEvent是一個對于所有IQS事件的基礎類型，AggregationEvent是其一個子類，用于記錄聚合事件和包含物流包裝的事件，具體內容見表A.2。表A.2AggregationEvent子類數據結構定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255這個事件被IQS記錄的日期時間，在事件提S記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00parentIDEPC255否值為OBERSVE時選填，否則為必填childEPCsList<EPC>單個標識最大長度為255否單件追溯標識數組，EPC定義見A.5.1，childEPCs與childQuantityList兩者至少存在一項childQuantityLList<QuantityElement>單個標識最大長度為255否批次追溯物標識數組，QuantityElement定義見A.5.2actionAction255是ADD：向容器增加;DELETE：從容器移除；OBSERVE：帶容器進行業(yè)務事件bizStepBusinessStepID255否業(yè)務步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務位置標識DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述bizLocationBusinessLocationID255否事件發(fā)生后，物品所在業(yè)務位置標識bizTransactionListList<BusinessTransaction>單個標識最大長度為255否與事件相關的事務單據數組，BusinessTransaction定義見A.5.3sourceListList<Source>單個標識最大長度為255否在整個事務中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標識最大長度為255否在整個事務中結束的位置，Destination定A5.4IotextensionList<EvtElementList>單個標識最大長度為255否存放事件的詳細信息，EvtElementList定義A.3TransactionEvent子類數據結構定義EPCISEvent是一個對于所有IQS事件的基礎類型，TransactionEvent是其一個子類，用于記錄帶有事務過程的業(yè)務事件信息，具體內容見表A.3。表A.3TransactionEvent子類數據結構定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255這個事件被IQS記錄的日期時間，在事件提S記錄，在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值，這個字段的值應是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00bizTransactionListList<BusinessTransaction>單個標識最大長度為255是與事件相關的事務單據數組，BusinessTransaction定義見表parentIDEPC255否容器追溯標識，EPC定義見A.5.1epcListList<EPC>單個標識最大長度為255否單件追溯標識數組，EPC定義見A.5.1quantityListList<QuantityElement>單個標識最大長度為255否批次追溯標識數組，QuantityElement定義DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述ActionAction255是ADD：事務發(fā)生時/新增對象時；DELETE事務結束時/對象移除時；OBSERVE：事務進行中bizStepBusinessStepID255否業(yè)務步驟，值見A.5.7DispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務位置標識bizLocationBusinessLocationID255否事件發(fā)生后，對象所在業(yè)務位置標識sourceListList<Source>單個標識最大長度為255否在整個事務中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標識最大長度為255否在整個事務中結束的位置，Destination定A5.4IotextensionList<EvtElementList>單個標識最大長度為255否存放事件的詳細信息，EvtElementList定義見A.5.5A.4TransformationEvent子類數據結構定義EPCISEvent是一個對于所有IQS事件的基礎類型，TransformationEvent是其一個子類，用于記錄投料產出事件信息，具體內容見表A.4。表A.4TransformationEvent子類數據結構定義字段名稱字段類型最大長度Byte是否必填描述eventTimeTime255是事件發(fā)生時間recordTimeTime255否這個事件被IQS記錄的日期時間。在事件提S記錄；在查詢時可以獲得eventTimeZoneOffsetString255是時間發(fā)生地點時區(qū)與UTC時區(qū)的差值。這個字段的值應是字符串，以‘+’或者‘-’開頭，后兩位是在00到14之間(包括00，14)的數字，接著是一個冒號，后面是兩位若前兩位是14，后兩位必須是00inputEPCListList<EPC>單個標識最大長度為255否單件追溯標識數組，EPC定義見A.5.1，當transformationID未賦值時，當transformationID賦值時，inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少存在1項DB32/T3411—2018字段名稱字段類型最大長度Byte是否必填描述inputQuantityLList<QuantityElement>單個標識最大長度為255否批次追溯標識數組，QuantityElement定義見A.5.2，當transformationID未賦值時，inputEPCList和inputQuantityList至少存在1項,當transformationID賦值時，inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少outputEPCListList<EPC>單個標識最大長度為255否單件追溯標識數組，EPC定義見A.5.1。當transformationID未賦值時，outputEPCList和outputQuantityList至inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少outputQuantityListList<QuantityElement>單個標識最大長度為255否批次追溯標識數組，QuantityElement定義見A.5.2。當transformationID未賦值時，outputEPCList和outputQuantityList至inputEPCList、inputQuantityList、outputEPCList、outputQuantityList至少transformationTransformationID255否變換編號，用于標記一個批次物品的多個投料生產事件bizStepBusinessStepID255否業(yè)務步驟，值見A.5.7dispositionDispositionID255否物品狀態(tài)，值見A.5.8readPointReadPointID255否事件發(fā)生時刻的業(yè)務位置標識bizLocationBusinessLocationID255否事件發(fā)生后，對象所在業(yè)務位置標識bizTransactionListList<BusinessTransaction>單個標識最大長度為255否與事件相關的事務單據數組，BusinessTransaction定義見表A.5.3sourceListList<Source>單個標識最大長度為255否在整個事務中開始的位置，Source定義見A.5.4destinationListList<Destination>單個標識最大長度為255否在整個事務中結束的位置，Destination定A5.4ilmdILMD255否物品主數據補充，定義見A.5.6IotextensionList<EvtElementList>單個標識最大長度為255否存放事件的詳細信息，EvtElementList定義A.5相關數據結構定義DB32/T3411—2018A.5.1EPC數據結構定義EPC用于記錄一個用于單件追溯的追溯標識，類型為String，使用資源標識符形式。A.5.2QuantityElement數據結構定義QuantityElement用于記錄批次追溯的追溯標識，定義見表A.5。表A.5QuantityElement數據結構定義字段名稱字段類型最大長度Byte是否必填描述epcClassString255是用于批次追溯的物品標識，使用資源標識符形式QuantityString255是數量，數量用于形容epcClass如何標稱。如果沒有uom字段，數量必須為正整數，用于表示epcClass的內容的個數；如果存在uom字段，數量可以是任何正數，與uom一起表示epcClass的計量UomString255是epcClass所對應的對象的數量，使用GB/T17295中的通用代碼A.5.3BusinessTransaction數據結構定義BusinessTransaction用于記錄事件中事務相關的單據信息，定義見表A.6、A.7所示。表A.6BusinessTransaction數據結構定義字段名稱字段類型最大長度Byte是否必填格式說明TypeBizTransTypeID255是單據類型編號，見表A.7bizTransString255是單據號碼表A.7BizTransTypeID數據結構定義BizTransTypeID值說明po采購訂單poc采購訂單確認bol提貨單發(fā)票rma退貨授權pedigree履歷desadv發(fā)貨通知單DB32/T3411—2018A。7(續(xù))BizTransTypeID值說明recadv收貨通知單prodorder生產通知單A.5.4Source/Destination數據結構定義Source/Destination用于記錄開始/結束的業(yè)務位置、所有者、管理方信息，定義見表A.8、A.9所示。表A.8Source/Destination數據結構定義字段名稱字段類型最大長度Byte是否必填格式說明TypeSourceDestTypeID255是字段類型說明，見表A.9Source/destinationString255是業(yè)務位置標識，使用資源標識符表示表A.9SourceDestTypeID數據結構定義SourceDestTypeID值說明owning_party表示所有者possessing_party表示管理方location表示業(yè)務位置A.5.5EvtElementList數據結構定義EvtElementList用于記錄事件中的詳細信息，定義見表A.10、A.11所示。表A.10EvtElementList數據結構定義字段名稱字段類型最大長度Byte是否必填描述extNameString255是擴展名稱extContentString255是擴展內容extIDString255是擴展信息內容區(qū)分，見表A.11resLinkString255是資源鏈接resTypeString255是resLink資源鏈接所指向的目標類型0000無內容0001圖片0002視頻0003網站0004地圖DB32/T3411—2018表A.11extID數據結構定義用途00001表示extContent字段內容是以JSON格式保存的投料產出明細信息00002表示extContent字段內容是以JSON格式保存的出廠檢驗明細信息00003表示extContent字段內容是以JSON格式保存的原料自檢明細信息A.5.6ILMD數據結構定義ILMD用于保存事件中額外的主數據信息，可由多組屬性組成，每組屬性定義見表A.12所示。表A.12ILMD屬性數據結構定義參數名稱類型最大長度Byte是否必填描述String255是屬性名稱/編碼valueString255是屬性內容A.5.7BusinessStepID值定義BusinessStepID用于表示一項具體的業(yè)務過程。BusinessStepID應使用URN形式表示，表A.13中的BusinessStepID在使用時的格式為：urn:epcglobal:cbv:bizstep:BusinessStepID。表A.13BusinessStepID值定義BusinessStepID中文名稱中文說明accepting收貨表示物品在業(yè)務過程中改變了持有方和/或所有者assembling組裝表示多個物品被組合成一個物品，通常用于聚合事件,它與變換事件不同，輸入的物品依舊存在，這個過程可逆commissioning賦碼將標識賦予物理物品的階段creating_class_instance生產單個或批次物品的生產階段decommissioning取消賦碼標識與物品之間的關系取消，以便將來可以重新賦碼arriving送達表示物品在業(yè)務過程中到達某一個業(yè)務位置collecting集貨表示在業(yè)務過程中，物品經過揀貨后放到一起，準備進入下一個處理consigning托運該階段與staging_outbound,loading,departing,andaccepting互斥，發(fā)生時物品持有方和/或所有者會發(fā)生改變cycle_counting盤點通過清點物品數量獲得一個準確的庫存，可用于業(yè)務需要以外的其他會計用途departing起運/出發(fā)表示在業(yè)務處理過程中物品離開當前位置去目的地destroying銷毀銷毀一個物品，物品之后不會有事件發(fā)生DB32/T3411—2018BusinessStepID中文名稱中文說明encoding編碼將單件/批次標識寫入載體的過程holding扣留在業(yè)務過程中，物品被隔離以便進一步檢查installing安裝表示在業(yè)務過程中一個物品被放入一個復合物品中l(wèi)oading裝貨表示在業(yè)務過程中，物品被裝載到運輸工具中disassembling拆解將一個物品分解成多個單獨的組成部分entering_exiting進入物品跟隨消費者進入或離開特定的場所inspecting檢驗/審查檢驗物品存在的問題killing終結終止一個RFID標識，物品將由其他標識來標識other其他無法使用核心業(yè)務詞匯表中的詞匯描述的階段packing物流包表示在業(yè)務過程中，將物品放入更大的容器用于運輸receiving收貨表示在業(yè)務過程中，在某個位置接收物品，并放到倉庫repackaging重新包裝表示在業(yè)務過程中，物品重新進行包裝replacing替換表示在業(yè)務過程中，一個物品被另一個物品替換retail_selling零售表示物品通過貨幣等交換的方式改變所有者為消費者的過程picking揀貨根據訂單選取物品removing拆卸表示在業(yè)務過程中一個物品從一個復合物品中取出的事件repairing修理表示在業(yè)務過程中有故障的物品被修復的事件reserving保留表示一組未被賦碼的追溯標識提供給第三方使用shipping運輸可以替代staging_outbound,loadingandstaging_outbound放到發(fā)貨區(qū)表示在業(yè)務過程中，將一個物品移動到運輸發(fā)貨區(qū)stocking上架/出貨表示在業(yè)務過程中，使物品可以被銷售或放到揀貨區(qū)域transporting運輸物品通過運輸工具從一個位置移動到另外一個位置unpacking拆包拆開封裝物品的箱子或包裝，取出物品stock_taking庫存盤點庫存盤點storing倉儲將物品放到儲存物品的地方unloading卸貨將物品從運輸工具中卸載下來A.5.8DispositionID值定義DispositionID用于表示追溯物品在事件發(fā)生后的狀態(tài)。DispositionID應使用URN形式表示，表A.14中的DispositionID在使用時的格式為：urn:epcglobal:cbv:disp:DispositionID。表A.14ISO/IEC19988定義的DispositionID值定義物品狀態(tài)ID中文名稱中文說明active激活被貼標的物品進入供應鏈適用業(yè)務步驟：commissioningDB32/T3411—2018物品狀態(tài)ID中文名稱中文說明destroyed摧毀物品已不可用適用業(yè)務步驟：destroyinginactive注銷標簽注銷適用業(yè)務步驟：decommissioningin_transit運輸中物品運輸中適用業(yè)務步驟：shipping、departingdamaged損壞物品損壞了，無法使用適用業(yè)務步驟：accepting、inspecting、receiving、removing、repairing、replacingcontainer_closed封箱物品被裝運在封閉的容器內適用業(yè)務步驟：staging_outbound物品狀態(tài)ID中文名稱中文說明encoded編碼標識已寫入RFID適用業(yè)務步驟：encodingin_progressi進行中供應鏈中物品的默認狀態(tài)適用業(yè)務步驟：receiving、picking、loading、accepting、staging_outbound、arrivingexpired已經過期物品已過保質期適用業(yè)務步驟：holding、staging_outbound、storingdisposed銷毀物品已經被銷毀no_pedigree_match履歷異常沒有找到符合的履歷，進行進一步調查適用業(yè)務步驟：holding、staging_outbound、storingrecalled召回因為公共安全的原因召回中適用業(yè)務步驟：holding、staging_outbound、storingreturned送回因各種原因物品退貨中適用業(yè)務步驟：Receiving、holding、shippingsellable_not_accessible可準備銷售物品可以銷售，但消費者還不能進行購買適用業(yè)務步驟：receiving、storing、loading、holding、inspectingstolen被盜物品已經被偷盜non_sellable_other無法銷售物品不允許銷售適用業(yè)務步驟：holding、inspecting、staging_outbound、storingreserved已分配單件標識被分配給第三方適用業(yè)務步驟：reservingsellable_accessible上架銷售物品可被銷售，且消費者可以購買適用業(yè)務步驟：stocking、receivingretail_sold已被購買物品已被消費者購買適用業(yè)務步驟：retail_sellingunknown物品狀態(tài)未知物品狀態(tài)未知DB32/T3411—2018附錄B(資料性附錄)entQueryparamsQueryparamsBparams參數名稱類型最大長度Byte是否必填描述eventTypeList<String>單個標識最大長度為255否如果指定了該參數(事件類型)，返回的查詢結果只包含與指定事件類型匹配的事件，本參數的取值可以為：ObjectEvent,AggregationEvent,TransactionEvent,或TransformationEvent；如果省略，會返回所有事件GE_eventTimeTime255否如果指定了該參數，返回的結果只包含eventTime大于指定時間的事件；如果省略，返回的結果不考慮eventTime(除非添加了LT_eventTime約束)LT_eventTimeTime255否如果指定了該參數，返回的結果只包含eventTime小于指定時間的事件如果省略，返回的結果不考慮eventTime(除非添加了GE_eventTime約束)GE_recordTimeTime255否如果提供了該參數，返回的結果只包含recordTime大于或者等于指定時間的事件如果省略，返回結果不考慮recordTimeLT_recordTimeTime255否如果指定了該參數，返回的結果只包含eventTime小于指定時間的事件如果省略，返回的結果不考慮recordTimeEQ_actionList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含有action字段并且該字段的取值與指定的參數值之一匹配的事件。本參數的取值只能是：ADD,OBSERVE或者DELETE如果省略，返回的事件不考慮action字段EQ_bizStepList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含bizStep字段非空且其取值與參數指定值之一匹配的事件如果省略該參數，返回的事件不考慮bizStep字段的值或者該字段是否存在EQ_dispositionList<String>單個標識最大長度為255否與EQ_bizStep參數類似，但是針對的是disposition字段20DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述EQ_readPointList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含readPoint非空并且readPoint字段的取值與參數指定值之一匹配的事件，如果本參數和WD_readPoint參數同時被省略，那么返回的結果事件不考慮readPoint字段的值或者該字段是否存在WD_readPointList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含readPoint非空并且readPoint的取值與參數指定值之一相匹配或是其直接或者間接后繼的事件，如果本參數和EQ_readPoint參數同時被省略，那么返回的結果不考慮readPoint字段的取值或者該字段是否存在EQ_bizTransaction_typeList<String>單個標識最大長度為255否本參數不是單一參數，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含bizTransactionList、業(yè)務交易列表中某個條目的type子字段與從本參數提取出的type名稱相同、bizTransction子字段與本參數對應部分指定的值相同EQ_source_typeList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集。如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含sourceList、源列表中某個條目的type子字段與從本參數提取出的type名稱相同、source子字段與本參數對應部分指定的值相同EQ_destination_typeList<String>單個標識最大長度為255否本參數不是單一參數，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含destinationList、目標列表中某個條目的type子字段與從本參數提取出的type名稱相同、destination子字段與本參數對應部分指定的值相同EQ_transformationIDList<String>單個標識最大長度為255否如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含transformationID、transformationID與本參數指定的值之一相等21DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述MATCH_epcList<String>單個標識最大長度為255否本參數用于查詢指定物品標識的相關事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：epcListchildEPCs字段、Cs參數指定的EPC模式或URI匹配、如果省略了本參數，那么返回的事件結果不考慮不管該兩個字段是否存在MATCH_parentIDList<String>單個標識最大長度為255否本參數用于查詢指定包裝物品標識的相關事件，與MATCH_epc字段類似，但是匹配的是AggregationEvent的parentID字段entparentIDAggregationEvent和TransactionEvent擴展類型的事件類型MATCH_inputEPCList<String>單個標識最大長度為255否本參數用于查詢指定原材料物品標識相關的變換事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含inputEPCList、inputEPCList字段中的某配；如果省略該參數，返回的事件不考慮inputEPCList字段或者該字段是否存在MATCH_outputEPCList<String>單個標識最大長度為255否本參數用于查詢指定產品物品標識相關的變換事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含outputEPCList、outputEPCList字段中的匹配MATCH_anyEPCList<String>單個標識最大長度為255否本參數用于查詢與指定的物品標識相關的所有事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含epcList，chidlEPCs，ParentID，inputEPCList字段，或者包含outputEPCList、parentID字段或者epcList，childEPCs，inputEPCList，outputEPCList字段中的某個EPC與本參22DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述MATCH_epcClassList<String>單個標識最大長度為255否本參數用于查詢指定的批次追溯標識相關的事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含quantityList，或者包含childQuantityList、quantityList或childQuantityList字段中的某個EPC與本參數指定的EPC模式或URI匹配，同時返回結果中還包含epcsClass字段與本參數QuantityEvent事件MATCH_inputEPCClassList<String>單個標識最大長度為255否本參數用于查詢批次追溯原材料物品標識相關的事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含inputQuantityList、inputQuantityList字段中的某個EPC與本參數指定的EPC模MATCH_outputEPCClassList<String>單個標識最大長度為255否本參數用于查詢批次追溯產品物品標識相關的事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含outputQuantityList、outputQuantityList字段中的某個EPC與MATCH_anyEPCClassList<String>單個標識最大長度為255否本參數用于查詢批次追溯標識相關的所有事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含quantityList，childQuantityList,inputQuantityList,或者outputQuantityList字段中的一個、上述字段中EPC類與的某個EPC與本參數指定的EPC模式或URI匹配，同時返回結果中還包含epcsClass字段與本參數指定的件23DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述EQ_fieldnameList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是String或者詞匯表類型、滿足a條件的字段值與本參數指定的參數之一匹配，Fieldname是一個擴展字段的完全限定名，該擴展字段是由XML命名空間URI和名稱組成的XMLqname，對應的查詢參數可以通過連接EQ_字符串、該擴展字段的命名空間URI，#號符和擴展字段的名稱來創(chuàng)建EQ_fieldnameFloat255否與上面描述的EQ_fieldname類似，但是用于float類型的字段，返回事件結果滿足以下條件：有fieldname字段、該字段的類型與本參數的類型匹配(Int，Float，或者Time)、該字段的值與本參數指定的ieldnameEQfieldnameGT_fieldnameFloat255否與上面描述的EQ_fieldname類似，但是用于float類型的字段，返回事件結果滿足以下條件：有fieldname字段、該字段的類型與本參數的類型匹配(Int，Float，或者Time)、該字段的值與本參數指定的ieldnameEQfieldnameEQ_ILMD_fieldnameList<String>單個標識最大長度為255否與EQ_fieldname類似，返回的事件結果符ILMD部分fieldname的值與本參數指定值匹配24DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述HASATTR_fieldnameList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是詞匯表類型、滿足a條件的字段值是主數據可以獲得的詞匯表元素、該主數據的屬性值不為空，并且屬性名稱與本參數指定的值相同，Fieldname是一個擴展字段的完全限定名，對于標準字段，它代表字段名稱，例如bizLocaion；對于擴展字段，該擴展字段是由XML命名空間URI和名稱組成的XMLqname。對應的查詢參數可以通過連接EQ_字符串、該擴展字段的命名空間URI，#號符和擴展字段的名稱來創(chuàng)建EQATTR_fieldname_attrnameList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含fieldname字段，并且該字段的類型是詞匯表類型、滿足a條件的字段值是主數據可以獲得的詞匯表元素、該主數據的有名為attrname的屬性、attrname的值與本參數指定的屬性值匹配，Fieldname被構造為HASATTR_fieldnameorderByString255否如果指定參數該參數，則會命名一個單獨字段將查詢結果排序，orderDirection字段指明是按照升序還是降序排序。如果不指定本字段，返回的事件結果在列表中的順序是不確定的，本參數的值必須是evenTime,recordTime或者Int,Float,Time,String擴展字段的完全限定名，完全限定名由EQ_fieldname參數構造，對于String類型的字段，應該按照該字符串的Unicode編碼的字典順序排序，或者適合當前環(huán)境的排序序列，如果省略該參數，同一個查詢的兩次執(zhí)行其返回事件結果的順序也可能不同25DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述orderDirectionString255否如果本字段和orderBy字段同時被指定，那么返回的查詢結果會依照orderBy中指明的關鍵字按升序或者降序排序，本參數ASC或者DESC(表示降序)如果省略，本參數的默認值為DESCeventCountLimt255否如果指定本參數，則僅會返回滿足其他查詢條件的前N個事件，N代表本參數的值，具體返回的結果由orderBy字段orderDirection中指定的參數決定，如果省略本參數，則會返回所有滿足查詢參數的事件結果，本參數和maxEventCount參數是互斥的，只有當指定了orderBy參數時，才能使用本參數，maxEventCount與本參數的區(qū)別是，前者當返回結果超出限制時會引發(fā)異常，但是后者則是限制了返回數據的數量maxEventCountt255否如果指定了本參數，返回的事件數最多為該參數指定的值本參數和maxEventCount參數是互斥的，如果省略，返回的事件數目不受限制26DB32/T3411—2018附錄C(規(guī)范性附錄)SimpleMasterDataQuery時params參數SimpleMasterDataQuery時params參數見表C.1。C1SimpleMasterDataQuery時params參數參數名稱類型最大長度Byte是否必填描述vocabularyNameList<String>單個標識最大長度為255否如果指定了本參數，只有詞匯元素屬于參數指定詞匯表的事件才會被返回，該字符串列表中每一個字符串都代表一個詞匯表的URI名稱，如果省略本參數，需要返回所有的詞匯表includeAttributesBoolean255是如果參數值為真，返回的結果中會包含屬性名稱和匹配的詞匯表元素值；如果為假則不包含includeChildrenBoolean255是如果參數值為真，返回的結果中會包含匹配詞匯表元素的子列表，如果為假則不包含attributeNamesList<String>單個標識最大長度為255否如果指定本參數，返回事件的屬性必須與本參數指定的屬性名之一匹配，如果省略，所有屬性與詞匯表元素匹配事件都會被返回(如果想要獲得不包含屬性的詞匯表元素名稱，將includeAtributes的屬性設置為false)如果includeAtributes的值為false，本參數的值會忽略EQ_nameList<String>單個標識最大長度為255否如果指定本參數，返回事件的詞匯表元素必須與指定值相同，如果本參數和WD_name同時被省略，會包含所有的詞匯表元素WD_nameList<String>單個標識最大長度為255否如果指定本參數，返回事件的詞匯表元素與本字段指定詞匯表元素相同，或是指定詞匯表元素的直接或者間接后繼，如果本參數和EQ_name同時被省略，會包含所有的詞匯表元素HASATTRList<String>單個標識最大長度為255否如果指定了本參數，返回事件的詞匯表元素屬性不為空，并且其名稱與該參數指定的值之一相同27DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述EQATTR_attrnameList<String>單個標識最否本參數不是單一參數，而是一組參數集，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：詞匯表元素由一個非空的屬性attrname，并且該屬性的值與本字段指定的值之一相同maxElementCountt255否如果指定了本參數，返回的事件中包含的詞匯表元素最多為該參數指定的數值，如果省略該參數，返回結果中可以包含任意數目的詞匯表元素28DB32/T3411—2018附錄D(規(guī)范性附錄)AuthenticatedEQuery時params參數AuthenticatedEQuery時params參數見表D.1。表D.1AuthenticatedEQuery時params參數說明參數名稱類型最大長度Byte是否必填描述userIDString255是用戶名passwordString255是密碼eventTypeList<String>單個標識最大長度為255否如果指定了該參數(事件類型)，返回的查詢結果只包含與指定事件類型匹配的事件，本參數的取值可以為：ObjectEvent,AggregationEvent,TransactionEvent,、TransformationEvent；如果省略，會返回所有事件GE_eventTimeTime255否如果指定了該參數，返回的結果只包含eventTime大于指定時間的事件；如果省略，返回的結果不考慮eventTimeLT_eventTimeTime255否如果指定了該參數，返回的結果只包含eventTime小于指定時間的事件，如果省略，返回的結果不考慮eventTime(除非添加了GE_eventTime約束)GE_recordTimeTime255否如果提供了該參數，返回的結果只包含recordTime大于或者等于指定時間的事件，如果省略，返回結果不考慮recordTimeLT_recordTimeTime255否如果指定了該參數，返回的結果只包含eventTime小于指定時間的事件，如果省略，返回的結果不考慮recordTimeEQ_actionList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含有action字段并且該字段的取值與指定的參數值之一匹配的事件，本參數的取值只能是：ADD,OBSERVE或者DELETE，如果省略，返回的事件不考慮action字段EQ_bizStepList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含bizStep字段非空且其取值與參數指定值之一匹配的事件如果省略該參數，返回的事件不考慮bizStep字段的值或者該字段是否存在29DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述EQ_dispositionList<String>單個標識最大長度為255否與EQ_bizStep參數類似，但是針對的是disposition字段EQ_readPointList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含readPoint非空并且readPoint字段的取值與參數指定值之一匹配的事件，如果本參數和WD_readPoint參數同時被省略，那么返回的結果事件不考慮readPoint字段的值或者該字段是否存在WD_readPointList<String>單個標識最大長度為255否如果指定了該參數，返回的結果只包含readPoint非空并且readPoint的取值與參數指定值之一相匹配或是其直接或者間接后繼的事件，如果本參數和EQ_readPoint參數同時被省略，那么返回的結果不考慮readPoint字段的取值或者該字段是否存在EQ_bizLocationList<String>單個標識最大長度為255否與EQ_readPoint字段類似，但是針對的是bizLocation字段WD_bizLocationList<String>單個標識最大長度為255否與WD_readPoint字段類似，但是針對的是bizLocation字段EQ_bizTransaction_typeList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集。如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含bizTransactionList、業(yè)務交易列表中某個條目的type子字段與從本參數提取出的type名稱相同、bizTransction子字段與本參數對應部分指定的值相同EQ_source_typeList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集。如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含sourceList、源列表中某個條目的type子字段與從本參數提取出的type名稱相同、source子字段與本參數對應部分指定的值相同30DB32/T3411—2018參數名稱類型最大長度Byte是否必填描述EQ_destination_typeList<String>單個標識最大長度為255否本參數不是單一參數，而是一組參數集，如果指定了該種形式的參數，那么返回的結果事件必須滿足以下條件：包含destinationList、目標列表中某個條目的type子字段與從本參數提取出的type名稱相同、destination子字段與本參數對應部分指定的值相同EQ_transformationIDList<String>單個標識最大長度為255否如果指定了本參數，那么返回的結果事件必須滿足以下條件：包含transformationID、transformationID與本參數指定的值之一相等MATCH_epcList<String>單個標識最大長度為255否本參數用于查詢指定物品標識的相關事件，如果指定了本參數，那么返回的結果事件必須滿足以下條件：epcListchildEPCs字段、參數指定的EPC模式或URI匹配、如果省略了本參數，那么返回的事件結果不考慮不管該兩個字段是否存在MATCH_parentIDList<String>單個標識最大長度為255否本參數用于查詢指定包裝物品標識的相關事件，與MATCH_epc字段類似，但是匹配rentIDAggregationEvent、TransactionEvent擴展類型的事件類型MATCH_inputEPCList<