API
WO08-1.创建海外仓出库单(草稿)
更新时间: 2017-11-22 17:18:56 访问次数:641
接口说明

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

使用场景

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

备注

附:特殊尾程派送方式参数赋值说明 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。
请求示例
{
    "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

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

返回示例
{
    "code":0,
    "data":{
        "outboundOrderNum":"16000027"
    },
    "msg":"成功"
}