万邑通开发者网站 - 创建发货单

API

创建发货单

更新时间： 2018-10-11 09:54:21 访问次数：2023

接口说明

分销商提供商品sku、数量、收件人地址、发货仓、派送方式等信息创建物流订单进行发货

使用场景

分销商在刊登可卖商品后，产生了销售订单时，使用此接口创建发货订单（由供货商下物流订单）寄送包裹给买家

备注

无

请求说明

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

请求入参

名称	类型	必填	说明	示例
repeatable	String(1)	Y	用户授权此发货单是否分销商订单号可重复。是否允许重复不可为空。 eg. 可重复则取值 ‘Y’ 不可重复则取值‘N’,当repeatable =Y时允许重复，即一个分销商订单号sellerOrderNo是可以重复创建发货订单的；当repeatable=N时不允许重复，一个分销商订单号sellerOrderNo只允许生成一张发货订单	跟ebay订单校验无关
isAuto	String(1)	Y	是否自动推送发货物流订单,当isAuto=Y时，系统自动将发货订单进行推送，订单状态转为等待发货,当isAuto=N时，此时需要分销商再次使用确认发货wanyilian.distributor.order.confirm，订单状态才会转为等待发货	Y/N
sellerOrderNo	String()	N	分销商订单号
recipientName	String()	Y	收件人姓名,来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum	String()	Y	收件人电话
zipCode	String()	Y	邮政编码
emailAddress	String()	Y	收件人电子邮箱
state	String()	Y	收件人国家名称，可使用国家英文全称或是ISO国家代码。收件人国家不可为空
region	String()	Y	收件人州名称。收件人州不可为空
city	String()	Y	城市
address1	String()	Y	收件人街道1
address2	String()	N	收件人街道2
doorplateNumbers	String()	N	派送方式为DHL、UK DPD，门牌号必填
VATNo	String()	N	UK必填
PackageList	Array		包裹列表，以下为包裹节点
-\|packageNo	String()	N	包裹序号
-\|warehouseCode	String()	N	万邑通海外仓code，唯一，可查询
-\|deliveryWayCode	String()	Y	最后一公里派送方式code,最后一公里派送方式code不可为空,可查询
-\|authBarcode	String()	N	授权条码，供货分销关系唯一授权码	允许为空，保留字段
-\|eBayOrderID	String()	N	eBay OrderID 用于标识一条唯一的eBay 订单，这个订单可以包含一个或多个商品交易（一个交易对应一个eBay 上的Transaction_ID + Item_ID）. 当买家在一个时间向同一卖家购买多种商品，eBay 将会基于这些交易（Transaction）生成一个唯一订单号（OrderID）。当买家一次仅仅购买一种商品（一个ItemID）时，则此OrderID 与此笔交易一一对应。在使用CompleteSale 接口时，OrderID 被用于定位一笔订单
-\|productList	Array		出库商品列表,以下为子节点
-\|-\|productCode	String()	Y	分销平台系统编码，对应查询分销商品接口wanyilian.supplier.spu.querySPUList的randomSKU系统编码
-\|-\|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":"wanyilian.distributor.order.create",
    "app_key":"rebecca",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"aaaaaaa",
        "city":"Bayswater North",
        "doorplateNumbers":"109",
        "emailAddress":"abc@winit.com",
        "phoneNum":"15900001111",
        "VATNo":"vattest001",
        "packageList":[
            {
                "packageNo":"",
                "warehouseCode":"US0003",
                "deliveryWayCode":"OSF1010520",
                "authBarcode":"",
                "eBayOrderID":"3434245-24377766",
                "productList":[
                    {
                        "eBayBuyerID":"98877456rere",
                        "eBaySellerID":"99887rtrtr66123",
                        "eBayItemID":"3434245",
                        "eBayTransactionID":"24377766",
                        "productCode":"LCD-IP4-06",
                        "productNum":"3",
                    },
                    {
                        "eBayBuyerID":"98877456rere",
                        "eBaySellerID":"99887rtrtr66123",
                        "eBayItemID":"3434245",
                        "eBayTransactionID":"24377766",
                        "productCode":"WLCD-IP4-01",
                        "productNum":"1",
                    }
                ]
            }
        ],
        "recipientName":"mingbao",
        "region":"WV",
        "repeatable":"Y",
        "isAuto":"N",
        "sellerOrderNo":"PowerSellerABC123",
        "state":"US",
        "zipCode":"25085"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}

返回出参

名称	类型	必填	说明	示例
orderNums	Array	Y	发货订单号列表
-\|orderNo	String()	Y	发货订单号	由分销平台生成返回
-\|estimateCost	Number(,2)	Y	预估费用（RMB），精确至百分位	因OMS预做费用接口为USD，获得预估total费用后，需由美元转RMB

返回参数说明正确的返回结果：查询成功。错误的返回结果：错误码，错误信息

返回示例

Json
XML

{
    "code":0,
    "data":{
        "orderNums":[
            {
                "orderNo":"WO1605745-1",
                "estimateCost":3.98,
            }
        ]
    },
    "msg":"成功"
}

关键词

创建发货单