1、ICS 35.040CCS A 00T/ZNZ浙 江 省 农 产 品 质 量 安 全 学 会 团 体 标 准T/ZNZ 1262022浙农码编码及应用技术规范Technical specification for basic coding rules and application ofZhejiang Agricultural Code2022-07-29 发布2022-08-29 实施浙江省农产品质量安全学会发 布全国团体标准信息平台T/ZNZ 1262022I前言本文件按照GB/T 1.1-2020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能
2、涉及专利。本文件的发布机构不承担识别专利的责任。本文件由浙江省农产品质量安全学会提出并归口。本文件起草单位：浙江省农业农村大数据发展中心、浙江省农业科学院农产品质量安全与营养研究所、浙江甲骨文超级码科技股份有限公司、浙江农林大学、浙江森特信息技术有限公司、安吉县农业农村局。本文件主要起草人：陶忠良、管孝锋、王兵、吴晓柯、韩伟达、孙彩霞、刘玉红、任璐怡、钱帅吉、岳晓兰、章玉、陈婷、金晶、周凡、朱莹、黄海龙、乔婉霞、陆林峰、李林、夏芳、任俊俊、徐颖、叶洪波、吴家满、刘已增、朱海帆、汤朱敏。全国团体标准信息平台T/ZNZ 12620221浙农码编码及应用技术规范1范围本文件规定了浙农码的术语与定义，
3、编码、代码、呈现管理要求、数据共享与交换接口要求。本文件适用于浙农码所有编码对象数字标签的编码，以及应用过程中的管理。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260中华人民共和国行政区划代码GB 32100法人和其他组织统一社会信用代码编码规则GB/T 33993商品二维码DB33/T 912新时代美丽乡村建设规范3术语和定义下列术语和定义适用于本文件。3.1浙农码Zhejiang agricultural and rura
4、l code通过数字化方式，按照统一编码规范，赋予涉农领域的人、组织、物唯一数字标签。也是乡村数字服务集成入口。3.2编码coding给事物或概念赋予浙农码的过程。3.3代码codes由数字组成的表示信息的明确的规则体系。3.4应用场景apply scenario基于统一的服务与管理平台，实现服务和管理具体项目业务目标、可检验可复现的场景。3.5呈现rendering全国团体标准信息平台T/ZNZ 12620222展示浙农码设计理念、使用场景及浙农码属性的展现样式。3.6预警early warning通过对事件过程中部分特征信息的识别、确认、收集和监测，按照特定的判断依据，在特定事件发生之前发
5、出紧急信号，报告危险情况的行为。3.7接入系统accessing system有接入浙农码平台需求的第三方应用系统。4编码4.1一般要求编码前应确定当前场景，明确编码对象属性，确定编码对象精度，宜以编码对象中最小识别单位为标识单元编码。4.2编码原则4.2.1基本原则4.2.1.1涉及的编码对象代码应具备唯一性。4.2.1.2信息真实有效，应具备验证功能。4.2.1.3结构设计应符合实际业务流程。4.2.1.4编码规则应符合 GB/T 2260、GB 32100 的要求。4.2.1.5涉及的编码对象代码按属性类别进行划分，应按实际业务场景确定最小分类单元。4.2.2兼容性代码结构的设计应保持与
6、已实施编码规则之间的兼容性。4.2.3安全性编码信息应避免使用企业、个人及其他隐私信息。4.2.4稳定性除产品序列号性质的编码外，编码中不应出现随时空发生变化的编码码段，应保证编码的稳定性。4.2.5拓展性为满足个性化需求，编码应具备拓展性，以便应对未来不断增长的编码对象类型。拓展的编码应满足4.2.1、4.2.2、4.2.3、4.2.4的要求。4.3码制码制应符合GB/T 33993相关要求，采用QR码码制进行编码。4.4编码对象分为：农业主体、农产品、资源装备、乡村和其他涉农对象。4.5编码结构全国团体标准信息平台T/ZNZ 126202234.5.1数字编码浙农码由纯数字组成，一般长度为
7、19位，见图1。图 1浙农码编码结构图4.5.2浙农码版本标识码浙农码从左至右前两位为浙农码版本标识，编码10代表1.0版本，浙农码版本最基础版为1.0版本，根据相关需要，升级后的版本依据版本升级情况命名。4.5.3唯一属性码根据编码对象属性当前应用场景细分小类，赋予唯一编码，涉及行政区划的应符合GB/T 2260相关规定，应保障编码对象的唯一性和可追溯性，唯一属性码为17位。4.5.4动态扩展为满足不断增长的扩展需要以及与其他系统的兼容性而预留，动态扩展应根据实际业务需要动态增加。4.6编码载体浙农码应根据实际应用场景为编码对象选择不同类型编码载体，一般条件下宜使用二维码为编码载体，特殊情况
8、下可使用RFID、NFC等为编码载体。5代码5.1代码分类分类代码作为编码对象的分类属性，应在申领浙农码时提供，可通过应用程序在数据库中读取。5.2农产品分类代码见表1。表 1农产品的分类代码分类分类代码代码农产品010000粮油010100蔬菜010200茶叶010300果品010400畜产品010500水产品010600竹木010700全国团体标准信息平台T/ZNZ 12620224表 1 农产品的分类代码（续）分类分类代码代码花卉苗木010800蚕桑010900食用菌011000中药材011100宠物011200其他0199005.3农业主体浙农码中农业主体宜按属性和从事生产经营范围进行
9、分类，分类代码见表2。表 2农业主体的分类代码分类分类代码代码农业主体020000农业企业020100农民专业合作社020200家庭农场020300规模大户020400畜牧养殖场020500屠宰场020600无害化处理场020700农家乐020800船员020900农资店021000水产养殖场021100畜禽转运主体021200宠物主021300农业废弃物回收站0214005.4资源装备分类代码见表3。表 3资源装备的分类代码分类分类代码代码资源装备030000农机030100渔船030200承包地030300冷库030400全国团体标准信息平台T/ZNZ 12620225表 3 资源装备的分
10、类代码（续）分类分类代码代码粮食生产功能区030500高标准农田030600农田(非统一编码地块)030700农业标准地030800农房030900宅基地031000传感设备0311005.5乡村浙农码中乡村宜按当前场景业务属性分类，编码对象为行政村的，应符合DB33/T 912相关要求，分类代码见表4。表 4乡村的分类代码分类分类代码代码乡村040000行政村040100农户040200低收入农户040300村集体经济合作社040400景观0405006呈现管理6.1符号、代号和缩略语下列符号、代号和缩略语适用于本文件：API应用程序接口（Application Programming In
11、terface）UI用户界面(User Interface)APP手机软件（Application）QR快速响应矩阵码（Quick Response）CMYK印刷色彩模式（Cyan Magenta Yellow BlacK）FTP文件传输协议（File Transfer Protocol）HTTP超文本传输协议（Hypertext Transfer Protocol）API应用程序接口（Application Programming Interface）XML可扩展标记语言（Extensible Markup Language）JSON轻量级的数据交换格式（JavaScript Object
12、Notation）UTF-88 位元（Universal Character Set/Unicode Transformation Format）6.2呈现样式6.2.1尺寸全国团体标准信息平台T/ZNZ 12620226浙农码二维码部分尺寸应不小于11 mm11 mm，中心浙农码字体图形标识区域面积对比二维码面积比例不宜大于1:19。6.2.2形状浙农码形状分为推荐版和简版两种，推荐版呈现形状为外圆内方，外圈内部有 5 片叶子点缀在码本体四周，外圈以智慧农业、养殖元素为主，参见图 2；简化版呈现形状为正方形，周边无点缀，参见图3。图 2推荐版浙农码示例图 3简化版浙农码示例6.3绿码正常浙农
13、码码本身颜色应为绿色，绿码的CMYK色值应为C80 M20 Y100 K0。6.4预警码6.4.1预警色分类预警色为黄色和红色，黄码的CMYK色值应为C0 M35 Y90 K0，红码的CMYK色值应为C0 M95 Y95 K0。6.4.2预警分级浙农码红码为最高预警，黄码次之，是否预警由业务接入方根据赋码对象业务系统的业务场景分级或不分级，选择分级的应在正式启用上线前制定预警分级标准，分级标准应科学合理公正。当前为黄码或红码的应在码的正下方查看黄码或红码的原因。6.4.3预警码样式浙农码预警码样式参见图4。全国团体标准信息平台T/ZNZ 12620227图 4预警码示例黄码（左）、红码（右）6
14、.5申领6.5.1申领途径浙农码应提供多种申领途径：通过登录浙农码总仓进行申领。接入系统通过开放的 API 接口，进行浙农码申领。通过浙农码掌上服务端申领入口进行申领。根据业务扩展需求开放其他申领途径。6.5.2申领方式浙农码的申领方式有批量申领和单个申领两种方式。6.5.3批量申领6.5.3.1一次性有大量的农产品、农业主体、生产要素、美丽乡村的乡村要素需要批量赋码时，宜通过批量申请的方式进行快速申领。6.5.3.2拟接入系统对接浙农码开发平台时，接入系统应通过浙农码开发平台 API 接口进行批量申领。6.5.4单个申领6.5.4.1根据申领类别，通过登录浙农码掌上服务端进行认证后填写相关信
15、息提交申领。6.5.4.2信息参见附录 A。6.6接入场景应用6.6.1接入基本要求6.6.1.1用码量达到 5 万次及以上。6.6.1.2对接的业务场景能够体现浙农码的功能；包括但不限于码上查询、码上直办、码上服务、码上营销、码上监管、码上信用等。6.6.1.3应有实际应用场景落地，提交场景说明文档，有实体标识的应提供实际标识 UI 设计并指出浙农码使用部分；电子标识则应提供实际与浙农码结合的样式页面。全国团体标准信息平台T/ZNZ 126202286.6.1.4有系统或服务承接浙农码的应用，系统应处于活跃状态。赋码的主体或对象在应用系统内应有唯一标识，该唯一标识用于浙农码申领。6.6.2接
16、入流程业务系统接入浙农码应按图5流程接入。通过邮件和手机号，申请注册成为浙农码平台开发者输入应用名称，生成clientID、clientSecret在沙箱环境进行接口联调测试，详见接口文档正式环境申请码、使用码图 5 业务系统接入流程7数据共享与交换接口要求7.1数据共享与交换7.1.1数据交换格式浙农码的数据共享应采用JSON数据存储形式作为数据交换格式。7.1.2数据接口调用浙农码一般使用Web Service技术向其他相关的应用系统提供调用接口，外部应用的业务处理应通过授权调用Web Service进行。7.1.3数据接口安全应设立接口对接认证机制，非正确认证用户，不允许调用接口所提供数据。7.1.4数据接口响应数据接口平均响应时间应小于 0.5 秒，接口服务并发能力应大于 200 次/秒数据传输。7.2数据传输7.2.1数据传输协议数据传输协议应采用HTTP，技术实现应采用Restful Web Service方式。7.2.2数据传输格式数据传输中的数据格式应为Application/JSON，数据字符集UTF-8。7.2.3数据传输安全数据传输过程中应具备故障时自动恢复功能，