天猫商城WMS接入规范白皮书

天猫商城WMS接入标准白皮书RevisionHistoryDateVersionDescriptionAuthor2023.12.050.5整体框架，系统逻辑，接口逻辑，测试用例，沙箱使用，联调上线蒋启帅2023-12-270.6添加XML例如，去掉表3-12中的“item-code〞蒋启帅2023-1-5增加沙箱环境里的gateway地址蒋启帅2023-2-22修改日常测试环境gateway地址，订单确认中的itemlist.蒋启帅2023-02-29增加订单操作的考前须知蒋启帅2023-10-24订单确认接口修改蒋启帅目录目录第一章前言 41. 前言 42. 名词解释 4第二章对接流程 5第三章系统与接口 7包装整理费-包裹处理费 34包装整理费-打包费 34包装整理费-包装物料费 35运费-配送费 35装卸搬运费-装卸费 35服饰仓储费 35电器仓储费〔TP〕 36电器仓储费〔商家〕 36包装整理费-开箱全检费 36包装整理费-熨烫整形费 37包装整理费-紧急收货费 37包装整理费-更换包装费 37包装整理费-挂吊牌费 37包装整理费-代贴条码费 37包装整理费-退货入仓费 38包装整理费-批量退仓费 38包装整理费-鞋类清洁费 38包装整理费-鞋类清洁费 38包装整理费-订单取消返回货架费 38第四章联调与上线 51第一章前言前言淘宝商城，亚洲最大网上购物网站——淘宝网打造的在线B2C购物平台。自2023年4月10日建立淘宝商城以来，众多品牌包括联想、惠普、优衣库、迪士尼、Kappa、乐扣乐扣、JackJones、罗莱家纺在淘宝商城开设的官方旗舰店，受到了消费者的热烈欢送。迄今为止，淘宝商城已经拥有超过1.8亿买家，15000个商户，20000个品牌。目前的淘宝商城处在飞速开展阶段，多种新型网络营销模式正在不断被开创。在淘宝商城业务飞速开展的过程中，商城商家产生了巨大的整体电子商务解决方案需求。物流宝通过整合各方资源为淘宝商城商家提供了包括物流效劳、ERP效劳在内的整体电子商务解决方案。为了方便ERP合作伙伴能快速了解淘宝商城的业务、物流宝业务、商城商家的作业流程，对接物流宝，参加物流宝体系，从而为商城商家提供更好的效劳，我们推出了ERP接入物流宝白皮书。本文档的目标读者为有意向接入物流宝为淘宝商城商家效劳的TMS合作伙伴。名词解释WLB:物流宝B2C：BusinesstoCustomerTMS：TransportationManagementSystem物流管理系统WMS:WarehouseManagementSystem仓库管理系统TP：淘拍档〔TaobaoPartner〕，即淘宝合作伙伴，是指参加淘宝合作伙伴方案的各类外包效劳提供商，简称TP。TC:TransactionCenter，交易中心，本文专指淘宝交易中心。LC:LogisticsCenter，物流中心，本文专指淘宝物流中心。第二章对接流程TP淘宝商城TP淘宝商城业务接洽运营业务流程2.垂直市场PD确认垂直市场PD3.横向PD提供申请表横向PD4.提交申请表横向PD5.提供白皮书，组织业务技术讲解TP技术人员技术支持，横向PD6.待TP开发完成接口后，提供沙箱账号TP技术人员技术支持7.调用接口联调自测TP技术人员技术支持8.反应联调结果TP技术人员技术支持9.日常环境测试TP技术人员淘宝测试人员10.日常测试通过后，发布效劳TP技术人员运营11.线上线下联调测试TP技术人员淘宝测试人员技术流程具体的时效以及接入流程请参照：《TP接入具体流程.xlsx》，本文仅涉及技术流程第三章系统与接口3.1.系统逻辑WLB与WMS使用POST方式进行通讯。WLB提供gateway效劳。主动模式WLBWLBWMS1.WLB下发消息2.WMS返回TorF图3-1WLB主动模式主动模式由WLB下发消息，WMS在收到消息后，解析消息操作类型和业务参数，指导生产和实操。此处WMS返回的“T〞，通常只表示通讯正常和消息必选参数正常。主动模式有：出入库订单下发〔除盘点单外〕用户订购仓储效劳消息取消订单消息被动模式WMSWMSWLB1.WMS回传WLB消息2.WLB返回TorF图3-2WLB被动模式依据约定，WMS需要将订单实操状态回传WLB，或者WMS需要获取WLB商品信息等等，需要WMS主动调用WLB提供的gateway方法来完成。WLB会校验WMS回传的必选参数，并做出响应。此处的“T〞通常也只表示通讯正常和必选参数正常。被动模式有：WMS回传库内实操订单状态WMS确认出入库消息WMS上传盘点出入库单WMS上传对账单WMS查询商品信息WMS回传费用信息无论是主动或者被动模式，都是调用WLB的gateway中的方法，来完成通讯。区别仅是主动模式由WLB主动下发消息，而被动模式那么是WMS主动回传消息给WLB。3.2.接口概述根本约定〔重要！〕通讯约定：使用POST方式进行通讯，参数不做encode(URL转码)。参数大小写约定：没有强制要求的地方，统一使用小写。编码约定：如GBK或UTF-8等，TP指定〔input_charset〕，默认入驻时提交的设置。参数约定：支持JSON或XML，TP指定，默认入驻时提交的设置。签名约定：对通讯的业务参数〔content，下文会提到〕进行校验，签名生成公式：base64(MD5(content+keyValue))，keyValue由TP在发布WMS效劳时指定。消息数量约定：默认一个消息一个WLB订单，订单生成和下发并行，生成多少下发多少。当涉及批量处理时，默认最多处理50个。如查询多个商品item〔>50〕，一个消息一次查询50个。消息去重约定：在主动模式下，WLB通过下发字段中的notify_id〔下文会提到〕去重，WMS假设收到重复的notify_id，可以认为该消息是重复下发。〔TP对于WLB重复下发的消息，假设已处理，那么直接回传“T〞〕同样，被动模式下WMS通过回传唯一的out_biz_code(下文会提到)去重。时间约定：时间格式使用YYYY-MM-DDHH:mm:ss的格式，精确到秒。Content-Type约定：普通接口：application/x-www-form-urlencoded，上传文件接口：multipart/form-data〔application/x-www-form-urlencoded：窗体数据被编码为名称/值对。multipart/form-data：窗体数据被编码为一条消息，页上的每个控件对应消息中的一个局部。text/plain：窗体数据以纯文本形式进行编码，其中不含任何控件或格式字符。〕字段类型约定：需要严格依据字段表格中给出的参数格式和大小进行开发，防止类型不匹配或参数大小预留不够导致溢出。字段解析约定：参数字段中的必选字段是每次调用接口时都要求必须传入的。而可选字段会根据业务场景需求有差异〔在某些特殊业务场景下，可选也有可能是必选〕。所以仓库需根据实际业务场景，支持解析可选字段。在开发时，不应该认为可选字段，就不预留或不处理。3.2.2主动模式根本字段WLB下发消息给WMS，其根本字段定义如下表所示：接口类名消息请求格式名称类型可选/必选备注PartnerString(32)必选合作伙伴在淘宝用户的唯一标识，由淘宝指定。〔向淘宝索取〕如:2088002464631181notify_timeDate必选消息通知时间YYYY-MM-DDhh:mm:ssnotify_typeString(32)必选通知类型，接口方法名如:wlb_order_notifynotify_idString(32)必选通知ID，每个消息唯一，用于去重。input_charsetString(16)必选编码格式GBKUTF-8默认GBKSignString(64)必选签名ContentString必选消息内容或者消息参数，接口的消息参数，格式为<request><p1/><p2/></request>表3-1主动模式根本字段3.2.3被动模式根本字段WMS调用gateway中的接口反应或者向WLB查询消息。接口类名消息请求格式名称类型可选/必选备注serviceString(64)必选效劳名称，接口名称，如wlb_order_notifypartnerString(32)必选合作伙伴在淘宝用户的唯一标识，由淘宝指定〔向淘宝索取〕如:2088002464631181input_charsetString(16)必选编码格式GBKUTF-8默认GBKout_biz_codeString(64)可选WMS传入的消息ID，每个消息唯一，用于消息去重signString(64)必选签名contentString必选消息内容或者消息参数，接口的消息参数，格式为<request><p1/><p2/></request>content_typeString可选请求参数数据格式值类型：XML/JSON表3-2被动模式根本字段3.2.3被动模式消息响应字段WLB在收到WMS的消息后，会立即返回响应，其字段定义如下所示：接口类名消息响应格式名称类型可选/必选备注is_successString必选T成功F失败业务参数responseString可选文档中下发接口定义的响应格式，格式为<response><p1/><p2/></response>errorString可选错误信息，如果is_success是T，那么不需要填写该参数，如果is_success是F,那么必须填写该参数，便于查找问题原因表3-3被动模式响应字段3.2.4主动模式消息响应字段同样WMS在收到WLB消息后，同样需要立即返回响应，其字段定义如下：根本参数名称类型可选/必选备注is_successString必选是否成功T成功F失败业务参数名称类型可选/必选备注errorString可选错误信息，如果is_success是T，那么不需要填写该参数，如果is_success是F,那么必须填写该参数，便于查找问题原因表3-4主动模式响应字段3.3.接口详述用户订购仓储效劳通知〔主动模式，sub_params_notify〕WLB在收到货主订购仓储效劳后，会立即调用此接口，下发货主信息给WMS。其字段定义如下表所示：接口名称用户订购仓储效劳状态信息功能描述订单信息同步接口效劳名称sub_params_notify名称类型可选/必选备注partnerString(32)必选合作伙伴ID，由淘宝指定，〔向淘宝索取〕signtypeString(16)必选签名方式DASMD5signString(64)必选签名内容notify_idString(32)必选消息通知ID，用于去重notify_typeString(11)必选消息通知类型，此处固定是sub_params_notifynotify_timeDate必选消息通知时间YYYY-MM-DDhh:mm:sscontentString必选请求内容<request><user_Id>01000111</user_Id><service_tp_code>ANNTO-0001</service_tp_code><subscriber_nick>刘刘商家测试1</subscriber_nick><subscriber_mobile/subscriber_mobile><action_Type>ADD</action_Type><content>STO,EMS,HAIBAO</content><remark>备注</remark></request>业务参数content具体内容名称类型可选/必选备注user_idLong(20)必选货主idservice_codeString(64)必选效劳编码，淘宝指定subscriber_nameString(32)必选订购用户名字添加新字段，卖家注册时填写的真实姓名添加新字段，卖家注册时填写的真实姓名subscriber_nickString(32)必选订购用户昵称subscriber_mobileString(32)可选订购用户subscriber_phoneString(32)可选订购用户subscriber_contact_emailString(64)可选订购用户邮箱subscriber_addressString(128)可选订购用户地址action_typeString(16)必选操作类型：ADD-新增MODIFY-修改CANCEL-取消contentString必选仓储参数内容：默认物流公司，第二默认物流，包装材料格式如下：STO,EMS,HAIBAO如果其中为空，格式保持不变remarkString(4000)可选备注信息表3-5货主订购仓储效劳字段WMS返回：WMS在收到货主订购仓储效劳信息后，必须立刻依照表3-4格式返回“T〞or“F〞。此处返回“T〞表示：1.接受用户订购仓储效劳2.通讯正常3.约定必选参数解析正常。XML样例WLB下发：<?xmlversion="1.0"encoding="GBK"?><request> <user_id>仓储用户id</user_id> <service_code>效劳编码，淘宝指定</service_code> <subscriber_name>订购用户名字[卖家注册时填写的真实姓名]</subscriber_name> <subscriber_nick>订购用户昵称</subscriber_nick> <subscriber_mobile>订购用户</subscriber_mobile> <subscriber_phone>订购用户</subscriber_phone> <subscriber_contact_email>订购用户邮箱</subscriber_contact_email> <subscriber_address>订购用户地址</subscriber_address> <action_type>操作类型：ADD-新增,MODIFY-修改,CANCEL-取消</action_type> <content>仓储参数内容： 默认物流公司，第二默认物流，包装材料 格式如下： STO,EMS,HAIBAO 如果其中为空，格式保持不变 </content> <remark>备注信息</remark></request>WMS返回：成功：<?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>WLB出入库订单下发〔主动模式，wlb_order_notify〕WLB生成订单并主动下发订单给对应的WMS。其字段定义如下表所示：接口类名订单信息通知接口功能描述订单信息通知接口(销售出库单销售入库单调拨出库单调拨入库单采购入库单)效劳名称wlb_order_notify根底参数名称类型可选/必选备注partnerString(32)必选合作伙伴ID，由淘宝指定。〔向淘宝索取〕sign_typeString(16)必选签名方式DASMD5signString(64)必选签名内容notify_idString(32)必选消息通知ID，用于去重notify_typeString(11)必选消息通知类型，此处固定为：wlb_order_notifynotify_timeString必选消息通知时间YYYY-MM-DDhh:mm:sscontentString必选内容，见业务参数定义业务参数工程名称类型可选/必选备注订单根本信息store_codeString(64)必选仓储编码，淘宝指定。order_codeString(64)必选WLB订单编码order_typeInteger(11)必选操作子类型201交易出库单301调拨出库单302调拨入库单501退货入库单502换货出库单601采购入库单901普通出库单(如货主拉走一局部货)order_sourceInteger(11)必选201淘宝301其他订单来源，WMS订单来源，WMS可以选择使用order_create_timeString必选订单创立时间order_flagString可选订单标记以逗号分隔：1:cod–货到付款2:limit-限时配送3:presell-预售4:invoiceinfo-需要发票8:退换货9:上门效劳10:是否可改配送方式默认可更改，即没1012:是否卖家承当运费默认是，即没1213:退货时是否收取发票默认不收取,即没13为多项选择项，如1,2,8,9虽然是可选字段，但仓库必须能够处理此字段。〔重要！〕对于订单类型的特殊业务要求，如货到付款，限时配送，要求带发票等等。alipay_noString可选支付宝交易号COD订单必选total_amountLong可选总金额订单总额，非必要字段修改备注信息修改备注信息payable_amountLong可选对COD必选，应收总金额COD订单必选service_feeLong可选COD效劳费COD订单必选订单商品很多时有用〔商品item>50〕，来判断是否还有更多的订单商品order_item_countint(11)可选本消息的order_item数量当distribute_type为1时为必选订单屡次下发必选如订单中订单商品明细数为500本次下发50，order_item_count值为50total_order_item_count为500，即WMS需要接收到500个时，再开始处理订单，而不是接收到50处理50total_order_item_countint(11)可选总共ITEM数量当distribute_type为1时为必选订单屡次下发必选说明同上distribute_typeint(11)必选是否有更多商品0一次发送1屡次发送标识订单屡次下发实际配送信息tms_service_codeString(64)可选物流公司编码销退单会使用买家发货到仓库物流上门取货的情形那么不用tms_order_codeString(64)可选运单号,退货单有可能有运单号同上prev_order_codeString(64)可选原物流宝订单编码，在退换货时会用到退货入库单时可能会有销退单必选调拨出库单必选，对于调拨出库单，这个值是调拨入库单的编码，需要作强校验收货方信息receiver_infoString(512)可选收货方发货方信息必选其一和必选其一收货方信息^^^省^^^市^^^区^^^具体地址^^^收件方名称^^^^^^交易出库单必选换货出库单必选调拨出库单必选调拨入库单必选采购单入库单可选销退单可选全部字段都为空值那么该字段为空某个字段为空用NA来代替如310012^^^浙江省^^^杭州市^^^西湖区^^^塘苗路18号^^^淘宝发货方信息sender_infoString(512)可选发货方收货方信息必选其一和必选其一^^^省^^^市^^^区^^^具体地址^^^发件方名称^^^^^^调拨出库单必选调拨入库单必选全部字段都为空值那么该字段为空某个字段为空用NA来代替如310012^^^浙江省^^^杭州市^^^西湖区^^^塘苗路18号^^^淘宝配送要求〔order_flag字段中有时效要求时，有效〕schedule_typeInteger(11)可选投递时延要求:1-工作日2-节假日101,当日达102次晨达103次日达如果订单打上了限时配送标记〔order_flag为2〕，该字段才会有效如果没有限时配送标记那么为非限时配送各个值是互拆的关系，虽然字面意义上有交集schedule_startString可选送达开始时间COD订单一定会有同上格式为hh:mm:ssschedule_endString可选送达结束时间COD订单一定会有同上hh:mm:ss订单商品信息order_item_listList<wlb_order_item>必选订单商品信息,wlb_order_item见下表3-7<order_item_list></order_item_list>订单商品明细信息，这里有可能会存在一个订单里包含两个相同的item_id,在解析些数据时请注意package_countInteger(11)包裹数量入库单可能会关心这个字段expect_start_timeString可选预期送达开始时间入库单常用YYYY-MM-DDhh:mm:ss入库单关心该字段expect_end_timeString可选预期送达结束时间入库单常用YYYY-MM-DDhh:mm:ss入库单关心该字段EXPECT_TIMEstirng可选预计开始入库时间入库单关键字段〔行舟〕invoice_info_listinvoice_info->invoice_info_listinvoice_info->invoice_info_listList<InvoiceItem>可选发票信息，见下表3-8一个物流宝订单可能会带多张发票信息下来tms_infoString(512)可选运办公司相关信息出库单中可能会用到运输公司名称^^^运输公司联系人^^^运输公司运单号^^^运输公司^^^运输公司联系人身份证号申通物流^^^张三^^^EG123123^^^^^^特殊字段，在调拨出库时可能会用到，如涉及到大宗货物出库时，仓储公司可能会要求运输公司的人带上身份证等上门取货，以降低操作风险全部字段都为空值那么该字段为空某个字段为空用NA来代替distributor_user_nickString可选带下来的信息，一般不用关心分销附带信息订单其他属性attributes(2000)String可选扩展字段备注remark(4000)String(4000)可选备注表3-6订单信息下发字段注意：order_flag可选字段指定订单的特殊需求。如order_flag中有“2〞时，表示订单有时效要求。WMS在指定快递时，需注意选择可以满足时效要求的快递。同时时效要求记录在schedule_type，schedule_start，schedule_end三个字段中。order_flag中有“10〞时，表示商家指定了快递公司。指定的快递公司编码在tms_service_code中。如果商家指定的快递公司与仓实际指定的有差异，仓储可以与商家协调一致。最后使用的快递以仓储指定的为准。order_flag中有“4〞时，表示订单需要货票同行效劳，需要WMS解析发票信息字段(invoice_info_list)。order_flag中有“8〞时，表示该订单是退换货订单，需要WMS关注“实际配送信息〞的相关字段。order_flag中有“12〞时，表示该订单包邮订单。有“9〞表示该订单需要上门退换货。有“13〞时表示需要同时退回发票。这些主要与TMS有关。下发订单商品信息字段表3-6中商品信息字段如下表所示：不同于商品的不同于商品的item-id,需要TP记录，在出库确认时会用到。订单商品对象wlb_order_item名称类型可选/必选备注order_item_idLong(20)必选订单IDorder_source_codeString(64)可选交易编码sub_source_codeString(64)可选子交易编码user_idLong(20)必选卖家ID一般情况下，货主ID和卖家ID相同owner_user_id货主货主Long(20)必选货主ID代销情况下货主ID和卖家ID不同item_idLong(20)必选商品IDitem_nameString(64)必选商品名称item_codeString(64)必选商家编码〔商品统一条码，如UCC，EAN〕inventory_typeInt(11)必选库存类型1

