DB53∕T 1136.3-2022 食品安全信息追溯基础技术规范 第3部分：数据接口

ICS35.240.99

CCSL78

53

云南省地方标准

DB53/T1136.3—2022

食品安全信息追溯基础技术规范

第3部分：数据接口

2022-10-26发布2023-01-26实施

云南省市场监督管理局  发布

DB53/T1136.3—2022

前言

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

起草。

本文件是DB53/T1136《食品安全信息追溯基础技术规范》的第3部分。DB53/T1136一共发布以下3

个部分：

——第1部分：编码方法；

——第2部分：数据元；

——第3部分：数据接口。

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

本文件由云南省市场监督管理局提出并归口。

本文件起草单位：云南省市场监督管理局信息中心、云南省市场监督管理局、云南省标准化研究院、

中国移动通信集团云南有限公司、云南省盐业有限公司、云南鼎耀信息技术有限公司、昆明雪兰牛奶有

限责任公司、云南绿A生物工程有限公司。

本文件主要起草人：杨东霞、张娴、陈红丽、杨亚琦、杨增鸿、谢波、朱勋程、赵忆宁、李宁、黄

典一、杨俊、韩骥、赵欣、易正禹、邹汉铮、桑月军、宋治金、李文媛、陈福波、朱宁、林男、杨志、

金荣、段玉娟、荀春、余凡、左仕陆、杨康定。

I

DB53/T1136.3—2022

引言

食品安全始终是关系国计民生的大事。追溯体系的建立作为保障食品安全的重要管理手段一直是社

会关注的重点工作。从国内外追溯体系建设和实施的成效可以看出，建立追溯体系是一种能够预防和改

善食品安全问题的有效途径。在信息化技术应用于追溯体系建设过程中，追溯编码、数据元和数据接口

是重要的基础性工作。科学制定标准规范有利于实现追溯数据互联互通和追溯体系的推广应用。《食品

安全信息追溯基础技术规范》拟由三个部分构成：

——第1部分：编码方法。目的在于给出食品安全追溯体系中追溯码编码方法和表示要求；

——第2部分：数据元。目的在于给出食品安全追溯体系中基础数据元及其描述规则；

——第3部分：数据接口。目的在于给出食品安全追溯体系中生产企业数据上传信息的接口要求。

II

DB53/T1136.3—2022

食品安全信息追溯基础技术规范第3部分：数据接口

1范围

本文件规定了食品安全信息追溯的数据接口技术要求、数据接口参数和接口安全。

本文件适用于食品安全信息追溯的数据交换、传输和认证。

2规范性引用文件

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

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

文件。

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

GB/T7635.1全国主要产品分类与代码第1部分：可运输产品

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

GB/T38155重要产品追溯追溯术语

RFC1945超文本传输协议1.0(Hypertexttransferprotocol--HTTP/1.0)

RFC2616超文本传输协议1.1(Hypertexttransferprotocol--HTTP/1.1)

RFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptObjectnotation)

RFC4825可扩展标记语言配置接入协议(Theextensiblemarkuplanguage(XML)configuration

accessprotocol(XCAP))

3术语和定义

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

数据接口datainterface

一组用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。

接口协议interfaceprotocol

需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体

内容等，确定通信程序发送消息和接收消息的规则。

消息头MessageHeader

消息头包含了关于消息本身的元数据（例如，发送者和目标详细信息、消息属性、消息类型），不

同传输的头包含不同类型的信息。

安全认证securitycertificate

保证数据传输安全的加密方法和身份认证方法。

“名称/值”对name/valuepair

1

DB53/T1136.3—2022

JSON的数据存储格式，“名称/值”对组合中的名称写在前面双引号中，值写在后面双引号中，中

间用冒号隔开，“名称/值”对之间由逗号分隔。

追溯码traceabilitycode

追溯系统中对追溯单元进行唯一标识的代码。

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

4缩略语

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

HTTPS：安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：一种轻量级的数据交换格式(JavaScriptObjectNotation)

MD5：消息摘要算法第五版（Message-DigestAlgorithm5）

