粮库智能化升级改造项目数据交换共享建设方案.docx

粮库智能化升级改造项目数据交换共享建设方案本项目主要实现粮库智能化管理平台与省粮食局一期平台之间的数据交换，同时完成与全省智能粮库系统的数据对接。1.1.1 与一期平台对接系统根据用户的实际需求和管理要求，选择WebSerViCe接口方式和数据交换方式。1、WebSerViCe方式Web服务的体系结构是基于Web服务提供者、Web服务请求者、Web服务中介者三个角色和发布、发现、绑定三个动作构建的。简单地说，Web服务提供者就是Web服务的拥有者，它耐心等待为其他服务和用户提供自己已有的功能；Web服务请求者就是Web服务功能的使用者，它利用SOAP消息向Web服务提供者发送请求以获得服务;Web服务中介者的作用是把一个Web服务请求者与合适的Web服务提供者联系在一起，它充当管理者的角色，一般是UDDIo这三个角色是根据逻辑关系划分的，在实际应用中，角色之间很可能有交叉：一个Web服务既可以是Web服务提供者，也可以是Web服务请求者，或者二者兼而有之。显示了Web服务角色之间的关系:其中，“发布”是为了让用户或其他服务知道某个Web服务的存在和相关信息；“查找（发现）”是为了找到合适的Web服务；“绑定”则是在提供者与请求者之间建立某种联系。数据交换是由数据采集、数据传输和数据存储三部分组成。数据采集进行数据抽取和清洗，并形成加密的数据包;数据传输在接收到数据采集的请求后，根据全系统整体请求数量和链路拥堵情况，分配排队位置，进行数据传输；数据存储在接收到数据传输的请求后，去指定地址上获取数据包，并将数据包解密，整理数据格式存储到数据库中。最终实现数据交换传输的目的。1.1.2 粮库系统服务接口本项目建设粮库智能化管理平台及智能粮库系统软件,粮库硬件由库点自行建设。本项目智能粮库软件需要部署到各地市各粮库，软件开发商作为系统集成商，负责集成粮库系统软硬件，采集各粮库相关业务数据。粮库系统接口服务用来与粮库智能化管理平台提供的接口服务进行通信，将粮库系统中的业务数据上传到省粮库智能化管理平台。粮库系统服务接口上传的数据需要真实、可靠，数据上传需要由接口自动完成，不能由人工对数据进行修改后再上传。1.1.2.1通信机制1.1.2.1.1通信控制粮库智能化管理平台作为接口服务的发布方，对外提供接口服务；粮库系统服务接口作为粮库智能化管理平台接口的调用方，通过定时请求方式，调用粮库智能化管理平台发布的接口，完成与粮库智能化管理平台的通信。粮库智能化管理平台接口提供两种服务应答模式：(1)粮库系统服务接口主动调用粮库智能化管理平台接口进行数据上传。在这种模式下，通信服务调用过程如下图所示：粮库系统服务接口省级平台服务接口（2）粮库智能化管理平台主动请求粮库系统进行数据上传。粮库系统接口通过定时调用粮库智能化管理平台接口，接收粮库智能化管理平台的数据上传指令要求；接收到数据上传指令以后，粮库系统接口再调用粮库智能化管理平台对应的接口，上传对应的业务数据。在这种模式下，通信服务调用过程如下图所示：1.1.2.1.2安全机制数据上传过程中，主要考虑以下两点的安全性：（1）对上传数据的客户端需要进行认证，能够对数据上传方进行身份认证，防止未经认证的客户端提交脏数据，同时对己上传的数据不可抵赖；（2）在数据传输过程中，需要对数据进行加密，数据即使被截获也无法轻易破解，保证数据传输时的安全。由省平台提供统一的身份认证和安全加密机制。平台的对接开发单位，通过统一提供的加密控件和加密机制对数据加密，完成数据的安全上报。1.1.2.2 查询数据上报要求服务请求方：粮库信息系统服务响应方：粮库智能化管理平台加密方式：VPN网络加密接口方法：getDataRequestInfo（StringorgCode,StringentCode）请求/返回参数说明：表上报、更新数据方法参数请求参数说明entCode企业国标编码orgCode库点国标编码返回值-1该单位没有上传授权-2库点代码不合法-3企业ID校验失败（与省平台不匹配）-4数据库连接错误-5接口未开放-6访问超时-7其他错误O无数据请求1上传或更新仓储单位备案信息2上传或更新货位管理信息3上传或更新计划数据信息4上传或更新客户数据信息5上传或更新合同数据信息6上传或更新出入库通知单管理信息7上传或更新粮食实时库存信息8上传或更新出入库业务信息9上传或更新粮情检查记录信息IO上传或更新粮情监控信息11上传或更新通风管理信息12上传或更新熏蒸管理信息13上传或更新在库粮油质检信息14上传或更新粮食数量监测信息15上传或更新药剂管理信息16上传或更新设备管理信息17上传或更新视频监控信息1.1.2.3 上报或更新数据服务请求方：粮库信息系统服务响应方：粮库智能化管理平台加密方式：VPN网络加密接口方法：saveOrUpdateGrainDepotInfo(bytejsonData,StringCheckData,intdataType,StringorgCode,StringentCode)请求/返回参数说明：表上报、更新数据方法参数参数说明JsonData经过加密控件加密以后，需上传的业务数据。数据在组织时，以json格式组织。CheckData填写jsonDatabyte口的大小。dataType上报的数据类型1：企业数据上报服务2：库点数据上报服务3：仓房数据上报服务4：间数据上报服务5：油罐数据上报服务6：计划数据服务7：客户数据服务8：合同数据服务9：出入库通知单管理服务10：粮食实时库存服务11：出入库业务服务12：粮情检查记录服务13：粮情监控服务14：通风管理服务15：熏蒸管理服务16：在库粮油质检服务17：粮食数量监测服务18：药剂管理服务19：设备管理服务20：视频监控服务entCode加密后的企业国标编码orgCode加密后的库点国标编码返回值0上传成功1该单位没有上传授权2json数据格式不合法，解析失败3库点代码不合法4仓房感间货位编码不合法5粮食品种编码不合法6粮食性质编码不合法7粮食等级编码不合法8化验指标编码不合法9关键字（返回）为空10没有数据11企业ID校验失败（与省平台不匹配）12数据库连接错误13计量单位不合法14接口未开放15必填字段为空16访问超时17其他错误1.1.2.4 仓储单位备案管理服务1.1.2.4.1上报企业基本信息数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报企业基本信息方法参数序号名称Code说明*1企业名称enterpriseName*2企业编码enterpriseCode需要遵照企业国标编码填写3企业组织机构代码证organizationCode*4企业性质enterproperty参见“附录2:25企业所有制性质”*5省provinceld行政区划编码，6位数字*6市cityld行政区划编码，6位数字*7县CountryId行政区划编码，6位数字8邮政编码postalcode邮编，6位数字9地址address*10法人代表corporation11联系电话phoneNo12传真faxNo13邮箱email14上级机构idbelongld15上级机构编码belongCode16是否仓储企业isStorageY：是；N：否17是否应急企业isEmergencyY：是；N：否18是否放心粮油isAdministrativeY：是；N：否*19是否有效isValidY：是；N：否20经度longitude21纬度latitude22审核人auditName23审核状态auditState参见“附录2:28审核状态”24审核日期auditDate日期格式：YyyyMMddHHmmss25业务类型businessType参见“附录2:27主要业务”26隶属关系relateType参见“附录2:26隶属关系”27是否价格监测点isPricemonitoringY：是；N：否28手机号码CellPhone29三证合一IhreeCertificates30人数peoples正整数，单位人31企业名称简称enterpriseShortName32创建人CreateName33创建人登录CreateBy34更新人UpdateName35更新人登录UpdateBy36创建日期CreateDateH期：YyyyMMddHHmmss37更新日期UpdateDate日期：YyyyMMddHHmmss1.1.2.4.2上报库点基本信息数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报库点基本信息方法参数序号名称Code说明*1所属企业国标编码enterpriseCode2库点名称graindepotName3库点国标编码graindepotGbCode参见“附录2:1库点组织机构编码”4邮政编码postalcode邮编，6位数字5地址address6法人代表corporation7联系电话phoneNo8传真faxNo9邮箱email10经度longitude11纬度latitude12是否有效isValidY：是；N：否13库区数gdCount正整数，单位个14仓房设计总容量StoreDesignCapacity数字,保留两位，单位吨15仓房实际总容量StoreActualCapacity数字,保留两位，单位吨16油罐设计总容量OilcanDesignCapacity数字,保留两位，单位吨17油罐实际总罐容OilcanActualCapacity数字,保留两位，单位吨18具备原粮储备资格（打孔）IsStorageTitleY：是；N：否19具备成品粮储isFinishTitleY：是；N：否备资格（打孔）20仓房总数StoreCount正整数，单位个21感间总数WarehouseCount正整数，单位个22油罐总数OilcanCount正整数，单位个23备注remark24土地性质一划拨IandAssign数字，单位平方米25占地面积AoorSpace数字，单位平方米26土地性质一出让IandSell数字，单位平方米27土地性质.其他IandOther数字，单位平方米28土地出让价值IandValue数字，单位万元29土地性质.闲置空地面积IandSpareSpace数字，单位平方米30土地性质一仓储设施原值IandFacilitiesOldValue数字，单位平方米31地坪信息_地坪terrace数字，单位平方米32地坪信息.铁路专用线terraceRailway数字，单位米33地坪信息.有效长度terraceLength数字，单位米34地坪信息专用码头terraceWharf正整数，单位个35机械信息一烘干机数量engineCount正整数，单位个36机械信息一烘干能力engineAbility数字，单位吨/小时37机械信息.烘干机已使用年限engineAgeLimit数字，单位年38机械信息.谷物冷却机engineCooler正整数，单位台39接收能力（吨/小时）receive数字，单位吨/小时40接收能力.铁路（吨/小时）FeceiveRailway数字，单位吨/小时41接收能力.公路（吨/小时）receiveRoad数字，单位吨/小时42接收能力.其他（吨/小时）receivether数字，单位吨/小时43接收能力水路（吨/小时）FeceiveWaterway数字，单位吨/小时44发送能力（吨/小时）send数字，单位吨/小时45发送能力.铁路（吨/小时）SendRailway数字，单位吨/小时46发送能力.公路（吨/小时）SendRoad数字，单位吨/小时47发送能力.水路（吨/小时）SendWaterway数字，单位吨/小时48发送能力.其他（吨/小时）SendOther数字，单位吨/小时49保障技术.机械通风（仓数（个）ensureAeration正整数，单位个50保障技术一环流熏蒸（仓数（个）ensureFumigation正整数，单位个51保障技术.低温储粮（仓数（个）ensureLowTemperature正整数，单位个52保障技术.计算机测温（仓数（个）ensureThermometric正整数，单位个53保障技术.气调储粮（仓数（个）ensureAtmosphere正整数，单位个54信息化_业务管理系统（有/没有）ItIsBusiness0：没有；1：有55信息化_仓储管理系统（有/没有）itlsStorage0：没有；1：有56信息化_自动化作业系统（有/没有）itlsAuto0：没有；1：有57信息化_远程监管系统（有/没有）itlsRemote0：没有；1：有58信息化_其他管理系统（有/没有）itlsther0：没有；1：有59省provinceld行政区划编码,6三60市cityld行政区划编码,6位数子61县CountryId行政区划编码,6位数子62审核人auditName63审核状态auditState参见“附录2:28审核状态”64审核时间auditDate日期格式：YyyyMMddHHmmss65图片1picture166图片2picture?67上级机构idbelongld68上级机构编码belongCode69开发单位developCompany70手机号码cellphone71最低库存量minStock数字，单位吨72最IWJ库存量maxStock数字，单位吨73数据录入类型InfoEditType参见“附录2:29数据录入类型”74库点名简称graindepotShortName75创建人CreateName76创建人登录CreateBy77更新人UpdateName78更新人登录UpdateBy79创建日期CreateDate日期：YyyyMMddHHmmss80更新日期UpdateDate日期：YyyyMMddHHmmss1.1.2.4.3上报仓房基本信息数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报仓房基本信息方法参数序号名称Code说明1所属企业国标编码enterprise_code2所属库点国标编码graindepot_gb_code参见“附录2:1库点组织机构编码”3仓房国标编码StOrehoUSe_gb_code*4仓房名称storehouse_name*5仓房类型编号（立筒仓等）storehouse_type参见“附录2:3仓房感间类型”*6仓房状态storehouse_state参见“附录2:30仓房状态”7储粮方式store_way01：散装；02：包装8使用情况use_type参见“附录2:31使用情况”9主要业务primary_service参见“附录2:27主要业务”10设计容量design_capacity数字，单位吨11实际容量actual_capacity数字，单位吨12建成年份completed_year格式：YYYY13经度longitude14纬度latitude15仓房结构_地面ground参见“附录2:32仓房结构”16仓房结构一墙体wall参见“附录2:32仓房结构”17仓房结构一屋面roof参见“附录2:32仓房结构”18仓内长度（米）length数字，单位米19仓内宽度（米）width数字，单位米20檐口高度（米）height数字，单位米21仓内直径（米）diameter数字，单位米22装粮线高度（米）ladelineheight数字，单位米23保粮技术应用（打孔）tech_state参见“附录2:33保粮技术应用”，多个值用,拼接24备注remark25省provice行政区划编码，6位数字26市city行政区划编码，6位数字27县country行政区划编码，628图片1storehouse_url29图片2allstorehouse_url30存储类型storagetype参见“附录2:34存储资格”31审核人audit_name32审核状态audit_state参见“附录2:28审核状态”33审核日期audit_date日期格式：YyyyMMddHHmmss34创建人CreateName35创建人登录CreateBy36更新人UpdateName37更新人登录updateBy38创建日期CreateDate日期：YyyyMMddHHmmss39更新日期UpdateDate日期：YyyyMMddHHmmss1.1.2.4.4上报感间基本信息数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报廉间基本信息方法参数序号名称Code说明1所属企业国标编码enterprise_code2所属库点国标编码graindepot_gb_code参见“附录2:21库点组织机构编码”3所属仓房国标编码storehouse_gb_code4咸间国标编码warehouse_gb_code*5感间名称warehouse_name6备注remark7图片1door_img_ur18图片2panorama_ur19审核人audit_name10审核状态audit_state参见“附录2:28审核状态”11审核日期audit_date日期格式：YyyyMMddHHmmss12感间实际仓容actual_capacity数字，单位吨13新型传感器newtypeofSensor14长length小数点2位15宽width小数点2位16高height小数点2位17创建人CreateName18创建人登录createBy19更新人UpdateName20更新人登录UpdateBy21创建日期CreateDateH期：YyyyMMddHHmmss22更新日期UpdateDateH期：YyyyMMddHHmmss23省编码provice24市编码city25县编码country1.L2.4.5上报油罐基本信息数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报油罐基本信息方法参数序号名称Code说明1企业国标编码entCode2库点国标编码orgCode参见“附录2:21库点组织机构编码”3油罐编码oilcan_code4油罐名称oilcan_name5油罐规格oc_format6设计罐容design_capacity精度保留2位小数，单位吨7实际罐容actual_capacity精度保留2位小数，单位吨8油罐直径diameter精度保留2位小数，单位米9油罐图度height精度保留2位小数，单位米10装油线度lade_line_height精度保留2位小数，单位米11主要业务primary_service参见“附录2:27主要业务”12油罐状态oc_state参见“附录2:35油罐状态”13使用情况use_state参见“附录2:31使用情况”14装备情况（打孔）equipment_state参见“附录2:36油罐装备情况”15经度longitude精度保留6位小数16纬度latitude精度保留6位小数17备注remark18图片1picl19图片2pic220审核状态auditstate参见“附录2:28审核状态”21省provice行政区划编码，6位数字22市city行政区划编码，6位数字23县country行政区划编码，6位数字24建设年份construction_year格式：YYYY25创建人CreateName26创建人登录createBy27更新人UpdateName28更新人登录UpdateBy29创建日期CreateDate日期：YyyyMMddHHmmss30更新日期UpdateDate日期：yyyyMMddHHmmss1.1.2.5计划管理上报计划数据方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报计划数据方法参数序号名称Code说明*1计划编号plannumber*2计划标题plan_title3计划描述plan_desc4计划文号reference_number*5客户计划执行类型execute_type1收储计划；2销售计划；3轮换计划*6要求数量demand_amount公斤制7粮食年期grain_annual8收储完成数量instore_count单位公斤9销售完成数量outstore_count单位公斤10计划粮收储单价Storagejprice单位：元/公斤11计划粮收储开始时间storage_begin_time格式：格式：YyyyMMddHHmmss12计划粮收储storage_end_格式：截止时间timeYyyyMMddHHmmss13计划粮销售价格sales_price单位：元/公斤14计划销售开始时间sales_begin_time格式：YyyyMMddHHmmss15计划销售截止时间sales_end_time格式：YyyyMMddHHmmsS16计划状态customer_plan_state0未接收；1待提交；2正在执行；3已结束*17下达单位plan_customer18计划隶属分类编码plan_group_id19计划隶属分类名称plan_group_name20创建人名称creater*21粮食品种grain_kind需要符合标准，请参见“附录2：4粮食品种”22粮食性质grain_attribute需要符合标准，请参见“附录2：5粮食性质"1.1.2.6客户管理上报客户数据方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报客户数据方法参数序号名称Code说明*1客户分类classifytrue：代表个人客户，false：代表企业客户*2客户编号customer_id*3客户姓名name4客户联系地址address5客户手机号码mobile6身份证identification7电子邮件email8客户描述remark9企业性质名称GeneralProperty10开票信息（发票抬头）invoice_titIe11开户行名称bank_name12银行账户名称account_name13开户账号account_number14种植面积plant_acreag。15每亩的价外补贴数量subsidy单位为公斤：当启用价外补贴是有用，用于计算价外补贴上限；16客户分组编码customer_group_id17客户分组名称customer_group_name18客户所属district地区名称1.1.2.7合同管理上报合同数据方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报合同数据方法参数序号名称Code说明*1合同编号contract_number*2合同标题contract_titIe*3合同客户编号customer_id*4合同客户名称customer_name*5合同粮食单价grainprice*6合同粮食数grain_quanti量ty7总金额money_quantity总金额：二合同规定单价×合同规定*8合同签订人SigningJnan*9合同签订时间signing_time格式：YyyyMMddHHmmsS10合同生效日期enable_date格式：YyyyMMddHHmmss11合同截止日期disable_date格式：YyyyMMddHHmmss*12合同创建人create_man*13合同创建时间create_time格式：YyyyMMddHHmmss14合同的变更记录标志change_record_flag0不是变更记录；1是原合同的变更记录15合同变更原因change_reason*16合同类型contract_type1收购合同；2销售合同；3代储合同17原合同编号original_con变更记录对应的原tract合同编号18粮食性质grain_attribute需要符合标准，请参见“附录2:5粮食性质”*19粮食品种grain_kind需要符合标准，请参见“附录2:4粮食品种”20粮食年期grain_annual21支付方式contract_pay.type22已完成数量finishedquantity23已完成数量金额money_of_finished_quantity24合同备注remark25价外补贴启用下限subsidy_effective_fIoor单位为公斤26价外补贴上限subsidy_uppe单位为公斤27价外补贴的单价subsidy_unit_price单位为元/公斤28已经结算的价外补贴数量closed_subsidy_amount29每亩补贴数量subsidy单位：千克/亩30客户种粮面积PlantAcreage单位：亩31计划编号plan_number1.1.2.8出入库通知单管理1.1.2.8.1上报出入库通知单数据方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报出入库通知单数据方法参数序号名称Code说明*1发货凭证标识bill_id*2凭证类型bill_type1入库凭证；2出库凭证*3开单日期billdate格式：YyyyMMddHHmmss*4开单人名称bill_man*5数量shiping_count公斤或件*6完成数量finished_count公斤或件*7已收到总金额received_money*8单位名称delivery_customer提货单的提货单位；或者是发货单的发货单位*9粮食种类goods_kind*10合同编号contract11绑定的仓库warehouse12绑定的仓房货位goodsLocation13备注bill_memo1.1.2.9粮食实时库存管理服务上报实时库存数据方法的接口定义方法名称：SaveorUpdateGrainDepotInfo请求参数：dataType,entCode,orgCode返回值：参考返回值列表上报数据列表：表上报实时库存数据方法参数序号名称Code说明*1仓房国标编码Storehouse*2仓股编码house需要符合标准，请参见“附录2:2仓房版间货位编码”3货位编码allocation需要符合标准，请参见“附录2:2仓房版间货位编码”*4仓库状态status对应仓廉货位的状态：0：空仓状态；1：作业状态；2：保管状态；5保管账IDhouseStoreID从粮食入库开始，一直到出库结束，作为仓傲内的一批粮食的唯一标识。当仓库状态不为空仓时，此值不能为空；6粮食品种grainKind需要符合标准，请参见“附录2:4粮食品种”当仓库状态不为空仓时，此