智能調(diào)度平臺接口

智能調(diào)度配送管理平臺接口規(guī)范

（工作流系統(tǒng)分冊）二0—四年 月目錄TOC\o"1-5"\h\z\o"CurrentDocument"概述 3\o"CurrentDocument"編寫目的 3\o"CurrentDocument"預期讀者 3\o"CurrentDocument"術語 3\o"CurrentDocument"交互示意圖 3\o"CurrentDocument"接口需求 3危貨駕駛員報銷接口 錯誤！未定義書簽。\o"CurrentDocument"需求描述 3\o"CurrentDocument"數(shù)據(jù)類清單 3接口交互流程圖 4\o"CurrentDocument"流程圖說明 4\o"CurrentDocument"WebService服務清單 4供應商預付款信息 錯誤！未定義書簽。需求描述 錯誤！未定義書簽。數(shù)據(jù)類清單 錯誤！未定義書簽。接口交互流程圖 錯誤！未定義書簽。流程圖說明 錯誤！未定義書簽。WebService服務清單 錯誤！未定義書簽。TOC\o"1-5"\h\z\o"CurrentDocument"WEBSERVICE集成 5\o"CurrentDocument"危貨駕駛員報銷接口接口 5危貨駕駛員報銷接口服務 5供應商預付款信息接口 錯誤！未定義書簽。供應商預付款信息服務 錯誤！未定義書簽。\o"CurrentDocument"接口規(guī)約 6\o"CurrentDocument"4.1. WEBSERVIC服務接口基本規(guī)約 6\o"CurrentDocument"技術標準 6\o"CurrentDocument"服務設計原則 7\o"CurrentDocument"服務調(diào)用原則 7\o"CurrentDocument"接口說明 7

1.概述編寫目的為統(tǒng)一智能調(diào)度管理配送平臺與工作流的集成接口，特制定本接口規(guī)范，以指導智能調(diào)度管理配送平臺集成的設計、開發(fā)、測試及部署實施工作。預期讀者本接口規(guī)范預期讀者為智能調(diào)度管理配送平臺和工作流接口設計開發(fā)人員。1.3.術語Webservice集成：通過WebService的方式進行數(shù)據(jù)傳遞的接口集成方式。1.4.交互示意圖智能調(diào)度管理配送《 -平臺 智能調(diào)度管理配送《 -平臺 1、〉慈令=> 工作流系統(tǒng)WebService服務器2.接口需求危貨駕駛員報銷接口需求描述根據(jù)工作流系統(tǒng)業(yè)務開展的要求，需要從智能調(diào)度管理配送平臺中獲取危貨駕駛員報銷接口，為駕駛員補貼等業(yè)務開展提供數(shù)據(jù)支撐。數(shù)據(jù)類清單智能調(diào)度管理配送平臺提供：

m、一sm'數(shù)據(jù)類型數(shù)據(jù)類交互頻度駕駛員任務危貨駕駛員報銷接口2.1.3.接口交互流程圖駕駛員任務信息工作流智能調(diào)度配送管理平

臺工作流流程圖說明1、 工作流系統(tǒng)填寫駕駛員報銷派車單號。2、 工作流系統(tǒng)調(diào)用智能調(diào)度管理配送平臺Webservice接口，通知智能調(diào)度管理配送平臺。3、 智能調(diào)度管理配送平臺接收Webservice通知。4、 智能調(diào)度管理配送平臺將危貨駕駛員報銷接口反饋給工作流系統(tǒng)。WebService服務清單服務提供者服務分類服務名稱

智能調(diào)度管理配送平臺危貨駕駛員報銷接口3.Webservice集成危貨駕駛員報銷接口接口危貨駕駛員報銷接口服務接口說明接口說明工作流系統(tǒng)調(diào)用智能調(diào)度管理配送平臺Webservice接口，智能調(diào)度管理配送平臺將危貨駕駛員報銷接口發(fā)送給工作流系統(tǒng)。接口方式WebService方法名稱WS_DRIVER_REIMBURSEMENT服務端智能調(diào)度管理配送平臺調(diào)用端工作流系統(tǒng)數(shù)據(jù)頻度輸入?yún)?shù)中文名輸入?yún)?shù)英文名參數(shù)格式非空含義派車單號NOMTKString(32)是車載狀態(tài)CTRANSPString(32)是空、重車標識01空車02重車返回值中文名稱返回值英文名稱返回值格式非空含義主駕駛MAIN_DRIVERString(32)否Select DRIVER_NAMEfromT_DRIVERwhereDRIVER_IDin(select DRIVER_ID fromR_TASKINFO whereTASK_NO=’’)副駕駛SECOND_DRIVERString(32)否Select DRIVER_NAMEfromT_DRIVERwhereDRIVER_IDin(selectASSISTANT_DRIVER_NOfrom R_TASKINFO whereTASK_NO=’’)

