开发者文档
创建海外仓出库单(草稿)

接口说明

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

 

使用场景

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

请求说明

URL

http://api.winit.com.cn/ADInterface/api

接口测试

http://erp.sandbox.winit.com.cn/ADInterface/api

验证方式

Token,md5

格式

json

http请求方式

http

请求数限制

默认每分钟300,有需要可以申请加大

 

参数说明

名称

类型

必填

说明

示例

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 组合唯一时,我们确认此出库单为唯一。作废订单也将被记录并实施验证。  

例外情况:

当用户由于业务需要重复发送一个海外仓出库单时,可将IsRepeat设为‘Y’,则以上唯一性验证失效,此时系统不阻止重复下单。IsRepeat设为‘N’时则唯一性验证生效。


deliveryWayID

String()

Y

最后一公里派送方式ID。最后一公里派送方式ID不可为空。   可查询

 


insuranceTypeID

String()

Y

最后一公里派送方式所用保险类型ID。保险类型ID不可为空。

 


sellerOrderNo

String()

N

卖家订单号。

 


recipientName

String()

Y

收件人姓名,来自于由eBay买家提供收货地址。收件人姓名不可为空。

 


phoneNum

String()

N

收件人电话。

 


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,门牌号必填

 


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。

 


platform

String()

N

第三方卖家工具在提交海外仓出库单时填写该字段,命名规则由万邑通与三方工具提供商共识。卖家不必上传。  

 



请求示例

{
    "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"
}

返回结果示例 

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

失败示例

{
    "action":"createOutboundInfo",
    "app_key":"rebecca",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"82 Worendo Street",
        "city":"Bayswater North",
        "deliveryWayID":"1000020",
        "eBayOrderID":"3298472983749823480",
        "emailAddress":"443664682@qq.com",
        "insuranceTypeID":1000000,
        "phoneNum":"15900001111",
        "productList":[
            {
                "eBayBuyerID":"PowerBuyerDEF456",
                "eBayItemID":"34BayItemI34245",
                "eBaySellerID":"PowerSellerABC123",
                "eBayTransactionID":"2433ctionI234",
                "productCode":"W124313131",
                "productNum":"1",
                "specification":""
            }

        ]
,
        "recipientName":"mingbao",
        "region":"Victoria",
        "repeatable":"Y",
        "sellerOrderNo":"PowerSellerABC123",
        "state":"AU",
        "warehouseID":1000001,
        "zipCode":"3153"
    }
,
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"EB8FDDFEF686D128DC9ABB127A6B500C",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

返回结果示例 

{
    "code":201301,
    "data":"",
    "msg":"产品 * 未找到 *"
}

错误分析:产品编码(productCode)填写错误,海外仓商品以sku+specification(规格)为标识商品,使用正确的sku和specification规格才查找到商品。

 

返回参数说明

正确的返回结果:出库单号,出库单成功。

错误的返回结果:错误码,错误信息


附:特殊尾程派送方式参数赋值说明

1.尾程派送服务DHL Packet Service收件人地址填写邮局自提柜时

    address1填写邮局

    address2填写自提柜编号

    doorplateNumbers填写门牌号

例:收件人地址为邮局“Postfiliale”地址门牌号为“520”邮局自提柜编号为800811570