四川地方粮库数据接口规范平台库点06修订版.docx

四川地方粮库数据接口规范平台库点06修订版.docx

《四川地方粮库数据接口规范平台库点06修订版.docx》由会员分享，可在线阅读，更多相关《四川地方粮库数据接口规范平台库点06修订版.docx（208页珍藏版）》请在冰豆网上搜索。

四川地方粮库数据接口规范平台库点06修订版

四川省地方粮库数据接口规范（平台-库点）201906修订版

修订内容

1、网络环境要求

P5页。

安防视频连接要求：

新增域名解析+端口映射或VPN地址。

2、上报或更新业务数据

P10页，新增

2701：

账套信息数据上报服务

2702：

科目信息数据上报服务

2703：

科目余额数据上报服务

2704：

辅助核余额算数据上报服务

2705：

凭证信息数据上报服务

2706：

辅助核算管理数据服务

2707：

辅助核算部门信息数据服务

2708：

辅助核算个人信息数据服务

2709：

辅助核算单位信息数据服务

2710：

辅助核算项目信息数据服务

2711：

辅助核算仓房信息数据服务

2712：

辅助核算低值易耗品信息数据服务

2713：

辅助核算粮油品种信息数据服务

3、安全会议台账数据接口

P71页，新增

11

库区编号

kqbh

String（21）

18位统一社会信用代码+3位顺序号组成，必须是阿拉伯数字和大写英文字母组合而成的21位，相同的库区编码为一条数据，以最新上传的数据为准

4、安全培训教育台账数据接口

P72页，新增

21

库区编号

kqbh

String（21）

18位统一社会信用代码+3位顺序号组成，必须是阿拉伯数字和大写英文字母组合而成的21位，相同的库区编码为一条数据，以最新上传的数据为准

5、库点信息系统数据接口

P79页，新增

10

库区编号

kqbh

String（21）

18位统一社会信用代码+3位顺序号组成，必须是阿拉伯数字和大写英文字母组合而成的21位，相同的库区编码为一条数据，以最新上传的数据为准

6、熏蒸信息数据接口

P81页，新增

23

库区编号

kqbh

String（21）

18位统一社会信用代码+3位顺序号组成，必须是阿拉伯数字和大写英文字母组合而成的21位，相同的库区编码为一条数据，以最新上传的数据为准

7、设备信息数据接口

P88页，新增

41

库区编号

kqbh

String（21）

18位统一社会信用代码+3位顺序号组成，必须是阿拉伯数字和大写英文字母组合而成的21位，相同的库区编码为一条数据，以最新上传的数据为准

8、财务信息数据接口

P92页，新增

上报的数据类型

2701：

账套信息数据上报服务

2702：

科目信息数据上报服务

2703：

科目余额数据上报服务

2704：

辅助核余额算数据上报服务

2705：

凭证信息数据上报服务

2706：

辅助核算管理数据服务

2707：

辅助核算部门信息数据服务

2708：

辅助核算个人信息数据服务

2709：

辅助核算单位信息数据服务

2710：

辅助核算项目信息数据服务

2711：

辅助核算仓房信息数据服务

2712：

辅助核算低值易耗品信息数据服务

2713：

辅助核算粮油品种信息数据服务

9、视频追溯存储地址

P8页，视频信息接口地址：

新增FTP:

//10.100.100.100/D/SPZS。

P103页，新增FTP:

//10.100.100.100/D/SPZS。

10、出入库流水数据接口

P61页，视频流水号的描述：

18位统一社会信用代码+3位库区编码+8位日期+3位流水号。

P103页，文件命名规则：

视频文件名称以18位统一社会信用代码+3位库区编码+8位日期+3位流水号命名。

11、硬盘录像机所属厂家

P115页，新增

3

其他

编号：

密级：

普通商密

四川省地方粮库信息化建设数据接口技术规范（平台-库点）

四川省粮食和物资储备局

