万邑通开发者网站 - WO08-1.创建海外仓出库单（草稿）

API

WO08-1.创建海外仓出库单（草稿）

更新时间： 2017-11-22 17:18:56 访问次数：1051

接口说明

通过本接口用户可以创建出库单（草稿状态）。

使用场景

用户可使用本接口创建出库单，一次请求仅支持创建一个出库单。

备注

附：特殊尾程派送方式参数赋值说明 1.尾程派送服务DHL Packet Service收件人地址填写邮局自提柜时 address1填写邮局 address2填写自提柜编号 doorplateNumbers填写门牌号例：收件人地址为邮局“Postfiliale”，地址门牌号为“520”，邮局自提柜编号为“800811570”

请求说明

URL	http://api.winit.com.cn/ADInterface/api
接口测试	http://erp.sandbox.winit.com.cn/ADInterface/api
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。

请求入参

名称	类型	必填	说明
warehouseID	String()	Y	万邑通海外仓ID，唯一，可查询。
eBayOrderID	String()	N	eBay OrderID 用于标识一条唯一的eBay 订单，这个订单可以包含一个或多个商品交易（一个交易对应一个eBay 上的Transaction_ID + Item_ID）. 当买家在一个时间向同一卖家购买多种商品，eBay 将会基于这些交易（Transaction）生成一个唯一订单号（OrderID）。当买家一次仅仅购买一种商品（一个ItemID）时，则此OrderID 与此笔交易一一对应。在使用CompleteSale 接口时，OrderID 被用于定位一笔订单。
repeatable	String(1)	Y	用户授权此海外仓出库单是否可重复。是否允许重复不可为空。 eg. 可重复则取值 ‘Y’ 不可重复则取值‘N’ 我们根据eBay对一个Shipping Order唯一性验证规则制定相应的海外仓出库单唯一性验证规则如下：当一个海外仓出库单对应的eBay OrderID, eBay TransactionID, eBayItemID 组合唯一时，我们确认此出库单为唯一。作废订单也将被记录并实施验证。例外情况：当用户由于业务需要重复发送一个海外仓出库单时，可将repeatable设为‘Y’，则以上唯一性验证失效，此时系统不阻止重复下单。repeatable设为‘N’时则唯一性验证生效。
deliveryWayID	String()	Y	最后一公里派送方式ID。最后一公里派送方式ID不可为空。可查询
insuranceTypeID	String()	Y	最后一公里派送方式所用保险类型ID。保险类型ID不可为空。默认为1000000
sellerOrderNo	String()	N	卖家订单号
recipientName	String()	Y	收件人姓名,来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum	String()	Y	收件人电话
zipCode	String()	Y	邮政编码
emailAddress	String()	N	收件人电子邮箱
state	String()	Y	收件人国家名称，可使用国家英文全称或是ISO国家代码。收件人国家不可为空
region	String()	Y	收件人州名称。收件人州不可为空
city	String()	Y	城市
address1	String()	Y	收件人街道1
address2	String()	N	收件人街道2
doorplateNumbers	String()	N	派送方式为DHL、UK DPD，门牌号必填
productList	Array		出库商品列表,以下为子节点
--\|productCode	String()	Y	产品编码。产品编码不可为空,指SKU
--\|specification	String()	N	规格（如果此产品注册时填写了该字段，那么此为必填项，否则无法准确定位您注册的产品。如果您在注册产品时没有填写该字段，则在XML中去掉‘Specification’字段。）
--\|eBayTransactionID	Long	N	eBay TransactionID。eBay TransactionID为选填。 eBay上使用TransactionID+ItemID标识一个唯一的交易，一个OrderID可以对应一个或多个交易。当一笔交易的拍卖方式为‘BID’时，此笔交易的TransactionID为‘0’。 eBay API参考： eBay API: GetOrders Paramater: OrderArray.Order.TransactionArray.Transaction.TransactionID
--\|eBayItemID	Long	N	eBay ItemID。eBay ItemID为选填。 eBay上使用描述一个刊登的唯一标识。一个刊登可以产生多笔交易，但是ItemID是唯一不变的。 eBay API参考： eBay API: GetOrders Paramater: OrderArray.Order.TransactionArray.Transaction.Item.ItemID
--\|eBaySellerID	String()	N	当前Transaction对应的eBay Seller ID。eBay Seller ID为选填。 eBay API参考： eBay API: GetOrders Paramater: OrderArray.Order.SellerUserID
--\|eBayBuyerID	String()	N	当前Transaction对应的eBay Buyer ID。eBay Buyer ID为选填。 eBay API参考： eBay API: GetOrders Paramater: OrderArray.Order.BuyerUserID
--\|productNum	Integer()	Y	一个海外仓出库单所包含的某个产品的数量。产品对应的单品数量必须>0。

请求示例

Json
XML

{
    "action":"createOutboundInfo",
    "app_key":"rebecca",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"82 Worendo Street",
        "city":"Bayswater North",
        "deliveryWayID":"1010520",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "insuranceTypeID":1000000,
        "phoneNum":"15900001111",
        "productList":[
            {
                "eBayBuyerID":"98877456rere",
                "eBayItemID":"3434245",
                "eBaySellerID":"99887rtrtr66123",
                "eBayTransactionID":"24377766",
                "productCode":"LCD-IP4-01",
                "productNum":"1",
                "specification":""
            }
        ],
        "recipientName":"mingbao",
        "region":"WV",
        "repeatable":"Y",
        "sellerOrderNo":"PowerSellerABC123",
        "state":"US",
        "warehouseID":1000008,
        "zipCode":"25085"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}

返回出参

名称	类型	必填	说明	示例
outboundOrderNum	String(80)	Y	出库订单号	0

返回参数说明正确的返回结果：出库单号，出库单成功。错误的返回结果：错误码，错误信息

返回示例

Json
XML

{
    "code":0,
    "data":{
        "outboundOrderNum":"16000027"
    },
    "msg":"成功"
}

关键词

WO08-1.创建海外仓出库单（草稿）