《T_YNZYC 0103-2023 云南省中药材追溯体系 第3部分：数据接口规范.docx》由会员分享，可在线阅读，更多相关《T_YNZYC 0103-2023 云南省中药材追溯体系 第3部分：数据接口规范.docx（15页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、学兔兔标准下载ICS65.020.99CCSB00T/YNZYC云南省中药材种植养殖行业协会团体标准T/YNZYC01032023云南省中药材追溯体系第3部分：数据接口规范YunnanProvincialTraceabilitySystemofTraditionalChineseMedicinalMaterialsPart3:DataInterfaceSpecification2023-12-30发布2023-12-30实施云南省中药材种植养殖行业协会发布学兔兔标准下载T/YNZYC01032023前言本文件按照GB/T1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草
2、。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由云南省中药材种植养殖行业协会提出并归口。本文件起草单位：云南省中药材种植养殖行业协会、云南省商务厅、云南钰津供应链科技有限公司本文件主要起草人：苏豹、陈晓虹、张艳芳、吕秀田、丁剑、张雪、李艳、尹容梅、李学芬、胡俩剑、杨辉I学兔兔标准下载T/YNZYC01032023云南省中药材追溯体系第3部分：数据接口规范1范围本标准规定了云南省中药材追溯体系的术语和定义、追溯数据接口的总体要求、接口类型、接口关系、接口基本功能和参数等内容。本标准适用于构建云南省中药材追溯体系数据接口规范。2规范性引用文件下列文件中的内容
3、通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260中华人民共和国行政区划代码GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T38159重要产品追溯追溯体系通用要求中国药典3术语和定义下列术语和定义适用于本文件。3.1主体码subjectcode用于产品生产流通过程中识别主体身份的代码。按照身份主体的不同，分为流通节点主体码以及经营者主体码。4下列缩略语适用于本文件。HTTPS:超文本传输安全协议(HyperTextTransferProtocol
4、overSecureSocketLayer或HypertextTransferProtocolSecure)ID:标识符(Identifier)JSON:轻量级的数据交换格式(JavaScriptObjectNotation)5中药材追溯体系数据接口总体要求5.1通信协议应采用符合IETFRFC2818规定的HTTPS协议作为底层承载协议。5.2接口描述接口命名使用通用的驼峰命名方式，接口文本描述语言采用通用的JSON格式。2学兔兔标准下载T/YNZYC010320235.3编码字符集应采用IETFRFC3629规定的UTF-8字符集。5.4数据类型中药材追溯系统数据接口覆盖所能支持数据类型，
5、包括：字符串型（String）数字型（Number）时间型（Datetime）对象型（Objeck）数组型（Array）布尔型（Boolean）空（NULL）6中药材追溯体系数据接口类型中药材追溯系统数据接口主要包括下列类型：主体信息类，包括但不限于主体信息类参数；基地档案类，包括但不限于基地基本信息、基地环境信息、基地操作人员、基地管理人员等；追溯信息类，包括但不限于种源信息、种植信息、物料信息、采收信息、加工信息、仓储信息、销售信息、运输信息等；资料信息类，包括但不限于资料数据类。7中药材追溯体系数据接口关系图1中药材追溯体系数据接口关系图8中药材追溯体系数据接口基本功能和参数3字段名含义
6、数据类型必选/可选说明En_name企业名称String必选通过统一社会信用代码获取企业注册名称Unif_soci_cred_code社会统一信用代码String必选18位统一社会信用代码Legal_User_Name法人姓名String必选-Legal_Id_Card法人身份证号String必选企业法人身份证信息Contacts_Name联系人String必选-Contact_phone联系电话String必选区域代码（按GB/T2260中华人民共和国行政区划代码标准填写）Mailbox邮箱String必选-Office_address地址String必选具体到省、市、区、乡enterpri
7、seProperty企业属性String必选依据中药材属性将企业划分为药材种植和药材养殖型企业En_Operation业务类型String必选具体到种苗繁育、药材种植、产地初加工、药材经销En_img资质证照array必选将图片转为Base64编码格式存储Logo企业logoarray必选将图片转为Base64编码格式存储Account_opening_application_form开户申请表String必选将图片转为Base64编码格式存储字段名含义数据类型必选/可选说明BaseName基地名称String必选-CreatYear创建年份Number必选-BaseType基地类型Numbe
8、r必选1-种苗繁育；2-药材种植MedicineName植物名称String必选按照中国药典中的品名要求填写标兔学兔准下载T/YNZYC010320238.1主体信息类接口8.1.1功能用于监管平台查询企业基本备案信息。8.1.2参数主体信息类参数见表1。表1主体信息类参数8.2基地档案类接口8.2.1功能用于监管平台查询企业基地基本信息。8.2.2基地基本信息1)请求参数基地基本信息请求参数应符合表2的规定。表2基地基本信息请求参数4字段名含义数据类型必选说明baseCode基地编号String必选-soilId土壤类型Number必选-soilName土壤名称String必选-enviro
9、nmentCode环境编号String必选-phValuepH值String必选-headwaters水源Number必选1-井水；2-河流frostlessDay无霜期（天）String必选-accumu积温（摄氏度）String必选-hottest最热月平均气温String必选-hightTemperature土壤质地年绝对最高气温String必选-soilTexture土壤质地Number必选1-壤土；2-沙土；3-黏土organicContent有机质含量String必选-annualPre年降水量（单位mm）String必选-averageTem年平均气温String必选-colde
10、stTem最冷月平均气温String必选-minimumTem年绝对最低气温String必选-sunshine年日照时数（单位小时）String必选-picUrl图片地址array必选-picCode图片来源String必选-字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选说明baseCode基地编号String必选-标准兔学兔下载T/YNZYC010320232)响应参数基地基本信息响应参数应符合表3的规定。表
11、3基地基本信息响应参数8.2.3基地环境信息3)请求参数基地环境信息请求参数应符合表4的规定。表4基地环境信息请求参数4)响应参数基地环境信息响应参数应符合表5的规定。表5基地环境信息响应参数8.2.4基地操作人员信息5)请求参数基地操作人员信息请求参数应符合表6的规定。5字段名含义数据类型必选说明baseCode基地编号String必选-plantArea种植面积String必选单位：亩trueName姓名String必选-isPoverty是否贫困户Number必选操作员当前是否为贫困帮扶户（1-是；2-否）idCard身份证String必选-phone手机号String必选-type类型
12、Number必选1-带动就业；2-带动种植字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选说明trueName真实姓名String必选-phone手机号String必选-标学兔兔准下载T/YNZYC0103
13、2023表6基地操作人员信息请求参数6)响应参数基地操作人员信息响应参数应符合表7的规定。表7基地操作人员信息响应参数8.2.5基地管理人员信息7)请求参数基地管理人员信息请求参数应符合表8的规定。表8基地管理人员信息请求参数8)响应参数基地管理人员信息响应参数应符合表9的规定。表9基地操作人员信息响应参数8.3追溯信息类接口6字段名含义数据类型必选说明baseCode基地编号String必选-baseName基地名称String必选-medicineName药材名称String必选-latinName拉丁名String必选-pattern种植方式Number必选1-轮作；2-兼做；3-套种；
14、4-直播；5-移栽；6-其他propagatingType繁殖方式Number必选1-有性繁殖；2-无性繁殖；3-种子直播；4-分割繁殖；5-压条繁殖；6-扦插繁殖；7-嫁接繁殖；8-组培繁殖provenanceCode种源批号String必选-字段名含义数据类型必选说明plantationCode种植批号String必选关联种植信息的种植批次号missionCode任务编号String必选-plantationType任务类型Number必选1-播种；2-除草；3-移栽；4-虫害防治；5-灌溉；6-施肥；7-病害防治；8-种子、种苗处理；9-整地；10-其他字段名含义数据类型必选说明Code
15、响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功标学兔兔准下载T/YNZYC010320238.3.1功能用于监管平台查询企业追溯基本信息，不限于种源信息、种植信息、采收信息、加工信息、监测信息、销售信息、仓储信息、运输信息等。8.3.2种源信息9)请求参数种源信息请求参数应符合表10的规定。表10种源信息请求参数10)响应参数种源信息响应参数应符合表11的规定。表11种源信息响应参数8.3.3种植信息11)请求参数种植信息请求参数应符合表12-13的规定。表12种植
16、信息-添加任务请求参数表13种植信息-任务记录请求参数字段名含义数据类型必选说明7字段名含义数据类型必选说明materialName物料名称String必选-materialUrl物料缩略图String必选-materialType类型Number必选6-其他vender生产厂家String必选-province省份String必选-city市String必选-district区String必选-address详细地址String必选详细地址baseCode基地编号String必选-字段名含义数据类型必选说明Code响应状态码Number必选-TaskWeeding任务列表object必选查看
17、任务列表的返回参数说明文档plantationMission种植任务object必选-enOperationList物料集合array必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功accomplishment完成量String必选-trueName操作员姓名String必选-baseOperatorId操作员IDNumber必选-accomplishTime完成时间datetime必选符合GB/T7408中的日期格式要求picUrl图片array必选-字段名含义数据类型必选说明Code响
18、应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功兔学兔标准下载T/YNZYC0103202312)响应参数种植信息响应参数应符合表14-15的规定。表14种植信息-添加任务响应参数表15种植信息-任务记录响应参数8.3.4物料信息13)请求参数物料信息请求参数应符合表16的规定。表16物料信息请求参数1-消毒剂；2-生长调节剂；3-除虫剂；4-除草剂；5-肥料；8字段名含义数据类型必选说明baseCode基地编号String必选-recoveryCode采收批号Stri
19、ng必选-trueName操作员String必选-baseOperatorId操作员IDString必选-recoveryNum采收产量String必选保留两位小数，单位：kgrecoveryArea采收面积String必选单位：亩recoveryTime采收时间String必选符合GB/T7408中的日期格式要求picUrl图片array必选将图片转为Base64编码格式存储字段名含义数据类型必选说明processDictId采收部位字典IDNumber必选-recoveryWay采收方式Number必选1-人工采收；2-机器采收recoveryName采收部位String必选-totalA
20、rea采收总面积String必选单位：亩baseCode基地编号String必选-字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功标准兔学兔下载T/YNZYC01032023baseName基地名称String必选-14)响应参数物料信息响应参数应符合表17的规定。表17物料信息响应参数8.3.5采收信息15)请求参数采收信息请求参数应符合表18-19的规定。表18采收信息-药材采收（采收任务）请求参数表19采收信息-药材采收（采收记
21、录）请求参数9字段名含义数据类型必选说明baseCode基地编号String必选-recoveryCode采收批号String必选-trueName操作员String必选baseOperatorId操作员IDString必选recoveryNum采收产量String必选单位：Kg（保留两位小数）/株recoveryArea采收面积String必选单位：亩recoveryTime采收时间String必选符合GB/T7408中的日期格式要求picUrl图片array必选将图片转为Base64编码格式存储字段名含义数据类型必选说明recoveryWay采收方式Number必选1-人工采收；2-机器采
22、收seedType种源类型Number必选1-种子；2-种苗totalArea采收总面积String必选单位：亩baseCode基地编号String必选-weightUnit产量单位Number必选0-Kg；1-株growingYear采收年限String必选-字段名含义数据类型必选说明freshWarehouseCode鲜货批号String必选-medicineName药材名称String必选-processType加工类型Number必选1-内部原料；2-外部原料weight原料重量String必选单位：Kg字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Numbe
23、r必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功准标学兔兔下载T/YNZYC01032023表20采收信息-种源采收（新增种源）请求参数表21采收信息-种源采收（采收记录）请求参数16)响应参数采收信息请求参数应符合表22的规定。表22采收信息响应参数8.3.6加工信息17)请求参数加工信息请求参数应符合表23-24的规定。表23加工信息（加工任务）请求参数10字段名含义数据类型必选说明freshWarehouseCode外部鲜货编号String必选-medicineName药材名称String必选按照中国药典中的
24、品名要求填写recoveryNum采收产量String必选单位：Kg（保留两位小数）/株recoveryName采收部位String必选-startTime任务开始时间String必选符合GB/T7408中的日期格式要求accomplishTime完成时间String必选符合GB/T7408中的日期格式要求sourceAddr来源具体途径String必选-enterpriseCode企业编号String必选-freshAddr鲜货产地String必选详细地址字段名含义数据类型必选说明enterpriseCode企业编码String必选-medicineProcessCode加工批号String
25、必选-medicineName药材名称Number必选按照中国药典中的品名要求填写processName加工等级String必选-pageNum分包数Number必选-pageSize包装规格Number必选-plantName植物名称String必选按照中国药典中的品名要求填写字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选/可选说明medicineProcessCode加工批号String必选-process
26、Yield加工产量String必选单位：KgtechnologyDictId加工工艺ID列表array必选-学兔兔标准下载T/YNZYC01032023表24加工信息（任务记录）请求参数18)响应参数加工信息响应参数应符合表25的规定。表25加工信息响应参数8.3.7仓储信息19)请求参数仓储信息请求参数应符合表26-28的规定。表26仓储信息（鲜货入库）请求参数表27仓储信息（药材存储）请求参数11字段名含义数据类型必选说明seedType种源类型Number必选1-种子；2-种苗medicineName药材名称String必选按照中国药典中的品名要求填写weight重量String必选单位
27、：Kg（保留两位小数）/株comment备注String必选-startTime任务开始时间String必选符合GB/T7408中的日期格式要求accomplishTime完成时间String必选符合GB/T7408中的日期格式要求sourceAddr种源来源具体途径String必选-seedAddr种源产地String必选详细地址weightUnit重量单位Number必选0-Kg；1-株字段名含义数据类型必选说明saleCode销售订单号String必选saleType商品类型Number必选1-药材；2-种子；3-种苗；4-药材鲜货clientType客户类型Number必选1-内部；2
28、-外部clientName客户名称String必选-字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功标兔学兔准下载T/YNZYC01032023表28仓储信息（种源入库）请求参数20)响应参数仓储信息响应参数应符合表29的规定。
29、表29仓储信息响应参数8.3.8销售信息21)请求参数销售信息请求参数应符合表30的规定。表30销售信息请求参数22)响应参数销售信息响应参数应符合表31的规定。表31销售信息响应参数12字段名含义数据类型必选说明transportCode运输单号String必选-saleCode销售订单号String必选-enterpriseCode企业编号String必选-transportType运输方式String必选1-陆运；2-空运；3-水运transportTime发货时间String必选-字段名含义数据类型必选说明Code响应状态码Number必选-RST复位Number必选用于将指定的中断屏
30、蔽位复位为逻辑0，指令形式：RST1DescUI自动化报告参数String必选描述脚本执行内容为操作成功字段名含义数据类型必选说明fileType文件类型Number必选1-公共文件；2-企业文件fileName文件名称String必选-fileUrl文件地址String必选-标兔学兔准下载T/YNZYC010320238.3.9运输信息23)请求参数运输信息请求参数应符合表32的规定。表32运输信息请求参数24)响应参数运输信息响应参数应符合表33的规定。表33销售信息响应参数8.4资料信息类接口8.4.1功能用于企业平台存储相关资料信息。8.4.2参数资料信息类请求参数见表34。表34资料信息类参数13学兔标准兔下载T/YNZYC010320231