深圳市地方标准 DB4403/T582—2025 肉品溯源数据接口规范 Specificationformeattraceabilitydatainterface 2025-01-15发布 2025-02-01实施 深圳市市场监督管理局   发布ICS35.240.60 CCSX07DB4403DB4403/T582—2025 I目次 前言..................................................................................II 1范围................................................................................1 2规范性引用文件......................................................................1 3术语和定义..........................................................................1 4缩略语..............................................................................1 5接口方法及调用说明..................................................................1 5.1接口传输要求及对接流程..........................................................1 5.2数据类型........................................................................2 5.3数据接口........................................................................3 附录A（资料性）数据接口应用示例......................................................8 A.1凭据Token接口的应用示例........................................................8 A.2同步肉品溯源数据接口的应用示例..................................................9 A.3查询动检证核验结果接口的应用示例...............................................11 A.4同步肉品溯源数据并核验动检证接口的应用示例.....................................12 附录B（资料性）动物代码表...........................................................15 附录C（资料性）产品代码表...........................................................17 附录D（资料性）产品类型代码表.......................................................18 参考文献..............................................................................19DB4403/T582—2025 II前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》 的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由深圳市市场监督管理局提出并归口。 本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、供广深圳肉类智能交易市 场有限公司。 本文件主要起草人：李广斌、陈利平、陈伟峰、周哲、刘浩、郭静文、苏晓润、李思璁、郑文 科、靳恒宇、李佩霖、陈瑜、吴岳、练晓、孙勇。DB4403/T582—2025 1肉品溯源数据接口规范 1范围 本文件规定了调用肉品（批发）溯源系统的数据接口进行数据交换的接口方法和调用说明。 本文件适用于调用肉品（批发）溯源系统的数据接口的集成开发。 2规范性引用文件 本文件没有规范性引用文件。 3术语和定义 下列术语和定义适用于本文件。 3.1 数据接口datainterface 以电子文件的形式实现，计算机软件系统之间传送数据、交换信息的接口。 [来源：GB/T42940—2023,3.3] 3.2 数据对接方datadockingparty 数据接口调用者，与肉品（批发）溯源系统进行数据交换的单位。 4缩略语 下列缩略语适用于本文件。 API：应用程序编程接口（ApplicationProgrammingInterface） HTTP：超文本传输协议（HyperTextTransferProtocol） JSON：对象简谱（JavascriptObjectNotation） 5接口方法及调用说明 5.1接口传输要求及对接流程 5.1.1接口使用JSON传输数据，技术接口对接示意如图1所示。肉品数据对接方系统获取访问令牌， 访问验证通过后，根据预先定义好的接口方法，进行肉品溯源数据交换，数据接口应用示例见附录A。 注：肉品溯源数据主要包含分销台账数据、动物检疫合格证明（以下简称“动检证”）数据等。 5.1.2数据交换分为三种方式： a)数据对接方系统输入参数，同步肉品溯源数据后，肉品（批发）溯源系统（以下简称“溯源 系统”）自动实时返回溯源数据同步结果； b)数据对接方系统主动进行动检证核验结果查询；DB4403/T582—2025 2c)数据对接方系统输入参数，同步肉品溯源数据后，溯源系统自动实时返回溯源数据同步结果 和动检证核验结果。 注：Token指邀请、登录系统的临时令牌。 图1技术接口对接示意图 5.2数据类型 数据接口应支持的数据类型包括: a)字符型； b)整数型； c)浮点型； d)布尔型； e)日期型； f)对象型。DB4403/T582—2025 35.3数据接口 5.3.1凭据Token调用接口 5.3.1.1接口说明 接口说明如下： a)接口名称：接口访问授权调用接口； b)接口描述：用于获取业务接口的访问调用凭据； c)HTTP请求方式：GET； d)接口标识符：GetToken。 5.3.1.2接口输入参数及说明 凭据Token调用接口的输入参数及说明见表1。 表1凭据Token调用接口的输入参数及说明 输入参数 数据类型是否非空 说明 ParamsappId 字符型 是 应用码 appSecret字符型 是 应用授权码 5.3.1.3接口返回参数及说明 凭据Token调用接口的返回参数及说明见表2。 表2凭据Token调用接口的返回参数及说明 返回参数 数据类型是否非空 说明 datasuccess 布尔型 是 调用结果，若为“true”，表示成功；若为“false”，表示 失败 message 字符型 是 提示信息 code 整数型 是 成功则返回代码“0”；失败则返回错误码“500” result 字符型 是 授权访问令牌Token timestamp整数型 是 时间戳 5.3.2同步肉品溯源数据的调用接口 5.3.2.1接口说明 接口说明如下： a)接口名称：同步肉品溯源数据的调用接口； b)接口描述：用于同步数据对接方系统的肉品溯源数据； c)HTTP请求方式：POST； d）接口标识符：ImportData。 5.3.2.2接口输入参数及说明 同步肉品溯源数据调用接口的输入参数及说明见表3。DB4403/T582—2025 4表3同步肉品溯源数据调用接口的输入参数及说明 输入参数 数据类型是否非空 说明 Headers 对象型 是 X-Access-Token：授权访问令牌Token BodysalesDocumentNo 字符型 是 分销凭证编号 productBarcode 字符型 否 产品编码 productName 字符型 是 产品名称 productCategoryCode字符型 是 产品分类编码，由“动物代码+产品代码+产品类型代码”组 成，例如商品猪胴体中温肉分类编码为1010610110102，动物 代码、产品代码、产品类型代码分别见附录B、附录C及附录 D productImg 字符型 否 产品图片的网址，多个网址以“，”分隔 batchCode 字符型 是 批次编码，批次唯一标识，可用“检疫合格证编号+轨道号+分 割流水号”表示 batch 字符型 否 批次 batchWeight 浮点型 是 批次总重量 batchUnit 字符型 否 批次单位（KG，G，默认KG） batchInNo 字符型 否 批次进货单号 batchInWeight 浮点型 是 批次进货重量 batchInPrice 浮点型 是 批次进货单价，单价的单位为“元/KG”或“元/G” batchInDate 日期型 是 批次进货日期，按“年-月-日”的格式输入。示例：2024-01- 01 batchOutPrice 浮点型 是 批次销售单价，单位重量的人民币价格，单位为“元 /(KG,G)” batchOutDate