可销售库存101

残次102

机损103

箱损201

冻结库存301

在途库存item_quantityLong(11)必选商品数量item_priceLong(20)可选销售价格item_versionitem_public_versionitem_versionitem_public_versionitem_versionInt(11)必选商品版本，WLB允许货主修改商品属性描述，每修改一次就对应一个商品版本信息batch_remarkString(64)可选批次备注〔商超需关注〕attributesString(2000)可选属性数据KEYVALUE格式，允许货主新增或修改商品属性〔KEY〕，如颜色，尺寸等等表3-7订单商品信息字段下发订单发票字段〔invoice_info_list〕表3-6中发票字段如下表所示：名称类型可选/必选备注typeString(64)必选发票类型增值税普通发票普通发票titleString(64)必选发票抬头amountString(64)必选发票金额contentString(512)可选发票内容表3-8订单发票信息字段上表中的发票内容〔content〕，为扩展字段，具体商品信息会随该字段下发。其格式为：<content>商品名称^^商品型号^^商品数量^^商品计量单位^^单价!!商品名称^^商品型号^^商品数量^^商品计量单位^^单价</content>WMS返回：WMS在收到订单信息后，必须立刻依照表3-4格式返回“T〞or“F〞。此处返回“T〞仅表示：1.通讯正常2.约定必选参数解析正常。并不代表WMS正式接单。假设返回“F〞需要附加错误描述信息。XML样例WLB下发：<?xmlversion="1.0"encoding="GBK"?><request><store_code>仓储编码，淘宝指定</store_code><order_code>WLB订单编码</order_code><order_type>操作子类型:201交易出库单,301调拨出库单,302调拨入库单,501退货入库单,502换货出库单,601采购入库单,901普通出库单(如货主拉走一局部货)</order_type><order_source>[201淘宝301其他]订单来源，WMS可以选择使用</order_source><order_create_time>订单创立时间</order_create_time> <order_flag> 订单标记以逗号分隔： 1:cod–货到付款 2:limit-限时配送 3:presell-预售 4:invoiceinfo-需要发票 8:退换货 9:上门效劳 10:是否可改配送方式默认可更改，即没10 12:是否卖家承当运费默认是，即没12 13:退货时是否收取发票默认不收取,即没13 为多项选择项，如1,2,8,9 </order_flag> <alipay_no>支付宝交易号[COD订单必选]</alipay_no><total_amount>19560</total_amount> <payable_amount>对COD必选，应收总金额</payable_amount> <service_fee>COD效劳费</service_fee><order_item_count> 订单屡次下发必选 如订单中订单商品明细数为500 本次下发50，order_item_count值为50 total_order_item_count为500，即WMS需要接收到500个时，再开始处理订单，而不是接收到50处理50 </order_item_count><total_order_item_count>订单屡次下发必选说明同上</total_order_item_count><distribute_type>是否有更多商品:0一次发送1屡次发送</distribute_type><receiver_info>收货方发货方信息必选其一和必选其一收货方信息 ^^^省^^^市^^^区^^^具体地址^^^收件方名称^^^^^^ 交易出库单必选 换货出库单必选 调拨出库单必选 调拨入库单必选 采购单入库单可选 销退单可选 全部字段都为空值那么该字段为空 某个字段为空用NA来代替 如310012^^^浙江省^^^杭州市^^^西湖区^^^塘苗路18号^^^淘宝 </receiver_info><sender_info>发货方收货方信息必选其一和必选其一 ^^^省^^^市^^^区^^^具体地址^^^发件方名称^^^^^^ 调拨出库单必选 调拨入库单必选 全部字段都为空值那么该字段为空 某个字段为空用NA来代替 如310012^^^浙江省^^^杭州市^^^西湖区^^^塘苗路18号^^^淘宝</sender_info> <invoice_info_list><!--一个物流宝订单可能会带多张发票信息下来--> <invoice_item> <type>发票类型:1 普通发票,2 增值税发票</type> <title>发票抬头</title> <amount>发票金额</amount> <content>商品名称^^商品型号^^商品数量^^商品计量单位^^单价!!商品名称^^商品型号^^商品数量^^商品计量单位^^单价</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>卖家ID一般情况下，货主ID和卖家ID相同</user_id><owner_user_id>货主ID代销情况下货主ID和卖家ID不同</owner_user_id><item_id>商品ID[可能会存在一个订单里包含两个相同的item_id]</item_id><item_name>商品名称</item_name><item_code>商家编码〔商品统一条码，如UCC，EAN〕</item_code><inventory_type>库存类型: 1可销售库存 101残次 102机损 103箱损 201冻结库存 301在途库存 </inventory_type><item_quantity>商品数量</item_quantity><item_price>销售价格</item_price><item_version>商品版本，WLB允许货主修改商品属性描述，每修改一次就对应一个商品版本信息</item_version><batch_remark>批次备注</batch_remark> <attributes>属性数据KEYVALUE格式，允许货主新增或修改商品属性〔KEY〕，如颜色，尺寸等等: 例如分号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>包裹数量</package_count> <expect_start_time>预期送达开始时间入库单常用:YYYY-MM-DDhh:mm:ss</expect_start_time> <expect_end_time>预期送达结束时间入库单常用:YYYY-MM-DDhh:mm:ss</expect_end_time> <schedule_type>投递时延要求:1-工作日2-节假日101,当日达102次晨达103次日达</schedule_type> <schedule_start>送达开始时间COD订单一定会有</schedule_start> <schedule_end>送达结束时间COD订单一定会有</schedule_end> <tms_info>运办公司相关信息 出库单中可能会用到 运输公司名称^^^运输公司联系人^^^运输公司运单号^^^运输公司^^^运输公司联系人身份证号 申通物流^^^张三^^^ </tms_info> <distributor_user_nick>带下来的信息，一般不用关心[分销附带信息]</distributor_user_nick> <attributes>{扩展字段}</attributes> <remark>备注</remark></request>WMS返回：成功：<?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>WMS订单状态回传〔被动模式，wlb_order_info_sync〕依据约定，WMS需要将库内实操状态回传WLB。WLB将依据回传消息在TC前台显示。状态约定WMS_ACCEPT出库入库，共有状态。WMS确认订单可以处理，并正式接单。需要特别强调：WMS未回传接单，假设产生撤单〔订单取消〕，WLB不会调用取消订单接口〔下文会提到〕通知WMS。因为WLB认为此时WMS未接单，订单将被直接取消而不会有通知。假设WMS已回传接单，假设产生撤单，WLB会询问WMS是否允许撤单。假设WMS拒绝撤单，订单将无法取消。回传状态的起点必须是WMS_ACCECPT或WMS_REJECT。目前接单后不允许回传拒单。WMS_REJECT出库入库，共有状态。WMS确认订单无法处理，返回拒单。WMS_PRINT出库实操。WMS打印拣货单。WMS_PICK出库实操，WMS开始拣货。WMS_CHECK出库实操，WMS复核订单商品。WMS_PACKAGE出库实操，WMS打包订单商品。WMS_FAILED出库实操，订单发货失败〔买家拒签〕订单状态回传字段如下表所示：接口类名订单信息同步接口功能描述订单信息同步接口本接口和TMS共用效劳名称wlb_order_info_sync根本参数名称类型可选/必选备注serviceString(64)必选效劳名称，此处固定为：wlb_order_info_syncpartnerString(32)必选合作伙伴在淘宝注册的用户ID，由淘宝指定〔向淘宝索取〕sign_typeString(16)必选签名类型MD5DSAsignString(64)必选签名内容contentString必选详细见业务参数业务参数content名称类型可选/必选备注out_biz_codeString(64)必选消息ID，用来去重。service_codeString(64)必选仓库编码，淘宝指定order_codeString(64)必选WLB订单编码tms_order_codeString(64)可选该字段供TMS使用，用来回传TMS运送状态标识operatorString(64)必选操作人operator_contactString(64)可选针对TMS状态回传有效联系人operator_dateString必选操作时间格式yyyy-mm-ddhh:mm:ssstatusString(32)必选信息内容：WMS_ACCEPT-接单WMS_PRINT-打印WMS_PICK-捡货WMS_CHECK-复核WMS_PACKAGE-打包WMS_REJECT-接单失败WMS_FAILED-订单发货失败(买家拒签)contentString(2000)可选状态更改描述，中文描述remarkString(4000)可选备注表3-9订单状态回传字段WLB返回：WLB在收到订单状态变化信息后，会即刻依照表3-3格式返回“T〞or“F〞。当WMS返回“WMS_ACCEPT〞时，WLB返回“T〞，那么表示WLB接受WMS接单。假设返回“F〞，WMS需要判断WLB返回的错误信息里是否有订单已被取消的描述。其他状态回传，WLB返回“T〞仅表示1.通讯正常2.参数必选字段解析正常。XML样例WMS回传：<?xmlversion="1.0"encoding="GBK"?><request><out_biz_code>消息ID，用来去重</out_biz_code><service_code>仓库编码，淘宝指定</service_code><order_code>WLB订单编码</order_code><tms_order_code>该字段供TMS使用，用来回传TMS运送状态标识</tms_order_code><operator>操作人</operator><operator_contact>针对TMS状态回传有效:联系人</operator_contact><operator_date>操作时间格式yyyy-mm-ddhh:mm:ss</operator_date><status>信息内容： WMS_ACCEPT-接单 WMS_PRINT-打印 WMS_PICK-捡货 WMS_CHECK-复核 WMS_PACKAGE-打包 WMS_REJECT-接单失败 WMS_FAILED-订单发货失败(买家拒签)</status><content>状态更改描述，中文描述</content><remark></remark></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>WMS确认订单出入库〔被动模式，wlb_order_confirm〕状态约定出库时，WMS确认订单出库，那么表示订单商品已完成所有库内操作，商品已打包，TMS可以直接上门揽件。只允许出库确认回传1次，如果有拆单，多个运单号也1次回传所有信息，每个运单跟包裹中的SKU关联，重量、体积、包材型号，包材数量等一起回传。如果仓库对物流宝订单合并包裹，仓库需对每个订单分别进行确认，分别确认的时候需要回传与确认订单进行合并包裹的订单。入库时，WMS确认入库，那么表示订单已完成所有入库库内操作，商品已上架并处于可销售操作。此接口支持不同商品分批确认，不支持同一商品屡次确认。〔原那么是一个商品，不管到货多少件，一个订单里只允许确认入库一次。〕局部入库：不同商品可以分批次入库，同样遵循同一个商品，只允许确认入库一次的原那么。当出现局部入库时，商品库存处于冻结状态，只有完全入库后商品库存才会增加。〔所以订单不应该长期处于局部入库状态。〕在实操中，如果某一商品迟迟都无法到货，建议按0个商品数量做回传，关闭掉订单。在实操时，必须严格按照约定的状态进行回传。出库时，假设过早回传确认订单出库，会导致TMS揽不到件。入库时，假设过早回传确认入库，会导致商品在淘宝前台已上架，但实际并未处于可销状态。同样假设过晚回传，会导致商品一直处于库内操作状态，影响信息流和实物流。影响用户体验。同样，也影响淘宝对TP的评分。另外需要注意的是，WLB允许订单屡次确认，即分批次确认订单商品入库。在调用此接口后，商品库存将产生扣减或增加。需要特别注意。订单确认出入库字段根本参数根本参数名称类型可选/必选备注serviceString(64)必选效劳名称固定值wlb_order_confirmpartnerString(32)必选合作伙伴ID，由淘宝指定〔向淘宝索取〕signtypeString(11)必选签名方式DSAMD5signString(64)必选签名内容contentString必选参数，具体见业务参数定义业务参数contnt名称类型可选/必选备注order_codeString(64)必选物流宝订单编码out_biz_codeString(64)必选外部业务编码，消息ID，用于去重一个合作伙伴中要求唯一屡次确认时，每次传入要求唯一tms_order_listList<tms_order>可选快递单列表<tms_order_list><tms_order><tms_service_code/><tms_order_code/><remark新加，备注信息/>新加，备注信息<package_weight/>从订单级别移到运单级别，回传包裹重量从订单级别移到运单级别，回传包裹重量<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>快递单字段见表3-11confirm_typeInt(11)必选支持出入库单屡次确认入库单允许对不同商品分批确认，不允许对同一个商品分批确认。出库单不允许对商品进行分配确认，只能一次确认回传。入库单允许对不同商品分批确认，不允许对同一个商品分批确认。出库单不允许对商品进行分配确认，只能一次确认回传。0最后一次确认或是一次性确认1屡次确认当屡次确认时，确认的ITEM种类全部被确认时，确认完成默认值为0例如输入2认为是0package_weightInt(11)可选该订单的包裹重量，单位：g，主要是给商超销售订单使用package_heightDouble可选该订单的包裹高度，单位：厘米package_lengthDouble可选该订单的包裹长度，单位：厘米package_widthDouble可选该订单的包裹宽度，单位：厘米这四个包裹信息全部移到tms_order_list这四个包裹信息全部移到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/><!—批次相关信息<batch_code/><due_date/><guarantee_period/><guarantee_unit/><produce_area/><produce_code/><produce_date/><!—批次相关信息</item></item_list></order_item></order_item_list>订单商品字段见表3-12wlb_order_joinString(256)可选合单的订单号,如本订单与LBX111合单，那么值为LBX111。超过2个订单合单,以分号隔开,如LBX123;LBX223新加，回传与这个订单进行合单的新加，回传与这个订单进行合单的其他订单信息featureString(512)可选扩展字段；以key:value形式组合。Key，value以冒号隔开，多个key:value以分号隔开；货票同行order_invoice_listList<Invoice>可选<order_invoice_list><invoice><tradeNumber/><invoiceNumber/><invoiceCode新加，回传订单发票信息/>新加，回传订单发票信息<invoice></order_invoice_list>tradeNumber表示交易号invoiceNumber表示发票号invoiceCode表示发票代码表3-10WMS确认订单出入库字段运单字段表3-11中的运单字段运单对象tms_order名称类型可选/必选备注tms_service_codeString(64)必选快递公司效劳编码〔由淘宝指定〕tms_order_codeString(64)必选运单编码package_weightInt(11)必选包裹重量，单位：克必选必选package_lengthInt(11)可选包裹长度，单位：毫米注意单位注意单位package_widthInt(11)可选包裹宽度，单位：毫米package_heightInt(11)可选包裹高度，单位：毫米package_material_listList<package_material>可选包裹的包材信息tms_item_listList<tms_item>可选包裹里面的商品信息remarkString(256)可选包裹备注信息新加新加表3-11确认订单中的运单字段表3-12中的包材字段包材对象package_material名称类型可选/必选备注material_typeString(64)必选如果包材对象不为空，那么型号和数量不能为空如果包材对象不为空，那么型号和数量不能为空淘宝指定的包材型号见附录1,回传包材编码见附录1,回传包材编码material_quantityInt(11)必选包材的数量表3-12运单中的包材字段表3-13中的运单商品字段运单商品对象tms_item名称类型可选/必选备注item_idLong(19)必选物流宝商品id类型改为Long类型改为Longitem_quantityInt(11)必选此运单里该商品的数量表3-13运单中的包材字段注意：WMS在发布效劳后，淘宝小二将为其指定TMS，即WMS和TMS的绑定。并告知TMS编码和运单规那么。在订单出库时，WMS必须回传正确的快递公司编码和运单号。WLB将对快递公司和运单号进行校验。假设出错那么会要求WMS重传。WMS需要依据约定，尽量减少线下的沟通，如通知TMS揽货等等。订单商品字段无改动无改动表3-14中的订单商品字段商品结构属性order_item名称类型可选/必选备注order_item_idLong(20)必选order_item_idowner_user_idLong(20)必选货主IDweightInteger(11)可选sku重量单位克入库时为必选入库时为必选lengthInteger(11)可选长单位mmwidthInteger(11)可选宽单位mmheightInteger(11)可选高单位mmis_completedboolean可选是否完成不支持同一个商品分批确认不支持同一个商品分批确认item_listList<item>必选商品属性列表，见表3-13表3-14确认订单中的商品字段商品属性字段无改动无改动表3-15中的商品属性字段商品结构属性item名称类型可选/必选备注inventory_typeInteger(11)必选库存类型1可销售库存101类型用来定义残次品201冻结类型库存301在途库存quantityInteger(11)必选数量batch_codeString(64)可选批次号due_dateString(32)可选到货日期guarantee_periodLong(20)可选保质期，默认以天为单位guarantee_unitInteger(11)可选保质期单位produce_areaString(255)可选生产地区produce_codeString(255)可选生产编码,同一商品可能因商家有不同编码。produce_dateString(32)可选YYYY-MM-DDhh:mm:ss表3-15商品属性字段发票信息字段商品结构属性invoice名称类型可选/必选备注tradeNumberString(64)可选invoiceNumberString(64)必选发票号invoiceCodeString(64)可选发票代码表3-16发票属性字段WLB返回：WLB在收到订单状态变化信息后，会即刻依照表3-3格式返回“T〞or“F〞。此处的“T〞表示WLB接受WMS订单出库或入库，商家库存将产生增减。假设返回“F〞，WMS需要检验订单是否有已被取消的描述。XML样例WMS回传：<?xmlversion="1.0"encoding="GBK"?><request><order_code>物流宝订单编码</order_code><out_biz_code>外部业务编码，消息ID，用于去重</out_biz_code><confirm_type>支持入库单屡次确认0最后一次确认或是一次性确认1屡次确认当屡次确认时，确认的ITEM种类全部被确认时，确认完成</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>运单编码</tms_order_code><package_weight>包裹重量<package_weight/><package_length>包裹长度<package_length/><package_width>包裹宽度<package_width/><package_height>包裹高度<package_height/><package_material_list><package_material><material_type>包材型号1<material_type/><material_quantity/>数量<material_quantity/></package_material><package_material><material_type>包材型号2<material_type/><material_quantity/>数量<material_quantity/></package_material></package_material_list><tms_item_list><tms_item><item_id>商品id</item_id><item_quantity>商品数量</item_quantity></tms_item></tms_item_list></tms_order> <!--标识多条数据--> <tms_order><tms_service_code>快递公司效劳编码〔由淘宝指定〕</tms_service_code><tms_order_code>运单编码</tms_order_code><package_weight>包裹重量<package_weight/><package_length>包裹长度<package_length/><package_width>包裹宽度<package_width/><package_height>包裹高度<package_height/><package_material_list><package_material><material_type>包材型号1<material_type/><material_quantity/>数量<material_quantity/></package_material><package_material><material_type>包材型号2<material_type/><material_quantity/>数量<material_quantity/></package_material></package_material_list><tms_item_list><tms_item><item_id>商品id</item_id><item_quantity>商品数量</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>长单位mm</length><width>宽单位mm</width><height>高单位mm</height><is_completed>是否完成</is_completed><item_list><item><inventory_type>库存类型 1可销售库存 101类型用来定义残次品 201冻结类型库存 301在途库存 </inventory_type><quantity>数量</quantity> <batch_code>批次号</batch_code> <due_date>到货日期</due_date> <guarantee_period>保质期，默认以天为单位</guarantee_period> <guarantee_unit>保质期单位</guarantee_unit> <produce_area>生产地区</produce_area> <produce_code>生产编码,同一商品可能因商家有不同编码</produce_code> <produce_date>YYYY-MM-DDhh:mm:ss</produce_date></item><item_list></order_item> <order_item> <!--标识多条数据--><order_item_id>order_item_id</order_item_id> <owner_user_id>货主ID</owner_user_id><weight>重量单位克</weight><length>长单位mm</length><width>宽单位mm</width><height>高单位mm</height><is_completed>是否完成</is_completed><item_list><item><inventory_type>库存类型 1可销售库存 101类型用来定义残次品 201冻结类型库存 301在途库存 </inventory_type><quantity>数量</quantity> <batch_code>批次号</batch_code> <due_date>到货日期</due_date> <guarantee_period>保质期，默认以天为单位</guarantee_period> <guarantee_unit>保质期单位</guarantee_unit> <produce_area>生产地区</produce_area> <produce_code>生产编码,同一商品可能因商家有不同编码</produce_code> <produce_date>YYYY-MM-DDhh:mm:ss</produce_date></item><item_list></order_item></order_item_list><order_invoice_list><invoice><tradeNumber>交易号</traderNumber><invoiceNumber/>发票号</invoiceNumber><invoiceCode/>发票代码</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〔包材定义〕包材编码型号规格尺寸重量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特卖1#95*250*2000.14001101TM_001102特卖2#350*285*600.22001102TM_001103特卖3#430*315*1050.32001103TM_001104特卖4#400*300*1500.32001104TM_001105特卖5#390*280*2900.