天貓商城WMS接入標(biāo)準(zhǔn)白皮書(shū)RevisionHistoryDateVersionDescriptionAuthor2023.12.050.5整體框架，系統(tǒng)邏輯，接口邏輯，測(cè)試用例，沙箱使用，聯(lián)調(diào)上線蔣啟帥2023-12-270.6添加X(jué)ML例如，去掉表3-12中的“item-code〞蔣啟帥2023-1-5增加沙箱環(huán)境里的gateway地址蔣啟帥2023-2-22修改日常測(cè)試環(huán)境gateway地址，訂單確認(rèn)中的itemlist.蔣啟帥2023-02-29增加訂單操作的考前須知蔣啟帥2023-10-24訂單確認(rèn)接口修改蔣啟帥目錄目錄第一章前言 41. 前言 42. 名詞解釋 4第二章對(duì)接流程 5第三章系統(tǒng)與接口 7包裝整理費(fèi)-包裹處理費(fèi) 34包裝整理費(fèi)-打包費(fèi) 34包裝整理費(fèi)-包裝物料費(fèi) 35運(yùn)費(fèi)-配送費(fèi) 35裝卸搬運(yùn)費(fèi)-裝卸費(fèi) 35服飾倉(cāng)儲(chǔ)費(fèi) 35電器倉(cāng)儲(chǔ)費(fèi)〔TP〕 36電器倉(cāng)儲(chǔ)費(fèi)〔商家〕 36包裝整理費(fèi)-開(kāi)箱全檢費(fèi) 36包裝整理費(fèi)-熨燙整形費(fèi) 37包裝整理費(fèi)-緊急收貨費(fèi) 37包裝整理費(fèi)-更換包裝費(fèi) 37包裝整理費(fèi)-掛吊牌費(fèi) 37包裝整理費(fèi)-代貼條碼費(fèi) 37包裝整理費(fèi)-退貨入倉(cāng)費(fèi) 38包裝整理費(fèi)-批量退倉(cāng)費(fèi) 38包裝整理費(fèi)-鞋類清潔費(fèi) 38包裝整理費(fèi)-鞋類清潔費(fèi) 38包裝整理費(fèi)-訂單取消返回貨架費(fèi) 38第四章聯(lián)調(diào)與上線 51第一章前言前言淘寶商城，亞洲最大網(wǎng)上購(gòu)物網(wǎng)站——淘寶網(wǎng)打造的在線B2C購(gòu)物平臺(tái)。自2023年4月10日建立淘寶商城以來(lái)，眾多品牌包括聯(lián)想、惠普、優(yōu)衣庫(kù)、迪士尼、Kappa、樂(lè)扣樂(lè)扣、JackJones、羅萊家紡在淘寶商城開(kāi)設(shè)的官方旗艦店，受到了消費(fèi)者的熱烈歡送。迄今為止，淘寶商城已經(jīng)擁有超過(guò)1.8億買(mǎi)家，15000個(gè)商戶，20000個(gè)品牌。目前的淘寶商城處在飛速開(kāi)展階段，多種新型網(wǎng)絡(luò)營(yíng)銷(xiāo)模式正在不斷被開(kāi)創(chuàng)。在淘寶商城業(yè)務(wù)飛速開(kāi)展的過(guò)程中，商城商家產(chǎn)生了巨大的整體電子商務(wù)解決方案需求。物流寶通過(guò)整合各方資源為淘寶商城商家提供了包括物流效勞、ERP效勞在內(nèi)的整體電子商務(wù)解決方案。為了方便ERP合作伙伴能快速了解淘寶商城的業(yè)務(wù)、物流寶業(yè)務(wù)、商城商家的作業(yè)流程，對(duì)接物流寶，參加物流寶體系，從而為商城商家提供更好的效勞，我們推出了ERP接入物流寶白皮書(shū)。本文檔的目標(biāo)讀者為有意向接入物流寶為淘寶商城商家效勞的TMS合作伙伴。名詞解釋W(xué)LB:物流寶B2C：BusinesstoCustomerTMS：TransportationManagementSystem物流管理系統(tǒng)WMS:WarehouseManagementSystem倉(cāng)庫(kù)管理系統(tǒng)TP：淘拍檔〔TaobaoPartner〕，即淘寶合作伙伴，是指參加淘寶合作伙伴方案的各類外包效勞提供商，簡(jiǎn)稱TP。TC:TransactionCenter，交易中心，本文專指淘寶交易中心。LC:LogisticsCenter，物流中心，本文專指淘寶物流中心。第二章對(duì)接流程TP淘寶商城TP淘寶商城業(yè)務(wù)接洽運(yùn)營(yíng)業(yè)務(wù)流程2.垂直市場(chǎng)PD確認(rèn)垂直市場(chǎng)PD3.橫向PD提供申請(qǐng)表橫向PD4.提交申請(qǐng)表橫向PD5.提供白皮書(shū)，組織業(yè)務(wù)技術(shù)講解TP技術(shù)人員技術(shù)支持，橫向PD6.待TP開(kāi)發(fā)完成接口后，提供沙箱賬號(hào)TP技術(shù)人員技術(shù)支持7.調(diào)用接口聯(lián)調(diào)自測(cè)TP技術(shù)人員技術(shù)支持8.反應(yīng)聯(lián)調(diào)結(jié)果TP技術(shù)人員技術(shù)支持9.日常環(huán)境測(cè)試TP技術(shù)人員淘寶測(cè)試人員10.日常測(cè)試通過(guò)后，發(fā)布效勞TP技術(shù)人員運(yùn)營(yíng)11.線上線下聯(lián)調(diào)測(cè)試TP技術(shù)人員淘寶測(cè)試人員技術(shù)流程具體的時(shí)效以及接入流程請(qǐng)參照：《TP接入具體流程.xlsx》，本文僅涉及技術(shù)流程第三章系統(tǒng)與接口3.1.系統(tǒng)邏輯WLB與WMS使用POST方式進(jìn)行通訊。WLB提供gateway效勞。主動(dòng)模式WLBWLBWMS1.WLB下發(fā)消息2.WMS返回TorF圖3-1WLB主動(dòng)模式主動(dòng)模式由WLB下發(fā)消息，WMS在收到消息后，解析消息操作類型和業(yè)務(wù)參數(shù)，指導(dǎo)生產(chǎn)和實(shí)操。此處WMS返回的“T〞，通常只表示通訊正常和消息必選參數(shù)正常。主動(dòng)模式有：出入庫(kù)訂單下發(fā)〔除盤(pán)點(diǎn)單外〕用戶訂購(gòu)倉(cāng)儲(chǔ)效勞消息取消訂單消息被動(dòng)模式WMSWMSWLB1.WMS回傳WLB消息2.WLB返回TorF圖3-2WLB被動(dòng)模式依據(jù)約定，WMS需要將訂單實(shí)操狀態(tài)回傳WLB，或者WMS需要獲取WLB商品信息等等，需要WMS主動(dòng)調(diào)用WLB提供的gateway方法來(lái)完成。WLB會(huì)校驗(yàn)WMS回傳的必選參數(shù)，并做出響應(yīng)。此處的“T〞通常也只表示通訊正常和必選參數(shù)正常。被動(dòng)模式有：WMS回傳庫(kù)內(nèi)實(shí)操訂單狀態(tài)WMS確認(rèn)出入庫(kù)消息WMS上傳盤(pán)點(diǎn)出入庫(kù)單WMS上傳對(duì)賬單WMS查詢商品信息WMS回傳費(fèi)用信息無(wú)論是主動(dòng)或者被動(dòng)模式，都是調(diào)用WLB的gateway中的方法，來(lái)完成通訊。區(qū)別僅是主動(dòng)模式由WLB主動(dòng)下發(fā)消息，而被動(dòng)模式那么是WMS主動(dòng)回傳消息給WLB。3.2.接口概述根本約定〔重要！〕通訊約定：使用POST方式進(jìn)行通訊，參數(shù)不做encode(URL轉(zhuǎn)碼)。參數(shù)大小寫(xiě)約定：沒(méi)有強(qiáng)制要求的地方，統(tǒng)一使用小寫(xiě)。編碼約定：如GBK或UTF-8等，TP指定〔input_charset〕，默認(rèn)入駐時(shí)提交的設(shè)置。參數(shù)約定：支持JSON或XML，TP指定，默認(rèn)入駐時(shí)提交的設(shè)置。簽名約定：對(duì)通訊的業(yè)務(wù)參數(shù)〔content，下文會(huì)提到〕進(jìn)行校驗(yàn)，簽名生成公式：base64(MD5(content+keyValue))，keyValue由TP在發(fā)布WMS效勞時(shí)指定。消息數(shù)量約定：默認(rèn)一個(gè)消息一個(gè)WLB訂單，訂單生成和下發(fā)并行，生成多少下發(fā)多少。當(dāng)涉及批量處理時(shí)，默認(rèn)最多處理50個(gè)。如查詢多個(gè)商品item〔>50〕，一個(gè)消息一次查詢50個(gè)。消息去重約定：在主動(dòng)模式下，WLB通過(guò)下發(fā)字段中的notify_id〔下文會(huì)提到〕去重，WMS假設(shè)收到重復(fù)的notify_id，可以認(rèn)為該消息是重復(fù)下發(fā)?！睺P對(duì)于WLB重復(fù)下發(fā)的消息，假設(shè)已處理，那么直接回傳“T〞〕同樣，被動(dòng)模式下WMS通過(guò)回傳唯一的out_biz_code(下文會(huì)提到)去重。時(shí)間約定：時(shí)間格式使用YYYY-MM-DDHH:mm:ss的格式，精確到秒。Content-Type約定：普通接口：application/x-www-form-urlencoded，上傳文件接口：multipart/form-data〔application/x-www-form-urlencoded：窗體數(shù)據(jù)被編碼為名稱/值對(duì)。multipart/form-data：窗體數(shù)據(jù)被編碼為一條消息，頁(yè)上的每個(gè)控件對(duì)應(yīng)消息中的一個(gè)局部。text/plain：窗體數(shù)據(jù)以純文本形式進(jìn)行編碼，其中不含任何控件或格式字符?！匙侄晤愋图s定：需要嚴(yán)格依據(jù)字段表格中給出的參數(shù)格式和大小進(jìn)行開(kāi)發(fā)，防止類型不匹配或參數(shù)大小預(yù)留不夠?qū)е乱绯?。字段解析約定：參數(shù)字段中的必選字段是每次調(diào)用接口時(shí)都要求必須傳入的。而可選字段會(huì)根據(jù)業(yè)務(wù)場(chǎng)景需求有差異〔在某些特殊業(yè)務(wù)場(chǎng)景下，可選也有可能是必選〕。所以倉(cāng)庫(kù)需根據(jù)實(shí)際業(yè)務(wù)場(chǎng)景，支持解析可選字段。在開(kāi)發(fā)時(shí)，不應(yīng)該認(rèn)為可選字段，就不預(yù)留或不處理。3.2.2主動(dòng)模式根本字段WLB下發(fā)消息給WMS，其根本字段定義如下表所示：接口類名消息請(qǐng)求格式名稱類型可選/必選備注PartnerString(32)必選合作伙伴在淘寶用戶的唯一標(biāo)識(shí)，由淘寶指定。〔向淘寶索取〕如:2088002464631181notify_timeDate必選消息通知時(shí)間YYYY-MM-DDhh:mm:ssnotify_typeString(32)必選通知類型，接口方法名如:wlb_order_notifynotify_idString(32)必選通知ID，每個(gè)消息唯一，用于去重。input_charsetString(16)必選編碼格式GBKUTF-8默認(rèn)GBKSignString(64)必選簽名ContentString必選消息內(nèi)容或者消息參數(shù)，接口的消息參數(shù)，格式為<request><p1/><p2/></request>表3-1主動(dòng)模式根本字段3.2.3被動(dòng)模式根本字段WMS調(diào)用gateway中的接口反應(yīng)或者向WLB查詢消息。接口類名消息請(qǐng)求格式名稱類型可選/必選備注serviceString(64)必選效勞名稱，接口名稱，如wlb_order_notifypartnerString(32)必選合作伙伴在淘寶用戶的唯一標(biāo)識(shí)，由淘寶指定〔向淘寶索取〕如:2088002464631181input_charsetString(16)必選編碼格式GBKUTF-8默認(rèn)GBKout_biz_codeString(64)可選WMS傳入的消息ID，每個(gè)消息唯一，用于消息去重signString(64)必選簽名contentString必選消息內(nèi)容或者消息參數(shù)，接口的消息參數(shù)，格式為<request><p1/><p2/></request>content_typeString可選請(qǐng)求參數(shù)數(shù)據(jù)格式值類型：XML/JSON表3-2被動(dòng)模式根本字段3.2.3被動(dòng)模式消息響應(yīng)字段WLB在收到WMS的消息后，會(huì)立即返回響應(yīng)，其字段定義如下所示：接口類名消息響應(yīng)格式名稱類型可選/必選備注is_successString必選T成功F失敗業(yè)務(wù)參數(shù)responseString可選文檔中下發(fā)接口定義的響應(yīng)格式，格式為<response><p1/><p2/></response>errorString可選錯(cuò)誤信息，如果is_success是T，那么不需要填寫(xiě)該參數(shù)，如果is_success是F,那么必須填寫(xiě)該參數(shù)，便于查找問(wèn)題原因表3-3被動(dòng)模式響應(yīng)字段3.2.4主動(dòng)模式消息響應(yīng)字段同樣WMS在收到WLB消息后，同樣需要立即返回響應(yīng)，其字段定義如下：根本參數(shù)名稱類型可選/必選備注is_successString必選是否成功T成功F失敗業(yè)務(wù)參數(shù)名稱類型可選/必選備注errorString可選錯(cuò)誤信息，如果is_success是T，那么不需要填寫(xiě)該參數(shù)，如果is_success是F,那么必須填寫(xiě)該參數(shù)，便于查找問(wèn)題原因表3-4主動(dòng)模式響應(yīng)字段3.3.接口詳述用戶訂購(gòu)倉(cāng)儲(chǔ)效勞通知〔主動(dòng)模式，sub_params_notify〕WLB在收到貨主訂購(gòu)倉(cāng)儲(chǔ)效勞后，會(huì)立即調(diào)用此接口，下發(fā)貨主信息給WMS。其字段定義如下表所示：接口名稱用戶訂購(gòu)倉(cāng)儲(chǔ)效勞狀態(tài)信息功能描述訂單信息同步接口效勞名稱sub_params_notify名稱類型可選/必選備注partnerString(32)必選合作伙伴ID，由淘寶指定，〔向淘寶索取〕signtypeString(16)必選簽名方式DASMD5signString(64)必選簽名內(nèi)容notify_idString(32)必選消息通知ID，用于去重notify_typeString(11)必選消息通知類型，此處固定是sub_params_notifynotify_timeDate必選消息通知時(shí)間YYYY-MM-DDhh:mm:sscontentString必選請(qǐng)求內(nèi)容<request><user_Id>01000111</user_Id><service_tp_code>ANNTO-0001</service_tp_code><subscriber_nick>劉劉商家測(cè)試1</subscriber_nick><subscriber_mobile/subscriber_mobile><action_Type>ADD</action_Type><content>STO,EMS,HAIBAO</content><remark>備注</remark></request>業(yè)務(wù)參數(shù)content具體內(nèi)容名稱類型可選/必選備注user_idLong(20)必選貨主idservice_codeString(64)必選效勞編碼，淘寶指定subscriber_nameString(32)必選訂購(gòu)用戶名字添加新字段，賣(mài)家注冊(cè)時(shí)填寫(xiě)的真實(shí)姓名添加新字段，賣(mài)家注冊(cè)時(shí)填寫(xiě)的真實(shí)姓名subscriber_nickString(32)必選訂購(gòu)用戶昵稱subscriber_mobileString(32)可選訂購(gòu)用戶subscriber_phoneString(32)可選訂購(gòu)用戶subscriber_contact_emailString(64)可選訂購(gòu)用戶郵箱subscriber_addressString(128)可選訂購(gòu)用戶地址action_typeString(16)必選操作類型：ADD-新增MODIFY-修改CANCEL-取消contentString必選倉(cāng)儲(chǔ)參數(shù)內(nèi)容：默認(rèn)物流公司，第二默認(rèn)物流，包裝材料格式如下：STO,EMS,HAIBAO如果其中為空，格式保持不變r(jià)emarkString(4000)可選備注信息表3-5貨主訂購(gòu)倉(cāng)儲(chǔ)效勞字段WMS返回：WMS在收到貨主訂購(gòu)倉(cāng)儲(chǔ)效勞信息后，必須立刻依照表3-4格式返回“T〞or“F〞。此處返回“T〞表示：1.接受用戶訂購(gòu)倉(cāng)儲(chǔ)效勞2.通訊正常3.約定必選參數(shù)解析正常。XML樣例WLB下發(fā)：<?xmlversion="1.0"encoding="GBK"?><request> <user_id>倉(cāng)儲(chǔ)用戶id</user_id> <service_code>效勞編碼，淘寶指定</service_code> <subscriber_name>訂購(gòu)用戶名字[賣(mài)家注冊(cè)時(shí)填寫(xiě)的真實(shí)姓名]</subscriber_name> <subscriber_nick>訂購(gòu)用戶昵稱</subscriber_nick> <subscriber_mobile>訂購(gòu)用戶</subscriber_mobile> <subscriber_phone>訂購(gòu)用戶</subscriber_phone> <subscriber_contact_email>訂購(gòu)用戶郵箱</subscriber_contact_email> <subscriber_address>訂購(gòu)用戶地址</subscriber_address> <action_type>操作類型：ADD-新增,MODIFY-修改,CANCEL-取消</action_type> <content>倉(cāng)儲(chǔ)參數(shù)內(nèi)容： 默認(rèn)物流公司，第二默認(rèn)物流，包裝材料 格式如下： STO,EMS,HAIBAO 如果其中為空，格式保持不變 </content> <remark>備注信息</remark></request>WMS返回：成功：<?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>T</is_success></wlb>失?。?lt;?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>F</is_success> <error>失敗原因</error></wlb>WLB出入庫(kù)訂單下發(fā)〔主動(dòng)模式，wlb_order_notify〕WLB生成訂單并主動(dòng)下發(fā)訂單給對(duì)應(yīng)的WMS。其字段定義如下表所示：接口類名訂單信息通知接口功能描述訂單信息通知接口(銷(xiāo)售出庫(kù)單銷(xiāo)售入庫(kù)單調(diào)撥出庫(kù)單調(diào)撥入庫(kù)單采購(gòu)入庫(kù)單)效勞名稱wlb_order_notify根底參數(shù)名稱類型可選/必選備注partnerString(32)必選合作伙伴ID，由淘寶指定。〔向淘寶索取〕sign_typeString(16)必選簽名方式DASMD5signString(64)必選簽名內(nèi)容notify_idString(32)必選消息通知ID，用于去重notify_typeString(11)必選消息通知類型，此處固定為：wlb_order_notifynotify_timeString必選消息通知時(shí)間YYYY-MM-DDhh:mm:sscontentString必選內(nèi)容，見(jiàn)業(yè)務(wù)參數(shù)定義業(yè)務(wù)參數(shù)工程名稱類型可選/必選備注訂單根本信息store_codeString(64)必選倉(cāng)儲(chǔ)編碼，淘寶指定。order_codeString(64)必選WLB訂單編碼order_typeInteger(11)必選操作子類型201交易出庫(kù)單301調(diào)撥出庫(kù)單302調(diào)撥入庫(kù)單501退貨入庫(kù)單502換貨出庫(kù)單601采購(gòu)入庫(kù)單901普通出庫(kù)單(如貨主拉走一局部貨)order_sourceInteger(11)必選201淘寶301其他訂單來(lái)源，WMS訂單來(lái)源，WMS可以選擇使用order_create_timeString必選訂單創(chuàng)立時(shí)間order_flagString可選訂單標(biāo)記以逗號(hào)分隔：1:cod–貨到付款2:limit-限時(shí)配送3:presell-預(yù)售4:invoiceinfo-需要發(fā)票8:退換貨9:上門(mén)效勞10:是否可改配送方式默認(rèn)可更改，即沒(méi)1012:是否賣(mài)家承當(dāng)運(yùn)費(fèi)默認(rèn)是，即沒(méi)1213:退貨時(shí)是否收取發(fā)票默認(rèn)不收取,即沒(méi)13為多項(xiàng)選擇項(xiàng)，如1,2,8,9雖然是可選字段，但倉(cāng)庫(kù)必須能夠處理此字段?！仓匾?！〕對(duì)于訂單類型的特殊業(yè)務(wù)要求，如貨到付款，限時(shí)配送，要求帶發(fā)票等等。alipay_noString可選支付寶交易號(hào)COD訂單必選total_amountLong可選總金額訂單總額，非必要字段修改備注信息修改備注信息payable_amountLong可選對(duì)COD必選，應(yīng)收總金額COD訂單必選service_feeLong可選COD效勞費(fèi)COD訂單必選訂單商品很多時(shí)有用〔商品item>50〕，來(lái)判斷是否還有更多的訂單商品order_item_countint(11)可選本消息的order_item數(shù)量當(dāng)distribute_type為1時(shí)為必選訂單屢次下發(fā)必選如訂單中訂單商品明細(xì)數(shù)為500本次下發(fā)50，order_item_count值為50total_order_item_count為500，即WMS需要接收到500個(gè)時(shí)，再開(kāi)始處理訂單，而不是接收到50處理50total_order_item_countint(11)可選總共ITEM數(shù)量當(dāng)distribute_type為1時(shí)為必選訂單屢次下發(fā)必選說(shuō)明同上distribute_typeint(11)必選是否有更多商品0一次發(fā)送1屢次發(fā)送標(biāo)識(shí)訂單屢次下發(fā)實(shí)際配送信息tms_service_codeString(64)可選物流公司編碼銷(xiāo)退單會(huì)使用買(mǎi)家發(fā)貨到倉(cāng)庫(kù)物流上門(mén)取貨的情形那么不用tms_order_codeString(64)可選運(yùn)單號(hào),退貨單有可能有運(yùn)單號(hào)同上prev_order_codeString(64)可選原物流寶訂單編碼，在退換貨時(shí)會(huì)用到退貨入庫(kù)單時(shí)可能會(huì)有銷(xiāo)退單必選調(diào)撥出庫(kù)單必選，對(duì)于調(diào)撥出庫(kù)單，這個(gè)值是調(diào)撥入庫(kù)單的編碼，需要作強(qiáng)校驗(yàn)收貨方信息receiver_infoString(512)可選收貨方發(fā)貨方信息必選其一和必選其一收貨方信息^^^省^^^市^^^區(qū)^^^具體地址^^^收件方名稱^^^^^^交易出庫(kù)單必選換貨出庫(kù)單必選調(diào)撥出庫(kù)單必選調(diào)撥入庫(kù)單必選采購(gòu)單入庫(kù)單可選銷(xiāo)退單可選全部字段都為空值那么該字段為空某個(gè)字段為空用NA來(lái)代替如310012^^^浙江省^^^杭州市^^^西湖區(qū)^^^塘苗路18號(hào)^^^淘寶發(fā)貨方信息sender_infoString(512)可選發(fā)貨方收貨方信息必選其一和必選其一^^^省^^^市^^^區(qū)^^^具體地址^^^發(fā)件方名稱^^^^^^調(diào)撥出庫(kù)單必選調(diào)撥入庫(kù)單必選全部字段都為空值那么該字段為空某個(gè)字段為空用NA來(lái)代替如310012^^^浙江省^^^杭州市^^^西湖區(qū)^^^塘苗路18號(hào)^^^淘寶配送要求〔order_flag字段中有時(shí)效要求時(shí)，有效〕schedule_typeInteger(11)可選投遞時(shí)延要求:1-工作日2-節(jié)假日101,當(dāng)日達(dá)102次晨達(dá)103次日達(dá)如果訂單打上了限時(shí)配送標(biāo)記〔order_flag為2〕，該字段才會(huì)有效如果沒(méi)有限時(shí)配送標(biāo)記那么為非限時(shí)配送各個(gè)值是互拆的關(guān)系，雖然字面意義上有交集schedule_startString可選送達(dá)開(kāi)始時(shí)間COD訂單一定會(huì)有同上格式為hh:mm:ssschedule_endString可選送達(dá)結(jié)束時(shí)間COD訂單一定會(huì)有同上hh:mm:ss訂單商品信息order_item_listList<wlb_order_item>必選訂單商品信息,wlb_order_item見(jiàn)下表3-7<order_item_list></order_item_list>訂單商品明細(xì)信息，這里有可能會(huì)存在一個(gè)訂單里包含兩個(gè)相同的item_id,在解析些數(shù)據(jù)時(shí)請(qǐng)注意package_countInteger(11)包裹數(shù)量入庫(kù)單可能會(huì)關(guān)心這個(gè)字段expect_start_timeString可選預(yù)期送達(dá)開(kāi)始時(shí)間入庫(kù)單常用YYYY-MM-DDhh:mm:ss入庫(kù)單關(guān)心該字段expect_end_timeString可選預(yù)期送達(dá)結(jié)束時(shí)間入庫(kù)單常用YYYY-MM-DDhh:mm:ss入庫(kù)單關(guān)心該字段EXPECT_TIMEstirng可選預(yù)計(jì)開(kāi)始入庫(kù)時(shí)間入庫(kù)單關(guān)鍵字段〔行舟〕invoice_info_listinvoice_info->invoice_info_listinvoice_info->invoice_info_listList<InvoiceItem>可選發(fā)票信息，見(jiàn)下表3-8一個(gè)物流寶訂單可能會(huì)帶多張發(fā)票信息下來(lái)tms_infoString(512)可選運(yùn)辦公司相關(guān)信息出庫(kù)單中可能會(huì)用到運(yùn)輸公司名稱^^^運(yùn)輸公司聯(lián)系人^^^運(yùn)輸公司運(yùn)單號(hào)^^^運(yùn)輸公司^^^運(yùn)輸公司聯(lián)系人身份證號(hào)申通物流^^^張三^^^EG123123^^^^^^特殊字段，在調(diào)撥出庫(kù)時(shí)可能會(huì)用到，如涉及到大宗貨物出庫(kù)時(shí)，倉(cāng)儲(chǔ)公司可能會(huì)要求運(yùn)輸公司的人帶上身份證等上門(mén)取貨，以降低操作風(fēng)險(xiǎn)全部字段都為空值那么該字段為空某個(gè)字段為空用NA來(lái)代替distributor_user_nickString可選帶下來(lái)的信息，一般不用關(guān)心分銷(xiāo)附帶信息訂單其他屬性attributes(2000)String可選擴(kuò)展字段備注remark(4000)String(4000)可選備注表3-6訂單信息下發(fā)字段注意：order_flag可選字段指定訂單的特殊需求。如order_flag中有“2〞時(shí)，表示訂單有時(shí)效要求。WMS在指定快遞時(shí)，需注意選擇可以滿足時(shí)效要求的快遞。同時(shí)時(shí)效要求記錄在schedule_type，schedule_start，schedule_end三個(gè)字段中。order_flag中有“10〞時(shí)，表示商家指定了快遞公司。指定的快遞公司編碼在tms_service_code中。如果商家指定的快遞公司與倉(cāng)實(shí)際指定的有差異，倉(cāng)儲(chǔ)可以與商家協(xié)調(diào)一致。最后使用的快遞以倉(cāng)儲(chǔ)指定的為準(zhǔn)。order_flag中有“4〞時(shí)，表示訂單需要貨票同行效勞，需要WMS解析發(fā)票信息字段(invoice_info_list)。order_flag中有“8〞時(shí)，表示該訂單是退換貨訂單，需要WMS關(guān)注“實(shí)際配送信息〞的相關(guān)字段。order_flag中有“12〞時(shí)，表示該訂單包郵訂單。有“9〞表示該訂單需要上門(mén)退換貨。有“13〞時(shí)表示需要同時(shí)退回發(fā)票。這些主要與TMS有關(guān)。下發(fā)訂單商品信息字段表3-6中商品信息字段如下表所示：不同于商品的不同于商品的item-id,需要TP記錄，在出庫(kù)確認(rèn)時(shí)會(huì)用到。訂單商品對(duì)象wlb_order_item名稱類型可選/必選備注order_item_idLong(20)必選訂單IDorder_source_codeString(64)可選交易編碼sub_source_codeString(64)可選子交易編碼user_idLong(20)必選賣(mài)家ID一般情況下，貨主ID和賣(mài)家ID相同owner_user_id貨主貨主Long(20)必選貨主ID代銷(xiāo)情況下貨主ID和賣(mài)家ID不同item_idLong(20)必選商品IDitem_nameString(64)必選商品名稱item_codeString(64)必選商家編碼〔商品統(tǒng)一條碼，如UCC，EAN〕inventory_typeInt(11)必選庫(kù)存類型1

