农药追溯新标数据上报接口设计实战:32/34位编码规则与JSON接口规范落地指南

一、政策背景:农药追溯进入强制合规时代

2026年6月9日,农业农村部农药检定所正式发布《农药追溯编码规则及接口规范标准》征求意见稿,面向全行业公开征求意见,截止时间为2026年7月15日。这份标准首次将农药二维码编码生成规则与数据交换接口同时上升为农业行业标准,标志着农药追溯管理从"鼓励附码"全面升级为"强制合规"。

新标准的核心价值在于系统性地解决农药追溯体系中长期存在的三大顽疾:码从哪来(编码规则不统一)、数据往哪传(接口规范缺失)、格式怎么约定(数据标准混乱)。三者合一,真正打通农药生产、流通、经营的全链条数据闭环。

💡 合规倒计时

《农药追溯编码规则及接口规范标准》意见征集将于2026年7月15日截止。标准正式实施后,所有农药生产企业须按新规完成系统改造,否则将面临市场准入风险。

二、核心编码规则:32位/34位单元识别代码结构详解

新标准对农药二维码编码进行了统一规范,根据应用场景分为农药标签二维码(32位)和农药外包装二维码(34位)两种规格。

2.1 农药标签二维码编码结构(32位)

农药标签二维码由追溯网址与单元识别代码组成,其中单元识别代码采用32位阿拉伯数字,结构如下:

码段位置 位数 内容说明 编码规则
第1位 1位 登记类别代码 1=PD(正式登记);2=WP(卫生用药);4=EX(仅供出口)
第2-7位 6位 农药登记证号后6位 不足6位从中国农药信息网查询补齐
第8位 1位 生产类型 1=登记证持有人自产;2=委托加工;3=委托分装
第9-11位 3位 产品规格码 企业自行编制,体现产品规格差异
第12-32位 21位 随机码 包含校验码,验证追溯码正确性

2.2 农药外包装二维码编码结构(34位)

外包装二维码单元识别代码扩展至34位,在标签码基础上增加了2位包装层级码:

码段位置 位数 内容说明 编码规则
第1位 1位 登记类别代码 1=PD;2=WP;4=EX
第2-7位 6位 农药登记证号后6位 同标签二维码
第8位 1位 生产类型 同标签二维码
第9-11位 3位 产品规格码 同标签二维码
第12-13位 2位 包装层级码 01=最小包装;02=中转包装;03=运输外包装
第14-34位 21位 随机码 包含校验码

2.3 内外包装关联机制

新标准明确要求,农药产品存在内外包装的,内外包装二维码必须建立层级关联关系。这一设计彻底堵死了"刮码窜货"的操作空间——即使刮掉外包装码,内包装码仍可追溯完整流转信息。

三、数据交换接口规范:RESTful API + JSON标准

新标准采用RESTful API架构设计数据交换接口,统一使用JSON格式传输数据,确保跨系统互操作性。以下为标准定义的三类核心接口:

3.1 农药生产入库数据接口

生产入库接口用于农药生产企业在产品完成包装后,将生产批次信息上报至追溯系统。

// 农药生产入库数据上报接口示例 { "productionInfo": { "companyCode": "913701123070060012", // 企业统一社会信用代码 "productionLicense": "农药生许XXXX号", // 农药生产许可证号 "registrationNo": "PD20XXXX" // 农药登记证号 }, "productInfo": { "productName": "25%高效氯氟氰菊酯悬浮剂", "dosageForm": "SC", // 剂型代码 "specification": "100ml/瓶", "batchNo": "20260702A01", "productionDate": "2026-07-02" }, "codeInfo": { "outerCode": "1XXXXXX1XXX001XXXXXXXXXXX", // 外包装34位码 "innerCode": "1XXXXXX1XXX001XXXXXXXXXXX", // 内包装32位码 "codeRelation": "PARENT" // 关联关系 }, "quantity": 5000, "warehouse": "济南仓A区" }

3.2 农药经营入库数据接口

