粮库信息系统政策性粮食收购数据交换规范doc.docx
《粮库信息系统政策性粮食收购数据交换规范doc.docx》由会员分享，可在线阅读，更多相关《粮库信息系统政策性粮食收购数据交换规范doc.docx（33页珍藏版）》请在冰点文库上搜索。
粮库信息系统政策性粮食收购数据交换规范doc
粮库信息系统与政策性粮食收购
“一卡通"系统数据交换规范
（试行）
国家粮食局
二〇一八年三月
1。
目的及适用范围
为促进粮食行业信息化建设的健康发展，推进行业互联互通，避免地方粮库信息系统（简称“粮库系统”）和政策性粮食收购“一卡通"系统（简称“一卡通”系统）的重复建设，实现已建两个系统的信息共享，满足粮库生产经营、粮食行政主管部门行业管理和政策性粮食收购主体（中储粮等）业务监管需求，制订本规范。
本规范规定了政策性粮食购销过程中数据对接的方式、数据种类和内容、对接方法和流程.
本规范适用于政策性粮食购销过程中的数据共享，实现购销数据和支付审批结果的交换。
2。
规范性引用文件
（1）《国务院办公厅关于印发政务信息系统整合共享实施方案的通知》（国办发〔2017〕39号）
（2）《国务院关于印发政务信息资源共享管理暂行办法的通知》（国发〔2016〕51号）
（3）《粮食数据采集规范政策性粮食收购》LS/T1805—2016
（4）《国家粮食局关于规范粮食行业信息化建设的意见》（国粮财〔2016〕74号）
（5）《地方粮库信息化建设技术指引（试行）》（国粮办发〔2017〕217号）
3.名词术语
3。
1粮库系统
指安装在各地方粮库，具有粮食购销信息化管理功能的信息系统.
3.2“一卡通”系统
指安装在各地方粮库，用于政策性粮食收购的“一卡通"系统。
3。
3数据交换
指粮库系统和“一卡通”系统交换政策性粮食购销数据.
4.数据交换方案
为解决粮库系统和“一卡通”系统在粮库并行运行,造成粮库使用不便和重复建设的问题，通过两套系统对接,共享硬件资源进行信息采集和交换。
系统以一个为主，另一个为辅，主系统负责各项业务的办理并采集数据，推送给辅系统，辅系统将处理结果反馈给主系统。
根据主、辅系统的定位和数据流向,有两种方式供选择，各地可根据需要选择其中一种对接方式。
4。
1粮库系统为主
经省、市、县等粮食行政管理部门组织，并按照《地方粮库信息化建设验收规范（试行）》验收通过的粮库信息系统,可按照本对接方式进行政策性粮食数据共享交换。
粮库系统为主系统,负责粮库各项业务处理.按照本规范约定的格式将政策性粮食购销数据加密后生成压缩包，存放到指定的目录。
“一卡通”系统从相应目录获取数据,并将审核和付款等处理结果生成反馈文件，保存到相应目录,粮库系统再从相应目录获取反馈结果。
4。
2“一卡通”系统为主
“一卡通”系统为主系统,负责粮库各项业务办理。
按照本规范约定的格式将所有购销数据加密后生成压缩包，存放到指定的目录，粮库系统从相应目录获取数据。
5。
收购数据交换规范
5.1粮库系统为主
粮库系统每2～3小时（可自定义）将政策性粮食收购数据按照接口要求推送到指定的目录，“一卡通”系统到该目录定时抓取、解析，将数据报送至直属库“一卡通"系统。
直属库完成审核付款后，再将审核付款结果下发到收储库点“一卡通”系统中。
收储库点“一卡通”系统将收购数据的审核和付款等处理结果生成反馈文件,保存到相应目录,粮库信息系统按照接口规范到相应目录获取反馈结果。
5.1.1业务流程说明
业务流程见图5—1。
图5—1粮库系统为主的业务流程图
5.1。
1。
1新增收购单据
（1）粮库信息系统按照规定的频率（2～3小时，可自定义）将新生成的业务数据生成zip包存放在指定的目录（默认D：
/szlkjk/lkxtSend，可自定义，目录默认为隐藏）。
压缩包及其内部文件要求详见5。
1。
2.1、5。
1。
2.3。
（2）收储库点“一卡通”系统按照规定的频率（2～3小时，可自定义）在指定的目录读取zip文件，传送给直属库，同时将zip文件转存至指定的目录（默认D：
/szlkjk/backup/lkxtSend，可自定义,目录默认为隐藏）。
（3）直属库审核及付款信息发送到收储库点“一卡通”系统,“一卡通”系统将一条或多条反馈信息生成Excel文件,保存到指定目录（默认D:
/szlkjk/yktReturn，可自定义，目录默认为隐藏）。
反馈信息Excel文件命名规则及反馈信息字段说明见5。
1。
2。
2、5。
1.2。
5。
（4）粮库信息系统按照规定的频率（2～3小时，可定制）读取该Excel文件，同时将Excel文件转存至指定的目录（默认D：
/szlkjk/backup/yktReturn,可自定义，目录默认为隐藏）.
（5）反馈处理类型，详见5。
1。
2。
6。
（6）粮库信息系统按照规定的频率（1～3月，可定制）对D：
/szlkjk/backup/lkxtSend及D：
/szlkjk/backup/yktReturn中的文件进行清理。
（7）为了避免出现一个系统文件生成过程中另一个系统读取文件的问题,在压缩包生成后，再生成一个标志性文件.该文件同压缩包同名，后缀名为“.finish”，“一卡通”系统在读取文件时首先判定目录中是否包含“.finish”文件，包含时再进行读取，确保文件的完整性。
5。
1.1。
2变更（含作废）收购单据
（1）变更（含作废）收购数据和新增收购单据一并保存到Excel中,生成zip包后发送。
（2）变更操作：
“单据操作类型"为“1”,“单据状态”为“1”；所有字段均重新发送;涉及变更字段及变更说明在“备注"列说明，具体格式为：
变更字段及变更原因之间用“：
”分割，多项变更字段之间用“/"分割，详见示例。
（3）作废操作：
“单据操作类型”为“1”，“单据状态”为“0",“备注"中说明作废原因.其他列除“单据编号”及“校验码"外均无需发送。
5。
1。
2数据格式
5。
1。
2。
1粮库信息系统发送数据包
（1）粮库信息系统生成的数据包采取zip文件格式，包含1个收购数据Excel文件及若干个照片数据。
（2）每次发送均生成一个新的zip包文件，zip包文件命名格式为《XXXX年XX月XX日XXX粮库信息系统收购数据_X。
zip》（zip中XXXX年XX月XX日为生成zip包日期，XXX为库点名称，zip包最后一位编号为当日的数据包流水号，从“1”开始顺序依次增加，如2017年05月18日XX收储库粮库信息系统收购数据_1。
zip、2017年05月18日XX收储库粮库信息系统收购数据_2。
zip）。
（3）zip压缩包打开权限密码默认为“"，粮库系统及“一卡通”系统均支持自定义。
（4）收购数据Excel文件名称为：
《XXXX年XX月XX日XX时XX分XXX粮库信息系统收购数据.xls》，“XXXX年XX月XX日XX时XX分”为生成Excel文件的时间,使用24小时制，XXX为库点名称。
收购数据Excel文件内含一个工作表,该工作表可包含一行或多行收购数据，收购数据Excel文件的各列名称及说明见5.1。
2.4.
（5）为防止数据篡改，对数据文件和表内数据同时加密：
收购数据Excel文件中对每行数据均进行SHA（安全哈希算法）加密,生成校验码,存放在最后一列，同时采用DES（对称加密算法）算法对整个收购数据Excel文件进行加密，文件加密后，数据对用户不可见.“一卡通”系统读取文件后，先同样采用DES算法对收购数据Excel文件进行解密，再对其中每一行数据的校验码进行校验比对，比对通过后，进行后续操作，否则返回错误代码.其中DES的密钥需由双方系统约定,保持一致。
（6）收购数据Excel文件中各行收购数据所涉及照片数据存放在zip文件的照片目录中,目录名称为单据业务日期，如“"，照片内容及格式详见5。
1.2.3.
5。
1。
2.2“一卡通"系统反馈数据
1）“一卡通"系统反馈信息以Excel文件格式存放在指定文件夹。
2）反馈信息Excel文件名称格式为：
《XXXX年XX月XX日XX时XX分XXX反馈信息。
xls》，“XXXX年XX月XX日XX时XX分”为反馈时间，使用24小时制,XXX为库点名称。
3）粮库信息系统发送的每条收购业务数据，“一卡通"系统均生成一行反馈信息.反馈信息Excel文件包含一个工作表,其中可包含一行或多行反馈信息。
4）反馈信息的格式见5。
1。
2。
5。
5）为防止数据篡改，对数据文件和表内数据同时加密:
每行反馈记录均进行SHA（安全哈希算法）加密，生成校验码,存放在最后一列，同时采用DES（对称加密算法）算法对整个反馈记录数据文件进行加密，文件加密后,数据对用户不可见。
由粮库信息系统读取文件后,同样采用DES算法对文件进行解密,再对反馈文件中的每一行数据的校验码进行校验比对，比对通过后,进行后续操作,否则粮库信息系统提示人工干预。
其中DES的密钥需由双方系统约定，保持一致.
6）反馈文件的加密方式需和粮库信息系统发送数据包的加密方式保持一致。
5。
1。
2。
3照片内容格式
每行收购数据均对应7张照片，具体要求见表5—1.
表5—1照片数据要求
编号
图片名称
描述
大小
分辨率
1
业务日期_单据编号_CYRSFZTX。
JPG
承运人身份证照片
〈150KB
102＊126
2
业务日期_单据编号_KHSFZTX。
JPG
客户身份证照片
〈150KB
102*126
3
业务日期_单据编号_JS_1.JPG
结算环节照片
〈200KB
1024＊768
4
业务日期_单据编号_CM_1.JPG
称毛重时前摄像头拍摄的照片
〈200KB
640＊480
5
业务日期_单据编号_CM_2.JPG
称毛重时后摄像头拍摄的照片
〈200KB
640*480
6
业务日期_单据编号_CP_1。
JPG
称皮重时前摄像头拍摄的照片
〈200KB
640*480
7
业务日期_单据编号_CP_2。
JPG
称皮重时后摄像头拍摄的照片
〈200KB
640＊480
说明:
承运人身份证照片信息，从承运人身份证中读取；客户身份证照片信息,从客户身份证中读取。
前摄像头位于车的前上方,要求能够看清磅上车辆的车牌号及车的全貌,并能看清驾驶室全貌。
后摄像头位于车的后上方,要求能够看清磅上车辆的车牌号、车厢及车的全貌。
结算环节照片为结算时拍摄的客户或银行卡照片。
5.1。
2.4收购数据字段说明
收购数据字段说明见表5-2。
表5—2收购数据字段说明表
列名
业务涵义
示例
必填
单据操作类型
0：
新增，1:
变更
0
是
单据编号
每笔业务数据的唯一编号
RK_37003，格式为RK_+6位粮库编号+年月日+四位流水（19位）
是
库点名称
收储库点名称
XXX
是
品种
粮食的品种，取值按照GB1350—GB1353的品种编码
混合小麦
是
等级
粮食的等级，取值按照GB1350-GB1353的等级编码
二等
是
客户名称
客户名称（粮权所有者，即收款人）
张三
是
客户身份证号
客户身份证号
377…
是
客户地址
客户身份证上的地址
XX市XX区XX村XX号
否
承运人姓名
承运人姓名（送粮人）
李四
是
承运人身份证号
承运人身份证号
3783…
是
客户联系电话
客户联系电话
…
否
仓房编号
仓房编号
1号仓
是
货位编号
货位编号
2号位
否
货位容量
货位容量
3000
否
收获年度
粮食的收获年度
2016
是
库存性质
最低收购价、国家临时存储
最低收购价
是
业务日期
粮食入库的日期,如果跨天,则取净重确认时间
是
粮食国别
粮食国别
中国
是
产地代码
国家统计局下发的县级及以上行政区划代码
130128
是
车船号
车牌号或者轮船号
苏AXXXXX
是
毛重
粮食的毛重
4500
是
皮重
粮食的皮重
1200
是
其它扣量
其它扣量
0
是
结算数量
毛-皮—其它扣量-各检验项目扣量
3126
是
入门登记员
流程操作人员
…
是
出门登记员
流程操作人员
…
是
毛重检斤员
流程操作人员
…
是
皮重检斤员
流程操作人员
…
是
保管员
流程操作人员
…
是
扦样员
流程操作人员
…
是
检验员
流程操作人员
…
是
水分
各检验项目指标、扣量数量、扣量比例％
13
是
扣水分比例
1
是
扣水分数量
33
是
杂质
2
是
扣杂质比例
3
是
扣杂质数量
99
是
不完善粒
9
品种为小麦和玉米时，必填
扣不完善粒比例
0。
5
扣不完善粒数量
17
容重
780
品种为小麦和玉米时，必填
出糙率
0
品种为稻谷时,必填
整精米率
0
品种为稻谷时，必填
扣整精米率比例
0
扣整精米率数量
0
色泽气味
正常
是
黄粒米
0
品种为稻谷时,必填
黄粒米扣量比例
0
黄粒米扣量数量
0
谷外糙米
0
品种为稻谷时，必填
谷外糙米扣量比例
0
谷外糙米扣量数量
0
其中生霉粒
0
品种为玉米时，必填
生霉粒扣量比例
0
生霉粒扣量数量
0
其中矿物质
1
品种为小麦时,必填
其中矿物质扣量比例
0。
75
其中矿物质扣量数量
25
硬度
65
品种为小麦时，必填
互混率
0
品种为稻谷时，必填
互混率扣量比例
0
扣互混率数量
0
检验时间
检验结果录入时间，格式为yyyy-MM—dd（空格）HH:
mm:
ss。
下同。
2015-01—0112：
36：
55
是
称毛时间
毛重录入时间
2015—01—0113：
16:
55
是
称皮时间
皮重录入时间
2015—01—0115:
16:
51
是
发票号码
单据的发票号码
XXX
否
发票状态
正常发票、作废发票
正常发票
否
库点税号
库点的纳税识别号
2369
否
发票代码
发票代码
2300153350
否
银行代码
102中国工商银行
103中国农业银行
104中国银行
105中国建设银行
314农村商业银行
402农村信用合作社
403中国邮政储蓄
999其它银行
103
是
开户行号
银行卡的开户行号
XXX
是
开户行名称
银行卡的开户行名称
XXX
是
银行卡号
银行卡号
XXX
是
标准单价
粮食的标准单价
2.36000
是
扣价信息
检验项目1:
扣量单价；检验项目2:
扣量单价;注：
标点用英文
否
结算单价
结算的单价
2。
36000
是
售粮人结算价款（结算单价＊结算数量）
售粮人结算金额
7377.36
是
总结算价款（标准单价＊结算数量）
总结算金额
7377.36
是
结算员姓名
结算环节人员姓名
XXX
是
结算时间
年月日时分秒,格式为yyyy—MM—dd（空格）HH:
mm：
ss。
2015—01—0112：
12：
20
是
单据状态
1：
正常；0:
作废
1
是
备注
补充说明
水分:
录入错误/毛重：
违规重称
否
校验码
以上所有列，按照Excel中的顺序拼接字符串，然后使用SHA（安全哈希算法）进行加密
Xxxxxxxxxxx
是
5。
1。
2。
5反馈信息字段说明
反馈信息字段说明见表5—3。
表5-3反馈信息字段说明表
列名
业务涵义
示例
单据编号
每笔业务数据的唯一编号，需和粮库系统发送的单据编号一致。
RK_37003，格式为RK_+6位粮库编号+年月日+四位流水（19位）
库点名称
收储库点名称
XXX库点
业务日期
粮食入库的日期
返回状态
详见表4返回状态说明
05
返回信息
对返回状态进行补充说明
已支付,无法变更
校验码
以上所有列，按照Excel中的顺序拼接字符串,然后使用SHA（安全哈希算法）进行加密
Xxxxxxxxxxx
5。
1。
2。
6返回状态说明
返回状态说明见表5—4.
表5-4返回状态说明表
返回状态
状态说明
处理方式
00
处理完成
01
未找到需变更单据
根据“单据编号”重新传输原始单据
02
校验码不匹配
根据“单据编号"重新发送相应收购数据
03
数据不合法
具体字段及原因位于“返回信息”.粮库系统检查调整后再次发送
04
扣量扣价未验证通过
粮库系统重新进行扣量扣价计算后,再次发送。
发送时，“单据操作类型”为“变更”
05
无法变更
具体原因位于“返回信息”
06
密码错误
检查确认约定的密码
07
文件无法正常打开
粮库信息系统重新推送数据
99
其它错误，请联系运维人员排查
具体错误信息位于“返回信息"
5。
1。
2。
7其他说明
（1）计量单位及精度：
1）数量：
公斤，整数。
2）单价：
元/公斤，五位精度。
3）金额：
元，两位精度。
4）容量：
吨,三位精度。
5）水分：
%，一位精度。
6）杂质：
％,一位精度。
7）不完善粒：
%,一位精度.
8）出糙率：
%，一位精度。
9）整精米率:
％，一位精度.
10）水分及挥发物:
％，一位精度。
11）不溶性杂质：
％,一位精度.
12）酸值：
mg/g,一位精度.
13）过氧化值:
mmol/kg,一位精度.
14）溶剂残留量:
mg/kg，一位精度。
15）黄粒米：
％，一位精度.
16）谷外糙米:
%，一位精度。
17）纯粮率:
％，一位精度。
18）其中生霉粒：
％，一位精度。
19）其中矿物质:
%,一位精度。
20）互混率:
%，一位精度。
21）热损伤粒：
％,一位精度.
22）含油量：
%，一位精度.
23）未熟粒:
％，一位精度。
24）生芽粒:
％，一位精度。
（2）所有的符号使用半角字符.
（3）文件名命名采用gb2312字符集.
（4）Excel版本不高于2013版。
5.2“一卡通"系统为主
“一卡通”系统为主系统，负责各项业务办理.“一卡通”系统将所有收购数据打包推送到指定的目录,由粮库系统到约定的目录抓取、解析数据包.
5。
2.1业务流程说明
“一卡通"系统为主的业务流程图如下：
图5-2“一卡通”系统为主的业务流程图
5。
2。
1。
1新增收购单据
（1）“一卡通"系统提供收购数据推送功能,每日定时（时间支持自定义配置，例如凌晨1点）将前一天审核通过的收购数据生成zip包存放在“一卡通”系统服务器上指定的目录（默认D：
/szlkjk/yktSend，可自定义，目录默认为隐藏）.压缩包及其内部文件要求详见5。
2。
2.1。
（2）粮库信息系统每日定时（时间支持自定义配置,例如凌晨1点）在指定的目录读取zip文件,同时将zip文件转存至指定的目录（默认D：
/szlkjk/backup/yktSend，可自定义,目录默认为隐藏）。
（3）粮库信息系统按照规定的频率（1～3月,可定制）对D:
/szlkjk/backup/yktSend中的文件进行清理.
5。
2.1。
2变更（含作废）收购单据
（1）变更收购数据和新增收购单一并保存到Excel中并发送。
（2）变更操作：
“单据操作类型”为“1”,“单据状态”为“1”；所有字段均重新发送；涉及变更字段及变更说明在“备注”列说明，具体格式为:
变更字段及变更原因之间用“：
"分割，多项变更字段之间用“/”分割，详见示例。
（3）作废操作：
“单据操作类型”为“1”，“单据状态"为“0"，“备注”中说明作废原因。
其他列除“单据编号"及“校验码”外均无需发送.
5。
2。
2数据格式
5.2。
2。
1“一卡通”系统发送数据包
（1）“一卡通”系统生成的数据包采取zip文件格式，包含收购数据Excel文件及照片数据。
（2）每天均生成一个新的zip包文件，zip包文件命名格式为《XXXX年XX月XX日XXX“一卡通”系统收购数据。
zip》，其中XXXX年XX月XX日为zip包生成日期，XXX为库点名称.如2017年05月18日XX收储库“一卡通"系统收购数据。
zip。
（3）zip压缩包打开权限密码默认为“"，粮库信息系统及“一卡通”系统均支持自定义。
（4）推送Excel数据格式：
zip包文件包含1个Excel格式的收购数据文件，名称格式为：
《XXXX年XX月XX日XXX“一卡通”系统系统收购数据。
xls》，其中XXXX年XX月XX日为zip包生成日期，XXX为库点名称。
Excel文件包含2个工作表，名称分别为:
“收购单据”和“结算信息”，其内部格式见5。
2.2。
2及5。
2.2。
3结算单据字段说明。
（5）为防止数据篡改，对数据文件和表内数据同时加密：
收购数据Excel文件中对每行数据均进行SHA（安全哈希算法）加密,生成校验码,存放在最后一列。
同时,采用DES（对称加密算法）算法对收购数据Excel进行整体加密，数据对用户不可见。
粮库信息系统在读取收购数据Excel文件时,先采用DES算法对文件进行解密,然后对数据文件中的每一行校验码进行校验比对，比对通过后，进行后续操作，否则返回错误代码.其中DES的密钥需由双方系统约定,保持一致。
（6）照片数据存放在zip文件的照片目录中,目录名称为单据业务日期，如“”，照片内容及格式详见5.1。
2.3.
（7）为了避免出现一个系统文件生成过程中另一个系统读取文件的问题，在压缩包生成后,再生成一个标志性文件.该文件同压缩包同名，后缀名为“。
finish”，粮库系统在读取文件时首先判定目录中是否包含“。
finish”文件，包含时再进行读取，确保文件的完整性。
5。
2。
2。
2收购单据字段说明
表5-5收购单据字段说明
列名
业务涵义
示例
必填
单据操作类型
0:
新增，1:
变更
0
是
单据编号
每笔入库业务数据的唯一编号
RK_37003,格式为RK_+6位库点编号+年月日+四位数字（19位）
是
库点名称
收储库点名称
XXX
是
品种
粮食的品种，取值按照GB1350—GB1353的品种编码
混合小麦
是
等级
粮食的等级，取值按照GB1350-GB1353的等级编码
二等
是
客户名称
客户名称（粮权所有者，即收款人）
张三
是
客户身份证号
客户身份证号
377…
是
客户地址
客户身份证上的地址
XX市XX区XX村XX号
否
承运人姓名
承运人姓名（送粮人）
李四
是
承运人身份证号
承运人身份证号
3783…
是
客户联系电话
客户联系电话
…
否
入粮仓房编号
入粮仓房编号
1号仓
是
入粮货位编号
入粮货位编号
2号位
是
收获年度
收获年度
2016
是
库存性质
最低收购价、国家临时存储
最低收购价
是
业务日期
粮食入库的日期
是
新增时间
年月日时分秒,格式为yyyy-MM—dd（空格）HH：
mm:
ss。
单据新增时间
2016-05—0113:
15：
24
是
变更时间
年月日时分秒,格式为yyyy—MM-dd（空格）HH：
mm：
ss。
单据变更时间，类型为新增时,字段值为空
2016—05-0113：
15:
24
否
国别
粮食国别
中国
是
产地
粮食产地
江苏省泰州市海陵区
是
车船号
车牌号或者轮船号
苏AXXXXX
是
毛重
粮食的毛重
4500
是
皮重
粮食的皮重
1200
是
其它扣量
其它扣量
0
是
结算数量
用于结算的数量
312
升级会员 