可銷(xiāo)售庫(kù)存101

殘次102

機(jī)損103

箱損201

凍結(jié)庫(kù)存301

在途庫(kù)存item_quantityLong(11)必選商品數(shù)量item_priceLong(20)可選銷(xiāo)售價(jià)格item_versionitem_public_versionitem_versionitem_public_versionitem_versionInt(11)必選商品版本，WLB允許貨主修改商品屬性描述，每修改一次就對(duì)應(yīng)一個(gè)商品版本信息batch_remarkString(64)可選批次備注〔商超需關(guān)注〕attributesString(2000)可選屬性數(shù)據(jù)KEYVALUE格式，允許貨主新增或修改商品屬性〔KEY〕，如顏色，尺寸等等表3-7訂單商品信息字段下發(fā)訂單發(fā)票字段〔invoice_info_list〕表3-6中發(fā)票字段如下表所示：名稱類型可選/必選備注typeString(64)必選發(fā)票類型增值稅普通發(fā)票普通發(fā)票titleString(64)必選發(fā)票抬頭amountString(64)必選發(fā)票金額contentString(512)可選發(fā)票內(nèi)容表3-8訂單發(fā)票信息字段上表中的發(fā)票內(nèi)容〔content〕，為擴(kuò)展字段，具體商品信息會(huì)隨該字段下發(fā)。其格式為：<content>商品名稱^^商品型號(hào)^^商品數(shù)量^^商品計(jì)量單位^^單價(jià)!!商品名稱^^商品型號(hào)^^商品數(shù)量^^商品計(jì)量單位^^單價(jià)</content>WMS返回：WMS在收到訂單信息后，必須立刻依照表3-4格式返回“T〞or“F〞。此處返回“T〞僅表示：1.通訊正常2.約定必選參數(shù)解析正常。并不代表WMS正式接單。假設(shè)返回“F〞需要附加錯(cuò)誤描述信息。XML樣例WLB下發(fā)：<?xmlversion="1.0"encoding="GBK"?><request><store_code>倉(cāng)儲(chǔ)編碼，淘寶指定</store_code><order_code>WLB訂單編碼</order_code><order_type>操作子類型:201交易出庫(kù)單,301調(diào)撥出庫(kù)單,302調(diào)撥入庫(kù)單,501退貨入庫(kù)單,502換貨出庫(kù)單,601采購(gòu)入庫(kù)單,901普通出庫(kù)單(如貨主拉走一局部貨)</order_type><order_source>[201淘寶301其他]訂單來(lái)源，WMS可以選擇使用</order_source><order_create_time>訂單創(chuàng)立時(shí)間</order_create_time> <order_flag> 訂單標(biāo)記以逗號(hào)分隔： 1:cod–貨到付款 2:limit-限時(shí)配送 3:presell-預(yù)售 4:invoiceinfo-需要發(fā)票 8:退換貨 9:上門(mén)效勞 10:是否可改配送方式默認(rèn)可更改，即沒(méi)10 12:是否賣(mài)家承當(dāng)運(yùn)費(fèi)默認(rèn)是，即沒(méi)12 13:退貨時(shí)是否收取發(fā)票默認(rèn)不收取,即沒(méi)13 為多項(xiàng)選擇項(xiàng)，如1,2,8,9 </order_flag> <alipay_no>支付寶交易號(hào)[COD訂單必選]</alipay_no><total_amount>19560</total_amount> <payable_amount>對(duì)COD必選，應(yīng)收總金額</payable_amount> <service_fee>COD效勞費(fèi)</service_fee><order_item_count> 訂單屢次下發(fā)必選 如訂單中訂單商品明細(xì)數(shù)為500 本次下發(fā)50，order_item_count值為50 total_order_item_count為500，即WMS需要接收到500個(gè)時(shí)，再開(kāi)始處理訂單，而不是接收到50處理50 </order_item_count><total_order_item_count>訂單屢次下發(fā)必選說(shuō)明同上</total_order_item_count><distribute_type>是否有更多商品:0一次發(fā)送1屢次發(fā)送</distribute_type><receiver_info>收貨方發(fā)貨方信息必選其一和必選其一收貨方信息 ^^^省^^^市^^^區(qū)^^^具體地址^^^收件方名稱^^^^^^ 交易出庫(kù)單必選 換貨出庫(kù)單必選 調(diào)撥出庫(kù)單必選 調(diào)撥入庫(kù)單必選 采購(gòu)單入庫(kù)單可選 銷(xiāo)退單可選 全部字段都為空值那么該字段為空 某個(gè)字段為空用NA來(lái)代替 如310012^^^浙江省^^^杭州市^^^西湖區(qū)^^^塘苗路18號(hào)^^^淘寶 </receiver_info><sender_info>發(fā)貨方收貨方信息必選其一和必選其一 ^^^省^^^市^^^區(qū)^^^具體地址^^^發(fā)件方名稱^^^^^^ 調(diào)撥出庫(kù)單必選 調(diào)撥入庫(kù)單必選 全部字段都為空值那么該字段為空 某個(gè)字段為空用NA來(lái)代替 如310012^^^浙江省^^^杭州市^^^西湖區(qū)^^^塘苗路18號(hào)^^^淘寶</sender_info> <invoice_info_list><!--一個(gè)物流寶訂單可能會(huì)帶多張發(fā)票信息下來(lái)--> <invoice_item> <type>發(fā)票類型:1 普通發(fā)票,2 增值稅發(fā)票</type> <title>發(fā)票抬頭</title> <amount>發(fā)票金額</amount> <content>商品名稱^^商品型號(hào)^^商品數(shù)量^^商品計(jì)量單位^^單價(jià)!!商品名稱^^商品型號(hào)^^商品數(shù)量^^商品計(jì)量單位^^單價(jià)</content> </invoice_item> <invoice_item> <type>2</type> <title>2</title> <amount>2</amount> <content>2</content> </invoice_item> <invoice_item> <type>3</type> <title>3</title> <amount>3</amount> <content>3</content> </invoice_item> </invoice_info_list><order_item_list><order_item><order_item_id>訂單商品ID</order_item_id> <order_source_code>交易編碼</order_source_code> <sub_source_code>子交易編碼</sub_source_code><user_id>賣(mài)家ID一般情況下，貨主ID和賣(mài)家ID相同</user_id><owner_user_id>貨主ID代銷(xiāo)情況下貨主ID和賣(mài)家ID不同</owner_user_id><item_id>商品ID[可能會(huì)存在一個(gè)訂單里包含兩個(gè)相同的item_id]</item_id><item_name>商品名稱</item_name><item_code>商家編碼〔商品統(tǒng)一條碼，如UCC，EAN〕</item_code><inventory_type>庫(kù)存類型: 1可銷(xiāo)售庫(kù)存 101殘次 102機(jī)損 103箱損 201凍結(jié)庫(kù)存 301在途庫(kù)存 </inventory_type><item_quantity>商品數(shù)量</item_quantity><item_price>銷(xiāo)售價(jià)格</item_price><item_version>商品版本，WLB允許貨主修改商品屬性描述，每修改一次就對(duì)應(yīng)一個(gè)商品版本信息</item_version><batch_remark>批次備注</batch_remark> <attributes>屬性數(shù)據(jù)KEYVALUE格式，允許貨主新增或修改商品屬性〔KEY〕，如顏色，尺寸等等: 例如分號(hào)key:value;key:value;key:value;key:value; </attributes></order_item> <order_item><order_item_id>105177768</order_item_id> <order_source_code>交易編碼</order_source_code> <sub_source_code>子交易編碼</sub_source_code><user_id>628491299</user_id><owner_user_id>628491299</owner_user_id><item_id>100068102</item_id><item_name>奔騰電飯煲PFFN3009T</item_name><item_code>TB_00018</item_code><inventory_type>1</inventory_type><item_quantity>2</item_quantity><item_price>32600</item_price><item_version>5</item_version> <batch_remark>批次備注</batch_remark><attributes></attributes></order_item> <order_item><order_item_id>105177769</order_item_id> <order_source_code>交易編碼</order_source_code> <sub_source_code>子交易編碼</sub_source_code><user_id>628491299</user_id><owner_user_id>628491299</owner_user_id><item_id>100068102</item_id><item_name>奔騰電飯煲PFFN3009T</item_name><item_code>TB_00018</item_code><inventory_type>1</inventory_type><item_quantity>2</item_quantity><item_price>32600</item_price><item_version>5</item_version> <batch_remark>批次備注</batch_remark><attributes></attributes></order_item></order_item_list> <package_count>包裹數(shù)量</package_count> <expect_start_time>預(yù)期送達(dá)開(kāi)始時(shí)間入庫(kù)單常用:YYYY-MM-DDhh:mm:ss</expect_start_time> <expect_end_time>預(yù)期送達(dá)結(jié)束時(shí)間入庫(kù)單常用:YYYY-MM-DDhh:mm:ss</expect_end_time> <schedule_type>投遞時(shí)延要求:1-工作日2-節(jié)假日101,當(dāng)日達(dá)102次晨達(dá)103次日達(dá)</schedule_type> <schedule_start>送達(dá)開(kāi)始時(shí)間COD訂單一定會(huì)有</schedule_start> <schedule_end>送達(dá)結(jié)束時(shí)間COD訂單一定會(huì)有</schedule_end> <tms_info>運(yùn)辦公司相關(guān)信息 出庫(kù)單中可能會(huì)用到 運(yùn)輸公司名稱^^^運(yùn)輸公司聯(lián)系人^^^運(yùn)輸公司運(yùn)單號(hào)^^^運(yùn)輸公司^^^運(yùn)輸公司聯(lián)系人身份證號(hào) 申通物流^^^張三^^^ </tms_info> <distributor_user_nick>帶下來(lái)的信息，一般不用關(guān)心[分銷(xiāo)附帶信息]</distributor_user_nick> <attributes>{擴(kuò)展字段}</attributes> <remark>備注</remark></request>WMS返回：成功：<?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>T</is_success></wlb>失?。?lt;?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>F</is_success> <error>失敗原因</error></wlb>WMS訂單狀態(tài)回傳〔被動(dòng)模式，wlb_order_info_sync〕依據(jù)約定，WMS需要將庫(kù)內(nèi)實(shí)操狀態(tài)回傳WLB。WLB將依據(jù)回傳消息在TC前臺(tái)顯示。狀態(tài)約定WMS_ACCEPT出庫(kù)入庫(kù)，共有狀態(tài)。WMS確認(rèn)訂單可以處理，并正式接單。需要特別強(qiáng)調(diào)：WMS未回傳接單，假設(shè)產(chǎn)生撤單〔訂單取消〕，WLB不會(huì)調(diào)用取消訂單接口〔下文會(huì)提到〕通知WMS。因?yàn)閃LB認(rèn)為此時(shí)WMS未接單，訂單將被直接取消而不會(huì)有通知。假設(shè)WMS已回傳接單，假設(shè)產(chǎn)生撤單，WLB會(huì)詢問(wèn)WMS是否允許撤單。假設(shè)WMS拒絕撤單，訂單將無(wú)法取消?；貍鳡顟B(tài)的起點(diǎn)必須是WMS_ACCECPT或WMS_REJECT。目前接單后不允許回傳拒單。WMS_REJECT出庫(kù)入庫(kù)，共有狀態(tài)。WMS確認(rèn)訂單無(wú)法處理，返回拒單。WMS_PRINT出庫(kù)實(shí)操。WMS打印揀貨單。WMS_PICK出庫(kù)實(shí)操，WMS開(kāi)始揀貨。WMS_CHECK出庫(kù)實(shí)操，WMS復(fù)核訂單商品。WMS_PACKAGE出庫(kù)實(shí)操，WMS打包訂單商品。WMS_FAILED出庫(kù)實(shí)操，訂單發(fā)貨失敗〔買(mǎi)家拒簽〕訂單狀態(tài)回傳字段如下表所示：接口類名訂單信息同步接口功能描述訂單信息同步接口本接口和TMS共用效勞名稱wlb_order_info_sync根本參數(shù)名稱類型可選/必選備注serviceString(64)必選效勞名稱，此處固定為：wlb_order_info_syncpartnerString(32)必選合作伙伴在淘寶注冊(cè)的用戶ID，由淘寶指定〔向淘寶索取〕sign_typeString(16)必選簽名類型MD5DSAsignString(64)必選簽名內(nèi)容contentString必選詳細(xì)見(jiàn)業(yè)務(wù)參數(shù)業(yè)務(wù)參數(shù)content名稱類型可選/必選備注out_biz_codeString(64)必選消息ID，用來(lái)去重。service_codeString(64)必選倉(cāng)庫(kù)編碼，淘寶指定order_codeString(64)必選WLB訂單編碼tms_order_codeString(64)可選該字段供TMS使用，用來(lái)回傳TMS運(yùn)送狀態(tài)標(biāo)識(shí)operatorString(64)必選操作人operator_contactString(64)可選針對(duì)TMS狀態(tài)回傳有效聯(lián)系人operator_dateString必選操作時(shí)間格式y(tǒng)yyy-mm-ddhh:mm:ssstatusString(32)必選信息內(nèi)容：WMS_ACCEPT-接單WMS_PRINT-打印WMS_PICK-撿貨WMS_CHECK-復(fù)核WMS_PACKAGE-打包WMS_REJECT-接單失敗WMS_FAILED-訂單發(fā)貨失敗(買(mǎi)家拒簽)contentString(2000)可選狀態(tài)更改描述，中文描述remarkString(4000)可選備注表3-9訂單狀態(tài)回傳字段WLB返回：WLB在收到訂單狀態(tài)變化信息后，會(huì)即刻依照表3-3格式返回“T〞or“F〞。當(dāng)WMS返回“WMS_ACCEPT〞時(shí)，WLB返回“T〞，那么表示W(wǎng)LB接受WMS接單。假設(shè)返回“F〞，WMS需要判斷WLB返回的錯(cuò)誤信息里是否有訂單已被取消的描述。其他狀態(tài)回傳，WLB返回“T〞僅表示1.通訊正常2.參數(shù)必選字段解析正常。XML樣例WMS回傳：<?xmlversion="1.0"encoding="GBK"?><request><out_biz_code>消息ID，用來(lái)去重</out_biz_code><service_code>倉(cāng)庫(kù)編碼，淘寶指定</service_code><order_code>WLB訂單編碼</order_code><tms_order_code>該字段供TMS使用，用來(lái)回傳TMS運(yùn)送狀態(tài)標(biāo)識(shí)</tms_order_code><operator>操作人</operator><operator_contact>針對(duì)TMS狀態(tài)回傳有效:聯(lián)系人</operator_contact><operator_date>操作時(shí)間格式y(tǒng)yyy-mm-ddhh:mm:ss</operator_date><status>信息內(nèi)容： WMS_ACCEPT-接單 WMS_PRINT-打印 WMS_PICK-撿貨 WMS_CHECK-復(fù)核 WMS_PACKAGE-打包 WMS_REJECT-接單失敗 WMS_FAILED-訂單發(fā)貨失敗(買(mǎi)家拒簽)</status><content>狀態(tài)更改描述，中文描述</content><remark></remark></request>WLB返回：成功：<?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>T</is_success></wlb>失?。?lt;?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>F</is_success> <error>失敗原因</error></wlb>WMS確認(rèn)訂單出入庫(kù)〔被動(dòng)模式，wlb_order_confirm〕狀態(tài)約定出庫(kù)時(shí)，WMS確認(rèn)訂單出庫(kù)，那么表示訂單商品已完成所有庫(kù)內(nèi)操作，商品已打包，TMS可以直接上門(mén)攬件。只允許出庫(kù)確認(rèn)回傳1次，如果有拆單，多個(gè)運(yùn)單號(hào)也1次回傳所有信息，每個(gè)運(yùn)單跟包裹中的SKU關(guān)聯(lián)，重量、體積、包材型號(hào)，包材數(shù)量等一起回傳。如果倉(cāng)庫(kù)對(duì)物流寶訂單合并包裹，倉(cāng)庫(kù)需對(duì)每個(gè)訂單分別進(jìn)行確認(rèn)，分別確認(rèn)的時(shí)候需要回傳與確認(rèn)訂單進(jìn)行合并包裹的訂單。入庫(kù)時(shí)，WMS確認(rèn)入庫(kù)，那么表示訂單已完成所有入庫(kù)庫(kù)內(nèi)操作，商品已上架并處于可銷(xiāo)售操作。此接口支持不同商品分批確認(rèn)，不支持同一商品屢次確認(rèn)?！苍敲词且粋€(gè)商品，不管到貨多少件，一個(gè)訂單里只允許確認(rèn)入庫(kù)一次?！尘植咳霂?kù)：不同商品可以分批次入庫(kù)，同樣遵循同一個(gè)商品，只允許確認(rèn)入庫(kù)一次的原那么。當(dāng)出現(xiàn)局部入庫(kù)時(shí)，商品庫(kù)存處于凍結(jié)狀態(tài)，只有完全入庫(kù)后商品庫(kù)存才會(huì)增加。〔所以訂單不應(yīng)該長(zhǎng)期處于局部入庫(kù)狀態(tài)。〕在實(shí)操中，如果某一商品遲遲都無(wú)法到貨，建議按0個(gè)商品數(shù)量做回傳，關(guān)閉掉訂單。在實(shí)操時(shí)，必須嚴(yán)格按照約定的狀態(tài)進(jìn)行回傳。出庫(kù)時(shí)，假設(shè)過(guò)早回傳確認(rèn)訂單出庫(kù)，會(huì)導(dǎo)致TMS攬不到件。入庫(kù)時(shí)，假設(shè)過(guò)早回傳確認(rèn)入庫(kù)，會(huì)導(dǎo)致商品在淘寶前臺(tái)已上架，但實(shí)際并未處于可銷(xiāo)狀態(tài)。同樣假設(shè)過(guò)晚回傳，會(huì)導(dǎo)致商品一直處于庫(kù)內(nèi)操作狀態(tài)，影響信息流和實(shí)物流。影響用戶體驗(yàn)。同樣，也影響淘寶對(duì)TP的評(píng)分。另外需要注意的是，WLB允許訂單屢次確認(rèn)，即分批次確認(rèn)訂單商品入庫(kù)。在調(diào)用此接口后，商品庫(kù)存將產(chǎn)生扣減或增加。需要特別注意。訂單確認(rèn)出入庫(kù)字段根本參數(shù)根本參數(shù)名稱類型可選/必選備注serviceString(64)必選效勞名稱固定值wlb_order_confirmpartnerString(32)必選合作伙伴ID，由淘寶指定〔向淘寶索取〕signtypeString(11)必選簽名方式DSAMD5signString(64)必選簽名內(nèi)容contentString必選參數(shù)，具體見(jiàn)業(yè)務(wù)參數(shù)定義業(yè)務(wù)參數(shù)contnt名稱類型可選/必選備注order_codeString(64)必選物流寶訂單編碼out_biz_codeString(64)必選外部業(yè)務(wù)編碼，消息ID，用于去重一個(gè)合作伙伴中要求唯一屢次確認(rèn)時(shí)，每次傳入要求唯一tms_order_listList<tms_order>可選快遞單列表<tms_order_list><tms_order><tms_service_code/><tms_order_code/><remark新加，備注信息/>新加，備注信息<package_weight/>從訂單級(jí)別移到運(yùn)單級(jí)別，回傳包裹重量從訂單級(jí)別移到運(yùn)單級(jí)別，回傳包裹重量<package_length/><package_width/><package_height/><package_material_list><package_material>新加，回傳包裹使用的包材信息新加，回傳包裹使用的包材信息<material_type/><material_quantity/></package_material></package_material_list><tms_item_list><tms_item>新加，回傳包裹里面的商品信息新加，回傳包裹里面的商品信息<item_id><item_quantity></tms_item></tms_item_list></tms_order></tms_order_list>快遞單字段見(jiàn)表3-11confirm_typeInt(11)必選支持出入庫(kù)單屢次確認(rèn)入庫(kù)單允許對(duì)不同商品分批確認(rèn)，不允許對(duì)同一個(gè)商品分批確認(rèn)。出庫(kù)單不允許對(duì)商品進(jìn)行分配確認(rèn)，只能一次確認(rèn)回傳。入庫(kù)單允許對(duì)不同商品分批確認(rèn)，不允許對(duì)同一個(gè)商品分批確認(rèn)。出庫(kù)單不允許對(duì)商品進(jìn)行分配確認(rèn)，只能一次確認(rèn)回傳。0最后一次確認(rèn)或是一次性確認(rèn)1屢次確認(rèn)當(dāng)屢次確認(rèn)時(shí)，確認(rèn)的ITEM種類全部被確認(rèn)時(shí)，確認(rèn)完成默認(rèn)值為0例如輸入2認(rèn)為是0package_weightInt(11)可選該訂單的包裹重量，單位：g，主要是給商超銷(xiāo)售訂單使用package_heightDouble可選該訂單的包裹高度，單位：厘米package_lengthDouble可選該訂單的包裹長(zhǎng)度，單位：厘米package_widthDouble可選該訂單的包裹寬度，單位：厘米這四個(gè)包裹信息全部移到tms_order_list這四個(gè)包裹信息全部移到tms_order_list里面order_item_listList<OrderItem>必選商品信息<order_item_list><order_item><order_item_id/><owner_user_id/><weight/><length/><width/><height/><is_completed><item_list><item><inventory_type/><quantity/><!—批次相關(guān)信息<batch_code/><due_date/><guarantee_period/><guarantee_unit/><produce_area/><produce_code/><produce_date/><!—批次相關(guān)信息</item></item_list></order_item></order_item_list>訂單商品字段見(jiàn)表3-12wlb_order_joinString(256)可選合單的訂單號(hào),如本訂單與LBX111合單，那么值為L(zhǎng)BX111。超過(guò)2個(gè)訂單合單,以分號(hào)隔開(kāi),如LBX123;LBX223新加，回傳與這個(gè)訂單進(jìn)行合單的新加，回傳與這個(gè)訂單進(jìn)行合單的其他訂單信息featureString(512)可選擴(kuò)展字段；以key:value形式組合。Key，value以冒號(hào)隔開(kāi)，多個(gè)key:value以分號(hào)隔開(kāi)；貨票同行order_invoice_listList<Invoice>可選<order_invoice_list><invoice><tradeNumber/><invoiceNumber/><invoiceCode新加，回傳訂單發(fā)票信息/>新加，回傳訂單發(fā)票信息<invoice></order_invoice_list>tradeNumber表示交易號(hào)invoiceNumber表示發(fā)票號(hào)invoiceCode表示發(fā)票代碼表3-10WMS確認(rèn)訂單出入庫(kù)字段運(yùn)單字段表3-11中的運(yùn)單字段運(yùn)單對(duì)象tms_order名稱類型可選/必選備注tms_service_codeString(64)必選快遞公司效勞編碼〔由淘寶指定〕tms_order_codeString(64)必選運(yùn)單編碼package_weightInt(11)必選包裹重量，單位：克必選必選package_lengthInt(11)可選包裹長(zhǎng)度，單位：毫米注意單位注意單位package_widthInt(11)可選包裹寬度，單位：毫米package_heightInt(11)可選包裹高度，單位：毫米package_material_listList<package_material>可選包裹的包材信息tms_item_listList<tms_item>可選包裹里面的商品信息remarkString(256)可選包裹備注信息新加新加表3-11確認(rèn)訂單中的運(yùn)單字段表3-12中的包材字段包材對(duì)象package_material名稱類型可選/必選備注material_typeString(64)必選如果包材對(duì)象不為空，那么型號(hào)和數(shù)量不能為空如果包材對(duì)象不為空，那么型號(hào)和數(shù)量不能為空淘寶指定的包材型號(hào)見(jiàn)附錄1,回傳包材編碼見(jiàn)附錄1,回傳包材編碼material_quantityInt(11)必選包材的數(shù)量表3-12運(yùn)單中的包材字段表3-13中的運(yùn)單商品字段運(yùn)單商品對(duì)象tms_item名稱類型可選/必選備注item_idLong(19)必選物流寶商品id類型改為L(zhǎng)ong類型改為L(zhǎng)ongitem_quantityInt(11)必選此運(yùn)單里該商品的數(shù)量表3-13運(yùn)單中的包材字段注意：WMS在發(fā)布效勞后，淘寶小二將為其指定TMS，即WMS和TMS的綁定。并告知TMS編碼和運(yùn)單規(guī)那么。在訂單出庫(kù)時(shí)，WMS必須回傳正確的快遞公司編碼和運(yùn)單號(hào)。WLB將對(duì)快遞公司和運(yùn)單號(hào)進(jìn)行校驗(yàn)。假設(shè)出錯(cuò)那么會(huì)要求WMS重傳。WMS需要依據(jù)約定，盡量減少線下的溝通，如通知TMS攬貨等等。訂單商品字段無(wú)改動(dòng)無(wú)改動(dòng)表3-14中的訂單商品字段商品結(jié)構(gòu)屬性order_item名稱類型可選/必選備注order_item_idLong(20)必選order_item_idowner_user_idLong(20)必選貨主IDweightInteger(11)可選sku重量單位克入庫(kù)時(shí)為必選入庫(kù)時(shí)為必選lengthInteger(11)可選長(zhǎng)單位mmwidthInteger(11)可選寬單位mmheightInteger(11)可選高單位mmis_completedboolean可選是否完成不支持同一個(gè)商品分批確認(rèn)不支持同一個(gè)商品分批確認(rèn)item_listList<item>必選商品屬性列表，見(jiàn)表3-13表3-14確認(rèn)訂單中的商品字段商品屬性字段無(wú)改動(dòng)無(wú)改動(dòng)表3-15中的商品屬性字段商品結(jié)構(gòu)屬性item名稱類型可選/必選備注inventory_typeInteger(11)必選庫(kù)存類型1可銷(xiāo)售庫(kù)存101類型用來(lái)定義殘次品201凍結(jié)類型庫(kù)存301在途庫(kù)存quantityInteger(11)必選數(shù)量batch_codeString(64)可選批次號(hào)due_dateString(32)可選到貨日期guarantee_periodLong(20)可選保質(zhì)期，默認(rèn)以天為單位guarantee_unitInteger(11)可選保質(zhì)期單位produce_areaString(255)可選生產(chǎn)地區(qū)produce_codeString(255)可選生產(chǎn)編碼,同一商品可能因商家有不同編碼。produce_dateString(32)可選YYYY-MM-DDhh:mm:ss表3-15商品屬性字段發(fā)票信息字段商品結(jié)構(gòu)屬性invoice名稱類型可選/必選備注tradeNumberString(64)可選invoiceNumberString(64)必選發(fā)票號(hào)invoiceCodeString(64)可選發(fā)票代碼表3-16發(fā)票屬性字段WLB返回：WLB在收到訂單狀態(tài)變化信息后，會(huì)即刻依照表3-3格式返回“T〞or“F〞。此處的“T〞表示W(wǎng)LB接受WMS訂單出庫(kù)或入庫(kù)，商家?guī)齑鎸a(chǎn)生增減。假設(shè)返回“F〞，WMS需要檢驗(yàn)訂單是否有已被取消的描述。XML樣例WMS回傳：<?xmlversion="1.0"encoding="GBK"?><request><order_code>物流寶訂單編碼</order_code><out_biz_code>外部業(yè)務(wù)編碼，消息ID，用于去重</out_biz_code><confirm_type>支持入庫(kù)單屢次確認(rèn)0最后一次確認(rèn)或是一次性確認(rèn)1屢次確認(rèn)當(dāng)屢次確認(rèn)時(shí)，確認(rèn)的ITEM種類全部被確認(rèn)時(shí)，確認(rèn)完成</confirm_type><wlb_order_join>LBX1111;LBX222</wlb_order_join><feature>invoiceNumber:1234;invoiceCode:abc12</feature><tms_order_list><tms_order><tms_service_code>快遞公司效勞編碼〔由淘寶指定〕</tms_service_code><tms_order_code>運(yùn)單編碼</tms_order_code><package_weight>包裹重量<package_weight/><package_length>包裹長(zhǎng)度<package_length/><package_width>包裹寬度<package_width/><package_height>包裹高度<package_height/><package_material_list><package_material><material_type>包材型號(hào)1<material_type/><material_quantity/>數(shù)量<material_quantity/></package_material><package_material><material_type>包材型號(hào)2<material_type/><material_quantity/>數(shù)量<material_quantity/></package_material></package_material_list><tms_item_list><tms_item><item_id>商品id</item_id><item_quantity>商品數(shù)量</item_quantity></tms_item></tms_item_list></tms_order> <!--標(biāo)識(shí)多條數(shù)據(jù)--> <tms_order><tms_service_code>快遞公司效勞編碼〔由淘寶指定〕</tms_service_code><tms_order_code>運(yùn)單編碼</tms_order_code><package_weight>包裹重量<package_weight/><package_length>包裹長(zhǎng)度<package_length/><package_width>包裹寬度<package_width/><package_height>包裹高度<package_height/><package_material_list><package_material><material_type>包材型號(hào)1<material_type/><material_quantity/>數(shù)量<material_quantity/></package_material><package_material><material_type>包材型號(hào)2<material_type/><material_quantity/>數(shù)量<material_quantity/></package_material></package_material_list><tms_item_list><tms_item><item_id>商品id</item_id><item_quantity>商品數(shù)量</item_quantity></tms_item></tms_item_list></tms_order></tms_order_list><order_item_list><order_item><order_item_id>order_item_id</order_item_id> <owner_user_id>貨主ID</owner_user_id><weight>重量單位克</weight><length>長(zhǎng)單位mm</length><width>寬單位mm</width><height>高單位mm</height><is_completed>是否完成</is_completed><item_list><item><inventory_type>庫(kù)存類型 1可銷(xiāo)售庫(kù)存 101類型用來(lái)定義殘次品 201凍結(jié)類型庫(kù)存 301在途庫(kù)存 </inventory_type><quantity>數(shù)量</quantity> <batch_code>批次號(hào)</batch_code> <due_date>到貨日期</due_date> <guarantee_period>保質(zhì)期，默認(rèn)以天為單位</guarantee_period> <guarantee_unit>保質(zhì)期單位</guarantee_unit> <produce_area>生產(chǎn)地區(qū)</produce_area> <produce_code>生產(chǎn)編碼,同一商品可能因商家有不同編碼</produce_code> <produce_date>YYYY-MM-DDhh:mm:ss</produce_date></item><item_list></order_item> <order_item> <!--標(biāo)識(shí)多條數(shù)據(jù)--><order_item_id>order_item_id</order_item_id> <owner_user_id>貨主ID</owner_user_id><weight>重量單位克</weight><length>長(zhǎng)單位mm</length><width>寬單位mm</width><height>高單位mm</height><is_completed>是否完成</is_completed><item_list><item><inventory_type>庫(kù)存類型 1可銷(xiāo)售庫(kù)存 101類型用來(lái)定義殘次品 201凍結(jié)類型庫(kù)存 301在途庫(kù)存 </inventory_type><quantity>數(shù)量</quantity> <batch_code>批次號(hào)</batch_code> <due_date>到貨日期</due_date> <guarantee_period>保質(zhì)期，默認(rèn)以天為單位</guarantee_period> <guarantee_unit>保質(zhì)期單位</guarantee_unit> <produce_area>生產(chǎn)地區(qū)</produce_area> <produce_code>生產(chǎn)編碼,同一商品可能因商家有不同編碼</produce_code> <produce_date>YYYY-MM-DDhh:mm:ss</produce_date></item><item_list></order_item></order_item_list><order_invoice_list><invoice><tradeNumber>交易號(hào)</traderNumber><invoiceNumber/>發(fā)票號(hào)</invoiceNumber><invoiceCode/>發(fā)票代碼</invoiceCode><invoice></order_invoice_list></request>WLB返回：成功：-<?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>T</is_success></wlb>失敗<?xmlversion="1.0"encoding="GBK"?><wlb> <is_success>F</is_success> <error>失敗原因</error></wlb>附錄1〔包材定義〕包材編碼型號(hào)規(guī)格尺寸重量PNTM_0010011#250*200*1200.15001001TM_0010022#370*310*900.29001002TM_0010033#400*200*1200.20001003TM_0010044#310*420*1000.30001004TM_0010055#400*300*1500.32001005TM_0010066#550*400*2000.58001006TM_0010077#250*210*1300.16001007TM_0010088#390*280*1500.29001008TM_0010099#390*280*2900.40001009TM_00101010#450*270*3900.50001010TM_00101111#550*400*1400.52001011TM_00101212#760*330*1200.47001012TM_001101特賣(mài)1#95*250*2000.14001101TM_001102特賣(mài)2#350*285*600.22001102TM_001103特賣(mài)3#430*315*1050.32001103TM_001104特賣(mài)4#400*300*1500.32001104TM_001105特賣(mài)5#390*280*2900.