RESTFul：基于HTTPS协议，可以使用XML格式定义或JSON格式定义

Token：是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌”

URL：互联网服务程序上用于指定信息位置的表示方法（UniformResourceLocator）

UTF-8：一种可变长度字符编码(8-bitUnicodeTransformationFormat)

XML：可扩展标记语言（ExtensibleMarkupLanguage）

5技术要求

基本要求

5.1.1接口要求

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

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

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

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

5.1.2容错要求

发生错误时，接口服务方将详细的错误信息返回至接口调用方，由接口调用方对错误进行记录分析

和整改。

接口协议

接口协议方式包括：

——采用基于HTTPS传输协议的RESTFul接口方式；

——采用JSON格式报文打包方式。

消息头基本参数

5.3.1安全认证接口Header参数

安全认证接口Header参数见表1。

2

DB53/T1136.3—2022

表1安全认证接口Header参数表

参数名称参数描述

Authorization接口授权

（其余字段）采用默认值

5.3.2业务交互接口Header参数

业务交互接口Header参数见表2。

表2业务交互接口Header参数表

参数名称参数描述

Authorization接口授权

授权token，格式为：bearer+token例如：

bearer

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJpc3N1c2VyIiwiYXVkIjoiYXVkaWVuY2UiL

CJ0ZW5hbnRfaWQiOiIwMDAwMDAiLCJ1c2VyX25hbWUiOiLkupHljZfkupHpgJ_kv6Hmga_mioDmnK_mnIn

pmZDlhazlj7giLCJ0b2tlbl90eXBlIjoiYWNjZXNzX3Rva2VuIiwicm9sZV9uYW1lIjoiZW50ZXJwcmlzZ

Trace-AuthSIsInVzZXJfdHlwZSI6Im1hc3RlciIsInVzZXJfaWQiOiI5OTY0NTgzMDUxMTgxMjE4MyIsInJvbGVfaWQ

iOiIxNDAyNDM3NTkyMDc4NzQ5Njk3Iiwibmlja19uYW1lIjoi5LqR5Y2X5LqR6YCf5L-h5oGv5oqA5pyv5

pyJ6ZmQ5YWs5Y-4IiwiZGV0YWlsIjp7InR5cGUiOiJ3ZWIifSwiZW50ZXJwcmlzZV9jb2RlIjoiOTE1MzA

xMDJNQTZLNEtBNTdRIiwiZGVwdF9pZCI6IjIzNyIsImFjY291bnQiOiI5MTUzMDEwMk1BNks0S0E1N1EiL

CJjbGllbnRfaWQiOiJzYWJlciIsImV4cCI6MTY1NTM3MDM4MCwibmJmIjoxNjU1MzY2NzgwfQ.M8o2wrI6

eKb9JovCDKLGhZVAB4k4tmwA-GmUGEGzZ71zCStoL62e0vmRlzppuniuOcvQa8cbqHyz1E_uk-MyEQ

（其余字段）采用默认值

基本数据类型

基本数据类型说明见表3。

表3数据类型说明表

类型名称类型说明

String字符串

Integer整型

File文件类型

Datetime日期格式：yyyymmdd,依据GB/T7408

Array数组类型

Boolean布尔类型。真值：true；假值：false

ObjectJSON对象类型

6数据接口

数据接口分类

3

DB53/T1136.3—2022

数据接口分类见图1所示。

图1数据接口分类

基本信息接口

6.2.1安全认证接口

获取用户登录token信息，进行用户安全认证，相关参数见表4。

表4安全认证接口数据

参数名称数据类型长度（Byte）是否必填描述

userNameString32是用户名，企业统一社会信用代码

passWordString45是登录密码，密码使用MD5加密

tenanIIdString12是租用号

grantTypeString45是授权类型，固定填写：password

scopeString255是权限，默认填写：all

6.2.2商品类别查询接口

查询追溯商品类别，参数见表5。

表5商品类别查询接口数据

参数名称数据类型长度（Byte）是否必填描述

goodsCatalogIdInteger64是商品类别号

goodsCatalogNameString32是商品类别

查询追溯商品类别，返回值见表6。

