DB15T 3952-2025农畜产品质量安全数据交换规范

农畜产品质量安全数据交换规范Specificationfordataexchangef2025-03-14发布2025-04-14实施内蒙古自治区市场监督管理局发布I 12规范性引用文件 13术语和定义 14信息交换原则 24.1统一性原则 24.2唯一性原则 24.3规范性原则 24.4可拓展性原则 25数据接口设计要求 25.1数据接口设计原则 25.2数据接口基本要求 25.3数据接口协议 35.4数据接口功能 36追溯数据交换内容 36.1数据元 36.2数据交换格式 36.3数据记录 37接口安全 57.1安全认证 57.2数字令牌 57.3传输安全 57.4数据加密 5本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起本文件由内蒙古自治区农牧厅归口。本文件起草单位：内蒙古自治区农畜产品质量安全中心、内蒙古自治区质量和标准化研究院、锡林郭勒盟农畜产品质量安全监测中心、乌兰察布市农牧局、呼和浩特市农牧局、鄂尔多斯市农畜产品质量安全中心、乌兰察布市农畜产品质量安全中心、巴彦淖尔市农牧局、达拉特旗农畜产品质量安全中心、察哈尔右翼前旗农畜产品质量安全检验检测站、成都曙光光纤网络有限责任公司、东河区农牧林草事业发展中心、扎兰屯市农畜产品质量安全中心、准格尔旗农畜产品安全与生态资源保护中心、呼和浩特市文化旅游广电局综合保障中心、扎赉特旗农畜产品质量安全中心。本文件主要起草人：云岩春、许大伟、李超、伊日贵、毕力格、顾海涛、赵雪、李刚、杨佳慧、曾大章、李强、曹志伟、奇宝力格、杜建云、特日格乐、任膺洁、于洁、于婷婷、闫肃、王静、王慧娟、郭春晖、郝贵宾、于海东、张欣昕、万通、赵波、马德惠、李佳、徐静、王丽霞、张妍、曹士安、邓贵权。1农畜产品质量安全数据交换规范1范围本文件规定了农畜产品质量安全数据交换规范的信息交换原则、数据接口设计要求、追溯数据交换内容、接口安全。本文件适用于农畜产品追溯系统之间信息交换的规划、设计、系统开发以及运行维护管理。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T7408.1日期和时间信息交换表示法第1部分：基本原则GB/T36478.4物联网信息交换和共享第4部分：数据接口GB/T38672信息技术大数据接口基本要求GB/T40094.3电子商务数据交易第3部分：数据接口规范GB/T44583重要产品追溯追溯码编码规范NY/T3177农产品分类与代码3术语和定义下列术语和定义适用于本文件。责任主体thesubjectofresponsibility农畜产品生产、收购、贮藏、运输过程中对质量安全负有直接责任的自然人或法人。追溯系统中对追溯单元进行唯一标识的代码。在农畜产品生产过程中投入使用的各种物品和要素，包括农资类、其他生产资料类、饲料类、兽药类、疫苗类等。农畜产品追溯系统之间互相发送、传输和接收数据的过程。DB15/T3952-20252在产品或服务的全生命周期中能够反映质量水平和安全程度，保障其符合质量和安全要求相关的依据。4信息交换原则4.1统一性原则各信息系统进行数据交换时追溯码编码应按照GB/T44583的要求。4.2唯一性原则追溯码编码与农畜产品追溯单元一一对应。4.3规范性原则按照规范格式确定信息交换的内容和数据格式，见表1、表2。4.4可拓展性原则各信息系统之间可根据实际需要确定扩展信息。5数据接口设计要求5.1数据接口设计原则接口设计应遵循高内聚、低耦合的设计原则，降低复杂度，提高系统的扩展性，保证实际运用中的便捷性和通用性。应符合以下要求：a)宜采用GB/T38672的规定，实现系统间的松耦合；b)充分考虑接口所涉及的各个系统的应用扩展情况，确保灵活地支撑需求变化；保证接口数据在各个系统间的一致性；c)在数据交互过程中，应具有传送和接收后的确认过程；d)使用简单、快捷、通用性好、可靠性高。5.2数据接口基本要求农畜产品追溯数据接口通过服务调用获取所需的信息，应符合下列要求：a)采用IETFRFC2818的HTTPS协议作为底层承载协议；b)采用IETFRFC3629规定的UTF-8字符集；c)采用GB/T7408.1规定的日期类型；d)采用IETFRFC3548规定的Base64编码规则将图片、文件二进制字节流转换为字符串；e)接口响应宜采用IETFRFC4627规定的JSON数据格式；f)建立接口日志记录，能识别数据异常或追溯交换数据情况；g)发生错误时，接口将详细的错误代码和错误信息返回给接口使用方，以利于接口使用方进行记录分析和整改。3DB15/T3952-20255.3数据接口协议数据接口协议宜符合RESTful风格接口的方式进行相互通信。符合RESTful风格的接口采用基于HTTP/HTTPS的简单访问方法GET、POST等。数据库接口方式应符合GB/T36478.4和GB/T40094.3的要求。5.4数据接口功能接口宜具有Web服务的注册、发布、管理、监控等功能。6追溯数据交换内容6.1数据元包括农畜产品质量安全追溯系统中设计的各个数据元的名称、标识、数据类型、数据格式、说明以及性质，具体描述如下：a)名称：描述追溯数据的技术语言；b)标识：唯一代表某一个数据元的标识符；c)数据类型：数据元的存储类型；d)数据格式：描述数据元的长度或精度、表示格式，其中代表日期的数据元统一采用GB/T7408.1的表示方法；e)说明：对数据元的简单描述；f)性质：表示数据元与农畜产品质量安全的相关性，分为重要、一般。6.2数据交换格式采用JSON或XML可扩展标记语言确定数据交换格式。6.3数据记录农畜产品追溯数据记录主要包括产品追溯信息、责任主体信息、品种信息、用药信息、疫苗信息、饲料信息、其他投入品信息、产品检测信息和包装信息等。以产品追溯信息和责任主体信息为例，见表1、表6.3.1产品信息记录农畜产品追溯信息的数据元素，如表1所示。表1农畜产品追溯主要数据元数据类型说明性质唯一标识某一追溯单元的农畜产品责任主体编码责任主体的唯一标识畜产品类别代码4表1农畜产品追溯主要数据元(续)数据类型说明性质日期其他有关责任主体的信息<Tracing_code></Traci<Responsible_entity_code></Responsible_entity_code><Classification_and_coding_of_agricultural_and_livestock_products></Clasand_coding_of_agricultural_and_livesto<Name_of_agricultural_and_livestock_products></Name_of_agricultural_and<Place_of_origin></Place_of<Processing_site></Processi<Processing_date></Processi数据类型说明性质责任主体名称责任主体的中文名称，自然人为责任主体时为姓名责任主体编码责任主体统一社会信信用体时为身份证号或护照号。责任主体类型人三种法人代表身份证、护照号，责任主体为自然人时联系人姓名责任主体的联系人姓名长度11责任主体地址其他有关责任主体的信息56.3.4责任主体XML格式<The_name_of_the_responsible_subject></The_name_of_the_responsib<Responsible_entity_code></Responsible_entity_code><The_type_of_responsibility_body></The_type_of_responsibil<Legal_representative></Legal_repre<Name_of_contact_person></Name_of_contac<Contact_phone></Contac7接口安全7.1安全认证数据接口安全认证应按照GB/T40094.3的要求。7.2数字令牌数据接口调用者应向数据接口服务提供方申请数字令牌，数字令牌通常包含appKey和appSecret两部分，appKey是调用者身份的标识，appSecret是调用