经营入库接口用于农药批发商、经销商在采购收货时,确认产品信息并上报入库数据。

// 农药经营入库数据对接接口示例 { "distributorInfo": { "companyCode": "91370100XXXXXXXX", "businessLicense": "农药经许XXXX号", "salesArea": "370100" // 授权销售区域代码 }, "supplierInfo": { "companyName": "XXXX农药有限公司", "traceCode": "供应商追溯码" }, "inboundInfo": { "inboundNo": "RK20260702001", "inboundDate": "2026-07-02T14:30:00+08:00", "productCode": "1XXXXXX1XXX001XXXXXXXXXXX", // 追溯码 "quantity": 500, "unit": "瓶" }, "storageLocation": "临沂仓-B区-03-05" }

3.3 农药经营出库数据交换接口

经营出库接口用于记录农药从经销商流向零售店或终端用户的交易数据,形成完整流通追溯链。

// 农药经营出库数据交换接口示例 { "salesInfo": { "salesNo": "CK20260702001", "salesDate": "2026-07-02T16:00:00+08:00", "salesType": "TO_RETAILER" // 销售类型 }, "buyerInfo": { "buyerName": "XXXX农资经营部", "buyerCode": "91370000XXXXXXXX", "areaCode": "370100" }, "productDetail": { "追溯码列表": [ "1XXXXXX1XXX001XXXXXXXXXXX", "1XXXXXX1XXX001XXXXXXXXXXY" ], "quantity": 100, "unitPrice": 15.50, "totalAmount": 1550.00 }, "logisticsInfo": { "transportNo": "物流单号", "gpsLocation": "36.6753,117.1205" } }

四、企业合规落地方案:五步完成系统改造

农药企业按照新标准完成合规改造,建议分五个阶段推进:

第一步:编码规则适配

升级现有农药二维码生成系统,按照新标准的32位/34位编码结构生成追溯码。关键要点是确保登记证号、规格码、生产类型等字段与官方数据一致。

第二步:内外码关联设计

建立内外包装层级关联数据库,记录每一级包装码与上级包装码的父子关系。生产环节完成赋码后,系统自动生成关联关系并上报。

第三步:API接口开发

按照标准JSON格式开发三类数据上报接口(生产入库、经营入库、经营出库),并实现数字签名认证机制,确保数据传输安全。

第四步:与监管平台对接

完成与省级农药监管平台或国家农药追溯系统的数据对接测试,确保上报数据格式完全符合标准要求。

第五步:全链路联调验证

进行生产、流通、零售全环节追溯链路测试,验证扫码查询信息完整性和数据上报及时性。

💡 技术选型建议

农药企业可选择自建追溯信息系统或对接专业第三方追溯平台。无论哪种方案,均需确保满足新标准的编码规则、接口规范和数据安全要求。建议优先考虑具备软硬件一体化能力的专业服务商,兼顾赋码效率和系统稳定性。

五、总结与展望

《农药追溯编码规则及接口规范标准》的发布,标志着农药行业数字化监管进入实质性执行阶段。32位/34位单元识别代码统一了"码从哪里来"的底层规则,RESTful API + JSON接口规范打通了"数据往哪里传"的技术路径,核心元数据标准解决了"格式怎么约定"的数据壁垒。

对于农药企业而言,2026年7月15日之前的意见反馈期是最后的声音表达窗口,而标准正式实施后的合规改造则是生存发展的必要投入。那些率先完成数字化部署的企业,将在渠道管控、防窜货预警、供应链金融等领域获得显著的竞争优势。

农药追溯体系的建立,不仅是监管合规的要求,更是企业构建数字化核心竞争力的战略机遇。在这场从"面子工程"到"真实透明"的变革中,每一家农药企业都需要认真思考:如何在合规框架内,通过技术手段实现产品全生命周期数据化管理,真正让每一瓶农药都有迹可循。

需要农药追溯系统建设支持?

硕创科技提供农药二维码软硬件一体化解决方案,助力企业合规落地追溯体系建设。

了解解决方案