创建发货单
更新时间: 2025-03-10 20:29:41 访问次数:4153

接口说明

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

使用场景

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

接口名称

wanyilian.distributor.order.create

请求说明

请求内容 说明
URL https://openapi.wanyilian.com/cedpopenapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,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必填
remark String() N 备注
PackageList Array Y 包裹列表,以下为包裹节点
- 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 Y 出库商品列表,以下为子节点
- - 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

请求示例

  1. {
  2. "action":"wanyilian.distributor.order.create",
  3. "app_key":"rebecca",
  4. "data":{
  5. "address1":"1 Stafford Crt.",
  6. "address2":"aaaaaaa",
  7. "city":"Bayswater North",
  8. "doorplateNumbers":"109",
  9. "emailAddress":"abc@winit.com",
  10. "phoneNum":"15900001111",
  11. "VATNo":"vattest001",
  12. "packageList":[
  13. {
  14. "packageNo":"",
  15. "warehouseCode":"US0003",
  16. "deliveryWayCode":"OSF1010520",
  17. "authBarcode":"",
  18. "eBayOrderID":"3434245-24377766",
  19. "productList":[
  20. {
  21. "eBayBuyerID":"98877456rere",
  22. "eBaySellerID":"99887rtrtr66123",
  23. "eBayItemID":"3434245",
  24. "eBayTransactionID":"24377766",
  25. "productCode":"LCD-IP4-06",
  26. "productNum":"3",
  27. },
  28. {
  29. "eBayBuyerID":"98877456rere",
  30. "eBaySellerID":"99887rtrtr66123",
  31. "eBayItemID":"3434245",
  32. "eBayTransactionID":"24377766",
  33. "productCode":"WLCD-IP4-01",
  34. "productNum":"1",
  35. }
  36. ]
  37. }
  38. ],
  39. "recipientName":"mingbao",
  40. "region":"WV",
  41. "repeatable":"Y",
  42. "isAuto":"N",
  43. "sellerOrderNo":"PowerSellerABC123",
  44. "state":"US",
  45. "zipCode":"25085"
  46. },
  47. "format":"json",
  48. "language":"zh_CN",
  49. "platform":"SELLERERP",
  50. "sign":"00000000000000000000000000000000",
  51. "sign_method":"md5",
  52. "timestamp":"2016-06-16 00:19:26",
  53. "version":"1.0"
  54. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

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

返回示例

  1. {
  2. "code":0,
  3. "data":{
  4. "orderNums":[
  5. {
  6. "orderNo":"WO1605745-1",
  7. "estimateCost":3.98,
  8. }
  9. ]
  10. },
  11. "msg":"成功"
  12. }
关键词