API
创建出库单
更新时间: 2024-03-07 17:30:42 访问次数:25970

接口说明

本接口可以创建出库单并提交至“确认中”状态。
“确认中”的出库单无法修改

接口名称

createOutboundOrder

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
接口版本version 2.0 当前版本(修改电商平台入参相关字段)
1.0 预计2023年6月停用,查看历史版本

请求入参

名称 类型 必填 说明 示例
sellerOrderNo String(60) N 卖家订单号
repeatable String(1) Y sellerOrderNo是否允许重复
Y:允许重复
N:不允许重复
推荐填写N
warehouseID String(10) Y 万邑通海外仓ID
通过接口queryWarehouse查询
1000001
deliveryWayID String(20) Y 最后一公里派送方式ID
物流渠道,可通过接口queryDeliveryWay查询出参中的deliveryID
1010308
state String(50) Y 收件人国家名称
1.可填写英文全称
2.可填写ISO国家二字码
city String(50) Y 收件人城市
region String(50) Y 收件人州名称
zipCode String(10) Y 收件人邮政编码
详见收件信息-邮编格式说明
address1 String() Y 收件人街道1
根据物流渠道不同,填写的要求不相同
address2 String(100) N 收件人街道2
根据物流渠道不同,填写的要求不相同
doorplateNumbers String(10) O 门牌号
根据物流渠道不同,门牌号需要必填
recipientName String(255) Y 收件人姓名
来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum String(128) O 收件人电话
emailAddress String(50) N 收件人电子邮箱
buyerCompany String(100) N 收件人公司名称
美国DGM渠道收件人公司为必填,要求为英文收件人公司(详细要求见价卡)
VATNo String(128) O 卖家VAT号,需先注册进口商(万邑联-个人中心-服务设置- 出口商/进口商管理-查看-VAT信息-VAT)
1)英国发欧盟,欧盟发英国的订单,根据渠道要求是否必填
2)渠道未要求必填的订单,如为英国出库订单,可填写
iossNo String(128) N IOSS编码
salesAmount BigDecimal(6,2) N 销售金额
限制0.01-999999.99
currency String(128) N 销售金额币种
receiverVATNo String(100) N 收件人VAT
receiverVATEORINo String(100) N 收件人VAT/EORI,已弃用
deliverySide String(2) 0 提货方
PL代表卖家自提
CY代表第三方物流公司自提
使用自提出库的物流产品时必填
注意:本入参的值不能为空,若不入参请去除该字段
thirdPartyLogistics String(100) 0 提货方
第三方物流公司名称
当提货方(deliverySide)为CY时必填
当提货方为(deliverySide)PL时去除该字段
trackingNoBOL String(50) N 第三方物流公司快递单号或BOL
当提货方(deliverySide)为CY时选填
当提货方(deliverySide)为PL时去除该字段
storeType String(100) N 电商平台类型
eBay,Amazon,Wish,TikTok,Temu,Shopify,OTTO,AliExpess,Other
platformAccount String(128) N 电商平台账号ID
详见电商平台字段说明
US-A16Q3SBG9UE1XO
platformOrderId String(128) N 电商平台订单ID
详见电商平台字段说明
112-345-1432
productList Array Y 商品列表
–|productCode String(100) Y 商品编码
winit注册的商品编码(SKU)
–|specification String(255) N 规格
如果商品在winit注册时填写了规格,则为必填项,否则不传。
–|productNum Integer() N 单品数量,数量必须>0。
注意:
若不入参SKU类型及库存单元标准件数,则该字段必填
若入参了outboundQuantity出库箱数,则该字段不可填
–|skuType String(32) N SKU类型
SINGLE:单一产品
SUITE:套装产品
BOX:箱产品
–|skuStandardQuantity Integer(10) N 库存单元标准件数
–|thirdPartyBarcode String(128) N 第三方条码
–|outboundQuantity Integer(10) N 出库箱数
如果入参了SKU类型,出库箱数为必传值
–|inventoryAttribute Array N 库存属性list
–|–|tagName String() O 库存属性CODE值如下:
stockGrade 商品等级
stockOrg(当卖家开通库存组织管理必填,未开通权限之前入参无效)
stockOwner 货主编码
–|–|tagValue String() O 当tagName为stockGrade时,入参商品等级
GOOD:良品(必须大写)
DEFECTIVE:不良品(必须大写)
当tagName为stockOrg时,入参库存组织编码
当tagName为stockOwner时,入参货主编码
–|platformTransactionId Long N 若若电商平台类型选择为eBay,请填写订单在平台的transation ID;
若电商平台类型选择为TikTok,请填写订单在平台的Package ID。
详见电商平台字段说明
–|platformItemId Long N 若电商平台类型选择为eBay,请填写商品在平台的Item ID;
若电商平台类型选择为TikTok,请填写商品在平台的Product ID。
详见电商平台字段说明
–|platformSellerId String() N 若电商平台类型选择为eBay,请填写eBay Seller ID
–|platformBuyerId String() N 若电商平台类型选择为eBay,请填写eBay Buyer ID。
packageMode String() N 出库加包装
已弃用,请参考增值服务VASList
PACKAGING_WINIT:WINIT标准包装
PACKAGING_CUSTOMER:客制包装
CUSTOM_LOGISTICS:WINIT标准&客制包装
NO:无包装
packageMerchandiseCode String() N 指定包材出库商品编码
已弃用,请参考增值服务VASList
packageType String() N 包材类型
已弃用,请参考增值服务VASList
COURIER_SATCHEL:快递袋
PADDED_ENVELOPE:气泡袋
CARTON_BOX:纸箱
NO:无包装
VASList Array N 增值服务列表
serviceCode String() N 值服务编码
可查询通过接口queryDeliveryWay查询出参中的serviceCode
增值服务输入详见 增值服务参数赋值说明
VASList.attrList Array N 增值明细信息
attrCode String() N 增值服务属性code
可查询通过接口queryDeliveryWay查询出参中的attrCode
ISA 投保金额
PACKAGE_MODE 出库加包装
PACKAGE_MERCHANDISE_CODE 指定包材出库商品编码
PACKAGE_TYPE_MATERIAL 包材类型
attrValue String(20) N 增值服务值

