散糧集裝箱信息平臺數(shù)據(jù)接口規(guī)范2021-05-17發(fā)布2021-08-01實施中國糧油學(xué)會發(fā)布I 12規(guī)范性引用文件 13術(shù)語和定義 14平臺數(shù)據(jù)對接總體框架 25平臺數(shù)據(jù)接口類型 26數(shù)據(jù)接口定義和請求參數(shù) 36.1銷售合同數(shù)據(jù)接口 36.2采購合同數(shù)據(jù)接口 36.3提單信息數(shù)據(jù)接口 46.4集裝箱信息數(shù)據(jù)接口 56.5集裝箱傳感器點位接口 56.6集裝箱糧情數(shù)據(jù)接口 66.7物流信息數(shù)據(jù)接口 77數(shù)據(jù)接口響應(yīng)參數(shù) 參考文獻(xiàn) 9Ⅲ本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件由中國糧油學(xué)會提出。本文件起草單位：航天信息股份有限公司、北大荒糧食集團有限公司營口分公司、河南工業(yè)大學(xué)、鄭州中糧科研設(shè)計院有限公司。1本文件給出了散糧集裝箱信息平臺總體框架，規(guī)定了數(shù)據(jù)接口類型、定義、請求參數(shù)和響應(yīng)參數(shù)。本文件適用于公鐵水聯(lián)運模式下，使用密封集裝箱的散糧物流相關(guān)方開發(fā)、使用散糧集裝箱信息平臺數(shù)據(jù)接口，也可以作為管理部門對散糧集裝箱信息平臺數(shù)據(jù)接口的管理依據(jù)。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T6512運輸方式代碼GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時間表示法GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則LS/T1703糧食信息分類與編碼糧食及加工產(chǎn)品分類與代碼LS/T1713庫存糧食識別代碼T/CCOA5—2019糧食流通基礎(chǔ)數(shù)據(jù)元3術(shù)語和定義下列術(shù)語和定義適用于本文件。未包裝或不需要任何包裝的糧食。用于裝運散糧(3.1)的密封集裝箱。通過公共網(wǎng)絡(luò)或?qū)Ｓ镁W(wǎng)絡(luò)，進(jìn)行信息采集、匯總、分析和利用，實現(xiàn)業(yè)務(wù)管理或提供服務(wù)的信息兩個功能單元共享的邊界，由各種特征(如功能、物理互連、信號交換等)來定義。標(biāo)記一個貨位糧食的唯一標(biāo)識符。24平臺數(shù)據(jù)對接總體框架散糧集裝箱平臺通過數(shù)據(jù)接口分別對接業(yè)務(wù)系統(tǒng)、外接設(shè)備、物流系統(tǒng)等，將多源信息數(shù)據(jù)集成到平臺。平臺數(shù)據(jù)對接總體框架見圖1。業(yè)務(wù)系統(tǒng)業(yè)務(wù)系統(tǒng)銷售合同數(shù)據(jù)接口采購合同數(shù)據(jù)接口提單信息數(shù)據(jù)接口集裝箱信息數(shù)據(jù)接口散糧集裝箱信息平臺集裝箱傳感器點位接口集裝箱糧情數(shù)據(jù)接口外接設(shè)備信息業(yè)務(wù)信息數(shù)據(jù)接口物流信息溫度傳感器水分傳感器濕度傳感器物流系統(tǒng)5平臺數(shù)據(jù)接口類型平臺數(shù)據(jù)接口包括業(yè)務(wù)信息數(shù)據(jù)接口、外接設(shè)備數(shù)據(jù)接口、物流信息數(shù)據(jù)接口三種類型。各類型數(shù)據(jù)接口名稱和功能見表1。表1平臺數(shù)據(jù)接口列表業(yè)務(wù)信息數(shù)據(jù)接口銷售合同數(shù)據(jù)接口將銷售合同信息傳給平臺采購合同數(shù)據(jù)接口將采購合同信息傳給平臺提單信息數(shù)據(jù)接口將集裝箱運輸?shù)奶釂涡畔鹘o平臺集裝箱數(shù)據(jù)接口將集裝箱信息傳給平臺外接設(shè)備數(shù)據(jù)接口集裝箱傳感器點位接口將集裝箱傳感器信息傳給平臺集裝箱糧情數(shù)據(jù)接口將箱內(nèi)糧情信息傳給平臺物流信息數(shù)據(jù)接口物流信息數(shù)據(jù)接口將集裝箱物流信息傳給平臺3內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺表3銷售合同數(shù)據(jù)接口請求參數(shù)表數(shù)據(jù)類型含義及說明示例字符型品種字符型+封裝集裝箱的唯一鉛封號字符型字符型向糧貿(mào)企業(yè)購買糧食的客戶企業(yè)限公司補充信息復(fù)合型臨時存放或其他備注信息表4采購合同數(shù)據(jù)接口定義數(shù)據(jù)更新接口同步調(diào)用平臺4數(shù)據(jù)類型含義及說明示例品種集裝箱唯一編號(執(zhí)行GB/T1836)統(tǒng)一社會信用代碼，執(zhí)行GB32100×××農(nóng)墾集團有限公司補充信息復(fù)合型臨時存放或其他備注信息表6提單信息數(shù)據(jù)接口定義內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺數(shù)據(jù)類型含義及說明示例統(tǒng)一社會信用代碼，執(zhí)行GB32100××海運物流有限公司訂單日期日期型遼寧省營口市鲅魚圈區(qū)日月大道與遼東灣大街交叉路口目的地目的地名稱集裝箱唯一編號(執(zhí)行GB/T1836)補充信息復(fù)合型臨時存放或其他備注信息5內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺數(shù)據(jù)類型含義及說明示例集裝箱唯一編號(執(zhí)行GB/T1836)品種數(shù)量(噸)數(shù)值型日期型單價(元)數(shù)值型數(shù)值型集裝箱鉛封狀態(tài)圖圖片的OSS地址補充信息復(fù)合型臨時存放或其他備注信息內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺6數(shù)據(jù)類型含義及說明示例返回值表明傳感器在箱內(nèi)或箱外?！癴alse”表示“箱外”集裝箱唯一編號(執(zhí)行GB/T1836)傳感器位置狀態(tài)圖圖片的OSS地址補充信息復(fù)合型臨時存放或其他備注信息表12集裝箱糧情數(shù)據(jù)接口定義內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺表13集裝箱糧情數(shù)據(jù)接口請求參數(shù)表數(shù)據(jù)類型含義及說明示例字符型數(shù)據(jù)采集時間時間型氏度℃)數(shù)值型度(℃)分比%)數(shù)值型5分比%)數(shù)值型比數(shù)值1字符型補充信息復(fù)合型臨時存放或其他備注信息7內(nèi)容數(shù)據(jù)更新接口同步調(diào)用平臺數(shù)據(jù)類型含義及說明示例字符型日期型狀態(tài)發(fā)生時間時間型狀態(tài)發(fā)生地點字符型該條運輸狀態(tài)發(fā)生地點遼寧省營口市鲅魚圈區(qū)日月大道與遼東灣大街交叉路口字符型已發(fā)車經(jīng)度數(shù)值型數(shù)值型字符型補充信