粮库信息系统政策性粮食收购数据交换规范doc.docx

1、粮库信息系统政策性粮食收购数据交换规范doc粮库信息系统与政策性粮食收购“一卡通系统数据交换规范(试行）国家粮食局二一八年三月1。目的及适用范围为促进粮食行业信息化建设的健康发展，推进行业互联互通，避免地方粮库信息系统（简称“粮库系统”）和政策性粮食收购“一卡通系统（简称“一卡通”系统)的重复建设，实现已建两个系统的信息共享，满足粮库生产经营、粮食行政主管部门行业管理和政策性粮食收购主体(中储粮等）业务监管需求，制订本规范。本规范规定了政策性粮食购销过程中数据对接的方式、数据种类和内容、对接方法和流程.本规范适用于政策性粮食购销过程中的数据共享，实现购销数据和支付审批结果的交换。2。规范性引用

2、文件（1)国务院办公厅关于印发政务信息系统整合共享实施方案的通知（国办发201739号)(2）国务院关于印发政务信息资源共享管理暂行办法的通知(国发201651号）(3）粮食数据采集规范 政策性粮食收购LS/T 18052016 （4）国家粮食局关于规范粮食行业信息化建设的意见(国粮财201674号） （5)地方粮库信息化建设技术指引（试行）（国粮办发2017217号）3.名词术语3。1 粮库系统指安装在各地方粮库，具有粮食购销信息化管理功能的信息系统.3.2“一卡通”系统指安装在各地方粮库，用于政策性粮食收购的“一卡通系统。3。3数据交换指粮库系统和“一卡通”系统交换政策性粮食购销数据.4.

3、数据交换方案为解决粮库系统和“一卡通”系统在粮库并行运行,造成粮库使用不便和重复建设的问题，通过两套系统对接,共享硬件资源进行信息采集和交换。系统以一个为主，另一个为辅，主系统负责各项业务的办理并采集数据，推送给辅系统，辅系统将处理结果反馈给主系统。根据主、辅系统的定位和数据流向,有两种方式供选择，各地可根据需要选择其中一种对接方式。4。1粮库系统为主经省、市、县等粮食行政管理部门组织，并按照地方粮库信息化建设验收规范(试行）验收通过的粮库信息系统,可按照本对接方式进行政策性粮食数据共享交换。粮库系统为主系统,负责粮库各项业务处理.按照本规范约定的格式将政策性粮食购销数据加密后生成压缩包，存放

4、到指定的目录。“一卡通”系统从相应目录获取数据,并将审核和付款等处理结果生成反馈文件，保存到相应目录,粮库系统再从相应目录获取反馈结果。4。2“一卡通”系统为主“一卡通”系统为主系统,负责粮库各项业务办理。按照本规范约定的格式将所有购销数据加密后生成压缩包，存放到指定的目录，粮库系统从相应目录获取数据。5。收购数据交换规范5.1粮库系统为主粮库系统每23小时(可自定义）将政策性粮食收购数据按照接口要求推送到指定的目录，“一卡通”系统到该目录定时抓取、解析，将数据报送至直属库“一卡通系统。直属库完成审核付款后，再将审核付款结果下发到收储库点“一卡通”系统中。收储库点“一卡通”系统将收购数据的审核

5、和付款等处理结果生成反馈文件,保存到相应目录,粮库信息系统按照接口规范到相应目录获取反馈结果。5.1.1业务流程说明业务流程见图51。图51 粮库系统为主的业务流程图5.1。1。1新增收购单据（1）粮库信息系统按照规定的频率(23小时，可自定义）将新生成的业务数据生成zip包存放在指定的目录（默认D：/szlkjk/lkxtSend，可自定义，目录默认为隐藏）。压缩包及其内部文件要求详见5。1。2.1、5。1。2.3。(2）收储库点“一卡通”系统按照规定的频率（23小时，可自定义）在指定的目录读取zip文件，传送给直属库，同时将zip文件转存至指定的目录（默认D：/szlkjk/backup/

6、lkxtSend，可自定义,目录默认为隐藏）。（3）直属库审核及付款信息发送到收储库点“一卡通”系统,“一卡通”系统将一条或多条反馈信息生成Excel文件,保存到指定目录(默认D:/szlkjk/yktReturn，可自定义，目录默认为隐藏）。反馈信息Excel文件命名规则及反馈信息字段说明见5。1。2。2、5。1.2。5。（4）粮库信息系统按照规定的频率（23小时，可定制）读取该Excel文件， 同时将Excel文件转存至指定的目录(默认D：/szlkjk/backup/yktReturn,可自定义，目录默认为隐藏）.（5）反馈处理类型，详见5。1。2。6。（6)粮库信息系统按照规定的频率（

7、13月，可定制）对D：/szlkjk/backup/lkxtSend及D：/szlkjk/backup/yktReturn中的文件进行清理。（7）为了避免出现一个系统文件生成过程中另一个系统读取文件的问题,在压缩包生成后，再生成一个标志性文件.该文件同压缩包同名，后缀名为“.finish”，“一卡通”系统在读取文件时首先判定目录中是否包含“.finish”文件，包含时再进行读取，确保文件的完整性。5。1.1。2变更（含作废）收购单据（1)变更(含作废)收购数据和新增收购单据一并保存到Excel中,生成zip包后发送。(2)变更操作：“单据操作类型为“1”,“单据状态”为“1”；所有字段均重新发

8、送;涉及变更字段及变更说明在“备注列说明，具体格式为：变更字段及变更原因之间用“：”分割，多项变更字段之间用“/分割，详见示例。(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为库点名称

9、，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文件的各列名称及说明

10、见5.1。2.4.（5）为防止数据篡改，对数据文件和表内数据同时加密：收购数据Excel文件中对每行数据均进行SHA(安全哈希算法）加密,生成校验码,存放在最后一列，同时采用DES（对称加密算法)算法对整个收购数据Excel文件进行加密，文件加密后，数据对用户不可见.“一卡通”系统读取文件后，先同样采用DES算法对收购数据Excel文件进行解密，再对其中每一行数据的校验码进行校验比对，比对通过后，进行后续操作，否则返回错误代码.其中DES的密钥需由双方系统约定,保持一致。(6)收购数据Excel文件中各行收购数据所涉及照片数据存放在zip文件的照片目录中,目录名称为单据业务日期，如“，照片内容

11、及格式详见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（安全哈希算法）加密，生成校验码,存放在最后一列

12、，同时采用DES(对称加密算法）算法对整个反馈记录数据文件进行加密，文件加密后,数据对用户不可见。由粮库信息系统读取文件后,同样采用DES算法对文件进行解密,再对反馈文件中的每一行数据的校验码进行校验比对，比对通过后,进行后续操作,否则粮库信息系统提示人工干预。其中DES的密钥需由双方系统约定，保持一致.6)反馈文件的加密方式需和粮库信息系统发送数据包的加密方式保持一致。5。1。2。3照片内容格式每行收购数据均对应7张照片，具体要求见表51.表51 照片数据要求编号图片名称描述大小分辨率1业务日期_单据编号_CYRSFZTX。JPG承运人身份证照片150KB1021262业务日期_单据编号_K

13、HSFZTX。JPG客户身份证照片150KB102*1263业务日期_单据编号_JS_1.JPG结算环节照片200KB10247684业务日期_单据编号_CM_1.JPG称毛重时前摄像头拍摄的照片200KB6404805业务日期_单据编号_CM_2.JPG称毛重时后摄像头拍摄的照片200KB640*4806业务日期_单据编号_CP_1。JPG称皮重时前摄像头拍摄的照片200KB640*4807业务日期_单据编号_CP_2。JPG称皮重时后摄像头拍摄的照片200KB640480说明:承运人身份证照片信息，从承运人身份证中读取；客户身份证照片信息,从客户身份证中读取。前摄像头位于车的前上方,要求能

14、够看清磅上车辆的车牌号及车的全貌,并能看清驾驶室全貌。后摄像头位于车的后上方,要求能够看清磅上车辆的车牌号、车厢及车的全貌。结算环节照片为结算时拍摄的客户或银行卡照片。5.1。2.4收购数据字段说明收购数据字段说明见表5-2。表52 收购数据字段说明表列名业务涵义示例必填单据操作类型0：新增，1:变更0是单据编号每笔业务数据的唯一编号RK_37003，格式为RK_+6位粮库编号+年月日+四位流水（19位）是库点名称收储库点名称XXX是品种粮食的品种，取值按照GB1350GB1353的品种编码混合小麦是等级粮食的等级，取值按照GB1350-GB1353的等级编码二等是客户名称客户名称（粮权所有者

15、，即收款人)张三是客户身份证号客户身份证号377是客户地址客户身份证上的地址XX市XX区XX村XX号否承运人姓名承运人姓名（送粮人）李四是承运人身份证号承运人身份证号3783是客户联系电话客户联系电话否仓房编号仓房编号1号仓是货位编号货位编号2号位否货位容量货位容量3000否收获年度粮食的收获年度2016是库存性质最低收购价、国家临时存储最低收购价是业务日期粮食入库的日期,如果跨天,则取净重确认时间是粮食国别粮食国别中国是产地代码国家统计局下发的县级及以上行政区划代码130128是车船号车牌号或者轮船号苏AXXXXX是毛重粮食的毛重4500是皮重粮食的皮重1200是其它扣量其它扣量0是结算数量

16、毛-皮其它扣量-各检验项目扣量3126是入门登记员流程操作人员是出门登记员流程操作人员是毛重检斤员流程操作人员是皮重检斤员流程操作人员是保管员流程操作人员是扦样员流程操作人员是检验员流程操作人员是水分各检验项目指标、扣量数量、扣量比例 13是扣水分比例1是扣水分数量33是杂质2是扣杂质比例3是扣杂质数量99是不完善粒9品种为小麦和玉米时，必填扣不完善粒比例0。5扣不完善粒数量17容重780品种为小麦和玉米时，必填出糙率0品种为稻谷时,必填整精米率0品种为稻谷时，必填扣整精米率比例0扣整精米率数量0色泽气味正常是黄粒米0品种为稻谷时,必填黄粒米扣量比例0黄粒米扣量数量0谷外糙米0品种为稻谷时，必

17、填谷外糙米扣量比例0谷外糙米扣量数量0其中生霉粒0品种为玉米时，必填生霉粒扣量比例0生霉粒扣量数量0其中矿物质1品种为小麦时,必填其中矿物质扣量比例0。75其中矿物质扣量数量25硬度65品种为小麦时，必填互混率0品种为稻谷时，必填互混率扣量比例0扣互混率数量0检验时间检验结果录入时间，格式为yyyy-MMdd（空格）HH:mm:ss。下同。2015-0101 12：36：55是称毛时间毛重录入时间20150101 13：16:55是称皮时间皮重录入时间20150101 15:16:51是发票号码单据的发票号码XXX否发票状态正常发票、作废发票正常发票否库点税号库点的纳税识别号2369否发票代码

18、发票代码2300153350否银行代码102 中国工商银行103 中国农业银行104 中国银行105 中国建设银行314 农村商业银行402 农村信用合作社403 中国邮政储蓄999 其它银行103是开户行号银行卡的开户行号XXX是开户行名称银行卡的开户行名称XXX是银行卡号银行卡号XXX是标准单价粮食的标准单价2.36000是扣价信息检验项目1:扣量单价；检验项目2:扣量单价;注：标点用英文否结算单价结算的单价2。36000是售粮人结算价款（结算单价结算数量）售粮人结算金额7377.36是总结算价款（标准单价结算数量)总结算金额7377.36是结算员姓名结算环节人员姓名XXX是结算时间年月日

19、 时分秒,格式为yyyyMMdd（空格）HH:mm：ss。20150101 12：12：20是单据状态1：正常；0:作废1是备注补充说明水分:录入错误/毛重：违规重称否校验码以上所有列，按照Excel中的顺序拼接字符串，然后使用SHA（安全哈希算法）进行加密Xxxxxxxxxxx是5。1。2。5反馈信息字段说明反馈信息字段说明见表53。表5-3 反馈信息字段说明表列名业务涵义示例单据编号每笔业务数据的唯一编号，需和粮库系统发送的单据编号一致。RK_37003，格式为RK_+6位粮库编号+年月日+四位流水（19位)库点名称收储库点名称XXX库点业务日期粮食入库的日期返回状态详见表4返回状态说明0

20、5返回信息对返回状态进行补充说明已支付,无法变更校验码以上所有列，按照Excel中的顺序拼接字符串,然后使用SHA(安全哈希算法）进行加密Xxxxxxxxxxx5。1。2。6返回状态说明返回状态说明见表54.表5-4 返回状态说明表返回状态状态说明处理方式00处理完成01未找到需变更单据根据“单据编号”重新传输原始单据02校验码不匹配根据“单据编号重新发送相应收购数据03数据不合法具体字段及原因位于“返回信息”.粮库系统检查调整后再次发送04扣量扣价未验证通过粮库系统重新进行扣量扣价计算后,再次发送。发送时，“单据操作类型”为“变更”05无法变更具体原因位于“返回信息”06密码错误检查确认约定

21、的密码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)谷外糙米:%，

22、一位精度。17)纯粮率:，一位精度。18)其中生霉粒：，一位精度。19)其中矿物质:%,一位精度。20)互混率:%，一位精度。21)热损伤粒：,一位精度.22)含油量：%，一位精度.23)未熟粒:，一位精度。24)生芽粒:，一位精度。（2）所有的符号使用半角字符.(3）文件名命名采用gb2312字符集.（4）Excel版本不高于2013版。5.2“一卡通系统为主“一卡通”系统为主系统，负责各项业务办理.“一卡通”系统将所有收购数据打包推送到指定的目录,由粮库系统到约定的目录抓取、解析数据包.5。2.1业务流程说明“一卡通系统为主的业务流程图如下：图5-2 “一卡通”系统为主的业务流程图5。2。

23、1。1新增收购单据（1）“一卡通系统提供收购数据推送功能,每日定时（时间支持自定义配置，例如凌晨1点）将前一天审核通过的收购数据生成zip包存放在“一卡通”系统服务器上指定的目录（默认D：/szlkjk/yktSend，可自定义，目录默认为隐藏）.压缩包及其内部文件要求详见5。2。2.1。(2）粮库信息系统每日定时（时间支持自定义配置,例如凌晨1点）在指定的目录读取zip文件, 同时将zip文件转存至指定的目录(默认D：/szlkjk/backup/yktSend，可自定义,目录默认为隐藏）。（3）粮库信息系统按照规定的频率（13月,可定制）对D:/szlkjk/backup/yktSend中

24、的文件进行清理.5。2.1。2变更（含作废)收购单据（1)变更收购数据和新增收购单一并保存到Excel中并发送。(2)变更操作：“单据操作类型”为“1”,“单据状态”为“1”；所有字段均重新发送；涉及变更字段及变更说明在“备注”列说明，具体格式为:变更字段及变更原因之间用“：分割，多项变更字段之间用“/”分割，详见示例。(3）作废操作：“单据操作类型”为“1”，“单据状态为“0，“备注”中说明作废原因。其他列除“单据编号及“校验码”外均无需发送.5。2。2数据格式5.2。2。1“一卡通”系统发送数据包（1）“一卡通”系统生成的数据包采取zip文件格式，包含收购数据Excel文件及照片数据。（2

25、)每天均生成一个新的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个工作表，名称分别为:“收购单据”

26、和“结算信息”，其内部格式见5。2.2。2及5。2.2。3结算单据字段说明。(5）为防止数据篡改，对数据文件和表内数据同时加密：收购数据Excel文件中对每行数据均进行SHA(安全哈希算法）加密,生成校验码,存放在最后一列。同时,采用DES(对称加密算法)算法对收购数据Excel进行整体加密，数据对用户不可见。粮库信息系统在读取收购数据Excel文件时,先采用DES算法对文件进行解密,然后对数据文件中的每一行校验码进行校验比对，比对通过后，进行后续操作，否则返回错误代码.其中DES的密钥需由双方系统约定,保持一致。（6)照片数据存放在zip文件的照片目录中,目录名称为单据业务日期，如“”，照片

27、内容及格式详见5.1。2.3.(7）为了避免出现一个系统文件生成过程中另一个系统读取文件的问题，在压缩包生成后,再生成一个标志性文件.该文件同压缩包同名，后缀名为“。finish”，粮库系统在读取文件时首先判定目录中是否包含“。finish”文件，包含时再进行读取，确保文件的完整性。5。2。2。2收购单据字段说明表5-5 收购单据字段说明列名业务涵义示例必填单据操作类型0:新增，1:变更0是单据编号每笔入库业务数据的唯一编号RK_37003,格式为RK_+6位库点编号+年月日+四位数字（19位）是库点名称收储库点名称XXX是品种粮食的品种，取值按照GB1350GB1353的品种编码混合小麦是等

28、级粮食的等级，取值按照GB1350-GB1353的等级编码二等是客户名称客户名称（粮权所有者，即收款人）张三是客户身份证号客户身份证号377是客户地址客户身份证上的地址XX市XX区XX村XX号否承运人姓名承运人姓名(送粮人)李四是承运人身份证号承运人身份证号3783是客户联系电话客户联系电话否入粮仓房编号入粮仓房编号1号仓是入粮货位编号入粮货位编号2号位是收获年度收获年度2016是库存性质最低收购价、国家临时存储最低收购价是业务日期粮食入库的日期是新增时间年月日 时分秒,格式为yyyy-MMdd（空格）HH：mm:ss。单据新增时间2016-0501 13:15：24是变更时间年月日 时分秒,格式为yyyyMM-dd（空格）HH：mm：ss。单据变更时间，类型为新增时,字段值为空201605-01 13：15:24否国别粮食国别中国是产地粮食产地江苏省泰州市海陵区是车船号车牌号或者轮船号苏AXXXXX是毛重粮食的毛重4500是皮重粮食的皮重1200是其它扣量其它扣量0是结算数量用于结算的数量312