標準里程DISTZ01String(32)否SelectSTAND_MILEfromT_LINEwhereSTATION_ID=(selectSTATION_IDfromR_TASKINFOwhereTASK_NO=’’)andsrc_idin(selectsrc_idfromR_TASKINFOwhereTASK_NO=’’)車輛編號VEH_TEXTString(256)否表：R_TASKINFO,T_FRONT；FRONT_S_NO路線編號ROUTE01String(32)否SelectLINE_NOfromT_LINEwhereSTATION_ID=(selectSTATION_IDfromR_TASKINFOwhereTASK_NO=’’)andsrc_idin(selectsrc_idfromR_TASKINFOwhereTASK_NO=’’)標準載重量LOAD_WGTString(32)否表:R_TASKINFO,T_TRUCK；TRUCK_VOL設備型號ENGINE_TYPEString(32)否表：R_TASKINFO,T_FRONT；FRONT_MODEL燃料類型FUEL_PRIString(32)否表：R_TASKINFO,T_FRONT；FRONT_TYPE路線描述BEZEIString(256)否T_LINE中氣源地-場站組裝油耗標準FC_STANDString(32)否T_LINE_STAND；FC_STAND路橋費ROAD_STANDString(32)否T_LINE_STAND；ROAD_STAND標準裝氣點裝車時間LOAD_STANDString(32)否T_LINE_STAND；LOAD_STAND標準重車運彳丁時間HEA_STANDString(256)否T_LINE_STAND；HEA_STAND標準卸氣點卸車時間UNLOAD_STANDString(32)否T_LINE_STAND ；UNLOAD_STAND標準空車運行時間EMP_STANDString(32)否T_LINE_STAND；EMP_STAND加油計量單位OIL_MPString(32)否T_LINE_STAND；OIL_MP4.接口規(guī)約Webservice服務接口基本規(guī)約技術標準客戶端和服務器用SOAP協(xié)議通過HTTP來交互，客戶端根據(jù)WSDL描述文檔生成SOAP請求消息發(fā)送到服務端，服務端解析收到的SOAP請求，調(diào)用WebService，然后再生成相應的SOAP應答送回到客戶端。服務設計原則智能調(diào)度管理配送平臺集成應用服務設計主要遵循以下原則：服務設計應遵循“可重用、松耦合、互操作”的原則，以便于實現(xiàn)系統(tǒng)間的集成應用；使用成熟標準實現(xiàn)產(chǎn)品簡化開發(fā)；服務接口無二義性；服務盡量考慮多個應用或者接口需求，增加可重用性；命名服務時應盡量使用通用術語，便于開發(fā)人員理解；服務應對實現(xiàn)細節(jié)進行封裝且粒度適中。服務調(diào)用原則本規(guī)范中所涉及業(yè)務系統(tǒng)提供的WebService服務接收到請求后解析操作編碼后再調(diào)用具體操作。流程接口調(diào)用時，當調(diào)用端調(diào)用接口失敗，應使流程保持在調(diào)用發(fā)生時的環(huán)節(jié)。報文規(guī)范接口說明接口地址內(nèi)網(wǎng)地址：SOAP1.1以下是SOAP1.1請求和響應示例。<SOAP-ENV:Envelopexmlns:SOAP-ENV="/soap/envelope/"xmlns:SOAP-ENC="/soap/encoding/"xmlns:xsi="/2001/XMLSchema-instance"xmlns:xsd="/2001/XMLSchema"><SOAP-ENV:Body><m:Z_O_MI_WF_ECC_049_TSW_NOMINATION_INFOxmlns:m="/workflow"><NOMTK>3000001184</NOMTK><NOMIT>20</NOMIT></m:Z_O_MI_WF_ECC_049_TSW_NOMINATION_INFO></SOAP-ENV:Body></SOAP-ENV:Envelope><SOAP:Envelopexmlns:SOAP="/soap/envelope/"><SOAP:Header/><SOAP:Body><nr1:Z_MT_WF_ECC_049_TSW_NOMIINFO_RESPxmlns:nr1="/ccs”><MAIN_DRIVER>陳二柱</MAIN_DRIVER><SECOND_DRIVER>陳立強</SECON