4

DB53/T1136.3—2022

表6商品类别查询返回值

参数名称数据类型长度（Byte）描述

goodsCataloCodeString32商品类别代码

goodsCatalogNameString32商品类别

parentIdInteger64上级类别号

6.2.3图片文件上传接口

上传食品追溯相关数据时所需提供的图片文件，参数见表7。

表7图片文件上传接口数据

参数名称数据类型长度（Byte）是否必填描述

图片文件。

fileFile5242880是格式要求：png、jpg、jpeg

大小限制：不超过5MByte

文件名（注：已经封装过，在

nameString32是其它接口中使用该值作为图

片文件地址）

图片文件上传接口，返回值见表8。

表8返回值

参数名称数据类型长度（Byte）描述

codeInteger(int32)32状态码，见附录表A.1

dataObject4096承载数据

msgString64提示信息

successBoolean8返回结果类型

6.2.4新增食品生产经营市场主体信息备案

上传新增食品生产企业、食品经营企业的基本备案信息，如：企业统一社会信用代码、企业名称等，

参数见表9。

表9新增食品市场主体信息备案

字段名称类型长度（Byte）是否必填描述

enterpriseCodeString64是企业信用代码

nameString100是企业名称

enterpriseLegalPersonString12是法定代表人

phoneString12是联系电话

addressString100是地址

provinceTypeString10是省份类型：A云南省，B外省

createByEntCodeString32是生产企业统一社会信用代码

createByEntNameString100是备案企业名称

5

DB53/T1136.3—2022

表9新增食品市场主体信息备案（续）

字段名称类型长度（Byte）是否必填描述

经营类型：1生产企业，2流通企

businessTypeString10是

业，3餐饮企业

businessLicensePicString255是营业执照图片URL地址

xkzImageString255是许可证图片图片URL地址

新增食品市场主体信息备案，返回值见表8所示。

6.2.5新增原辅料信息备案

上传新增追溯食品的原辅料基本备案信息，如：类别、名称、来源等，参数见表10。

表10新增原辅料备案数据

字段名称类型长度（Byte）是否必填描述

原料辅类别号：01原料，02食品添加剂，

materiaCatalogIdString32是

03食品相关产品

原辅料条码，食品相关产品没有条码，

materiaBarCodeString64是

有条码的原辅料填写条码值。

materiaNameString45是原辅料名称

expireString20是保质期，食品相关产品没有

spUnipString4是质保单位，食品相关产品没有

specString20是规格，食品相关产品没有

unitString20是规格单位

producePlaceString60是产地

produceEntCodeString32是生产企业统一社会信用代码

createByEntCodeString32是生产企业统一社会信用代码

originString2是来源类型：1进口原辅料，2国产原辅料

packageTypeString10是包装类型：1散装，2预包装

新增原辅料信息备案，返回值见表8所示。

6.2.6新增生产食品信息备案

上传新增生产食品备案基本信息，包括食品类别、食品名称等，参数见表11。

表11新增生产食品信息备案数据

字段名称类型长度（Byte）是否必填描述

食品添加剂标识号集合，

additiveIdsArray256是

标识号值由原辅料备案接口返回

barCodeString64是条码

createByEntCodeString32是生产企业统一社会信用代码

goodsCatalogIdString32是商品类别号

表11新增生产食品信息备案数据（续）

6

DB53/T1136.3—2022

字段名称类型长度（Byte）是否必填描述

goodsImgString255否外包装图片URL地址

guaranteeUnitString10是保质期单位，D天M月Y年

食品原辅料标识号集合。

materiaIdsArray256是

标识号值由原辅料备案接口返回

nameString100是商品名称

originCountryString20是原产国

originGoodsString4是食品来源类型：1进口食品，2国产食品

originPlaceString30是国内产地

packageTypeString10是包装类型：1预包装2散装

qualityGuaranteePeriodInteger(int32)20是保质期

食品相关产品标识号集合，

relatedIdsArray256是

标识号值由原辅料备案接口返回

resourceTypeString10是来源类型：1生产，2采购

shopLinkString255否商城链接

