DB4403/T 249-2022 进口冷链食品追溯数据接口规范

ICS35.240.01

CCSL78

DB4403

深圳市地方标准

DB4403/T249—2022

进口冷链食品追溯数据接口规范

Datainterfacespecificationofimportedcold-chainfoodtraceability

2022-07-29发布2022-08-01实施

深圳市市场监督管理局发布

DB4403/T249—2022

目次

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

1范围.................................................................................................................................................................1

2规范性引用文件............................................................................................................................................1

3术语和定义....................................................................................................................................................1

4缩略语.............................................................................................................................................................1

5基本要求........................................................................................................................................................2

6接口类型........................................................................................................................................................2

7接口关系........................................................................................................................................................2

8接口描述........................................................................................................................................................2

附录A（资料性）接口响应码说明.............................................................................................................11

附录B（资料性）追溯数据对接实例.........................................................................................................12

附录C（资料性）企业类型及编码说明.....................................................................................................13

附录D（资料性）资质证照类型及编码.....................................................................................................14

附录E（资料性）产品分类及编码.............................................................................................................15

参考文献.............................................................................................................................................................17

I

DB4403/T249—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由深圳市市场监督管理局提出并归口。

本文件起草单位：深圳市市场监督管理局、深圳市标准技术研究院。

本文件主要起草人：李颖、徐立峰、练晓、吕恺文、王恒、苏巍、陈瑜、周哲、陈炜霖、陈利平、

施伟、林智明。

II

DB4403/T249—2022

进口冷链食品追溯数据接口规范

1范围

本文件规定了进口冷链食品追溯系统数据接口的基本要求、接口类型、接口关系、接口描述。

本文件适用于企业、技术机构、监管部门在进口冷链食品追溯系统间的数据对接。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB12904商品条码零售商品编码与条码表示

GB32100法人和其他组织统一社会信用代码编码规则

DB4403/T191—2021食用农产品追溯码编码技术规范

IETFRFC2818TLS上的HTTP（HTTPoverTLS）

IETFRFC3548Base16，Base32，Base64数据编码（TheBase16，Base32，andBase64data

encodings）

IETFRFC3629UTF-8，ISO10646转换格式（UTF-8，atransformationformatofISO10646）

3术语和定义

下列术语和定义适用于本文件。

3.1

冷链食品cold-chainfood

通过冷链实现物流过程运输的果蔬类、水产类、肉制品类、禽蛋类、乳制品、粮食类等易腐食品及

其加工制品等食品。

注：包括冷冻食品和冷藏食品。

3.2

追溯系统traceabilitysystem

基于追溯码、文件记录、相关软硬件设备和通信网络，实现现代信息化管理并可获取产品追溯过程

中相关数据的集成。

[来源：GB/T38155—2019，2.6]

3.3

集中监管仓centralizedsupervisionwarehouse

具备进口冷链食品（3.1）相关疫情集中排查、集中管控、集中处置和产品外包装预防性消毒功能

的场所。

4缩略语

下列缩略语适用于本文件。

GS1：国际物品编码协会（GlobalStandards1）

HTTPS：以安全为目标的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

UTF-8：一种可变长度字符编码（8-bitUnicodeTransformationFormat）

1

DB4403/T249—2022

5基本要求

接口通过服务调用实现信息交换，应符合下列要求：

——采用IETFRFC2818规定的HTTPS协议作为底层承载协议；

——采用IETFRFC3629规定的UTF-8字符集；

——采用GB/T7408规定的日期类型；

——采用IETFRFC3548规定的Base64编码规则将图片文件转换为字符串；

——接口请求与接口响应均采用JSON数据格式；

——建立接口日志记录，能识别数据异常或追溯交换数据情况；

——发生错误时，通过接口将详细的错误信息返回至相关平台和节点系统，由相应平台和节点系

统对错误进行记录分析和整改。

6接口类型

进口冷链食品追溯系统数据接口主要包括下列类型：

——主体信息类，包括但不限于主体信息类参数；

——产品信息类，包括但不限于产品品类信息、产品批次信息、入境货物检验检疫证明信息、海

关进口货物报关单信息、消毒证明信息、核酸检测证明信息、集中监管仓出库证明信息；

