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

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

本项目主要实现粮库智能化管理平台与省粮食局一期

平台之间的数据交换，同时完成与全省智能粮库系统的数据

对接。

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通信控制J

粮库智能化管理平台作为接口服务的发布方，对外提供

接口服务；粮库系统服务接口作为粮库智能化管理平台接口

的调用方，通过定时请求方式，调用粮库智能化管理平台发

布的接口，完成与粮库智能化管理平台的通信。

粮库智能化管理平台接口提供两种服务应答模式：

（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其他错误

0无数据请求

1上传或更新仓储单位备案信息

2上传或更新货位管理信息

3上传或更新计划数据信息

4上传或更新客户数据信息

5上传或更新合同数据信息

6上传或更新出入库通知单管理信息

7上传或更新粮食实时库存信息

8上传或更新出入库业务信息

9上传或更新粮情检查记录信息

10上传或更新粮情监控信息

11上传或更粉纲管理信息

12上传或更新熏蒸管理信息

13上传或更新在库粮油质检信息

14上传或更新粮食数量监测信息

15上传或更新药剂管理信息

16上传或更新设备管理信息

17上传或更新视频监控信息

1.1.2.3上报或更新数据

服务请求方：粮库信息系统

服务响应方：粮库智能化管理平台

加密方式：VPN网络加密