spUnipString4是规格单位

specString20是规格

新增生产食品信息备案，返回值见表8所示。

6.2.7新增采购食品信息备案

上传新增采购食品备案基本信息，包括食品类别、食品名称等，参数见表12。

表12新增采购食品信息备案数据

字段名称类型长度（Byte）是否必填描述

goodsCatalogIdString32是商品类别号

nameString100是食品名称

barCodeString64是食品条码

specString20是规格

produceEntCodeString32是生产企业统一社会信用代码

produceEntNameString100是生产企业名称

spUnipString4是规格单位

qualityGuaranteePeriodInteger20是保质期

guaranteeUnitString10是保质期单位，Y年,M月，D天

packageTypeString10是包装类型：1预包装，2散装

resourceTypeString10是来源类型：1生产，2采购

originPlaceString30是产地

originGoodsString4是食品来源类型：1国产，2进口

新增采购食品信息备案，返回值见表8所示。

6.2.8新增仓库备案

7

DB53/T1136.3—2022

上传新增仓库备案基本信息，参数见表13。

表13新增仓库备案数据

字段名称类型长度（Byte）是否必填描述

warehouseNameString60是仓库名称

warehouseAddrString100是仓库地址

warehouseTypeString10是仓储型：1常温，2冷藏，3冷冻

仓库权属类型：1自建(私有)，2租

belongTypeInteger10是

用(公共)

contactPersonString20是联系人

contactPhoneString15是联系电话

isDefaultString10是是否是默认仓库：0否，1是

relationshipString10是仓库归属

新增仓库备案，返回值见表8所示。

追溯信息接口

6.3.1新增生产食品数据

上传新增生产食品数据信息，包括批次号、生产日期等，参数见表14。

表14新增生产食品数据

字段名称类型长度（Byte）是否必填描述

goodsInfoIdInteger(int64)64是商品备案号

materiaUseListArray256是食品生产所需原辅料信息（数组）

buyDateDate16是使用日期

entMateriaBuyIdString50是企业原辅料进货号

useCountInteger32是商品类别号

produceBatchString32是批次号

produceCountInteger(int32)32是生产数量

produceDateString(date-time)256是生产日期

新增生产食品数据，返回值见表8所示。

6.3.2上传质检报告

上传生产食品的质检报告图片，参数见表15。

表15上传质检报告数据

字段名称类型长度（Byte）是否必填描述

productInfoIdString64是商品号

quaImgString128是质检报告图片URL地址

上传质检报告，返回值见表8所示。

6.3.3新增原辅料进货数据

8

DB53/T1136.3—2022

上传新增原辅料进货信息，包括原料类别、数量等，参数见表16。

表16新增原辅料进货数据

字段名称类型长度（Byte）是否必填描述

supplyEntCodeString32是供货商社会信用代码

原料辅类别号：01原料，02食品添加剂，

materiaCatalogIdString32是

03食品相关产品

buyDateDate256是进货日期

countString64是进货数量

materiaBatchString16是原辅料批次

entMateriaInfoIdString64是原辅料名称

produceDateDate256是生产日期

reportImgString128是质检报告图片,图片URL地址

新增原辅料进货数据，返回值见表8所示。

6.3.4新增首站进货数据

流通企业上传新增食品首站进货数据，参数见表17。

表17新增首站进货数据

字段名称类型长度（Byte）是否必填描述

purchaseDateDatetime16是进货日期

supplyEntCodeString32是供货商统一社会信用代码

produceEntCodeString32是生产商统一社会信用代码

originPlaceString30是产地

goodsCatalogNameString50是商品类别名称

goodsCatalogIdString32是商品类别号

nameString50是商品名称

packageTypeString10是包装类型：1散装，2预包装

barCodeString64是条码

produceBatchString32是批次号

specString20是规格

spUnipString4是规格单位

produceCountString32是进货数量

produceDateDatetime16是生产日期

qualityGuaranteePeriodString20是保质期

guaranteeUnitString10是保质期单位，Y年,M月，D天

新增首站进货数据，返回值见表8所示。

6.3.5新增食品销货数据