河南工业大学

2019年1月

版本记录

类别：

A-增加；M-修改；D-删除

日期

版本号

类别

修订说明

作者

1引言

1.1.目的

为了实现库点智能粮库软件系统（以下简称“库点软件”）与省级粮食管理平台（以下简称“省平台”）的互联互通，现将对接所需内容整理成此文档。

如有其他互联互通需求，以后可在此文档基础上继续完善。

1.2.网络环境要求

为了保证的实现库点软件与省平台的互联互通需要，更好的将业务数据以及视频信息上传到省平台端，库区的网络环境配置要求如下：

1、网络带宽要求

Ø支持互联网功能；

Ø上行带宽最少5Mbps，建议上行带宽10Mbps及以上；

2、VPN连接要求

Ø支持IPSECVPN功能；

3、安防视频连接要求

Ø固定公网IP+端口映射、域名解析+端口映射或VPN地址。

1.3.对接内容

目前涉及到库点软件与省平台的互联互通内容涉及到了以下几方面：

Ø业务信息：

单位信息、仓储信息、仓储检测设备集成信息、质检化验信息、出入库信息、财务信息等数据。

Ø视频信息：

视频数据、视频控制等数据。

详见2.2数据接口规范的描述。

1.4.信息安全

基于信息安全的考虑，省平台中涉及的用户名、密码、数字签名证书等与信息安全有关的内容均不在本文中体现。

2.

数据对接

2.1.数据对接方案

2.1.1.数据安全加密

数据上传过程中，主要考虑以下两点的安全性：

（1）对上传数据的用户需要进行身份鉴别，防止未经认证的用户提交数据；

（2）业务信息传输过程中，需要对数据进行加密，确保数据安全。

四川省粮食和物资储备局将为全省各行政机关、事业单位、企业提供VPN账户信息、数字证书设备，以及数据加密的通用要求。

库点软件向省平台传递业务信息时，需按照本规范指定的加密方法进行处理，加密方法及加密jar包详见附件1：

加密jar包方法。

2.1.2.数据上报流程

2.1.2.1.身份鉴别

通信过程如下图所示：

2.1.2.2.数据上报

通信过程如下图所示：

2.1.2.3.数据上报触发机制

库点软件数据上报需要由软件自动触发执行，不能由库点人员手工提交上报。

2.1.2.4.数据接口对接地址

ØVPN服务器地址：

http:

//202.61.91.31:

4600，账户信息另发。

Ø业务信息接口地址：

http:

//172.21.204.133:

8090/grainplatform/bussiness?

wsdl（VPN账户连接用）。

Ø视频信息接口地址：

http:

//121.46.26.36:

8060/grainplatform/bussiness?

wsdl。

FTP:

//10.100.100.100/D/SPZS。

2.1.2.5.数据上传时间要求

粮食及加工产品分类编码表：

classification_food_poroducts

（1）业务信息

实时上传。

（2）视频信息

每天按地区分时段上传视频数据，未上传完成数据第二天对应时段继续上传，上传时间分配如下：

地区

智能粮库数量

计划上传时间段

成都

20

0:

00-2:

00

自贡

4

0:

00-2:

00

攀枝花

9

2:

00-4:

00

泸州

8

2:

00-4:

00

德阳

18

4:

00-6:

00

绵阳

28

6:

00-8:

00

广元

26

8:

00-10:

00

遂宁

8

10:

00-12:

00

内江

17

12:

00-14:

00

乐山

22

14:

00-16:

00

南充

17

14:

00-16:

00

宜宾

14

2:

00-4:

00

广安

29

16:

00-18:

00

达州

21

18:

00-20:

00

巴中

26

20:

00-22:

00

雅安

12

4:

00-6:

00

眉山

17

12:

00-14:

00

资阳

5

0:

00-2:

00

阿坝

14

14:

00-16:

00

甘孜

20

22:

00-0:

00

凉山

20

10:

00-12:

00

批发中心

4

8:

00-10:

00

川粮集团

2

0:

00-2:

00

2.2.数据接口规范

2.2.1上报或更新基础数据

Ø服务请求方：

库点软件

Ø服务响应方：

省平台

Ø接口方法：

intsaveOrUpdateBasicInfo（byte[]jsonData,StringcheckData，intdataType,StringorgCode,StringentCode）

Ø请求/返回参数说明：

表名：

report_update_datatype_basics

表2-1上报、更新基础数据方法参数

参数说明

jsonData

经过加密以后，需上传的业务信息。

数据在组织时，以json格式组织。

数据格式请参见后续说明。

checkData

填写jsonDatabyte[]的大小。

dataType

上报的数据类型

1企业基础信息

2仓储单位数据

3库区基础信息

4仓房基础信息

5厫间基础信息

6油罐基础信息

7仓储设施基础信息

8化验条件基础信息

9货位信息基础信息

10保管人员基础信息

11验质人员基础信息

12储备规模基础信息

orgCode

库区国标编码

entCode

企业组织机构代码

返回值

请参照表2-2上报、更新业务数据方法参数的返回值说明

2.2.2上报或更新业务数据

Ø服务请求方：

粮库信息系统

Ø服务响应方：

省级管理平台

Ø接口方法：

intsaveOrUpdateBussinessInfo（byte[]jsonData,StringcheckData，intdataType,StringorgCode,StringentCode）

Ø请求/返回参数说明：

表名dataType：

report_update_datatype_business

表名返回值：

report_update_datatype_returnvalue

表2-2上报、更新业务数据方法参数

参数说明

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：

能耗信息

21：

库点信息系统

22：

药品信息

23：

熏蒸信息

24：

机械通风信息

25：

设备信息

26：

粮情检查记录

27：

财务信息

2701：

账套信息数据上报服务

2702：

科目信息数据上报服务

2703：

科目余额数据上报服务

2704：

辅助核余额算数据上报服务

2705：

凭证信息数据上报服务

2706：

辅助核算管理数据服务

2707：

辅助核算部门信息数据服务

2708：

辅助核算个人信息数据服务

2709：

辅助核算单位信息数据服务

2710：

辅助核算项目信息数据服务

2711：

辅助核算仓房信息数据服务

2712：

辅助核算低值易耗品信息数据服务

2713：

辅助核算粮油品种信息数据服务

28：

数量监测

29：

仓门（人员）预警

30：

摄像头信息

31：

视频接口

orgCode

库区国标编码

entCode

企业组织机构代码

返回值

0

上传成功

1

该单位没有上传的授权

2

数据解密失败

3

json数据格式不合法，解析失败

4

库点编码不合法

5

仓房厫间货位编码不合法

6

仓房厫间类型不合法

7

粮食品种编码不合法

8

粮食性质编码不合法

9

粮食等级编码不合法

10

化验指标编码不合法

11

收支指标编码不合法

12

关键字（返回）为空

13

没有数据

14

企业编码不合法

15

仓房编码不合法

16

未查询到解密秘钥

17

数据库连接错误

30

json数据超长

31

害虫类型错误

32

药品编码不合法

33

熏蒸方式编码不合法

34

通风类型编码不合法

35

通风方式编码不合法

36

通风目的编码不合法

37

通风机械编码不合法

38

计量单位不合法

39

设备状态不合法

40

设备类型不合法

41

化验类型不合法

42

事件类型不合法

43

堆装方式不合法

44

预警类型编码不合法

50

非数字粮库

94

接口未开放

96

数据类型不合法

97

数据重复上传，系统设定有“连续3次重复上传数据，将锁定账户3天，3天内无法上传数据”的限制条件

98

必填字段为空

99

其他错误

2.3数据接口分类说明

2.3.1企业基础信息

接口请求方式：

POST

接口请求数据类型：

JSON

接口字段内容：

序号