接口方法：saveOrUpdateGrainDepotInfo(byte[]

jsonData,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上报企业基本信息数据方法的接口定义

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报企业基本信息方法参数

序号名称Code说明

enterpriseNa

*1企业名称

me

enterpriseCo需要遵照企业国标

*2企业编码

de编码填写

企业组织机构organization

3

代码证Code

参见“附录2:25企业

*4企业性质enterproperty

所有制性质”

行政区划编码，6位

*5省provinceld

数字

行政区划编码，6位

*6市cityld

娇

行政区划编码，6位

*7县countryld

数字

8邮政编码postalcode邮编，6位数字

9地址address

*10法人代表corporation

11联系电话phoneNo

12传真faxNo

13邮箱email

14上级机构idbelongld

15上级机构编码belongCode

16是否仓储企业isStorageY：是；N：否

17是否应急企业isEmergencyY：是；N：否

isAdministrat

18是否放心粮油Y：是；N：否

ive

*19是否有效isValidY：是；N：否

20经度longitude

21纬度latitude

22审核人auditName

参见“附录2:28审核

23审核状态auditState

状态”

日期格式：

24审核日期auditDate

yyyyMMddHHmmss

参见“附录2:27主要

25业务类型businessType

业务”

参见“附录2:26隶属

26隶属关系relateType

关系”

是否价格监测isPricemonit

27Y：是；N：否

八占、、oring

28手机号码cellPhone

threeCertifica

29三证合一

tes

30人数peoples正整数，单位人

enterprisesho

31企业名称简称

rtName

32创建人createName

33创建人登录createBy

34更新人updateName

35更新人登录updateBy

日期：

36创建日期createDate

yyyyMMddHHmmss

日期：

37更新日期updateDate

yyyyMMddHHmmss

1.1.2.4.2上报库点基本信息数据方法的接口定义

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报库点基本信息方法参数

序号名称Code说明

所属企业国标

*1enterpriseCode

编码

2库点名称graindepotName

参见“附录2:1

graindepotGbCo

3库点国标编码库点组织机构编

de

码”

4邮政编码postalcode邮编，6位数字

5地址address

6法人代表corporation

7联系电话phoneNo

8传真faxNo

9邮箱email

10经度longitude

11纬度latitude

12是否有效isValidY：是；N：否

13库区数gdCount正整数，单位个

仓房设计总容storeDesignCapa数字，保留两位，

14

量city单位吨

仓房实际总容storeActualCapa数字，保留两位，

15

量city单位吨

油罐设计总容oilcanDesignCa数字，保留两位，

16

量pacity单位吨

油罐实际总罐oilcanActualCap数字，保留两位，

17

容acity单位吨

具备原粮储备

18isStorageTitleY：是；N：否

资格（打孔）

19具备成品粮储isFinishTitleY：是；N：否

备资格（打孔）

20仓房总数storeCount正整数，单位个

21廉间总数warehouseCount正整数，单位个

22油罐总数oilcanCount正整数，单位个

23备注remark

数字，单位平方

24土地性质.划拨landAssign

米

数字，单位平方

25占地面积floorSpace

米

数字，单位平方

26土地性质_出让landSelJ

米

数字，单位平方

27土地性质—其他landOther

米

28土地出让价值landValue数字，单位万元

土地性质—闲置数字，单位平方

29landSpareSpace

空地面积米

土地性质一仓储landFacilitiesOl数字，单位平方

30

设施原值dValue米

数字，单位平方

31地坪信息—地坪terrace

米

地坪信息—铁路

32terraceRailway数字，单位米

专用线

地坪信息—有效

33terraceLength数字，单位米

长度

地坪信息.专用

34terraceWharf正整数，单位个

码头

机械信息.烘干

35engineCount正整数，单位个

机数量

机械信息.烘干数字，单位吨/

36engineAbility

能力小时

机械信息.烘干

37engineAgeLimit数字，单位年

机已使用年限

机械信息.谷物

38engineCooler正整数，单位台

冷却机

接收能力（吨/数字，单位吨/

39receive

小时）小时

接收能力.铁路数字，单位吨/

40receiveRailway

（吨/小时）小时

接收能力.公路数字，单位吨/

41receiveRoad

（吨/小时）小时

接收能力.其他数字，单位吨/

42receiveOther

（吨/小时）小时

接收能力.水路receiveWaterwa数字，单位吨/

43

（吨/小时）y小时

发送能力（吨/数字，单位吨/

44send

小时）小时

发送能力.铁路数字，单位吨/

45sendRailway

（吨/小时）小时

发送能力.公路数字，单位吨/

46sendRoad

（吨/小时）小时

发送能力.水路数字，单位吨/

47sendWaterway

（吨/小时）小时

发送能力.其他数字，单位吨/

48sendOther

（吨/小时）小时

保障技术.机械

49通风（仓数ensureAeration正整数，单位个

（个））

保障技术_环流

ensureFumigatio

50熏蒸（仓数正整数，单位个

n

（个））

保障技术.低温

ensureLowTemp

51储粮（仓数正整数，单位个

erature

（个））

保障技术.计算

ensureThermom

52机测温（仓数正整数，单位个

etric

（个））

保障技术_气调

ensureAtmosphe

53储粮（仓数正整数，单位个

re

（个））

信息化_业务管

54理系统（有/没itlsBusiness0：没有；1：有

有）

信息化_仓储管

55理系统（有/没itlsStorage0：没有；1：有

有）

信息化_自动化

56作业系统（有/itlsAuto0：没有；1：有

没有）

信息化_远程监

57管系统（有/没itlsRemote0：没有；1：有

有）

信息化_其他管

58理系统（有/没itlsOther0：没有；1：有

有）

行政区划编码,6

59省provinceld

位数字

行政区划编码,6

60市cityld

位数字

行政区划编码,6

61县countryld

位数字

62审核人auditName

参见“附录2:28

63审核状态auditState

审核状态”

日期格式：

64审核时间auditDateyyyyMMddHHm

mss

65图片1picture1

66图片2picture2

67上级机构idbelongld

68上级机构编码belongCode

developCompan

69开发单位

y

70手机号码cellphone

71最低库存量minStock数字，单位吨

72最IWJ库存量maxStock数字，单位吨

参见“附录2:29

73数据录入类型infoEditType

数据录入类型”

graindepotShort

74库点名简称

Name

75创建人createName

76创建人登录createBy

77更新人updateName

78更新人登录updateBy

日期：

79创建日期createDateyyyyMMddHHm

mss

日期：

80更新日期updateDateyyyyMMddHHm

mss

1.1.2.4.3上报仓房基本信息数据方法的接口定义

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报仓房基本信息方法参数

序号名称Code说明

所属企业国标

1enterprise_code

编码

参见“附录2:1库

所属库点国标graindepot_gb_

2点组织机构编

编码code

码”

storehouse_gb_

3仓房国标编码

code

storehouse__na

*4仓房名称

me

仓房类型编号storehouse__typ参见“附录2:3

*5

（立筒仓等）e仓房腰间类型”

storehouse_stat参见“附录2:30

*6仓房状态

e仓房状态”

01：散装;02：

7储粮方式store_way

包装

参见“附录2:31

8使用情况use_type

使用情况”

primary_servic参见“附录2:27

9主要业务

e主要业务”

design_capacit

10设计容量数字，单位吨

y

11实际容量actual_capacity数字，单位吨

12建成年份completed_year格式：YYYY

13经度longitude

14纬度latitude

参见“附录2:32

15仓房结构.地面ground

仓房结构”

参见“附录2:32

16仓房结构一墙体wall

仓房结构”

参见“附录2:32

17仓房结构—屋面roof

仓房结构”

18仓内长度（米）length数字，单位米

19仓内宽度（米）width数字，单位米

20檐口局度（米）height数字，单位米

21仓内直径（米）diameter数字，单位米

装粮线高度lade_line_heigh

22数字，单位米

（米）t

参见“附录2:33

保粮技术应用

23tech_state保粮技术应用”，

（打孔）

多个值用，拼接

24备注remark

行政区划编码，6

25省provice

位数字

行政区划编码，6

26市city

位数字

行政区划编码，6

27县country

位数字

28图片1storehouse_url

29图片2allstorehouse_u

rl

参见“附录2:34

30存储类型storagetype

存储资格”

31审核人audit_name

参见“附录2:28

32审核状态audit_state

审核状态”

日期格式：

33审核日期audit_dateyyyyMMddHHm

mss

34创建人createName

35创建人登录createBy

36更新人updateName

37更新人登录updateBy

日期：

38创建日期createDateyyyyMMddHHm

mss

日期：

39更新日期updateDateyyyyMMddHHm

mss

1.1.2.4.4上报廉间基本信息数据方法的接口定义

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报廉间基本信息方法参数

序号名称Code说明

所属企业国标编enterprise_

1

码code

参见“附录2:21

所属库点国标编graindepot_

2库点组织机构编

码gb_code

码”

所属仓房国标编storehouse_

3

码gb_code

warehouse_g

4席间国标编码

b_code

warehouse_n

*5感间名称

ame

6备注remark

doorimgur

7图片1

1

panoramaur

8图片2

1

9审核人audit_name

参见“附录2:28

10审核状态audit_state

审核状态”

日期格式：

11审核日期auditdate

yyyyMMddHHmmss

actual_capa

12席间实际仓容数字，单位吨

city

newtypeofSe

13新型传感器

nsor

14长length小数点2位

15宽width小数点2位

16高height小数点2位

17创建人createName

18创建人登录createBy

19更新人updateName

20更新人登录updateBy

日期：

21创建日期createDate

yyyyMMddHHmmss

日期：

22更新日期updateDate

yyyyMMddHHmmss

23省编码provice

24市编码city

25县编码country

1.1.2.4.5上报油罐基本信息数据方法的接口定义

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报油罐基本信息方法参数

序号名称Code说明

1企业国标编码entCode

参见“附录2:21库点

2库点国标编码orgCode

组织机构编码”

oilcanco

3油罐编码

de

oilcan_na

4油罐名称

me

5油罐规格ocformat

designed精度保留2位小数，单

6设计罐容

pacity位吨

actualca精度保留2位小数，单

7实际罐容

pacity位吨

精度保留2位小数，单

8油罐直径diameter

位米

精度保留2位小数，单

9油罐周度height

位米

ladeline精度保留2位小数，单

10装油线高度

height位米

primary_s参见“附录2:27主要

11主要业务

ervice业务”

参见“附录2:35油罐

12油罐状态ocstate

状态”

参见“附录2:31使用

13使用情况use_state

情况”

装备情况（打equipment参见“附录2:36油罐

14

孔）_state装备情况”

15经度longitude精度保留6位小数

16纬度latitude精度保留6位小数

17备注remark

18图片1picl

19图片2pic2

auditstat参见“附录2:28审核

20审核状态

e状态”

行政区划编码，6位数

21省provice

字

22市city行政区划编码，6位数

字

行政区划编码，6位数

23县country

字

construct

24建设年份格式：YYYY

ion_year

createNam

25创建人

e

26创建人登录createBy

updateNam

27更新人

e

28更新人登录updateBy

createDat日期：

29创建日期

eyyyyMMddHHmmss

updateDat日期：

30更新日期

eyyyyMMddHHmmss

1.1.2.5计划管理

上报计划数据

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报计划数据方法参数

序

名称Code说明

号

*1计划编号plannumber

*2计划标题plan_title

3计划描述plandesc

reference_nu

4计划文号

mber

客户计划执1收储计划；2销售

*5execute_type

行类型计划；3轮换计划

demandamoun

*6要求数量公斤制

t

7粮食年期grain_annual

收储完成数instore_coun单位公斤

8

量t

销售完成数outstorecou单位公斤

9

量nt

计划粮收储storage_pric单位：元/公斤

10

单价e

计划粮收储storage_begi格式：格式：

11

开始时间n_timeyyyyMMddHHmmss

12计划粮收储storage_end_格式：

截止时间timeyyyyMMddHHmmss

计划粮销售

13sales_price单位：元/公斤

价格

计划销售开sales_begin_格式：

14

始时间timeyyyyMMddHHmmss

计划销售截sales_end_ti格式：

15

止时间meyyyyMMddHHmmss

0未接收；1待提

customer_pla

16计划状态交;2正在执行；3

n_state

已结束

plan_custome

*17下达单位

r

计划隶属分plan_group_i

18

类编码d

计划隶属分plan_group_n

19

类名称ame

20创建人名称creater

需要符合标准，请参

*21粮食品种grain_kind见“附录2：4粮食品

种”

grain_attrib需要符合标准，请参

22粮食性质

ute见“附录2：5粮食性

质”

1.1.2.6客户管理

上报客户数据

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报客户数据方法参数

序

名称Code说明

号

true：代表个人客户，

*1客户分类classify

false：代表企业客户

*2客户编号customer_id

*3客户姓名name

客户联系

4address

地址

客户手机

5mobile

号码

identificat

6身份证

ion

7电子邮件email

8客户描述remark

企业性质GeneralProp

9

名称erty

开票信息

invoicetit

10（发票抬

le

头）

开户行名

11bankname

称

银行账户account_nam

12

名称e

account_num

13开户账号

ber

plant_acrea

14种植面积

ge

每亩的价单位为公斤：当启用价外

15外补贴数subsidy补贴是有用，用于计算价

量外补贴上限；

客户分组customer_gr

16

编码oupid

客户分组customer_gr

17

名称oupname

18客户所属district

地区名称

1.1.2.7合同管理

上报合同数据

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报合同数据方法参数

序

名称Code说明

号

contract_num

*1合同编号

ber

contracttit

*2合同标题

le

合同客户编

customer_id

*3号

合同客户名customer_nam

*4

称e

合同粮食单

*5grainjprice

价

*6合同粮食数grain_quanti

量ty

总金额：=合同规定

money_quanti

7总金额单价X合同规定

ty

数量

*8合同签订人signing_man

合同签订时格式：

*9signing_time

间yyyyMMddHHmmss

合同生效日格式：

10enabledate

期yyyyMMddHHmmss

合同截止日格式：

11disabledate

期yyyyMMddHHmmss

*12合同创建人createman

合同创建时格式：

*13create_time

间yyyyMMddHHmmss

0不是变更记录；1

合同的变更changerecor

14是原合同的变更记

记录标志d_flag

录

合同变更原changereaso

15

因n

contract_typ1收购合同；2销售

*16合同类型

e合同；3代储合同

17原合同编号original_con变更记录对应的原

tract合同编号

需要符合标准，请参

grain_attrib

18粮食性质见“附录2:5粮食性

ute

质”

需要符合标准，请参

*19粮食品种grain_kind见“附录2:4粮食品

种”

20粮食年期grainannual

contract_pay

21支付方式

-type

finishedqua

22已完成数量

ntity

money_of_fin

已完成数量

23ishedquanti

金额

ty

24合同备注remark

价外补贴启subsidy_effe

25单位为公斤

用下限ctivefloor

价外补贴上subsidyuppe

26单位为公斤

限r_limit

价外补贴的subsidy_unit

27单位为元/公斤

单价price

已经结算的

closedsubsi

28价外补贴数

dy_amount

量

每亩补贴数

29subsidy单位：千克/亩

量

客户种粮面

30plantAcreage单位：亩

积

31计划编号plannumber

1.1.2.8出入库通知单管理

1.1.2.8.1上报出入库通知单数据

方法名称：saveOrUpdateGrainDepotlnfo

请求参数：dataType,entCode,orgCode

返回值：参考返回值列表

上报数据列表：

表上报出入库通知单数据方法参数

序

名称Code说明

号

发货凭证标

*1bill_id

识

*2凭证类型billtype1入库凭证；2出库

凭证

格式：

*3开单日期billdate

yyyyMMddHHmmss

*4开单人名称billman

shiping_coun公斤或件

*5数量

t

finished_cou公斤或件

*6完成数量

nt

已收到总金received_mon

*7

额ey

提货单的提货单位；

delivery_cus

*8单位名称或者是发货单的发