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

2、ls Association)簡稱CCOA,是中國科學(xué)技術(shù)協(xié)會領(lǐng) 導(dǎo)下的全國性一級學(xué)會，掛靠國家糧食和物資儲備局，是以從事糧食和油脂科學(xué)研究、工業(yè)生 產(chǎn)的高中級科技人員和企業(yè)家為主體的跨行業(yè)、跨地區(qū)、跨部門的群眾性學(xué)術(shù)團體。地址：北京市西城區(qū)百萬莊大街11號 電話=編：100037傳真址:T/CCOA 372021目 次tuW ni翻i2規(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 集裝箱信

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

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

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

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

7、列表接口類型接口名稱接口功能業(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ù)接口將集裝箱物流信息傳給平臺6數(shù)據(jù)接口定義和請求參數(shù)6.1銷售合同數(shù)據(jù)接口6.1.1銷售合同數(shù)據(jù)接口定義見表2。表2銷售合同數(shù)據(jù)接口定義項目內(nèi)容接口功能類型數(shù)據(jù)更新接口接口調(diào)用類型同步調(diào)用接口提供方糧貿(mào)企業(yè)端系統(tǒng)接口調(diào)用方平臺6.1.2銷售合同數(shù)據(jù)接口請求參數(shù)見表3。表

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

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

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

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

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

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

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

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

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