名称

Code

数据类型

说明

1

企业名称

qymc

String（128）

2

企业代码

qydm

String（18）

采用18位统一社会信用代码，必须是阿拉伯数字和大写英文字母组合而成的18位，不可空，相同的统一社会信用代码为一条数据，以最新上传的数据为准

3

企业性质

qyxz

String

（1）

1:

国有企业

2:

民营企业

3:

事业单位

4:

港澳台商投资企业

5:

外商投资企业

6:

其他内资企业

7:

个体工商户

9:

其他

（不可空）

4

企业类型

qylx

String

（2）

10:

粮食仓储企业

11:

中央直属储备粮库

13:

省级储备粮库

14:

地市级储备粮库

15:

县级储备粮库

19:

其他仓储企业

20:

粮食购销企业

30:

粮食加工企业

40:

粮食设备制造企业

90:

其他粮食企业

（不可空）

5

营业地址或个人住所

yydz

String（256）

（可空）

6

注册资本

zczb

Decimal（18,6）

默认-1。

单位：

万元（不可空）

7

资产总额

zcze

Decimal（18,6）

默认-1。

单位：

万元（不可空）

8

年加工量

njgl

Decimal（20,3）

默认-1。

单位：

吨（不可空）

9

主要加工品种编码

zyjgpzbm

String（64）

多个编码以英文逗号分割

10

年经营量

njyl

Decimal（20,3）

单位吨

11

主要经营品种

zyjypz

String（64）

多个编码以英文逗号分割

12

年收购量

nsgl

Decimal（20,3）

单位吨

13

主要收购品种

zysgpz

String（64）

参考多个编码以英文逗号分割，不足7位的在后面补0

14

自有资金

zyzj

Decimal（20,3）

默认-1。

单位：

万元

（不可空）

15

仓储容量

ccrl

Decimal（20,3）

默认-1。

单位：

吨

（不可空）

16

邮政编码

yzbm

String（6）

6位（不可空）

17

地址

dz

String（256）

18

法定代表人

fddbr

String（20）

（可空）

19

身份证号

sfzh

String（18）

法定代表人身份证号（可空）

20

法人联系方式

frsjh

String（20）

国内标准手机号码和座机号（可空）

21

企业联系人

qylxr

String（20）

（可空）

22

办公电话

bgdh

String（20）

（可空）

23

企业联系人电话

qylxrdh

String（20）

（可空）

24

传真

cz

String（20）

25

邮箱

yx

String（50）

26

上级机构id

sjjgid

String（50）

27

上级机构编码

sjjgbm

String（18）

28

是否仓储企业

sfccqy

String

（1）

Y：

是；N：

否

29

是否列入应急体系

sflryjtx

String

（1）

0：

否；

1：

是;

9:

暂无此值。

30

是否放心粮油

sffxly

String

（1）

Y：

是；N：

否

31

企业是否有效

qysfyx

String

（1）

Y：

是；N：

否

32

备案编码

babh

String（64）

（可空）

33

备案日期

barq

String（10）

格式：

yyyy-MM-dd（可空）

34

经度

jd

Decimal（10,6）

默认值：

-1；（不可空）

35

纬度

wd

Decimal（10,6）

默认值：

-1；（不可空）

36

审核人

shr

String（20）

37

审核状态

shzt

String

（1）

参见“3.25审核状态”

38

审核日期

shrq

String（10）

格式：

yyyy-MM-dd

39

业务类型

ywlx

String

（1）

参见“3.27主要业务”

40

隶属关系

lsgx

String

（2）

参见“3.26隶属关系”（不可空）

41

是否价格监测点

sfjgjcd

String

（1）

Y：

是；N：

否

42

手机号码

sjhm

String（18）

43

人数

rs

Integer

正整数，单位人

44

企业名称简称

qymcjc

String（120）

45

创建人

cjr

String（20）

46

创建人登录

cjrdl

String（10）

