DB32T 3411-2018食品安全电子追溯信息查询服务数据接口规范

ICS67.040X00备案号：江苏省地DB32方标准DBT3411—2018Interfacespecificationsofinformationqueryserviceforfoodsafetyelectronicraceability江苏省质量技术监督局发布IDB32/T3411—2018 DB32/T3411—2018 H 40 IDB32/T3411—2018前言本标准按照GB/T1.1—2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位：江苏省质量和标准化研究院、复旦大学无锡研究院、中科院计算机网络中心、无锡捷玛科技物联有限公司。本标准主要起草人：胡冶、崔兆明、王俊宇、刘毅、曹云、杨博、刘佳、周广军、王瑜、钱侃、王开疆、吴双力、田野。1DB32/T3411—2018食品安全电子追溯信息查询服务数据接口规范1范围本标准规定了食品安全电子追溯信息查询服务的功能要求、数据接口。本标准适用于食品安全电子追溯信查查询服务的接口实现。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T17295国际贸易计量单位代码DB32/TXXXX-2018食品安全电子追溯标识解析服务数据接口规范RFC2616超文本传输协议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终端用户所使用的具备追溯查询能力的软件系统的统称。3.7CU网元captureunitnetworkelement负责采集数据、上传的网元。3.8SP网元supervisorplatformnetworkelement负责接收IQS网元上报的追溯数据，并利用追溯数据进行监管行为的网元。3.9追溯代理traceabilityproxy以用户发起的HTTP追溯查询请求为触发，代替追溯用户调用IRS,DCS和IQS网元的多个接口完成追溯查询逻辑功能的网元。4缩略语下列缩略语适用于本文件。CU：捕获单元(CaptureUnit)DNS：域名服务(DomainNameService)DCS：数据目录服务(DataCatalogService)EU：终端用户(EndUser)IQS：信息查询服务(InformationQueryService)IRS：标识解析服务(IdentificationResolutionService)JSON：JS对象标记(JavaScriptObjectNotation)RFID：射频识别(RadioFrequencyIdentification)SP：监管平台(SupervisorPlatform)URL：统一资源定位符(UniformResourceLocator)URN：统一资源名称(UniformResourceName)XML：可扩展标记语言(ExtensibleMarkupLanguage)5信息查询服务功能要求5.1系统架构3DB32/T3411—2018食品安全电子追溯系统应由企业平台、监管平台和查询平台组成，食品安全电子追溯系统的系统架构见DB32/TXXXX。信息查询服务由IQS网元实现，IQS网元架构图见图1。图1IQS网元构架5.2信息查询服务基本功能信息查询服务应提供但不限于以下功能：a)传输服务——通过数据传输接口接收企业平台(CU网元)传输的追溯数据；b)查询服务——通过查询接口与查询平台交互实现追溯数据的查询。6信息查询服务接口要求6.1基本要求食品安全电子追溯系统的各个网元之间应通过Internet公共以太网接口互联互通。IQS网元与其他网元的物理接口上承载的协议栈应为HTTP或HTTPS协议栈，数据接口应使用基于HTTP/HTTPS协议的JSON格式的消息体传输数据。IQS接口分为：a)数据传输接口；b)查询接口。6.1.1IQS传输接口食品生产经营企业信息管理系统通过该接口和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请求的规定，使用Get或者POST方法调用接口，并将请求参数按照消息格式用JSON封装后，包含在HTTP的Request消息的Body中发送给对方。6.4.2响应接口调用成功后，应由IQS网元进行处理，处理方式应符合RFC4825对XML的规定或RFC4627对JSON格式的规定，处理结束后应将处理结果放置在HTTP的Response消息的Body中，返回给调用者。HTTP的Response消息应符合RFC2616中的规定。7主数据传输接口7.1接口基本功能提供食品生产经营企业提供向IQS提交静态数据的功能。注：静态数据包括食品生产企业的企业基本信息、原料基本信息、供货厂商基本信息、生产流程基本信息、产成品基本信息、销售商基本信息、原料及产生品检验信息等。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接口调用静态数据不随生产活动而变化，静态数据因企业其他活动发生改变时调用该接口。接口调用方向：由CU网元向IQS网元提出请求。注：调用示例可参见附录F。8事件传输接口8.1接口基本功能提供食品生产经营企业提供向IQS提交动态数据的功能。注：动态数据包括与企业生产化活动相关的数据，如原辅料及产成品进销存数量、生产投料等数据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接口基本功能提供食品生产经营企业向IQS上传资源文件的的功能，资源文件应包含图片、视频、文档文件等。9.2接口定义接口名称：resUpload。资源文件传输接口请求参数及响应参数见表10、表11。表10资源文件传输接口请求参数参数名称类型最大长度Byte是否必填描述filePathfile255是待上传文件表11资源文件传输接口响应参数参数名称类型最大长度Byte是否必填描述statusString255是返回值，用于表示状态：success上传成功，false上传失败fileURLString255否返回值为success时，本字段存放可用于访问的文件URL；否则为空9.3接口调用接口调用方向：由CU网元向IQS网元提出请求。注：调用示例可参见附录H。8DB32/T3411—201810查询接口10.1接口基本功能提供从IQS查询符合条件的静态数据和动态数据的功能。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(规范性附录)EPCISEvent定义A.1ObjectEvent子类数据结构EPCISEvent是一个对于所有IQS事件的基础类型，ObjectEvent是其一个子类，用于记录对象事件数据，结构见表A.1。表A.1ObjectEvent子类数据结构字段名称字段类型最大长度Byte是否必填描述eventTimeTime255是事件发生时间recordTimeTime255否这个事件被IQS记录的日期时间，在事件提交到IQS传输接口时必须忽略，由IQS自动记录；在查询时可以获得eventTimeZoneOffsetString255是时间发生地点时区与UTC时区的差值，这个字段的值应是字符串，以‘+’或者‘-’14)的数字，接着是一个冒号，后面是两若前两位是14，后两位必须是00epcListList<EPC>单个标识最大255否单件追溯标识数组，EPC定义见A.5.1，epcList与quantityList两者至少存在1项quantityListList<QuantityElement>单个标识最大255否批次追溯标识数组，QuantityElement定义见A.5.2，epcList与quantityList两者actionAction255是事件导致的物品状态变化，ADD：增加;DELETE：移除；OBSERVE：不变bizStepBusinessStepID255否业务步骤，值见A.5.7dispositionDispositionID255否物品状态，值见A.5.8readPointReadPointID255否事件发生时刻的业务位置标识bizLocationBusinessLocationID255否事件发生后，物品所在业务位置标识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是事件发生时间recordTimeTime255这个事件被IQS记录的日期时间，在事件提S记录；在查询时可以获得eventTimeZoneOffsetString255是时间发生地点时区与UTC时区的差值，这个字段的值应是字符串，以‘+’或者‘-’开头，后两位是在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：带容器进行业务事件bizStepBusinessStepID255否业务步骤，值见A.5.7dispositionDispositionID255否物品状态，值见A.5.8readPointReadPointID255否事件发生时刻的业务位置标识DB32/T3411—2018字段名称字段类型最大长度Byte是否必填描述bizLocationBusinessLocationID255否事件发生后，物品所在业务位置标识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是其一个子类，用于记录带有事务过程的业务事件信息，具体内容见表A.3。表A.3TransactionEvent子类数据结构定义字段名称字段类型最大长度Byte是否必填描述eventTimeTime255是事件发生时间recordTimeTime255这个事件被IQS记录的日期时间，在事件提S记录，在查询时可以获得eventTimeZoneOffsetString255是时间发生地点时区与UTC时区的差值，这个字段的值应是字符串，以‘+’或者‘-’开头，后两位是在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：事务发生时/新增对象时；DELETE事务结束时/对象移除时；OBSERVE：事务进行中bizStepBusinessStepID255否业务步骤，值见A.5.7DispositionDispositionID255否物品状态，值见A.5.8readPointReadPointID255否事件发生时刻的业务位置标识bizLocationBusinessLocationID255否事件发生后，对象所在业务位置标识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是事件发生时间recordTimeTime255否这个事件被IQS记录的日期时间。在事件提S记录；在查询时可以获得eventTimeZoneOffsetString255是时间发生地点时区与UTC时区的差值。这个字段的值应是字符串，以‘+’或者‘-’开头，后两位是在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否业务步骤，值见A.5.7dispositionDispositionID255否物品状态，值见A.5.8readPointReadPointID255否事件发生时刻的业务位置标识bizLocationBusinessLocationID255否事件发生后，对象所在业务位置标识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提货单发票rma退货授权pedigree履历desadv发货通知单DB32/T3411—2018A。7(续)BizTransTypeID值说明recadv收货通知单prodorder生产通知单A.5.4Source/Destination数据结构定义Source/Destination用于记录开始/结束的业务位置、所有者、管理方信息，定义见表A.8、A.9所示。表A.8Source/Destination数据结构定义字段名称字段类型最大长度Byte是否必填格式说明TypeSourceDestTypeID255是字段类型说明，见表A.9Source/destinationString255是业务位置标识，使用资源标识符表示表A.9SourceDestTypeID数据结构定义SourceDestTypeID值说明owning_party表示所有者possessing_party表示管理方location表示业务位置A.5.5EvtElementList数据结构定义EvtElementList用于记录事件中的详细信息，定义见表A.10、A.11所示。表A.10EvtElementList数据结构定义字段名称字段类型最大长度Byte是否必填描述extNameString255是扩展名称extContentString255是扩展内容extIDString255是扩展信息内容区分，见表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用于表示一项具体的业务过程。BusinessStepID应使用URN形式表示，表A.13中的BusinessStepID在使用时的格式为：urn:epcglobal:cbv:bizstep:BusinessStepID。表A.13BusinessStepID值定义BusinessStepID中文名称中文说明accepting收货表示物品在业务过程中改变了持有方和/或所有者assembling组装表示多个物品被组合成一个物品，通常用于聚合事件,它与变换事件不同，输入的物品依旧存在，这个过程可逆commissioning赋码将标识赋予物理物品的阶段creating_class_instance生产单个或批次物品的生产阶段decommissioning取消赋码标识与物品之间的关系取消，以便将来可以重新赋码arriving送达表示物品在业务过程中到达某一个业务位置collecting集货表示在业务过程中，物品经过拣货后放到一起，准备进入下一个处理consigning托运该阶段与staging_outbound,loading,departing,andaccepting互斥，发生时物品持有方和/或所有者会发生改变cycle_counting盘点通过清点物品数量获得一个准确的库存，可用于业务需要以外的其他会计用途departing起运/出发表示在业务处理过程中物品离开当前位置去目的地destroying销毁销毁一个物品，物品之后不会有事件发生DB32/T3411—2018BusinessStepID中文名称中文说明encoding编码将单件/批次标识写入载体的过程holding扣留在业务过程中，物品被隔离以便进一步检查installing安装表示在业务过程中一个物品被放入一个复合物品中loading装货表示在业务过程中，物品被装载到运输工具中disassembling拆解将一个物品分解成多个单独的组成部分entering_exiting进入物品跟随消费者进入或离开特定的场所inspecting检验/审查检验物品存在的问题killing终结终止一个RFID标识，物品将由其他标识来标识other其他无法使用核心业务词汇表中的词汇描述的阶段packing物流包表示在业务过程中，将物品放入更大的容器用于运输receiving收货表示在业务过程中，在某个位置接收物品，并放到仓库repackaging重新包装表示在业务过程中，物品重新进行包装replacing替换表示在业务过程中，一个物品被另一个物品替换retail_selling零售表示物品通过货币等交换的方式改变所有者为消费者的过程picking拣货根据订单选取物品removing拆卸表示在业务过程中一个物品从一个复合物品中取出的事件repairing修理表示在业务过程中有故障的物品被修复的事件reserving保留表示一组未被赋码的追溯标识提供给第三方使用shipping运输可以替代staging_outbound,loadingandstaging_outbound放到发货区表示在业务过程中，将一个物品移动到运输发货区stocking上架/出货表示在业务过程中，使物品可以被销售或放到拣货区域transporting运输物品通过运输工具从一个位置移动到另外一个位置unpacking拆包拆开封装物品的箱子或包装，取出物品stock_taking库存盘点库存盘点storing仓储将物品放到储存物品的地方unloading卸货将物品从运输工具中卸载下来A.5.8DispositionID值定义DispositionID用于表示追溯物品在事件发生后的状态。DispositionID应使用URN形式表示，表A.14中的DispositionID在使用时的格式为：urn:epcglobal:cbv:disp:DispositionID。表A.14ISO/IEC19988定义的DispositionID值定义物品状态ID中文名称中文说明active激活被贴标的物品进入供应链适用业务步骤：commissioningDB32/T3411—2018物品状态ID中文名称中文说明destroyed摧毁物品已不可用适用业务步骤：destroyinginactive注销标签注销适用业务步骤：decommissioningin_transit运输中物品运输中适用业务步骤：shipping、departingdamaged损坏物品损坏了，无法使用适用业务步骤：accepting、inspecting、receiving、removing、repairing、replacingcontainer_closed封箱物品被装运在封闭的容器内适用业务步骤：staging_outbound物品状态ID中文名称中文说明encoded编码标识已写入RFID适用业务步骤：encodingin_progressi进行中供应链中物品的默认状态适用业务步骤：receiving、picking、loading、accepting、staging_outbound、arrivingexpired已经过期物品已过保质期适用业务步骤：holding、staging_outbound、storingdisposed销毁物品已经被销毁no_pedigree_match履历异常没有找到符合的履历，进行进一步调查适用业务步骤：holding、staging_outbound、storingrecalled召回因为公共安全的原因召回中适用业务步骤：holding、staging_outbound、storingreturned送回因各种原因物品退货中适用业务步骤：Receiving、holding、shippingsellable_not_accessible可准备销售物品可以销售，但消费者还不能进行购买适用业务步骤：receiving、storing、loading、holding、inspectingstolen被盗物品已经被偷盗non_sellable_other无法销售物品不允许销售适用业务步骤：holding、inspecting、staging_outbound、storingreserved已分配单件标识被分配给第三方适用业务步骤：reservingsellable_accessible上架销售物品可被销售，且消费者可以购买适用业务步骤：stocking、receivingretail_sold已被购买物品已被消费者购买适用业务步骤：retail_sellingunknown物品状态未知物品状态未知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、业务交易列表中某个条目的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，#号符和扩展字段的名称来创建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，#号符和扩展字段的名称来创建EQATTR_fieldname_attrnameList<String>单个标识最大长度为255否本参数不是单一参数，而是一组参数集，如果指定了该种形式的参数，那么返回的结果事件必须满足以下条件：包含fieldname字段，并且该字段的类型是词汇表类型、满足a条件的字段值是主数据可以获得的词汇表元素、该主数据的有名为attrname的属性、attrname的值与本参数指定的属性值匹配，Fieldname被构造为HASATTR_fieldnameorderByString255否如果指定参数该参数，则会命名一个单独字段将查询结果排序，orderDirection字段指明是按照升序还是降序排序。如果不指定本字段，返回的事件结果在列表中的顺序是不确定的，本参数的值必须是evenTime,recordTime或者Int,Float,Time,String扩展字段的完全限定名，完全限定名由EQ_fieldname参数构造，对于String类型的字段，应该按照该字符串的Unicode编码的字典顺序排序，或者适合当前环境的排序序列，如果省略该参数，同一个查询的两次执行其返回事件结果的顺序也可能不同25DB32/T3411—2018参数名称类型最大长度Byte是否必填描述orderDirectionString255否如果本字段和orderBy字段同时被指定，那么返回的查询结果会依照orderBy中指明的关键字按升序或者降序排序，本参数ASC或者DESC(表示降序)如果省略，本参数的默认值为DESCeventCountLimt255否如果指定本参数，则仅会返回满足其他查询条件的前N个事件，N代表本参数的值，具体返回的结果由orderBy字段orderDirection中指定的参数决定，如果省略本参数，则会返回所有满足查询参数的事件结果，本参数和maxEventCount参数是互斥的，只有当指定了orderBy参数时，才能使用本参数，maxEventCount与本参数的区别是，前者当返回结果超出限制时会引发异常，但是后者则是限制了返回数据的数量maxEventCountt255否如果指定了本参数，返回的事件数最多为该参数指定的值本参数和maxEventCount参数是互斥的，如果省略，返回的事件数目不受限制26DB32/T3411—2018附录C(规范性附录)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(规范性附录)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、业务交易列表中某个条目的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<