——冷库信息类，包括但不限于冷库信息类参数；

——追溯信息类，包括但不限于集中监管仓信息、收发货信息、出入库信息、运输信息。

7接口关系

进口冷链食品追溯系统数据接口关系如图1所示。

图1数据接口关系

8接口描述

8.1接口请求

2

DB4403/T249—2022

接口请求参数说明见表1。

表1接口请求参数

头部参数含义类型说明

接口调用方唯一标识，每个调用方会分配一个appid和一个

appid调用编码字符型

appsecret

timestamp请求时间日期时间型时间戳

nonce随机字符串字符型随机串（不少于10位）

signature请求签名字符型接口调用授权密钥，SHA-256加密

8.2接口响应

接口响应参数说明见表2。

表2接口响应参数

参数名含义类型说明

Success响应结果字符型是否成功

Message响应信息字符型提示信息

Code响应编码数字型接口响应码，见附录A

Timestamp响应时间日期时间型时间戳

Result响应数据参数字符型接口以JSON格式返回参数值，见附录B

8.3业务接口说明

8.3.1主体信息类接口说明

主体信息类参数见表3。

表3主体信息类参数

字段名含义类型说明

通过统一社会信用代码获取企业注册

Ent_name企业名称字符型

名称

18位统一社会信用代码，按照GB

Unif_soci_cred_code统一社会信用代码字符型

32100确定的编码规则

Contact联系人字符型—

Contact_phone联系电话字符型—

Legal_person法人代表字符型—

Office_address地址字符型—

Addr_districts所属区划字符型具体到省、市、区、街道

Ent_type_code企业类型字符型企业类型及编码说明见附录C

将图片转为Base64编码格式存储，具

Ent_img资质证照字符型

体的资质证照类型见附录D

8.3.2产品信息类接口说明

3

DB4403/T249—2022

产品品类信息接口

产品品类信息参数见表4。

表4产品品类信息参数

字段名含义类型说明

商品条码采用GS1编码，应符合GB

12904中商品条码的编码规则；产品编

Product_library_id商品条码/产品编码字符型码为系统自动生成的产品品类编码，

编码规则应按照DB4403/T191—2021

中第6章规定的编码方案

Product_name产品名称字符型实物产品标签上的产品名称

追溯系统二级分类代码，产品分类及

Product_category产品类型字符型

编码见附录E

Country原产国字符型产品输出国家

Life_number保质期限数字型—

Life_unit保质期单位字符型保质期以年、月或日为单位

Specification规格数字型—

Specification_unit规格单位字符型单位为千克（kg）、克（g）

Registration_number生产企业注册号字符型产品原产国生产企业注册号

Manufacturer生产企业名称字符型产品原产国生产企业名称

Product_label产品标签图片字符型将图片转为Base64编码格式存储

Product_img产品图片字符型将图片转为Base64编码格式存储

产品批次信息接口

产品批次信息参数说明见表5，产品批次对应的入境货物检验检疫证明信息说明、海关进口货物报

关单信息说明、消毒证明信息说明、核酸检测证明信息说明、集中监管仓出库证明信息说明分别见表6、

表7、表8、表9、表10。

表5产品批次信息参数

字段名含义类型说明

商品条码采用GS1编码，应符合GB

12904中商品条码的编码规则；产品编

Product_library_id商品条码/产品编码字符型码为系统自动生成的产品品类编码，

编码规则应按照DB4403/T191—2021

中第6章规定的编码方案

Product_name产品名称字符型实物产品标签上的产品名称

Container_number货柜编号字符型装载该批货物的货柜编号

编码规则应按照DB4403/T191—2021

Trace_code批次追溯码字符型

中第6章规定的追溯码编码方案

Batch实际批次字符型实物产品标签上的生产批号

Number_of_pieces首次入库件数数字型—

Weight首次入库重量字符型单位为千克（kg）

Inventory_pieces库存件数数字型可发货件数

Production_date生产日期日期时间型格式为YYYY-MM-DD

4

DB4403/T249—2022

表5产品批次信息参数（续）

字段名含义类型说明

可发货件数重量总和，单位为千克

Inventory_weight库存重量字符型

（kg）

Storage_name存放冷库名称字符型—

表6入境货物检验检疫证明信息