格式：

yyyy-MM-dd（可空）

47

更新人

gxr

String（20）

48

更新人登录

gxrdl

String（10）

格式：

yyyy-MM-dd（可空）

49

创建日期

cjrq

String（10）

格式：

yyyy-MM-dd（可空）

50

更新日期

gxrq

String（10）

格式：

yyyy-MM-dd（可空）

51

是否删除

sfsc

String

（1）

1：

删除

0：

不删除（可空）

空值默认为不删除

2.3.2仓储单位数据

接口请求方式：

POST

接口请求数据类型：

JSON

接口字段内容：

序号

中文名称

字段标识

数据类型

备注

1.

单位编码

dwbm

String（18）

18位统一社会信用代码，必须是阿拉伯数字和大写英文字母组合而成的18位，不可空，相同的统一社会信用代码为一条数据，以最新上传的数据为准

2.

单位名称

dwmc

String（128）

（不可空）

3.

单位性质

dwxz

String

（1）

1：

行政机关

2：

非参公管理事业单位

3：

参公管理事业单位

4：

国有及国有控股企业

5：

内资非国有企业

6：

私营企业

7：

港澳台商及外商企业

8：

个体工商户

（不可空）

4.

营业执照注册号

yyzzzch

String（50）

（可空）

5.

营业执照注册名称

yyzzzchmc

String（64）

单位名称（可空）

6.

法人代表

frdb

String（20）

（可空）

7.

法定代表人-办公电话

fddbrbgdh

String（20）

（可空）

8.

法定代表人-手机

rddbrsj

String（20）

11位标准手机号码（可空）

9.

电子邮箱

dzyx

String（50）

（可空）

10.

传真号码

czhm

String（32）

（可空）

11.

隶属关系

lsgx

String（18）

1:

中央企业

2:

地方企业

9:

其他

（不可空）

12.

主营业务

zyyw

String

（1）

1：

加工

2：

储备

3：

收纳

4：

中转

5：

特殊

9：

其他

（不为空）

13.

经营范围

jyfw

String（2048）

（不可空）

14.

农发行账户

nfhzh

String（32）

（可空）

15.

注册时间

zcsj

String（19）

格式为yyyy-MM-dd（可空）

16.

注册资本

zczb

Decimal（18,6）

默认值：

-1。

单位：

万元（不可空）

17.

从业人员人数

cyryrs

Integer

默认值：

-1。

（不可空）

18.

保管员人数

bgyrs

Integer

默认值：

-1。

（不可空）

19.

检化验员人数

jhyyrs

Integer

默认值：

-1。

（不可空）

20.

大专学历以上人数

dzysxlrs

Integer

默认值：

-1。

（不可空）

21.

有职业资格证书人数

yzyzgzsrs

Integer

默认值：

-1。

（不可空）

22.

中级以上职称人数

zjyszcrs

Integer

默认值：

-1。

（不可空）

23.

库区数

kqs

Integer

默认值：

-1。

（不可空）

24.

粮食库区数

lskqs

Integer

默认值：

-1。

（不可空）

25.

仓房数

cfs

Integer

默认值：

-1。

（不可空）

26.

有效仓容

yxcr

Decimal（20,3）

单位：

吨

（不可空）

27.

油脂库区数

yzkqs

Integer

默认值：

-1。

（不可空）

28.

油罐数

ygs

Integer

默认值：

-1。

（不可空）

29.

有效罐容

yxgr

Decimal（20,3）

默认值：

-1。

单位：

吨

（不可空）

30.

申请日期

sqrq

String（10）

格式为yyyy-MM-dd（可空）

31.

业务状态

ywzt

String

（2）

01：

未提交；

02：

备案待受理

03：

已备案；

04：

变更待受理

05：

已变更；

06：

停业待受理

07：

已停业；

08：

备案审核不通过；

09：

变更审核不通过；

10：

停业审核不通过

11:

其他

（不可空）