ICS?FORMTEXT?????FORMTEXT點擊此處添加中國標準文獻分類號T/FORMTEXTXXXFORMTEXTXXXXX—FORMTEXTXXXXFORMTEXT?????能源企業(yè)倉儲管理系統(tǒng)接口規(guī)范InterfaceSpecificationforEnergyEnterprERPeWarehouseManagementSystemFORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX發(fā)布FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX實施FORMTEXTXXXXXXX???發(fā)布T/XXXXXXXX—XXXX能源企業(yè)倉儲管理系統(tǒng)接口規(guī)范范圍本文件規(guī)定了能源企業(yè)倉儲管理系統(tǒng)的數(shù)據(jù)接口要求、協(xié)議與安全要求、字段標準。本文件適用于能源企業(yè)倉儲管理系統(tǒng)的接口設計、研發(fā)等應用集成工作。規(guī)范性引用文件本文件沒有規(guī)范性引用文件。術語和定義下列術語和定義適用于本文件。3.1倉儲管理系統(tǒng)WarehouseManagementSystem一種集成了供應鏈、庫存管理和物流運營的信息管理系統(tǒng)，主要用于提高企業(yè)的倉儲效率和物流效率，降低存儲成本，提高企業(yè)的運營效益。3.2物流LogERPtics根據(jù)實際需要，將運輸、儲存、裝卸、搬運、包裝、流通加工、配送、信息處理等基本功能實施有機結合，使物品從供應地向接收地進行實體流動的過程。[來源：GB/T18354-2021,3.2]3.3倉儲Warehousing利用倉庫及相關設施設備進行物品的入庫、儲存、出庫的活動。[來源：GB/T18354-2021,4.22]3.4接口Interface為邏輯信息流提供訪問模塊的邏輯入口點或出口點。[來源：GB/T40218-2021,3.1.27]3.5字段Field信息客體類別的成分。每個字段是類型字段、固定類型值字段、可變類型值字段、固定類型值集合字段、可變類型值集合字段、信息客體字段或信息客體集合字段。[來源：GB/T16262.2-2006,3.4.5]數(shù)據(jù)接口要求接口設計原則安全性接口設計應采用安全可靠的技術手段確保數(shù)據(jù)傳輸完整、保密，具備可核查性，便于追蹤數(shù)據(jù)的全過程、故障排查和審計。可靠性接口設計應融入高度可靠性機制，以確保數(shù)據(jù)傳輸過程的有效性以及服務運行的持續(xù)穩(wěn)定性?？蓴U展性接口設計應支持新業(yè)務的擴展以及接口容量與接口性能的提高，提供開放式標準接口，提供與其它系統(tǒng)的互聯(lián)互通。統(tǒng)一性接口應實現(xiàn)不同系統(tǒng)接口字段、通信協(xié)議、安全協(xié)議等標準的統(tǒng)一，確保在滿足安全和兼容的前提下，高效地完成數(shù)據(jù)處理與交換。數(shù)據(jù)字段要求接口字段宜包含入庫、出庫、移庫、盤點等環(huán)節(jié)的數(shù)據(jù)字段，字段具體標準見附錄A。數(shù)據(jù)格式要求接口的數(shù)據(jù)格式宜使用JSON（JavaScriptObjectNotation）或XML（ExtensibleMarkupLanguage）。日志監(jiān)控訪問日志應記錄每個接口請求的詳細信息，包括請求時間、請求方法、請求路徑、請求參數(shù)、響應狀態(tài)碼等。錯誤日志應記錄接口處理過程中出現(xiàn)的錯誤和異常情況，包含錯誤消息、錯誤堆棧追蹤和其他相關信息。健康檢查日志應記錄接口的健康檢查結果，包括響應時間、可用性、資源占用等。性能監(jiān)控應實時監(jiān)控接口的性能指標，如響應時間、吞吐量、并發(fā)用戶數(shù)等。安全監(jiān)控應監(jiān)控接口的安全性，包括異常訪問、惡意攻擊、異常行為等。監(jiān)控儀表盤可創(chuàng)建實時的監(jiān)控儀表板，顯示接口性能指標、資源使用情況、服務響應狀態(tài)、告警和事件觸發(fā)等關鍵數(shù)據(jù)。錯誤處理要求統(tǒng)一錯誤格式應定義一致的錯誤響應格式，包括錯誤碼、錯誤消息和可選的詳細錯誤信息，解析錯誤響應。錯誤日志記錄在發(fā)生錯誤時，應記錄錯誤日志，進行故障排除和問題追蹤。異常處理和回退機制在接口實現(xiàn)中應使用異常處理機制，捕獲并處理可能的異常情況。宜提供回退機制，確保系統(tǒng)的穩(wěn)定性和可靠性。錯誤重試和超時機制對于可能發(fā)生臨時錯誤的接口調用，應實施錯誤重試機制。宜設置超時時間，避免長時間的等待和資源占用。版本控制URI版本控制應在接口的URI中宜包含版本號，例如/api/v1/users。每個版本的接口具有獨立的URI，并且可以通過URI來區(qū)分和訪問不同的版本。查詢參數(shù)版本控制在接口的查詢參數(shù)中宜包含版本號，例如/api/users?version=1。通過查詢參數(shù)來標識和選擇要使用的接口版本。請求頭版本控制在HTTP請求頭中宜包含版本號，例如Accept-Version:1.0。服務器根據(jù)請求頭中的版本號來識別和處理請求。自定義請求頭版本控制在HTTP請求頭中宜添加自定義版本控制字段，例如X-API-Version:1.0。服務器根據(jù)自定義請求頭中的版本號來確定使用的接口版本。媒體類型版本控制宜使用不同的媒體類型來表示不同的接口版本，例如使用application/vnd.myapp.v1+json表示第一個版本的接口?？蛻舳撕头掌魍ㄟ^指定媒體類型來選擇和處理接口版本。URL路徑版本控制在接口的URL路徑中宜直接包含版本號，例如/v1/api/users。每個版本的接口可有獨立的URL路徑，并且可以通過路徑來區(qū)分和訪問不同的版本。通信協(xié)議要求5.1HTTP/HTTPS協(xié)議應使用HTTP的安全版本HTTPS協(xié)議對數(shù)據(jù)進行加密，保護用戶的登錄信息、交易數(shù)據(jù)等敏感信息。5.2MQTT協(xié)議物聯(lián)網設備之間的通信宜采用MQTT輕量級消息傳輸協(xié)議，支持多種QoS（QualityofService）級別，確保消息傳輸?shù)目煽啃院头€(wěn)定性。5.3TCP協(xié)議文件傳輸、電子郵件等可采用TCP協(xié)議，在發(fā)送和接收端建立連接時提供數(shù)據(jù)的分段、重組、流量控制、擁塞控制等功能，確保數(shù)據(jù)能夠按照正確的順序安全到達目的地。5.5WebSocke協(xié)議可采用WebSocket協(xié)議建立持久化的連接機制，允許服務器主動向客戶端推送數(shù)據(jù)，同時也支持客戶端向服務器發(fā)送數(shù)據(jù)，實現(xiàn)實時性較好的雙向通信。安全防護要求OAuth認證宜采用OAuth驗證，允許用戶授權第三方應用程序訪問他們存儲在其他服務提供商上的信息，而無需將登錄憑據(jù)分享給第三方。SSL/TLS加密協(xié)議宜使用SSL/TLS加密協(xié)議，使用公鑰加密和私鑰解密的方式對數(shù)據(jù)進行加密，確保數(shù)據(jù)只能由合法的接收方進行解密。RBAC宜采用RBAC訪問控制，基于用戶角色和權限進行訪問控制，以確保角色和權限的分配合理和可靠。

