T_YNZYC 0103-2023 云南省中药材追溯体系 第3部分：数据接口规范.docxVIP

学兔兔ｗｗｗ．ｂｚｆｘｗ．ｃｏｍ标准下载ICS?65.020.99

学

兔

兔

ｗ

ｗｗ

．ｂ

ｚｆ

ｘｗ

．ｃ

ｏｍ

标

准

下

载

CCS?B00

T/YNZYC

云南省中药材种植养殖行业协会团体标准

T/YNZYC?0103—2023

云南省中药材追溯体系?第?3?部分：

数据接口规范

Yunnan?Provincial?Traceability?System?of?Traditional?Chinese?Medicinal?Materials

Part?3:?Data?Interface?Specification

2023?-?12?-?30?发布 2023?-?12?-?30?实施

云南省中药材种植养殖行业协会??发?布

学兔兔ｗｗｗ．ｂｚｆｘｗ．ｃｏｍ标准下载T/YNZYC?0103—2023

学

兔

兔

ｗ

ｗｗ

．ｂ

ｚｆ

ｘｗ

．ｃ

ｏｍ

标

准

下

载

前 言

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

起草。

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

本文件由云南省中药材种植养殖行业协会提出并归口。

本文件起草单位：云南省中药材种植养殖行业协会、云南省商务厅、云南钰津供应链科技有限公司

本文件主要起草人：苏豹、陈晓虹、张艳芳、吕秀田、丁剑、张雪、李艳、尹容梅、李学芬、胡俩

剑、杨辉

I

学兔兔ｗｗｗ．ｂｚｆｘｗ．ｃｏｍ标准下载T/YNZYC?0103—2023

学

兔

兔

ｗ

ｗｗ

．ｂ

ｚｆ

ｘｗ

．ｃ

ｏｍ

标

准

下

载

云南省中药材追溯体系?第?3?部分：数据接口规范

1?范围

本标准规定了云南省中药材追溯体系的术语和定义、追溯数据接口的总体要求、接口类型、

接口关系、接口基本功能和参数等内容。

本标准适用于构建云南省中药材追溯体系数据接口规范。

2?规范性引用文件

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

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

改单）适用于本文件。

GB/T?2260?中华人民共和国行政区划代码

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

GB/T?38159?重要产品追溯?追溯体系通用要求

中国药典

3?术语和定义

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

3.1?主体码?subject?code

用于产品生产流通过程中识别主体身份的代码。按照身份主体的不同，分为流通节点主体码

以及经营者主体码。

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

HTTPS:?超?文?本?传?输?安?全?协?议?(Hyper?Text?Transfer?Protocol?over?Secure?Socket?Layer?或

Hypertext?Transfer?Protocol?Secure)

ID:?标识符?(Identifier?)

JSON:轻量级的数据交换格式?(JavaScript?Object?Notation)

5?中药材追溯体系数据接口总体要求

5.1?通信协议

应采用符合IETF?RFC?2818规定的HTTPS协议作为底层承载协议。

5.2?接口描述

接口命名使用通用的驼峰命名方式，接口文本描述语言采用通用的JSON格式。

2

学兔兔ｗｗｗ．ｂｚｆｘｗ．ｃｏｍ标准下载T/YNZYC?0103—2023

学

兔

兔

ｗ

ｗｗ

．ｂ

ｚｆ

ｘｗ

．ｃ

ｏｍ

标

准

下

载

5.3?编码字符集

应采用?IETF?RFC?3629?规定的?UTF-8?字符集。

5.4?数据类型

中药材追溯系统数据接口覆盖所能支持数据类型，包括：

——字符串型（String）

——数字型（Number）

——时间型（Datetime）

——对象型（Objeck）

——数组型（Array）

——布尔型（Boolean）

——空（NULL）

6?中药材追溯体系数据接口类型

中药材追溯系统数据接口主要包括下列类型：

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

——基地档案类，包括但不限于基地基本信息、基地环境信息、基地操作人员、基地管理人

员等；

——追溯信息类，包括但不限于种源信息、种植信息、物料信息、采收信息、加工信息、仓

储信息、销售信息、运输信息等；

——资料信息类，包括但不限于资料数据类。

7?中药材追溯体系数据接口关系

图1?中药材追溯体系数据接口关系图

8?中药材追溯体系数据接口基本功能和参数

3

字段名

含义

数据类型

必选/可选

说明

En_name

企业名称

String

必选

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

称

Unif_soci_cred_code

社会统一信用代码

Str