光明全程追溯管控平台详细设计说明书20180111

光明乳业全程追溯管控及追溯服务平台、产线赋码系统项目全程追溯管控平台-详细设计版本记录版本号版本描述责任人修订日期V1.0初版蒋旭峰2017-10-20V2.0终版蒋旭峰2017-12-8目录第一章系统总体设计 41.1总体逻辑图 41.2部署架构图 51.3说明 5第二章功能模块说明 62.1全程追溯管控平台接口 62.1.1牧场接口 62.1.2奶源接口 222.1.3MES接口 312.1.4WMS接口 772.1.5物流信息接口 852.2产品全程追溯管控平台系统 1042.2.1全程追溯数据查询 1042.2.2牧场追溯数据查询 1062.2.3生鲜乳运输追溯数据查询 1092.2.4生产过程追溯数据查询 1112.2.5仓储追溯数据查询 1112.2.6物流追溯数据查询 1162.3管控平台BI和综合展示系统 1182.3.1系统需求 1182.3.2基础数据分析 1192.3.3产业链追溯数据关系 1262.3.4BI决策分析 1312.3.5软件功能设计 162系统总体设计总体逻辑图全程追溯管控平台作为追溯应用和追溯数据的管理平台，用于收集、清洗和整理各子系统同步的追溯数据，提供产品的正向追踪和反向追溯功能。有牧场系统、MES、物流、WMS、ERP系统等通过接口将数据上报到数据共享系统，形成整个追溯管控平台的数据中心。通过BI工具将追溯数据整体分析，综合展示出来，给管理层提供决策数据。部署架构图ESB服务器提供ESB总线接口服务，各个子系统接口和数据采集接口注册到ESB。数据集成接口服务器提供各个子系统追溯数据的上报接口服务。全程追踪追溯系统服务器提供管理人员对追溯数据的查询和管理、查看数据集成共享数据库服务器提供数据集成共享系统手机的追溯数据的存储BI服务器提供数据集成共享数据库的建模和数据分析说明本文档中确认的字段接口仅用于模拟数据测试和接口联调，具体字段随着牧场、奶源、MES、WMS、和物流的实际建设情况进行调整。本文档中的展示系统页面是初稿，后续页面会更加光明相关部门和领导的反馈意见进行调整。功能模块说明全程追溯管控平台接口2.1.1牧场接口2.1.1.1接口列表【以列表方式简要说明表】：序号接口名称说明1牧场基本信息2消毒记录3饲养员信息4饲料记录5奶牛信息6转栏记录7免疫记录8用药记录9牧场奶仓CIP10饮用水监测11饮用水检测报告扫描件12奶牛检测报告13奶牛检验报告扫描件14临床检查记录15牧场挤奶信息16奶仓重量曲线详细说明牧场基本信息新增接口地址：/meadow/infoContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注Code牧场编码string(2)是Name名称string(16)是Province省string(6)是City市string(6)是District区string(6)是Address地址string(50)是ShortName简称string(20)是Manager负责人string(20)是Area面积(亩)int是CattleQTY牛数量int是MilkWeight产奶规模int是Level等级int是Latitude纬度float是Longitude经度float是Status状态bool是true/false更新接口地址：/meadow/infoContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法消毒记录新增接口地址：/meadow/disinfectionContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是OperationTime消毒时间string(19)是2017-09-2617:30:01Type消毒类型string(20)是Operator操作人姓名string(16)是饲养员信息新增接口地址：/meadow/breederContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是Name姓名string(16)是IDCard身份证号string(18)否Health健康情况string(10)是OperationDate入职年限string(10)是2017-09-26Postion岗位string(20)是更新接口地址：/meadow/breederContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法饲料记录新增接口地址：/meadow/fodderContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是CowshedCode牛舍编码string(6)是MaterielCode物料编码string(20)是MaterielName物料名称string(50)是Dosage用量float是OperationTime投料时间string(19)是2017-09-2617:30:01Operator操作人姓名string(16)是Supplier供应商string(50)是FodderBatch饲料批次号string(20)是奶牛信息新增接口地址：/meadow/cowContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是MeadowCode牧场编码string(2)是CowshedCode牛舍编码string(6)是MotherCode母号string(15)是FatherCode父号string(15)是GrandfatherCode外祖父string(15)是Birthday出生日期string(10)是2012-09-09DepartureDate离场日期string(10)否2017-09-26DepartureReason离场原因string(150)否IsGroup是否在群bool是true/false更新接口地址：/meadow/cowContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法转栏记录新增接口地址：/meadow/turnbarContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是OldCode转出舍号string(6)是NewCode转入舍号string(6)是Type转舍类型string(20)是免疫记录新增接口地址：/meadow/immuneContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是OperationTime日期string(19)是2017-09-2617:30:01Type免疫类型string(20)是Operator操作人姓名string(16)是Supplier生产企业或供应商string(50)是没有生产企业填供应商用药记录新增接口地址：/meadow/medicationContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是OperationTime日期string(19)是2017-09-2617:30:01DrugName药物名称string(20)是DrugCode药物编码string(20)是BatchNumber批次号string(20)是Dosage用量int是Unit计量单位string(20)是Operator操作人姓名string(16)是Supplier供应商或生产企业string(50)是没有生产企业填供应商牧场奶仓CIP新增接口地址：/meadow/meadowCIPContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是MilkSilosCode奶仓号string(20)是CIPItemsCIP数据json数组是CIPDateCIP日期string(10)是2017-09-26Operator操作人姓名string(16)是CIP数据(CIPItems)参数名描述类型必填备注Pressure压力float是Time操作时间string(19)是2017-09-2617:30:01Position位置string(20)是Temp温度float是PHPHfloat是饮用水监测新增接口地址：/meadow/drinkingWaterTestContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是OperationTime日期string(19)是2017-09-2617:30:01TestNo检验报告编码string(30)是TestItem检验项目text否将检验项目序列化成json格式{“检验项”:“检验值”}饮用水检测报告扫描件新增接口地址：/meadow/drinkingWaterTestReportContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注TestNo检验报告编码string(30)是TestImg扫描件byte是图片格式jpeg奶牛检验报告新增接口地址：/meadow/cowTestReportContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是TestNo检验报告编码string(30)是TestItem检验项目text否将检验项目序列化成json格式{“检验项”:“检验值”}二病检疫报告奶牛检验报告扫描件新增接口地址：/meadow/cowTestReportScanningCopyContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注TestNo检验报告编码string(30)是TestImg扫描件byte是临床检查记录新增接口地址：/meadow/clinicalContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注CowCode牛号string(8)是OperationTime日期string(19)是2017-09-2617:30:01TestResult检查结果string(50)是Operator操作人姓名string(16)是牧场挤奶信息新增接口地址：/meadow/milkingContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是MilkSilosCode奶仓号string(20)是CowCode牛号string(8)是CowshedCode牛舍string(6)是OperationTime挤奶时间string(19)是2017-09-2617:30:01QTY奶量int是Group挤奶班组string(10)否奶仓重量曲线新增接口地址：/meadow/silosWeightContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注MeadowCode牧场编码string(2)是MilkSilosCode奶仓号string(20)是Date重量数据日期string(10)是2017-01-01Items重量数据json数组是5分钟采集一次二级参数重量数据(Items)参数名描述类型必填备注Weight重量float是Time时间string(8)是17:30:012.1.2奶源接口2.1.2.1接口列表【以列表方式简要说明表】：序号接口名称说明1奶车保温实验报告2奶车信息3驾驶员信息4奶源运输2.1.2.2详细说明2.1.2.2.1奶车保温实验报告新增接口地址：/milking/truckInsulationTestReportContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注TrailerCode挂车号string(15)是OperationTime报告日期string(19)是2017-09-2617:30:01Temp环境温度float是MilkTemp初奶温度floot是T2424小时后温升float是Operator报告人姓名string(16)是2.1.2.2.2奶车信息新增接口地址：/milking/truckContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注LicenseNo车牌号string(15)是Ton奶车吨位int是Type奶车型号string(30)是LogisticsName物流公司名字string(50)是EXPDate准运证有效期string(10)是2017-01-01CardCode准运证编号string(30)是准运证扫描件上传接口地址：/meadow/quasiShipmentPermitContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注LicenseNo车牌号string(15)是LicenseImg准运证扫描件byte是文件格式jpeg2.1.2.2.3驾驶员信息新增接口地址：/milking/driverContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注IDCard身份证string(18)是Phone手机号string(11)是Name驾驶员姓名string(16)是HealthCode驾驶员健康证编号string(30)是EXPDate驾驶员健康证有效期string(10)是2017-09-26驾驶员健康证扫描件上传接口地址：/milking/healthContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注IDCard身份证string(18)是HealthImg健康证扫描件byte是文件格式jpeg2.1.2.2.4奶源运输新增接口地址：/milking/shippingContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注TransferCode生奶交接单号string(20)是TrailerCode挂车号string(15)是TruckCode车头号（车牌）string(15)是Destination去向工厂编码string(20)是ArrivalTime工厂到达时间string(19)是2017-09-2617:30:01UnloadTime卸奶时间string(19)是2017-09-2617:30:01DriverIDCard驾驶员身份证号string(18)是MilkTestReport生奶检验报告json数组是MilkCarRelation奶车奶槽和牧场奶仓关系json数组是SamplingTest取样检测json数组是GPS奶源运输GPS轨迹json数组是按比例尺缩放1km，采集TransportTemp在途温度json数组是1小时采集一次二级参数生奶检验报告（MilkTestReport）参数名描述类型必填备注MeadowCode牧场编码string(2)是OperationTime 日期string(19)是2017-09-2617:30:01InspectCode检测号string(50)是Weight重量(kg)float是Microorganism微生物（万）float是Alcohol酒精float是Acidity酸度int是Protein蛋白质float是Fat脂肪float是Solids总固形物float是Proportion比重string(10)是Freezing冰点float是Soma体细胞float是二级参数奶车奶槽和牧场奶仓关系（MilkCarRelation）参数名描述类型必填备注MeadowCode来源牧场编码string(2)是MilkTankNumber奶车奶槽号string(20)是MilkSilosCode牧场奶仓号string(20)是ArrivalTime到牧场收奶时间string(19)是2017-09-2617:30:01LeaveTime出牧场时间string(19)是2017-09-2617:30:01OpeningTime铅封开时间string(19)是OpeningNo开前铅封号string(30)是ClosingTime铅封封时间string(19)是ClosingNo封铅封号string(30)是二级参数取样检测（SamplingTest）参数名描述类型必填备注OperationTime 日期string(19)是2017-09-2617:30:01Operator检测人员姓名string(16)是二级参数奶源运输GPS轨迹（GPS）参数名描述类型必填备注Latitude纬度float是Longitude经度float是二级参数在途温度（TransportTemp）参数名描述类型必填备注Time时间string(8)是17:30:01Value温度值float是2.1.3MES接口MES接口里的CIP数据采集按1分钟间隔。即1小时有60条CIP数据所有CIP数据项参数定义参数名描述类型必填备注BeginTime开始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01Type清洗类型string(20)是酸洗，碱洗Temp温度float是Flow流量float是Conductance电导float是2.1.3.1奶源入库信息等所有CIP完成后调用新增接口地址：/MES/milkStorageContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注TransferCode生奶交接单号string(20)是FactoryCode工厂编码string(20)是BeginTime收奶开始时间string(19)是2017-09-2617:30:01EndTime收奶完成时间string(19)是2017-09-2617:30:01Operator收奶人员姓名string(16)是Items入库明细json数组是MilkJarCIP工厂收奶仓CIPjson对象是上一次所做的CIPMilkTestInfo奶源检测信息json数组是二级参数入库明细（Items）参数名描述类型必填备注MilkJarCode工厂收奶仓号string(20)是MilkTankNo奶车奶槽号string(20)是InQTY入库奶量int是MilkTemp收奶温度float是奶车奶槽的温度MilkJarCIPDate工厂收奶仓CIP清洗日期string(10)是2017-09-26MilkJarCIPItems工厂收奶仓CIPjson数组是当前收奶仓的CIP数据数据格式参考CIPItemsMilkTankCIP奶车奶槽CIP清洗日期string(10)是2017-09-26；MilkTankCIPItems奶车奶槽CIPjson数组是当前奶车奶槽的CIP数据数据格式参考CIPItems二级参数奶源检测信息（MilkTestInfo）参数名描述类型必填备注MilkTankNo奶车奶槽号string(20)是Operator取样人员姓名string(16)是OperationTime取样时间string(19)是2017-09-2617:30:01TestTime检验时间string(20)是2017-09-2617:30:01TestResult理化样text是按json字符串格式。包含以下字段：感官、酸度、酒精、脂肪、蛋白、非脂、总固体、凝结试验、油浴、E50TestOrg检测机构string(20)是TestOperator检验人员姓名string(16)是2.1.3.2原辅料1.3.2.1新增接口地址：/MES/MaterialContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注PurchaseOrderNo采购订单号string(20)是StorageDate入库日期string(10)是2017-09-26PurchaseOperator采购负责人string(10)是ContractNo合同编号string(20)是MaterialItems原辅料入库明细json数组是二级参数原辅料入库明细（MaterialItems）参数名描述类型必填备注MaterialCode原辅料编码string(16)是MaterialName原辅料名称string(16)是MaterialSpec原辅料规格string(16)是MaterialBatch原辅料批次string(16)是StorageQTY入库数量int是EXPDate保质期string(10)是SupplierCode供应商编码string(18)是2017-09-26SupplierName供应商名称string(50)是2原辅料检测报告新增接口地址：/MES/rawMaterial/TestReportContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注PurchaseOrderNo采购订单号string(20)是TestCode检测报告编码string(16)是TestReportName报告文件名string(18)是TestReportImg报告扫描件byte是文件格式jpeg2.1.3.3生产完成信息（生产工序）如果此产品的生产工序没有则可以不带此参数。如莫斯利安没有膜过滤工序，则膜过滤参数则无需。等生产完成后才调用此接口过程数据(温度、压力等)采集暂时按1分钟间隔定义参数定义参数名描述类型必填备注Time开始时间string(8)是17:30:01Value值float是新增接口地址：/MES/productionInfoContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注WorkOrderCode生产工单号string(20)是FactoryCode工厂编号string(20)是ProductName产品名称string(50)是ProductSpec产品规格string(20)是ProductCode产品编码string(20)是ProductBatch产品批次信息json数组是ProductWeight产品单位重量float是单位：gProductionDate生产日期string(19)是2017-09-26ProductEXP保质时间int是单位：天ProductionQTY生产数量int是最小包装单位的数量，如包LeaveTemp产品下线温度float是SupervisorName产品入库人员姓名string(16)是DeviceRelation工序关系json数组是TraceProduction生产溯源json对象是PickMaterial领料json对象是Delivery配料（缸）json对象是ConstantVolume定容(缸)json对象是Concentrate浓缩（设备）json对象是MembraneFiltration膜过滤（设备）json对象是TemporaryJar暂存缸（缸）json对象是InoculationFermentation接种发酵信息json对象是Presterilization预杀菌（缸）json对象是Degrease脱脂（设备、缸）json对象是MixedMilk混合奶（缸）json对象是AwaitJar待装缸（缸）json对象是Pasteurization巴氏杀菌（设备）json对象是SterilizationInfo杀菌信息（设备）json对象是SterileCylinder无菌缸（缸）json对象是Homogeneity均质（设备）json对象是MixingCylinder混料缸（缸）json对象是SingleCream稀奶油（缸）json对象是FillingInfo罐装信息json对象是二级参数批次信息（ProductBatch）参数名描述类型必填备注Batch产品批次号string(20)是生产批号QTY 灌装数量float是单位：吨二级参数工序关系（DeviceRelation）参数名描述类型必填备注Seq设备次序int是DeviceCode 当前设备编码string(20)是DeviceName当前设备名称string(20)是PreDevice前一工序设备编码string(20)是如果没有则空字符NextDeviceNo下一工序设备编码string(20)是如果没有则空字符Type工序类型int是1预杀菌（缸）、2暂存缸（缸）、3配料（缸）、4定容（缸）5、均质（设备）、6杀菌（设备）、7冷却（设备）、8接种发酵信息、9翻缸冷却（设备）、10待装缸（缸）、11巴氏杀菌（设备）、12无菌缸（缸）、13清洗消毒信息、14浓缩（设备）、15混合奶（缸）、16脱脂（设备、缸）、17膜过滤（设备）、18稀奶油（缸）、19混料缸（缸）二级参数生产溯源（TraceProduction）参数名描述类型必填备注MilkTankNo奶车奶槽号string(20)是TransferCode 生奶交接单号string(20)是FactoryMilkJarCode工厂收奶仓号string(20)是二级参数领料（PickMaterial）参数名描述类型必填备注PickMaterialCode领料单编码string(20)是Operator领料人员姓名string(16)是OperationTime领料时间string(19)是2017-09-2617:30:01PickMaterialItems领料明细json数组是三级参数领料明细（PickMaterialItems）参数名描述类型必填备注MaterialsCode原辅料编码string(20)是Num 领用数量int是Unit数量单位描述string(20)是如：克、千克等Batch原辅料批次string(20)是二级参数配料（缸）（Delivery）参数名描述类型必填备注DeviceCode设备编码（配料缸号）string(20)是MixTemp配料温度json数组是参考过程数据格式定义StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01Operator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是MixTime均质时间（搅拌时间）int是单位分钟。如20Chemical理化样text是按json字符串格式。包含以下字段：感官、酸度、脂肪、蛋白、非脂、总固体、蔗糖DeliveryItems投料项json数组是CIPItemsCIP数据项json数组是数据格式参考CIPItems三级级参数投料项（DeliveryItems）参数名描述类型必填备注MaterialsCode原辅料编码string(16)是MaterialsName原辅料名称string(16)是OperationTime投料时间string(19)是2017-09-2617:30:01Operator投料人姓名string(16)是DeliveryQTY投料数量float是Unit数量单位描述string(20)是如：克、千克等MaterialsBatch原辅料批次号string(20)是原辅料的产品批次号Reviewer复核人员姓名string(16)是二级参数定容（缸）（ConstantVolume）参数名描述类型必填备注DeviceCode设备编码（配料缸号）string(20)是StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01Temp定容温度json数组是参考过程数据格式定义MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等Operator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数浓缩（设备）（Concentrate）参数名描述类型必填备注SourceMilkJarCode来源生奶缸号string(20)是DeviceCode设备号string(20)是Temp温度json数组是参考过程数据格式定义StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01Operator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数膜过滤（设备）（MembraneFiltration）参数名描述类型必填备注DeviceCode设备编码string(20)是StartTime膜过滤起始时间string(19)是2017-10-1316:25:01EndTime膜过滤截止时间string(19)是2017-10-1319:25:01Flow流量L/Hjson数组是参考过程数据格式定义Temp温度℃json数组是参考过程数据格式定义Operator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数暂存缸（缸）（TemporaryJar）参数名描述类型必填备注DeviceCode设备编码（暂存缸号）string(20)是Temp温度json数组是参考过程数据格式定义StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数接种发酵信息（InoculationFermentation）参数名描述类型必填备注DeviceCode设备编码string(20)是Temp发酵温度（过程值）json数组是参考过程数据格式定义Hours发酵时间int是单位小时StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01EndAcidity终点酸度float是EndViscosity终端粘度float是Operator操作人员姓名string(10)是Reviewer复核人员姓名string(10)是MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、黏度、pH值、水合、脂肪、蛋白、总固体CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数预杀菌（缸）（Presterilization）参数名描述类型必填备注DeviceCode设备编码string(20)是Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、酒精、脂肪、蛋白、非脂、总固体MilkJarCode生奶缸号string(16)是StartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01SterilizationTemp杀菌温度json数组是参考过程数据格式定义ExitTemp出口温度json数组是参考过程数据格式定义HoldingTubeTemp保持管出口温度json数组是参考过程数据格式定义Operator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数脱脂（设备、缸）（Degrease）参数名描述类型必填备注DeviceCode设备编码string(20)是脱脂奶缸号MaterailQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等DegreasedChemical脱脂理化样text是按json字符串格式。包含以下内容：脂肪、蛋白MilkAndChemical生奶油理化样text是按json字符串格式。包含以下内容：脂肪HeatingEquNum加热设备号string(16)是HeatingTemp加热温度json数组是参考过程数据格式定义SeparatingEquNum分离机设备号string(16)是BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数待装缸（缸）（AwaitJar）参数名描述类型必填备注DeviceCode设备编码（暂存缸号）string(20)是Temp物料温度json数组是格式参考过程数据DataStartTime起始时间string(19)是2017-10-1316:25:01EndTime结束时间string(19)是2017-10-1319:25:01MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、黏度、pH值、水合、脂肪、蛋白、总固体CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数混合奶（缸）（MixedMilk）参数名描述类型必填备注DeviceCode设备编码string(20)是Temp物料温度json数组是格式参考过程数据DataBeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01Opreator操作人员姓名string(10)是Reviewer复核人员姓名string(10)是MaterailQTYBefore物料数量（混合前）float是MaterailQTYAfter物料数量（混合后）float是Unit数量单位描述string(20)是如：克、千克等Chemical理化样text是按json字符串格式。包含以下内容：脂肪、蛋白、非脂乳固体、酸度CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数巴氏杀菌（设备）（Pasteurization）参数名描述类型必填备注DeviceCode设备编码string(20)是Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、黏度、pH值、水合、脂肪、蛋白、总固体BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01SterilizeTime杀菌时间string(19)是2017-09-2617:30:01SterilizeTemp杀菌温度℃json数组是参考过程数据格式定义ExitTemp出口温度℃json数组是参考过程数据格式定义KeeperTransistorExitTemp保持管出口温度℃json数组是参考过程数据格式定义Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数杀菌信息（设备）（SterilizationInfo）参数名描述类型必填备注DeviceCode设备编码string(20)是Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、脂肪、蛋白、非脂、总固体、蔗糖BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01SterilizeTime杀菌时间string(19)是2017-09-2617:30:01SterilizeTemp杀菌温度℃json数组是参考过程数据格式定义ExitTemp出口温度℃json数组是参考过程数据格式定义KeeperTransistorExitTemp保持管出口温度℃json数组是参考过程数据格式定义Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数无菌缸（缸）（SterileCylinder）参数名描述类型必填备注DeviceCode设备编码string(20)是无菌缸号Chemical理化样text是按json字符串格式。包含以下内容：感官、酸度、黏度、pH值、水合、脂肪、蛋白、总固体Temp温度℃json数组是参考过程数据格式定义BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数均质（设备）（Homogeneity）参数名描述类型必填备注DeviceCode设备编码string(20)是BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01HomogeneityTemp均质温度℃json数组是参考过程数据格式定义Pressure均质压力Bar（过程值）string(200)是参考过程数据格式定义Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数混料缸（缸）（MixingCylinder）参数名描述类型必填备注DeviceCode设备编码string(20)是混料缸号MixTemp混料温度℃json数组是参考过程数据格式定义BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是MaterailQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等Chemical理化样text是按json字符串格式。包含以下内容：脂肪、蛋白、非脂乳固体、酸度CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数稀奶油（缸）（SingleCream）参数名描述类型必填备注DeviceCode设备编码string(20)是奶油缸缸号BeginTime起始时间string(19)是2017-09-2617:30:01EndTime结束时间string(19)是2017-09-2617:30:01Chemical理化样text是按json字符串格式。包含以下内容：脂肪Opreator操作人员姓名string(16)是Reviewer复核人员姓名string(16)是MeterialQTY物料数量float是Unit数量单位描述string(20)是如：克、千克等CIPItemsCIP数据项json数组是数据格式参考CIPItems二级参数罐装信息（FillingInfo）参数名描述类型必填备注DeviceCode设备编码string(20)是FillingCount灌装计数int是FillingCountUnit计数单位string(20)是FillingTemp灌装温度json数组是参考过程数据格式定义Operator操作人员姓名string(16)是OperationTime灌装开始时间string(19)是2017-09-2617:30:01EndTime灌装结束时间string(19)是2017-09-2617:30:01NetContent净含量string(10)是NetContentUnit净含量单位描述string(10)是NetContentTestTime净含量检测时间string(19)是2017-09-2617:30:01CloseTemp封合温度json数组是参考过程数据格式定义Pressure压力json数组是参考过程数据格式定义FillingEnvironment灌装间环境参数json数组是FillingTestReport罐装检验报告json数组是三级参数灌装间环境参数（FillingEnvironment）参数名描述类型必填备注Temp温度float是Humidity湿度float是PressureOffset压差float是SanitationTestResult卫生调查结果string(50)是Operator登记人员姓名string(16)是OperationTime登记时间string(19)是2017-09-2617:30:01三级参数罐装检验报告（FillingTestReport）参数名描述类型必填备注TestReportCode检验报告编码string(50)是ReportType检验报告类型int是1首件,2过程样,3末件,4目的样TestItemResult检验项目结果json数组是OperationTime检验时间string(19)是2017-09-2617:30:01Operator检验人员姓名string(16)是四级参数检验项目结果（TestItemResult）参数名描述类型必填备注TestItem检验项目string(20)是TestValue检验项目结果string(50)是2.1.3.4无菌样新增接口地址：/MES/sterileSampleContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注WorkOrderCode生产工单号string(16)是DeviceCode设备编码string(16)是Type工序类型int是1.预杀菌（缸）2.巴氏杀菌（设备）3.杀菌信息（设备）4.无菌缸（缸）TestResult无菌样检验数据text是字符串，按json格式。预杀菌包含以下内容：测芽孢、耐热芽孢巴氏杀菌（设备）包含以下内容：测菌落总数、大肠菌群、霉菌酵母菌、乳酸菌杀菌信息（设备）包含以下内容：测菌落总数、大肠菌群、霉菌酵母菌、芽孢、耐热芽孢无菌缸（缸）包含以下内容：测菌落总数、大肠菌群、霉菌酵母菌、乳酸菌2.1.3.5生产成品检验报告新增接口地址：/MES/productTestReportContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注ProductBatch产品批次号string(20)是生产批号TestTime检验时间string(19)是2017-09-2617:30:01TestNo检验合格证号string(20)是TestItemResult检验项目结果json数组是Reporter报告人员姓名string(16)是Auditor审核人员姓名string(16)是Approver批准人员姓名string(16)是Type报告类型int是1快检2正式报告二级参数检验项目结果（TestItemResult）参数名描述类型必填备注TestItem检验项目string(20)是TestValue检验项目结果string(50)是2.1.3.6生产成品留样信息新增接口地址：/MES/productLeaveContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注ProductBatch产品批次号string(20)是生产批号TestTime检验时间string(19)是2017-09-2617:30:01LeaveNum留样数量int是TestItemResult检验项目结果json数组是Reporter报告人员姓名string(16)是二级参数检验项目结果（TestItemResult）参数名描述类型必填备注TestItem检验项目string(20)是TestValue检验项目结果string(50)是2.1.4WMS接口2.1.4.1仓库信息新增接口地址：/wms/warehouseContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注Code仓库编码string(20)是此编码为ERP里的编码为准Name仓库名称string(20)是Address仓库地址string(50)是Province省string(20)是City市string(50)是District区string(50)是Type仓库类型int是1工厂仓2物流仓Status状态bool是true/false更新接口地址：/wms/warehouseContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法工厂入库新增接口地址：/wms/stockInContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注FactoryCode工厂编码string(20)是WarehouseCode仓库编码string(20)是ProduceOrderCode生产单号string(20)是WMSCode内部订单号string(20)是wms系统内部唯一编码OperationTime入库时间string(19)是2017-09-2617:30:01Type入库类型string(20)是Items入库明细json数组是入库明细（Items）参数名描述类型必填备注ProductCode产品编码string(20)是InQTY入库数量int是ProductBatch产品生产批次string(20)是ProduceDate产品生产日期string(10)是2017-09-26工厂出库新增接口地址：/wms/stockOutContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注WarehouseCode仓库编码string(20)是SaleOrder销售单号string(20)是WMSCode内部订单号string(20)是wms系统内部唯一编码ChainWarehouseCode出库分仓string(20)是OperationTime出库时间string(19)是2017-09-2617:30:01Type出库类型string(20)是Items出库批次信息json数组是DeliveryInfo出库客户信息json对象是出库客户信息（DeliveryInfo）参数名描述类型必填备注Code编码string(20)是Name名称string(50)是Province省份string(20)是City城市string(50)是District区string(50)是Address地址string(60)是Type类型1物流仓2经销商3商超4商贸5社区Level级别int否如果有级别则填（比如经销商）。1表示一级，以此类推出库批次信息（Items）参数名描述类型必填备注ProductCode产品编码string(20)是OutQTY出库数量int是ProductBatch产品生产批次号string(20)是ProductionDate产品生产日期string(19)是2017-09-26Operator放行人姓名string(16)是出库滞留新增接口地址：/wms/delayContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注WMSCode内部订单号string(20)是WarehouseCode仓库编码string(20)是SaleOrder销售单号string(20)是Reason滞留原因string(50)是ProductCode产品编码string(20)是ProductBatch产品批次string(20)是QTY滞留数量int是OperationTime滞留发生时间string(19)是2017-09-2617:30:01更新接口地址：/wms/delayContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法物流信息接口2.1.5.1分仓基本信息含中转仓新增接口地址：/logistics/warehouseContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注Code仓库编码string(20)是Name名称string(20)是Province省string(20)是City市string(50)是District区string(50)是Address地址string(50)是Area面积int是Manager负责人string(16)是Status状态bool是true:启用false:禁用更新接口地址：/logistics/warehouseContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法物流公司（承运商）信息新增接口地址：/logistics/logisticsCompanyContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注Code物流公司编码string(20)是Name物流公司名称string(50)是Address物流公司地址string(50)是Province省string(20)是City市string(50)是District区string(50)是更新接口地址：/logistics/logisticsCompanyContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法物流车辆信息新增接口地址：/logistics/truckContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注LicenseNo车牌号string(15)是LogisticsCode物流公司编码string(20)是RefrigerantType制冷剂型号string(100)是PermitNo运营证编号string(20)是每辆车的运营证EXPDate运营证到期日string(10)是2017-01-01更新接口地址：/logistics/truckContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法运营证扫描件上传接口地址：/logistics/operationCertificateContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注LicenseNo车牌号string(15)是PermitImg运营证扫描件byte是Jsp图片装卸工如果手机号变更，调用新增接口新增接口地址：/logistics/unloaderContentType：application/json请求方法：POST请求参数(json数组)：参数名描述类型必填备注Code员工编码string(20)是Phone手机号string(11)是LogisticsCode物流公司编码string(20)是Name姓名string(16)是HealthCode健康证编码string(30)是EXPDate健康证到期日string(10)是2017-09-26更新接口地址：/logistics/unloaderContentType：application/json请求方法：PUT请求参数(json对象)：参考新增方法健康证扫描件上传接口地址：/logistics/unloader/healthContentType：multipart/form-data请求方法：POST请求参数(bodyParam)：参数名描述类型必填备注UnloaderCode装卸工编码string(20)是HealthImg健康证扫描件byte是分仓入库信息新增接口地址：/logistics/stockInContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注WarehouseCode仓库编码string(20)是StockInCode入库单号string(19)是OperationTime入库时间string(19)是2017-09-2617:30:01LogisticsCode物流公司编码string(50)是SourceFactoryCode来源工厂编码string(19)是Items入库明细json数组是二级参数入库明细（Items）参数名描述类型必填备注ProductBatch产品批次string(20)是ProductCode产品编码string(20)是InQTY入库数量int是QTY当前在库数量int是当前入库时间时库存数量Temp入库产品温度float是分仓出库信息新增接口地址：/logistics/stockOutContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注WarehouseCode仓库编码string(20)是StockOutCode出库单号string(20)是OperationTime出库时间string(19)是2017-09-2617:30:01Operator出库人姓名string(16)是Items分仓出库明细json数组是DeliveryInfo出库客户json对象是收货人信息TransferCode中转仓编码json对象是二级参数分仓出库明细(Items)参数名描述类型必填备注ProductCode产品编码string(20)是ProductBatch产品批次string(20)StockOut出库数量int是OutTemp出库产品温度float是二级参数出库客户（DeliveryInfo）出库客户信息（DeliveryInfo）参数名描述类型必填备注Code编码string(20)是Name名称string(50)是Province省份string(20)是City城市string(50)是District区string(50)是Address地址string(60)是Type类型1物流仓2经销商3商超4商贸5社区Level级别int否如果有级别则填（比如经销商）。1表示一级，以此类推物流配送信息新增接口地址：/logistics/deliveryContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注DriverCode司机编码string(20)是UnloaderCode装卸工编码string(20)是LicenseNo车牌号string(15)是LogisticsCode物流公司编码string(20)是WarehouseCode出发分仓编码string(20)是OperationTime装车时间string(19)是2017-09-2617:30:01Temp装车前温度float是DeliveryItem配送终端明细json数组是DeliveryInfo出库客户json对象是Driver物流车司机json对象是TempData在途温度json数组是半小时采集一次GPS在途GPSjson数组是按比例尺缩放1km，采集二级参数配送终端明细（DeliveryItem）参数名描述类型必填备注DeliveryCode配送编码string(20)是StockOutCode出库单号string(20)是RetailCode终端编码string(20)是ProductBatch产品批次string(20)是ProductCode产品编码string(100)是ShippedQTY发货总数量int是ActualQTY实送总箱数int是ActualReceivedQTY实际接收数量int是DifferenceReason差异原因string(50)是ArrivalTime到达时间string(19)是2017-09-2617:30:01UnloadTime卸货时间string(19)是2017-09-2617:30:01二级参数出库客户（DeliveryInfo）出库客户信息（DeliveryInfo）参数名描述类型必填备注Code编码string(20)是Name名称string(50)是Province省份string(20)是City城市string(50)是District区string(50)是Address地址string(60)是Type类型1物流仓2经销商3商超4商贸5社区Level级别int否如果有级别则填（比如经销商）。1表示一级，以此类推二级参数物流车司机（Driver）参数名描述类型必填备注Code司机编码string(20)是Phone手机号string(11)是LogisticsCode物流公司编码string(20)是Name姓名string(16)是二级参数温度数据（TempData）参数名描述类型必填备注Time温度时间string(19)是当前温度时间Value温度数据float是二级参数温度数据（GPS）参数名描述类型必填备注Latitude纬度float是Longitude经度float是分仓温度新增接口地址：/logistics/warehousetempContentType：application/json请求方法：POST请求参数(json对象)：参数名描述类型必填备注warehouseCode仓库编码string(20)是Date温度日期string(10)是2017-01-01．当前日期，一天一次或者多次TempData温度数据json数组是1小时采集一次二级参数温度数据（TempData）参数名描述类型必填备注Time温度时间string(19)是当前温度时间Value温度数据float是产品全程追溯管控平台系统产品全程追溯管控平台系统包括：全程追溯数据查询、牧场追溯数据查询、生鲜乳运输追溯数据查询、生产过程追溯数据查询、仓储追溯数据查询、物流追溯数据查询、分析与决策共7部分。2.2.1全程追溯数据查询全程追溯数据查询包括：反向查询和正向查询两部分。两部分涵盖了追溯的全过程，追溯的产品信息到半产品信息再到奶源信息。反向查询：在反向查询中输入追溯码，系统后台根据追溯码链接到产品批次号快速定位产品信息，可查看该产品的完整质量信息；可快速定位到对应的产品编码、流向信息、工厂（MES）信息、奶源运输信息、牧场信息；通过工厂（MES）信息可展开工序流程，查看生产工序和操作人员看产品工序是否合格。展开产品信息可查看产品供应商。正向查询：在正向查询中产品批次、产品名称选择生产日期进行搜索，系统后台自动检索出产品列表信息；通过产品批次活名称快速定位到生产工单号、工厂编码、生产日期等详细数据；2.2.2牧场追溯数据查询牧场追溯数据查询：追溯牧场全部信息如牧场信息、牛舍信息、奶牛信息、消毒记录、饲养员信息、奶仓重量、奶仓CIP、饮用水检测。牧场信息查看：查看牧场的具体信息如牧场编号、牧场名称、牧场地址。牛舍信息查看：具体信息包括牛舍编码、饲料编码、饲料名称、饲料用量以及投料时间等。奶牛信息查看：具体信息包括如所属牧场、牛号、牛舍编码等。消毒记录查看：牧场消毒日期、消毒类型、操作人。饲养员信息：饲养员姓名、身份证号、健康情况、入职年限、岗位。奶仓重量：奶仓编号、操作。奶仓CIP：奶仓编号、CIP日期、CIP数据。饮用水检测：检验日期、检验项目。2.2.3生鲜乳运输追溯数据查询生鲜乳数据查询：主要查询生鲜乳运输追溯查询。输入交接单号或选择去向工厂，选择到达工厂时间进行生鲜乳运输搜索，可查看生奶交接单号关联到的驾驶员、奶车、挂车号、去向工厂、检验时间、检验人、生奶自检、工厂是否揽收等详细情况；通过驾驶员名字可查看驾驶员详细信息；通过奶车车头号可查看奶车详细信息以及历史运输记录；通过生奶自检可查看生奶自检详细信息；通过工厂是否揽收链接可查看入库详情。数据对接采集信息包括：牧厂生鲜乳存储罐编码、生鲜乳运输车编码、运输车辆号牌、车辆型号、吨位、车牌、所属物流公司、司机姓名、批次、运输日期、运出时刻、到达时刻、运抵企业GPS运输路线、实时温度监控。2.2.4生产过程追溯数据查询生产过程追溯指的是在产品生产过程中对生产各工序的具体信息进行追溯，具体的工序包括：杀菌，均质、配料等工序。每个工序的相关参数值都有所变化，例如：在杀菌工序应追溯到日期，杀菌时间，操作人员