已停用字段:
insuranceTypeID最后一公里派送方式所用保险类型ID ,默认为1000000;isShareOrder是否分销订单;fromBpartnerId分销人

请求示例

  1. {
  2. "action": "createOutboundOrder",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "D98D562FD584C495C783626718A817DB",
  6. "data": {
  7. "storeType": "tiktok",
  8. "platformOrderId": "order1",
  9. "platformAccount": ""account1",
  10. "doorplateNumbers": "0",
  11. "address1": "123.",
  12. "address2": "",
  13. "city": "Herten NRW",
  14. "deliveryWayID": "1010308",
  15. "emailAddress": "abc@winit.com",
  16. "phoneNum": "15900001111",
  17. "productList": [
  18. {
  19. "productCode": "auto_picking_001",
  20. "productNum": "1",
  21. "specification": "",
  22. "platformTransactionId": "t1",
  23. "platformItemId": "i1",
  24. "platformSellerId": "s1",
  25. "platformBuyerId": "b1"
  26. }
  27. ],
  28. "recipientName": "test",
  29. "region": "",
  30. "repeatable": "Y",
  31. "sellerOrderNo": "testforpaketservice",
  32. "state": "DE",
  33. "warehouseID": "1000089",
  34. "zipCode": "45701"
  35. },
  36. "format": "json",
  37. "language": "zh_CN",
  38. "platform": "OWNERERP",
  39. "sign": "05CA30465CAB1BA2664E3CAAB5A7D7C6",
  40. "sign_method": "md5",
  41. "timestamp": "2016-06-16 00:19:26",
  42. "version": "2.0"
  43. }

不良品出库

  1. {
  2. "action": "createOutboundOrder",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "D98D562FD584C495C783626718A817DB",
  6. "data": {
  7. "warehouseCode": "US0001",
  8. "shipperOrderNo": "不良品下单",
  9. "isRepeat": "Y",
  10. "storeType": "ebay",
  11. "VATNo": "",
  12. "iossNo": "",
  13. "buyerCompany": "万邑通 ",
  14. "receiverCountry": "US",
  15. "receiverCity": "mayo",
  16. "receiverState": "FL",
  17. "receiverName": "apitestlong001",
  18. "receiverPostcode": "32066",
  19. "receiverHouseNo": "No.320",
  20. "receiverAddressLine1": "address1 Postfiliale 560",
  21. "receiverAddressLine2": "",
  22. "receiverPhone": "1234567890",
  23. "receiverEmail": "1receivertest@winit.com.cn",
  24. "productList": [
  25. {
  26. "productCode": "buliang002",
  27. "inventoryAttribute":[
  28. {
  29. "tagName":"stockGrade",
  30. "tagValue":"DEFECTIVE"
  31. }
  32. ],
  33. "specification": "",
  34. "productNum": "1",
  35. "platformTransactionId": "",
  36. "platformItemId": "",
  37. "platformSellerId": "",
  38. "platformBuyerId": "",
  39. "skuType": "",
  40. "skuStandardQuantity": "",
  41. "thirdPartyBarcode": "",
  42. "outboundQuantity": "",
  43. "packingBatchNo": "",
  44. "batchDate": ""
  45. }
  46. ],
  47. "deliveryWayID":"2303043",
  48. "warehouseID":"1000008",
  49. "repeatable": "Y",
  50. "recipientName": "test",
  51. "zipCode":"32066",
  52. "state":"US",
  53. "region":"FL",
  54. "city":"Mayo",
  55. "address1":"testaddress001",
  56. "emailAddress": "abc@winit.com",
  57. "phoneNum": "15900001111",
  58. "pickUpSupplier": "",
  59. "logisticsSupplierName": "",
  60. "selfPickTrackingOrBOLNo": ""
  61. }
  62. "format": "json",
  63. "language": "zh_CN",
  64. "platform": "OWNERERP",
  65. "sign": "05CA30465CAB1BA2664E3CAAB5A7D7C6",
  66. "sign_method": "md5",
  67. "timestamp": "2016-06-16 00:19:26",
  68. "version": "2.0"
  69. }

返回出参

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

名称 类型 必填 说明 示例
orderNo String(80) Y 出库订单号
splitType String() | BW:仓群间拆单
WW:仓群内拆单
NONE:不拆单
orderNoList Array Y 出库订单号列表,拆单时返回多个

返回示例

  1. {
  2. "code": 0,
  3. "msg": "操作成功",
  4. "data": {
  5. "splitType": "NONE",
  6. "outboundOrderNums": ["WO1041628364"],
  7. "outboundOrderNum": "WO1041628364"
  8. }
  9. }