1、ICS 35.240.99CCS B 20T/CCOA 372021散糧集裝箱信息平臺數據接口規范Data interface specification for information platform of bulk grain container2021-05-17 發布2021-08-01 實施中國糧油學會發布本標準由中國糧油學會制定，其著作權為中國糧油學會所有。除了用于國家法律許可 范圍或事先得到中國糧油學會的許可外，不允許以任何形式再復制本標準。如果關于本標 準有任何著作權/版權或相關咨詢，請聯系中國糧油學會或本標準出版社！中國糧油學會(Chinese Cereals and Oi

2、ls Association)簡稱CCOA,是中國科學技術協會領 導下的全國性一級學會，掛靠國家糧食和物資儲備局，是以從事糧食和油脂科學研究、工業生 產的高中級科技人員和企業家為主體的跨行業、跨地區、跨部門的群眾性學術團體。地址：北京市西城區百萬莊大街11號 電話=編：100037傳真址:T/CCOA 372021目 次tuW ni翻i2規范性引用文件13術語和定義14平臺數據對接總體框架25平臺數據接口類型26 數據接口定義和請求參數 36.1 銷售合同數據接口 36.2 采購合同數據接口 36.3 提單信息數據接口 46.4 集裝箱信

3、息數據接口 56.5 集裝箱傳感器點位接口 56.6 集裝箱糧情數據接口 66.7 物流信息數據接口 77 數據接口響應參數7參考文獻本文件按照GB/T 1.12020(標準化工作導則 第1部分:標準化文件的結構和起草規則的規定 起草。本文件由中國糧油學會提出。本文件起草單位：航天信息股份有限公司、北大荒糧食集團有限公司營口分公司、河南工業大學、鄭 州中糧科研設計院有限公司。本文件主要起草人：陳召安、劉申、董婷婷、張東暉、彭遠、張或豪、王仁海、吳建軍、李杰、高蘭。T/CCOA 372021散糧集裝箱信息平臺數據接口規范1范圍本文件給出了散糧集裝箱信息平臺總體框架，規定了數據接口類型、定義、請求

4、參數和響應參數。 本文件適用于公鐵水聯運模式下，使用密封集裝箱的散糧物流相關方開發、使用散糧集裝箱信息平 臺數據接口，也可以作為管理部門對散糧集裝箱信息平臺數據接口的管理依據。2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文 件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于 本文件。GB/T 1836集裝箱代碼、識別和標記GB/T 6512運輸方式代碼GB/T 7408數據元和交換格式信息交換日期和時間表示法GB 32100法人和其他組織統一社會信用代碼編碼規則LS/T 1703糧食信息分類與編碼

5、糧食及加工產品分類與代碼LS/T 1713庫存糧食識別代碼T/CCOA 52019糧食流通基礎數據元3術語和定義下列術語和定義適用于本文件。3.1散糧 bulk grain未包裝或不需要任何包裝的糧食。3.2散糧集裝箱 bulk grain container用于裝運散糧（3.1）的密封集裝箱。3.3信息平臺 information platform通過公共網絡或專用網絡，進行信息采集、匯總、分析和利用，實現業務管理或提供服務的信息 系統。3.4接口 interface兩個功能單元共享的邊界，由各種特征（如功能、物理互連、信號交換等）來定義。 來源:GB/T 5271.12000,01.01.

6、383.5庫存識別代碼 indentification code of stock grain標記一個貨位糧食的唯一標識符。來源:LS/T 17132015,3.14平臺數據對接總體框架散糧集裝箱平臺通過數據接口分別對接業務系統、外接設備、物流系統等，將多源信息數據集成到 平臺。平臺數據對接總體框架見圖1。業務系統業務信息 數據接口銷售合同數據接口采購合同數據接口提單信息數據接口集裝箱信息數據接口物流系統物流信息數據接口散糧集裝箱信息平臺圖1總體框架5平臺數據接口類型平臺數據接口包括業務信息數據接口、外接設備數據接口、物流信息數據接口三種類型。各類型數 據接口名稱和功能見表1。表1平臺數據接口

7、列表接口類型接口名稱接口功能業務信息數據接口銷售合同數據接口將銷售合同信息傳給平臺采購合同數據接口將采購合同信息傳給平臺提單信息數據接口將集裝箱運輸的提單信息傳給平臺集裝箱數據接口將集裝箱信息傳給平臺外接設備數據接口集裝箱傳感器點位接口將集裝箱傳感器信息傳給平臺集裝箱糧情數據接口將箱內糧情信息傳給平臺物流信息數據接口物流信息數據接口將集裝箱物流信息傳給平臺6數據接口定義和請求參數6.1銷售合同數據接口6.1.1銷售合同數據接口定義見表2。表2銷售合同數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方糧貿企業端系統接口調用方平臺6.1.2銷售合同數據接口請求參數見表3。表

8、3銷售合同數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例銷售合同號字符型必選糧貿企業銷售糧食合同號XS20210331品種字符型必選按照LS/T 1703執行玉米集裝箱號字符型數組必選集裝箱唯一編號（執行GB/T 1836） +封裝集裝箱的唯一鉛封號CBHU3202732+ KWL340475客戶企業代碼字符型必選統一社會信用代碼，執行GB 32100911100 * * * * 0927388B客戶企業名稱字符型必選向糧貿企業購買糧食的客戶企業廣東省XXX糧食貿易有限公司補充信息復合型非必選臨時存放或其他備注信息6.2采購合同數據接口 6.2.1采購合同數據接口定義見表4。表4采

9、購合同數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方糧貿企業端系統接口調用方平臺6.2.2采購合同數據接口請求參數見表5。表5采購合同數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例采購合同號字符型必選糧貿企業采購糧食的合同號CG20210401品種字符型必選執行 LS/T 1703玉米集裝箱號字符型數組必選集裝箱唯一編號（執行GB/T 1836） +封裝集裝箱的唯一鉛封號CBHU3202732+ KWL340475來源企業代碼字符型必選統一社會信用代碼，執行GB 32100912330 * * * * 107724XC來源企業名稱字符型必選銷售糧食給糧貿

10、企業的來源企業XXX農墾集團有限公司補充信息復合型非必選臨時存放或其他備注信息6.3提單信息數據接口6.3.1提單信息數據接口定義見表6。表6提單信息數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方糧貿企業端系統接口調用方平臺6.3.2提單信息數據接口請求參數見表7。表7提單信息數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例物流企業代碼字符型必選統一社會信用代碼，執行GB 32100911100 * * * * 0004340U物流企業名稱字符型必選集裝箱運輸的物流企業XX海運物流有限公司運輸方式字符型必選執行 GB/T 6512公路運輸、鐵路運輸、海上運

11、輸提單號字符型必選物流公司定義的訂單號ZY077111032533訂單日期日期型必選進行物流訂單的日期，執行GB/T 74082021-03-31始發地字符型必選始發地名稱遼寧省營口市鲅魚圈區日月 大道與遼東灣大街交叉路口目的地字符型必選目的地名稱廣東省廣州市番禺區金龍路橋山段9號集裝箱號字符型數組必選集裝箱唯一編號（執行GB/T 1836） +封裝集裝箱的唯一鉛封號CBHU3202732 + KWL340475補充信息復合型非必選臨時存放或其他備注信息6.4集裝箱信息數據接口6.4.1集裝箱信息數據接口定義見表8。表8集裝箱信息數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用

12、接口提供方糧貿企業端系統接口調用方平臺6.4.2集裝箱信息數據接口請求參數見表9。表9集裝箱信息數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例集裝箱號字符型數組必選集裝箱唯一編號（執行GB/T 1836） +封裝集裝箱的唯一鉛封號CBHU3202732+ KWL340475品種字符型必選執行 LS/T 1703玉米數量（噸）數值型必選集裝箱內糧食質量1000裝箱日期日期型必選執行 GB/T 74082021-03-31單價（元）數值型必選集裝箱內糧食單價1000000采購合同號字符型必選集裝箱內糧食采購合同號CG20210401庫存識別代碼數值型必選執行 LS/T 17133014

13、326600100600103201303121425提單號字符型必選物流公司提供的物流訂單號ZY077111032533銷售合同號字符型必選集裝箱內糧食銷售合同號XS20210331集裝箱狀態字符型非必選集裝箱鉛封狀態圖圖片的OSS地址補充信息復合型非必選臨時存放或其他備注信息6.5集裝箱傳感器點位接口6.5.1集裝箱傳感器點位接口定義見表10。表10集裝箱傳感器點位接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方集裝箱糧情采集系統接口調用方平臺6.5.2集裝箱傳感器點位接口請求參數見表11。表11集裝箱傳感器點位接口請求參數表參數名稱數據類型約束/條件含義及說明示例傳

14、感器點位字符型必選傳感器所在點位存在箱內箱外布爾型必選返回值表明傳感器在箱內或箱外。 取值為“true”表示“箱內”，取值為 “false”表示“箱外”Ture描述字符型必選對傳感器的其他信息描述集裝箱號字符型數組必選集裝箱唯一編號（執行GB/T 1836） +封裝集裝箱的唯一鉛封號CBHU3202732+ KWL340475傳感器狀態字符型非必選傳感器位置狀態圖圖片的OSS地址補充信息復合型非必選臨時存放或其他備注信息6.6集裝箱糧情數據接口6.6.1集裝箱糧情數據接口定義見表12。表12集裝箱糧情數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方集裝箱糧情采集系統接

15、口調用方平臺6.6.2集裝箱糧情數據接口請求參數見表13。表13集裝箱糧情數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例傳感器ID字符型必選傳感器的編組ID數據采集時間時間型必選執行 GB/T 74082021-03-31 15：05：26箱內溫度（攝氏度°C）數值型必選集裝箱內糧食的溫度，單位為攝氏 度m20箱內濕度（百分比）數值型必選集裝箱內糧食的濕度，為百分比 數值5水分含量（百分比）數值型非必選集裝箱內糧食的水分含量，為百分 比數值1傳感器點位字符型必選傳感器的點位補充信息復合型非必選臨時存放或其他備注信息6.7物流信息數據接口6.7.1物流信息數據接口定義見表1

16、4。表14物流信息數據接口定義項目內容接口功能類型數據更新接口接口調用類型同步調用接口提供方物流企業端系統接口調用方平臺6.7.2物流信息數據接口請求參數見表15。表15物流信息數據接口請求參數表參數名稱數據類型約束/條件含義及說明示例狀態信息ID字符型必選該條運輸狀態的唯一 IDWL001狀態發生日期日期型必選該條運輸狀態發生日期，執行GB/T 74082021-03-31狀態發生時間時間型必選該條運輸狀態發生時間，執行GB/T 740815：05：26狀態發生地點字符型必選該條運輸狀態發生地點遼寧省營口市鲅魚圈區日 月大道與遼東灣大街交叉 路口狀態描述字符型必選對該運輸狀態的描述已發車經度數值型必選該條運輸狀態發生經度，執行T/CCOA 52019116.581 161緯度數值型必選該條運輸狀態發生緯度，執行T/CCOA 5201939.570 818提單號字符型必選物流公司定義的訂單號ZY077111032533補充信息復合型非必選臨時存放或其他備注信息7數據接口響應參數數據接口響應參數見表16。表16數據接口響應參數表參數名稱數據類型約束/條件含義及說明示例上傳結果布爾型必選返回上傳結果。取值為“true”表示 “成功”，取值為“false”表示“失敗”True失敗原因布爾型必選返回失敗的原因。取值為“true”表 示“該參數為空”，取值為“false