API
创建发货单
更新时间: 2018-10-11 09:54:21 访问次数:1453
接口说明

分销商提供商品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()
NUK必填
PackageList
Array
包裹列表,以下为包裹节点

-|packageNo
String()
N包裹序号

-|warehouseCode
String()
N万邑通海外仓code,唯一,可查询

-|deliveryWayCode
String()
Y最后一公里派送方式code,最后一公里派送方式code不可为空,可查询

-|authBarcode
String()
N授权条码,供货分销关系唯一授权码
允许为空,保留字段
-|eBayOrderID
String()
NeBay 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
NeBay TransactionID。eBay TransactionID为选填。 eBay上使用TransactionID+ItemID标识一个唯一的交易,一个OrderID可以对应一个或多个交易。 当一笔交易的拍卖方式为‘BID’时,此笔交易的TransactionID为‘0’。 eBay API参考: eBay API: GetOrders Paramater: OrderArray.Order.TransactionArray.Transaction.TransactionID

-|-|eBayItemID
LongNeBay 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
IntegerY一个海外仓出库单所包含的某个产品的数量。产品对应的单品数量必须>0

请求示例
{
    "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

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

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

                            
关键词