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