流通企业上传新增食品销货订单数据，参数见表18。

9

DB53/T1136.3—2022

表18新增食品销货数据

字段名称类型长度（Byte）是否必填描述

rkTypeString4是入库类型：1首站入库，2分销入库

orderNumString64是订单号

voucherNumString64是索证索票号

buyEntCodeString64是分销企业信用代码

buyEntNameString100是分销企业名称

buyTimeDatetime16是采购时间

voucherUrlString255否票据图片URL地址

statusInteger10是销货标志：0未销货，1销货

新增食品销货数据，返回值见表8所示。

追溯码生成接口

6.4.1追溯码下载接口

食品追溯码的下载，参数见表19。

表19追溯码下载数据

参数名称数据类型长度（Byte）是否必填描述

productIdString32是食品标识号

productBatchString255是食品批次

packageKindString32是包装类型：01小包，02中包，03大包

ZIPZIP409600是追溯码ZIP压缩包

追溯码下载，返回值见表8所示。

6.4.2追溯码样式新增

新增追溯码样式（带码值和图片），参数见表20。

表20追溯码样式新增数据

字段名称类型长度（Byte）是否必填描述

applyCountString32是申请数量

cpathString255是图片存放路径

packageKindString32是包装类型：1小包，2中包，3大包

qrcodeImgString255是二维码示例图URL地址

qrcodeLengthInteger10是二维码·长，默认100

qrcodeWeigthInteger10是二维码·宽，默认100

templateNameString60是模板名称

追溯码样式下载，返回值见表8所示。

6.4.3追溯码样式生成

生成追溯码（带码值，有图片），参数见表21。

10

DB53/T1136.3—2022

表21追溯码样式生成数据

字段名称类型长度（Byte）是否必填描述

idInteger32是食品标识号

numInteger64是申请数量

追溯码样式生成，返回值见表8所示。

6.4.4追溯码生成

生成追溯码（只有码值），参数见表22。

表22追溯码生成数据

字段名称类型长度（Byte）是否必填描述

goodsInfoIdString32是商品备案号

goodsCatalogIdString32是商品类别号

packageKindString32是包装类型:01小包，02中包，03大包

applyNumInteger32是申请个数

追溯码生成，返回值见表8所示。

6.4.5追溯码赋码绑定

生产企业追溯码绑定对应食品，参数见表23。

表23追溯码赋码绑定数据

字段名称类型长度（Byte）是否必填描述

goodIdString32是商品生产号

goodTypeIdString32是商品类别号

gs1String128是追溯码码值

packageKindString32是包装类型:01小包，02中包，03大包

scanningNumString32否扫描次数

追溯码赋码绑定，返回值见表8所示。

7接口安全

安全认证

食品安全信息追溯数据接口采用数字令牌的方式实现安全认证。即服务端生成的一串加密字符串、

以作客户端进行请求的一个“令牌”，如果“令牌”不存在，说明请求无效。

安全传输

使用食品安全信息追溯信息数据接口的生产经营者，可以申请具有相应资质的CA中心签发的数字证

书。采用HTTPS的方式，使用数字证书对接口的传输内容进行数字签名,实现身份识别和数据传输安全。

数字令牌

11

DB53/T1136.3—2022

使用食品安全信息追溯数据接口的生产经营者,可以申请追溯平台签发的唯一的数字令牌。使用接

口传输数据时附加数字令牌,实现身份识别认证。数字令牌的有效期为1小时，令牌失效后生产经营者需

要重新申请新的令牌，生产经营者的新令牌一经颁发，原有令牌即刻失效。

密码算法

数字证书和数字令牌采用的密码算法，应采用符合国家规定的密码算法。

12

DB53/T1136.3—2022

A

A

附录A

附录B（规范性）

附录CHTTP状态码表

HTTP响应报文状态码，见表A.1。

表A.1HTTP响应报文状态码表

HTTP状态码说明

200OK

201POST/PUT消息，带消息体

202消息已接收

204不带消息体

400BadRequest

401Unauthorized

403Forbidden

404NotFound

429TooManyRequest

500InternalServerError