API
WO07.创建海外仓出库单(确认中)
更新时间: 2017-11-22 17:17:30 访问次数:647
接口说明

通过本接口用户可以创建出库单并提交至“确认中”状态。当出库单状态在“确认中”后不能再更改状态。

使用场景

用户可使用本接口创建出库单至“确认中”,一次请求仅支持创建一个出库单。

备注

附: 一、特殊尾程派送方式参数赋值说明 1.尾程派送服务DHL Packet Service收件人地址填写邮局自提柜时 address1填写邮局 address2填写自提柜编号 doorplateNumbers填写门牌号 例:收件人地址为邮局“Postfiliale”,地址门牌号为“520”,邮局自提柜编号为“800811570” 二、DE DPD尾程派送服务新增“门牌号”强制校验说明 DE Warehouse尾程派送服务(如下)“门牌号[doorplateNumbers]”强制校验不能为空,未填写将提示下单错误,请进行填写或为空值时使用默认值。 派送方式:DPD International Parcels (2-8 business days) 派送方式ID:1000213

请求说明
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。
--|isShareOrder String(1) N 共享单(Y/N)
--|fromBpartnerId Integer N 共享人(共享单为Y,必填
请求示例
请按以下示例调用,用于验证是否使用UTF-8字符编码,提交成功后请将出库订单号提供给技术并要求在后台确认订单数据是否显示正常,相关公告请见:http://developer.winit.com.cn/Index/index.php?s=Index/index/id/226/l/zh-cn。
{
    "action":"createOutboundOrder",
    "app_key":"rebecca",
    "data":{
        "address1":"Körschstraße 7",
        "address2":"",
        "city":"Kipfenberg",
        "deliveryWayID":"2000003",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "insuranceTypeID":1000000,
        "phoneNum":"15900001111",
        "productList":[
            {
                "eBayBuyerID":"98877456rere",
                "eBayItemID":"3434245",
                "eBaySellerID":"99887rtrtr66123",
                "eBayTransactionID":"24377766",
                "productCode":"auto_sku52",
                "productNum":"1",
                "specification":""
            }
        ],
        "recipientName":"mingbao",
        "region":"Kipfenberg",
        "repeatable":"Y",
        "sellerOrderNo":"PowerSellerABC123",
        "state":"BE",
        "warehouseID":1012190,
        "zipCode":"25085",
        "isShareOrder":"N",
        "fromBpartnerId":"111"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}
其它用例
{
    "action":"createOutboundOrder",
    "app_key":"rebecca",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"aaaaaaa",
        "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",
        "isShareOrder":"N",
        "fromBpartnerId":"111"
    },
    "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":"1605745"
    },
    "msg":"成功"
}