（規(guī)范性）

接口字段標準A.1入庫場景接口字段標準。表A.1物資信息同步至WMS系統(tǒng)接口接口名稱物資信息同步至WMS系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：ERP->WMS發(fā)生頻度實時技術路線消息隊列服務提供方ERP字段描述字段名類型長度數(shù)據(jù)項說明是否必填倉庫編碼WAREHOUSE_NOVarchar230主鍵必輸采購訂單號EBELNVarchar20必輸采購訂單行項目EBELPVarchar5必輸物料編碼SKU_NOVarchar100必輸物料描述SKU_NAMEVarchar100必輸數(shù)量NUMvarchar100必輸物資身份碼ZSWIDVarchar24必輸表A.2WCS系統(tǒng)同步貨物信息至WMS系統(tǒng)接口接口名稱WCS系統(tǒng)同步貨物信息至WMS系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：WCS->WMS發(fā)生頻度實時技術路線消息隊列服務提供方WMS字段描述字段名類型長度數(shù)據(jù)項說明是否必填倉庫編碼WAREHOUSE_NOVarchar30必輸物料編碼SKU_NOVarchar100必輸采購訂單號EBELNVarchar20主鍵必輸采購訂單行項目EBELPVarchar5主鍵必輸訂單數(shù)量MENGEDouble13必輸?shù)截浗唤訂翁朲FHTZDHVarchar20主鍵必輸?shù)截浗唤訑?shù)量ZFHSLDouble13必輸車載物資數(shù)量CZWZSLvarchar100必輸物資身份碼ZSWIDVarchar24必輸包裝碼BOX_IDVarchar40非必輸數(shù)量NUMVarchar40必輸表A.3WMS系統(tǒng)同步入庫單信息至WCS系統(tǒng)接口接口名稱WMS系統(tǒng)同步入庫單信息給WCS系統(tǒng)接口數(shù)據(jù)流向單向，主數(shù)據(jù)流向為：WMS->WCS發(fā)生頻度實時技術路線消息隊列服務提供方WCS字段描述字段名類型長度數(shù)據(jù)項說明是否必填倉庫編碼WAREHOUSE_NOVarchar230主鍵必輸采購訂單號EBELNVarchar20必輸采購訂單行項目EBELPVarchar5必輸訂單數(shù)量MENGEDouble13必輸?shù)截浗唤訂翁朲FHTZDHVarchar20非必輸?shù)截浗唤訑?shù)量ZFHSLDouble13非必輸入庫單IN_NOVarchar100必輸入庫單行項目LINE_NOVarchar100必輸物料編碼SKU_NOVarchar100必輸物料描述SKU_NAMEVarchar100必輸車載物資數(shù)量ZSWIDVarchar24必輸消息文本MESSAGETEXT必輸物資身份碼ZSWID數(shù)組非必輸A.2出庫場景接口字段標準。A.4WMS系統(tǒng)同步下架倉位信息至WCS系統(tǒng)接口接口名稱WMS系統(tǒng)同步下架倉位信息至WCS系統(tǒng)數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：WMS->WCS發(fā)生頻度實時技術路線消息隊列服務提供方WCS字段描述字段名類型長度數(shù)據(jù)項說明是否必填倉庫編碼WAREHOUSE_NOVarchar230主鍵必輸倉位編碼UNIT_NOVarchar250主鍵必輸庫存編號NODE_IDVarchar250主鍵必輸出庫單編號OUT_NOVarchar220必輸出庫單行項目LINE_NOVarchar25必輸物料編碼MATNRVarchar236必輸數(shù)量OCCUPY_NUMVarchar224下架數(shù)量必輸A.5WCS系統(tǒng)反饋下架標識至WMS系統(tǒng)接口接口名稱WCS系統(tǒng)反饋下架標識至WMS系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：WCS->WMS發(fā)生頻度實時技術路線消息隊列服務提供方WMS字段描述字段名類型長度數(shù)據(jù)項說明是否必填出庫單編號OUT_NOVarchar220主鍵必輸出庫單行項目LINE_NOVarchar25主鍵必輸倉庫編碼WAREHOUSE_NOVarchar230必輸倉位編碼UNIT_NOVarchar250必輸庫存編號NODE_IDVarchar250必輸下架成功標識CGBSVarchar21必輸下架失敗反饋信息MESSAGEVarchar2255失敗原因非必輸A.3移庫場景接口字段標準。A.6WMS系統(tǒng)移倉任務下發(fā)至WCS系統(tǒng)接口接口名稱WMS系統(tǒng)移倉任務下發(fā)至WCS系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：WMS->WCS發(fā)生頻度按需技術路線消息隊列服務提供方WCS字段描述字段名類型長度數(shù)據(jù)項說明是否必填主鍵IDVARCHAR2255主鍵必填庫存編號NODE_IDVARCHAR250必填新倉位編碼UNIT_NOVARCHAR250必填原倉位編碼OLD_UNIT_NOVARCHAR250必填容器號BOX_IDVARCHAR240必填倉庫編碼WAREHOUSE_NOVARCHAR230必填倉庫名稱WAREHOUSE_NAMEVARCHAR2255必填存儲類型STORAGE_TYPEVARCHAR2255必填存儲區(qū)NODEVARCHAR2255必填A.4盤點場景接口字段標準。A.7WMS系統(tǒng)盤點任務下發(fā)至ERP系統(tǒng)接口接口名稱WMS系統(tǒng)盤點任務下發(fā)至ERP系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：WMS->ERP發(fā)生頻度按需技術路線消息隊列服務提供方WMS字段描述字段名類型長度數(shù)據(jù)項說明是否必填CHECK_D_ID盤點子表編號VARCHAR250主鍵必填CHECK_NO盤點單號VARCHAR250必填CHECK_LINE_NO盤點單行號INT11必填SKU_ID物料編碼VARCHAR250必填SKU_NAME物料名稱VARCHAR2255必填BOX_ID容器編碼VARCHAR240必填UNIT_NO倉位編碼VARCHAR250必填WAREHOUSE_NO倉庫編碼VARCHAR250必填STORAGE_TYPE存儲類型VARCHAR2255必填NODE存儲區(qū)VARCHAR2255必填A.8ERP系統(tǒng)反饋盤點結果至WMS系統(tǒng)接口接口名稱ERP系統(tǒng)反饋盤點結果至WMS系統(tǒng)接口數(shù)據(jù)流向雙向，主數(shù)據(jù)流向為：ERP->WMS發(fā)生頻度按需技術路線消息隊列服務提供方ERP字段描述字段名類型長度數(shù)據(jù)項說明是否必填盤點子表編號CHECK_D_IDVARCHAR250主鍵必填盤點單號CHECK_NOVARCHAR250必填盤點單行號CHECK_LINE_NOINT11必填物料編碼SKU_IDVARCHAR250必填物料名稱SKU_NAMEVARCHAR2255必填實盤數(shù)量CHECK_QTYFLOAT9，3必填容器編碼BOX_IDVARCHAR240必填倉位編碼UNIT_NOVA