TCAAA 122-2023 鸡肉品质数字化认证的产业链关键数据采集规范

T/CAAA122—2023鸡肉品质数字化认证的产业链关键数据采集规范中国畜牧业协会发布I前言 12规范性引用文件 13术语和定义 14缩略语 25数据采集内容 26数据采集方式 67数据采集要求 7附录A(资料性)鸡肉产业链关键数据集成接口说明 8参考文献 T/CAAA122—2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国畜牧业协会提出并归口。本文件起草单位：沈阳航空航天大学、中国质量认证中心、北京市农林科学院信息技术研究中心、中国畜牧业协会信息分会、中畜数字科技(北京)有限公司、思玛特(北京)食品有限公司、江苏京海禽业集团有限公司、江苏益客食品集团股份有限公司、京东科技集团、北京农学院。本文件主要起草人：尹宝生、余礼根、徐少山、刘钢、李奇峰、唐怡聪、姜南、刘强德、樊伟、任李佳隆、童津津。1鸡肉品质数字化认证的产业链关键数据采集规范1范围本文件给出了鸡肉产业链各环节的数据采集内容、方式、要求和集成接口说明。本文件适用于肉鸡养殖、屠宰、加工、流通过程中的信息管理、追溯、风险控制和鸡肉品质数字化2规范性引用文件仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本GB/T28452信息安全技术应用软件系统通用安全技术要求YD/T3747区块链技术架构安全要求3术语和定义GB/T28452和YD/T3747界定的以及下列术语和定义适用于本文件。一种在对等网络环境下，通过透明和可信规则，构建防伪造、防篡改和可追溯的块链式数据结构，实现和管理事务处理的模式。包括肉鸡养殖、运输、屠宰、加工、储存等一系列可能影响最终鸡肉品质的相关主要环节。肉鸡屠宰加工后形成的各类初加工生鲜产品，如鸡翅、鸡胸肉、白条鸡等。产业链关键数据采集keydatacollectionfortheindustrialchain在畜禽产品生产全过程中对影响品质的相关数据进行采集的过程，包括对相关物联网设备的数据采集、企业信息化系统中数据的采集和人工数据输入等方式。针对满足相关品质要求的鸡肉产品颁发的唯一认证标识编码，用来粘贴或印制在鸡肉产品最小包装上。该认证码为一物一码使用方式。鸡肉品质数字化认证chickenqualitycertificationbasedondigitaltechnology应用物联网、大数据和区块链等信息技术，以鸡肉产业链各环节关键数据为基础进行鸡肉品质批次动态验证的一种产品认证模式。畜禽产品品质数字化认证的信息化支撑平台。2T/CAAA122—20234缩略语下列缩略语适用于本文件。API:应用程序编程接口(ApplicationProgrammingInterface)UTF-8:Unicode的一种字符编码(UniversalCharacterSet/UnicodeTransformationFormat)URL:统一资源定位符(UniformResourceLocator)5数据采集内容5.1采集环节包括申请、养殖、运输、屠宰、检测、赋码和储存。5.2申请申请时关键数据采集内容如表1所示。表1申请环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型产业链相关主体证照信息营业执照初次申请/变更时是图片畜禽养殖代码证初次申请/变更时是图片动物防疫条件合格证初次申请/变更时是图片种畜禽生产经营许可证初次申请/变更时是图片引进雏鸡检疫证明初次申请/变更时是图片饲料生产许可证初次申请/变更时是图片饲料添加剂生产许可证初次申请/变更时是图片引种场种畜禽生产经营许可证初次申请/变更时是图片养殖排污许可证或自我说明初次申请/变更时是图片位置及布局信息行政位置及周边环境图初次申请/变更时是图片场区平面布局图初次申请/变更时是图片鸡舍平面图初次申请/变更时是图片防鼠防鸟布局图初次申请/变更时是图片人员信息养殖人员清单及健康证初次申请/变更时是文件屠宰加工人员清单及健康证初次申请/变更时是文件运输人员清单及健康证初次申请/变更时是文件驻场兽医列表及资格证初次申请/变更时是文件标识或证明禁止饲养其他畜禽标识初次申请/变更时是图片禁止接触外来活畜禽活禽产品标识初次申请/变更时是图片无沙门氏菌、鼠伤寒沙门氏菌、鸡败血支原体、滑液囊支原体感染的证明初次申请/变更时是图片3数据类别数据项名称采集时间或频次是否区块链存证数据类型报告或记录信息饮用水检测报告初次申请/变更时是图片排污检测报告初次申请/变更时是文件抗体检测报告初次申请/变更时是文件供料、供水系统应急预案初次申请/变更时是文件兽医健康计划初次申请/变更时是文件免疫程序文件初次申请/变更时是文件减抗计划初次申请/变更时是文件病死及病害动物无害化处理技术规范初次申请/变更时是文件召回程序初次申请/变更时是文件召回演练记录发生时否文件内部检查程序初次申请/变更时是文件内部检查报告初次申请/变更时是文件5.3养殖关键数据如表2所示。表2养殖环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型肉鸡建档信息建档批次标识每批次进鸡时是文本建档肉鸡品种/配套系每批次进鸡时是文本建档数量每批次进鸡时是数值建档日期每批次进鸡时是所在栋/舍号每批次进鸡时是文本鸡笼号每批次进鸡时是文本鸡笼面积每批次进鸡时是数值动物检疫合格证每批次进鸡时是图片来源信息引种场名称每批次进鸡时是文本来源鸡雏批次标识每批次进鸡时是文本引入数量每批次进鸡时是数值引入日期每批次进鸡时是出雏日期每批次进鸡时是养殖环境温度、湿度、氨气等传感器信息传感器设备ID定时采集是文本采集时间定时采集是时间采集数值定时采集是文本视频监控快照信息监控设备ID定时采集是文本视频快照截取时间定时采集是时间视频快照图片定时采集是图片饲喂信息饲喂日期发生时是饲料批次标识发生时是文本饲喂量发生时是数值4T/CAAA122—2023数据类别数据项名称采集时间或频次是否区块链存证数据类型免疫信息档案批次标识发生时是文本免疫日期发生时是免疫阶段发生时是文本免疫项目发生时是文本疫苗生产企业发生时是文本疫苗批次号发生时是文本有效期发生时是总用量发生时是文本操作人发生时是文本用药信息档案批次标识发生时是文本用药日期发生时是药物编码发生时是文本药物名称发生时是文本药物图片发生时是图片药品厂家发生时是文本药物批号发生时是文本用药总量发生时是文本疫病名称发生时是文本用药类型发生时是文本处方图片发生时是图片操作人发生时是文本淘汰信息档案批次标识发生时是文本淘汰日期发生时是淘汰数量发生时是数值淘汰原因发生时是文本无害化处理方式发生时是文本5.4运输关键数据如表3所示。表3运输环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型活体运输出栏批次标识运输时是文本出栏日期运输时是日期出栏数量运输时是数值产地检疫证明运输时是图片目的屠宰场运输时是文本运输车牌号运输时是文本车辆照片运输时是图片5.5屠宰关键数据如表4所示。5表4屠宰环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型屠宰(宰前)信息屠宰批次标识屠宰前是文本到达时间屠宰前是时间待宰棚编号屠宰前是文本进入屠宰场数量屠宰前是数值入场检疫时间屠宰前是时间入场检疫人员屠宰前是文本入场检疫结果屠宰前是图片兽药残留检测结果屠宰前是图片屠宰(宰后)信息屠宰时间屠宰后是时间屠宰数量屠宰后是数值致昏方式屠宰后是图片同步检验结果屠宰后是数值屠宰加工视频监控快照信息监控设备ID定时采集是文本视频快照截取时间定时采集是时间视频快照图片定时采集是图片5.6检测关键数据如表5所示。表5检测环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型检测数据屠宰批次标识每批次是文本感官和理化指标检测每批次是文本兽药残留检测定期检测是文本污染物限量检测定期检测是文本农药残留检测定期检测是文本兽药残留定期检测是文本微生物指标检测定期检测是文本操作人产品检测时是文本检测时间产品检测时是时间检测报告产品检测时是图片异常结果产品检测时是文本5.7赋码关键数据如表6所示。6T/CAAA122—2023表6赋码环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型鸡肉产品赋码激活产品编码赋码激活时是文本产品类型赋码激活时是文本产品重量/g赋码激活时是数值产品认证码编号赋码激活时是文本产品认证码激活时间赋码激活时是时间操作人赋码激活时是文本5.8储存关键数据如表7所示。表7储存环节关键数据表数据类别数据项名称采集时间或频次是否区块链存证数据类型产品入库产品认证码编号产品入库时是文本入库时间产品入库时是时间库房编号产品入库时是文本操作人产品入库时是文本库房温度传感器传感器设备ID定时采集是文本采集时间定时采集是时间采集数值定时采集是文本库房视频监控快照信息监控设备ID定时采集是文本视频快照截取时间定时采集是时间视频快照图片定时采集是图片产品出库认证码编号产品出库时是文本出库时间产品出库时是时间经销商产品出库时是文本出厂检疫证产品出库时是图片操作人产品出库时是文本6.1基于信息化系统的数据接口同步企业现有信息化管理系统中已经存在的数字化认证所需的数据内容宜通过数据同步API接口的方式，按照数字化认证平台的数据集成接口规范完成数据的集成对接。具体集成接口规范参见附录A。6.2基于物联网设备的数据接口对接基于养殖、屠宰、加工等环节部署安装的温度、湿度、气体、光照、视频监控等物联网设备实现对数据的直接采集和上传。具体集成接口规范参见附录A。6.3基于人工操作的数据采集7包括现场拍照、书面记录和应用软件填报等采集方式，最终录入或上传至数字化认证平台。7数据采集要求7.1真实性数据提供方需确保数据的真实准确。不准许对数据进行筛选、篡改和造假。7.2时效性针对各环节产生的数据应第一时间采集并同步到平台，不能晚于数据产生后24h。7.3完整性应保证各类数据的完整性。7.4可复核应妥善保留相关数据的原始数据或凭证且不可篡改。除视频数据的其他数据的保存期限应不少于产品保质期满后1y,无明确保质期规定的应保留2y以上。视频数据的保存期限不少于15d,超过15d的视频数据应保存视频快照，视频快照的采样周期一般不超过5min。7.5安全性应符合GB/T28452的要求，同时满足如下要求：a)分离存储：数字化认证相关数据与企业经营管理数据分离存储；b)上链存证：数字化认证所需的关键数据内容或数据内容的哈希值应完成区块链上链存证；c)访问安全：数据的访问应有严格的授权和认证机制并通过HTTPS形式访问，每次访问应具有完整的操作日志。8T/CAAA122—2023(资料性)鸡肉产业链关键数据集成接口说明采用POST请求方式。A.1.2编码格式A.1.3请求参数参数标识中文名数据类型参数说明appKey开发者身份标识String开发者身份标识参数由数字化认证平台统一生成，同时生成的还有开发者密钥appSecrettimestamp时间戳String时间戳参数在调用接口时生成，默认为系统当前时间nonce随机数String随机数参数为随机6位字母和数字的组合字符串MD5签名StringMD5签名参数的生成过程：首先按照请求参数(包含appKey)名的字母升序排列并在后面拼接开发者密钥appSecret,然后整体进行md5加密，最终将结果的字母转换为大写action接口调用标识String鸡肉产业链关键数据接口调用标识：4.1肉鸡批次建档接口4.2肉鸡批次出栏接口4.3养殖过程数据接口4.4传感器数据采集接口4.5肉鸡屠宰数据接口4.6赋码激活数据接口propData接口数据内容基于action值对应的具体需要传递的数据内容参数信息，具体参见各接口描述部分A.1.4返回信息接口返回参数信息如表A.2所示。9参数标识中文名数据类型参数说明返回码200接口执行成功300接口执行失败请求状态Booleantrue正常false异常requestId请求idString请求id,针对本次接口请求自动生成的唯一标识msg错误描述String错误描述A.2图片上传接口表A.3图片上传接口描述请求方式POST请求URL/api/dchFile/v1参数标识参数名称数据类型备注appKey开发者身份标识String开发者身份标识参数由数字化认证平台统一生成，同时生成的还有开发者密钥appSecrettimestamp时间戳String时间戳参数在调用接口时生成，默认为系统当前时间nonce随机数String随机数参数为随机6位字母和数字的组合字符串MD5签名StringMD5签名参数的生成过程：首先按照请求参数(包含appKey)名的字母升序排列并在后面拼接开发者密钥appSecret,然后整体进行md5加密，最终将结果的字母转换为大写图片对象数组MultipartFile[]二进制文件流报文结构示例"appKey":"A10000001","nonce":"A20D3F","sign":"39F2A0FB45B4E21BD21EF97F081C9E1A","files":[]返回信息{code:200,status:true,requestId:"10e5376e9a3844bd9e0cab2541fb68d2",fileId:"15faa0f9a5c6416883c72b06c8b9e010",msg:“接口执行成功”A.3鸡肉产业链关键数据同步接口T/CAAA122—2023A.3.1肉鸡批次建档接口表A.4批次档案创建接口描述请求方式POST请求URL/api/dch/v1参数标识参数名称数据类型备注in_batch_code肉鸡批次标识String肉鸡养殖档案的唯一标识animal_type肉鸡品种/配套系String引种场名称String出雏日期String出雏日期(格式为yyyy-MM-dd),用于养殖日龄的计算进鸡图片StringA.2图片上传接口返回的fileId报文结构示例{"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F""sign":"39F2A0FB45B4E21BD21EF97F081C9E1A""action":"4.1","propData":{"animaltype":"白羽肉鸡","in_name":"河南顺访种鸡场","in_count":"10000","in_to_date":"2020-12-21","in_image":"15faaOf9a5c6416883c72b06c8b9e010"}A.3.2养殖过程数据接口表A.5养殖过程数据接口描述请求方式POST请求URL/api/dch/v1参数标识参数名称数据类型备注in_batch_code肉鸡批次标识String肉鸡养殖档案的唯一标识记录idString记录id,用于记录的修改标识记录类型String3代表饲喂记录；4代表死淘记录；5代表鸡笼分布记录record_date记录日期String记录日期(格式为yyyy-MM-dd)record_image进鸡图片StringA.2图片上传接口返回的fileId其他接口参数(略)报文结构示例"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F""sign":"3E39BAB471A48A4512BB91E80DCB2467","action":"4.3","propData":[{"inbatchcode":"202011150091","type":"3","recorddate":"2021-03-19","deadcount":"1","deadremark":"死淘说明信息","dealway":"无害化处理厂处理","recordimage":"15faaOf9a5c6416883c72b06c8b9e010"{"inbatchcode":"202011150091","id":"""type":"3","recorddate":"2021-03-18","deadcount":"1","deadremark":"死淘说明信息","recordimage":"15faa0f9a5c6416883c72b06c8b9e010"]A.3.3传感器数据采集接口温度、湿度、氨气等传感器设备采集的数据定时调用本接口完成同步。在A.1基本接口调用形式的基础上，action赋值4.4,propData具体参数见表A.6。表A.6传感器数据采集接口描述请求方式POST请求URL/api/dch/v1参数标识参数名称数据类型备注设备编号String设备唯一标识params监测参数String检测参数格式为([{"type":"1","time":"2020-12-0219:03:32","value":"39"}])其中type取值：1:养殖场传感器湿度数据；2:养殖场传感器温度数据；3:养殖场传感器氨气数据；4:屠宰低温车间湿度数据；5:屠宰冷冻车间温度数据；6:光照记录；7:分贝记录；8:药品储备室温度记录；9:圈舍二氧化碳，10:圈舍硫化氢T/CAAA122—2023报文结构示例"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F","sign":"3E39BAB471A48A4512BB91E80DCB2467","action":"4.4","propData":{"iden":"UJ64313213","params":[{"type":"1","time":"2020-12-0219:03:32","value":"39"{"type":"2""time":"2020-12-0219:03:36","value":"5"]}A.3.4肉鸡批次出栏接口表A.7肉鸡批次出栏接口描述请求方式POST请求URL/api/dch/v1参数标识参数名称数据类型备注养殖批次编号String养殖档案的唯一标识outbatchcode出栏批次编号String屠宰档案的唯一标识出栏日期String出栏日期(格式为yyyy-MM-dd),用于养殖日龄的计算outcount出栏数量Stringslaughterhouse目的屠宰场Stringbusnumber运输车牌号String其他接口参数(略)报文结构示例"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F","sign":"39F2A0FB45B4E21BD21EF97F081C9E1A","action":"4.2""propData":{"inbatchcode":"202011150091""outbatchcode":"20210519220","outdate":"2020-11-15","outcount":"430","slaughterhouse:"某食品有限公司","busnumber":"京QE8888"}A.3.5宰前宰后数据接口屠宰企业在肉鸡宰前、宰后分别调用本接口完成数据同步。在A.1基本接口调用形式的基础上，action赋值4.5,propData具体参数见表A.8。表A.8宰前宰后数据接口描述请求方式POST请求URL/api/dch/vl参数标识参数名称数据类型备注out_batch_code屠宰批次编号String屠宰档案的唯一标识tuzaibianhao待宰棚编号String类型1宰前，2宰后arrive_time到达时间String格式为yyyy-MM-ddhh:mm:ss报文结构示例"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F","sign":"39F2A0FB45B4E21BD21EF97F081C9E1A","action":"4.5","propData":{"out_batch_code":"202011150091","tuzaibianhao":"daizai001","type":1,"arrive_time":"2020-11-1519:23:23","quarantine_time":"2020-11-15","quarantine_person":"刘某","quarantine_image":"15faa0f9a5c6416883c72b06c8b9e010","drug_residue_report":"25faa0f9a5c641233c72b06c8b9e010"}A.3.6赋码激活数据接口鸡肉产品完成加工包装后，在赋码激活时调用本接口。在A.1基本接口调用形式的基础上，action赋值4.6,propData具体参数见表A.9。表A.9赋码激活数据接口描述请求方式POST请求URL/api/dch/v1参数标识参数名称数据类型备注outbatchcode屠宰批次编号String屠宰档案的唯一标识productcode认证产品编码String认证产品的唯一标识weight认证产品重量String单位：克产品认证码编号String其他接口参数(略)报文结构示例"appKey":"A10000001","timestamp":"1630376717","nonce":"A20D3F","sign":"39F2A0FB45B4E21BD21EF97F081C9E1A","action":"4.6","propData":{"outbatchcode":"202011150091","productcode":"52030197""weight":"8.5","labelcode":"A0200000002"}T/CAAA122—2023A.4企业视频监控信息采集接口该接口用于数字化认证平台基于appKey获取accessToken和accessToken的有效时间，需要企业提供appKey和appSecret,具体接口描述见表A.10。请求方式请求URL企业提供参数标识参数名称数据类型备注开发者标识企业提供appKey和appSecret时间戳接口调用时间戳，默认为当前时间随机数随机6位字母和数字的组合字符串MD5签名按照请求参数拼接成字符串，整体进行md5的32位加密，最终将结果的字母转换为大写请求参数示例"appKey":"A10000001","timestamp":"1630376717","sign":"39F2A0FB45B4E21BD21EF97F081C9E1A"返回结果示例{"code":200,//200:成功，300:失败"msg":"token获取成功","accessToken":"at.7jrcjmna8qnqg8d3dgnzs87m4v2dme31-32enpqgusd-1jvdfe4-uxo15ik0s","expireTime":1470810222045//token有效时间数字化认证平台基于企业视频监控设备ID获取该设备记录请求方式POST请求URL企业提供参数标识参数名称数据类型备注设备IDString设备唯一标识IDstartTime视频开始时间String视频开始时间