API
创建出库单(确认中)
更新时间: 2019-10-18 16:13:19 访问次数:7252
接口说明

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

接口英文名称

createOutboundOrder

使用场景

使用本接口创建状态为“确认中”的出库单,
支持创建标准出库单、自提出库单、销毁出库单、商品下架
一次请求仅支持创建一个出库单。
"确认中"的出库单无法修改、无法作废

备注

  • 一、特殊尾程派送方式参数赋值说明
    1.尾程派送服务DHL Paket Service(DHL服务介绍收件人地址填写邮局自提柜时
    请按照以下要求进行填写:
    地址信息 填写要求 示例
    收件人街道1(address1) Postnumber代码+Packstation/ Paketshop/Postfiliale+ 3位数代码 1234567890Packstation101
    收件人街道2(address2) 不填写任何信息
    门牌号 填写3位数代码或者“0”(示例: 3位数代码:101,若填“0”,系统将会进行自动截取3位数代码) 0
    邮箱 非DHL注册用户使用Paketshop/Postfiliale服务必须填写邮箱 test@12234.com

    调用示例请参考入参。
    2.尾程派送使用追踪守护服务追踪服务介绍) 入参需要增加以下字段,详情参考入参。 填写"VASList":[{    
          "serviceCode":"OSF777778",
          "attrList":[{
              "attrCode":"ISA",
              "attrValue":"50"
    }]   }],

  • 投保金额为RMB,货币单位默认CNY
  • 二、欧洲尾程派送服务“门牌号“[doorplateNumbers]强制校验不能为空要求。
    以下派送方式(deliveryWayID),门牌号(doorplateNumbers)非空,如果第三方ERP没有可以填写门牌号,请将门牌号填写至地址1的末尾(最终取值规则请自行使用的ERP),涉及派送方式如下:
    1.OSF812036 DHL - Domestic Paket - Visual Check of Age (Standard 1-3 Business Days)-BE 2000991
    2.OSF811934 DPD - Domestic Economic Parcel (Standard 1-3 Business Days) 1000215
    3.OSF810514 DPD - Domestic Normal Parcel (Standard 1-3 Business Days) 1000211
    4.OSF811778 DPD - Domestic Normal Parcel (Standard 1-3 Business Days)-LMJ 2000080
    5.OSF810511 DPD - Domestic Small Parcel (Standard 1-3 Business Days) 1000212
    6.OSF810517 DPD - International Parcel (Standard 2-8 Business Days) 1000213
    7.OSF811940 UPS - International Single Parcel (Standard 2-6 Business Days) 2000098
    8.OSF811120 VAS - DHL - Domestic Freight (Standard 2-3 Business Days) 1031661
    9.OSF810568 VAS - DHL - Domestic Paket (Standard 1-3 Business Days) 1031659
    10.OSF811123 VAS - DHL - Europe Freight (Standard 2-10 Business Days) 1042664
    11.OSF810571 VAS - DHL - International Paket (Standard 2-8 Business Days) 1042663
    12.OSF811391 VAS - DPD - International Parcel (Standard 2-8 Business Days) 2000020
    13.OSF811002495 Colissimo FR Delivery (2-3 working days) 20001835
    14.OSF811543 DHL - Domestic Paket - Visual Check of Age (Standard 1-3 Business Days)-PL 2000043
    15.OSF810556 DHL - Domestic Paket (Standard 1-3 Business Days) 1010308
    16.OSF811715 DHL - Domestic Paket (Standard 1-3 Business Days) test 2000066
    17.OSF811784 DHL - Domestic Paket (Standard 1-3 Business Days)-BE 2000088
    18.OSF811539 DHL - Domestic Paket (Standard 1-3 Business Days)-PL 2000041
    19.OSF810559 DHL - International Paket (Standard 2-8 Business Days) 1010309
    20.OSF811787 DHL - International Paket (Standard 2-8 Business Days)-BE 2000089
    21.OSF811541 DHL - International Paket (Standard 2-8 Business Days)-PL 2000042
    22.OSF811781 DPD International Parcels Service (2-8 business days)-LMJ 2000081
    23.OSF811526 XDP - 1 Man Parcel-Multiple(Economy 3-5 Working Days) -BH-UKGF 2000039
    24.OSF820823 VAS - Self pick up service 2000970
  • 三、规避重复发货风险
    创建出库单时可以通过字段“repeatable”控制是否允许卖家订单号重复。
  • 四、自提出库单需要区分【卖家自提】或者【第三方物流公司】
    (1)卖家自提:订单归属方——卖家,自行前往winit仓库进行自提
    (2)第三方物流公司自提:订单归属方——卖家,委托第三方物流公司前往winit仓库进行自提。
    入参说明:
           卖家自提:deliverySide 必填 PL
           第三方物流公司自提:deliverySide :必填 CY,
                                               thirdPartyLogistics:必填,请填写物流公司名称 
                                               trackingNoBOL:选填

  • 目前自提出库的winit物流产品如下
    物流渠道编码
    (deliveryWayID)
    物流渠道名称
    (deliveryWay)
    2000970 VAS - Self pick up service
    2000022 Self pick up servicee
    200036 VAS - Self pick up service(palletzation)

    只有使用海外仓出库为自提出库的物流渠道时为必填,其他物流渠道非必填

    上线日期:2019年7月12日

  • 五、eBay返利政策要求

    一组ebayID(ebaySellerID)、TransacitonID、itemID只能返利一次
    winit禁止不同的收件人填写相同的transaction ID和item ID号.

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

名称 类型 必填 说明 示例
warehouseID String(10) Y 万邑通海外仓ID
通过接口queryWarehouse查询得到出参:warehouseID
1000001
eBayOrderID String(1) N eBay OrderID
eBay的订单号,若为eBay订单请务必准确填写eBayOrderID ,eBaySellerID,eBay TransactionID ,eBayItemID,这将影响到eBay返利政策。
使用eBay的CompleteSale接口时,OrderID可以用于定位一笔订单。
sellerOrderNo String(60) N 卖家订单号
repeatable String(1) Y 卖家订单号sellerOrderNo是否允许重复
Y:允许重复
N:不允许重复
推荐填写N
deliveryWayID String(20) Y 最后一公里派送方式ID
物流渠道,可查询通过接口queryDeliveryWay查询出参中的deliveryID
insuranceTypeID String() N 最后一公里派送方式所用保险类型ID
默认为1000000,已停用,不用入参
isShareOrder String() N 是否分销订单
已停用,不用入参
fromBpartnerId Integer N 分销人
已停用,不用入参
recipientName String(255) Y 收件人姓名
来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum String(128) Y 收件人电话
zipCode String(10) Y 邮政编码
emailAddress String(50) N 收件人电子邮箱
state String(50) Y 收件人国家名称
1.可填写英文全称
2.可填写ISO国家二字码
region String(50) Y 收件人州名称
city String(50) Y 城市
address1 String() Y 收件人街道1
根据物流渠道不同,填写的要求不相同
address2 String(100) N 收件人街道2
根据物流渠道不同,填写的要求不相同
doorplateNumbers String(10) O 门牌号
根据物流渠道不同,门牌号需要必填
派送方式为德国的DHL、UK DPD,门牌号为必填
详细见备注第二点
VATNo String(128) O 卖家VAT号
出库仓库在UK的出库单,要求填写VAT,英国海关要求

VASList
Array
N
增值服务列表,根据选择的物流渠道是否支持增值服务(通过接口queryDeliveryWay出参serviceCode的value就为增值服务,当非空是,可根据需要购买或者放弃购买增值服务
--|serviceCode
Array

Y
增值服务编码
可查询通过接口queryDeliveryWay查询出参中的serviceCode
OSF777778
--|attrList Array Y 增值服务选项,以下为子节点
--|--|attrCode
String()
Y 增值服务属性code
可查询通过接口queryDeliveryWay查询出参中的attrCode
目前暂时是ISA

投保金额ISA的最小值:0.01,最大是10000
ISA
--|--|attrValue String(20) Y 增值服务值
投保金额ISA的最小值:0.01,最大是10000
100
productList Array 出库商品列表,以下为子节点
--|productCode String(100) Y 商品编码
winit注册的商品编码(SKU)
--|specification String(255) N 规格
如果商品在winit注册时填写了规格,则为必填项,否则无法准确定位您注册的产品。
如果您在注册商品时没有填写该字段,则在入参中去掉‘Specification’字段。
--|eBayTransactionID Long N eBay交易ID选填,如果填写,则eBay TransactionID,eBay TransactionID,eBaySellerID三个值都需要填写,若不填写eBay TransactionID则三个值都不填写。 eBay上使用TransactionID+ItemID标识一个唯一的交易,一个OrderID可以对应一个或多个交易。 当一笔交易的拍卖方式为‘BID’时,此笔交易的TransactionID为‘0’。 eBay API参考: eBay API: GetOrders Paramater: OrderArray.Order.TransactionArray.Transaction.TransactionID
--|eBaySellerID String() N 当前Transaction对应的eBay Seller ID
eBay Seller ID为选填,若为eBay订单请务必准确填写eBayOrderID ,eBaySellerID,eBay TransactionID ,eBayItemID,这将影响到eBay返利政策。
eBay API参考:
eBay API: GetOrders
Paramater: OrderArray.Order.SellerUserID
--|eBayItemID Long N eBay ItemID
eBay ItemID为选填,若为eBay订单请务必准确填写eBayOrderID ,eBaySellerID,eBay TransactionID ,eBayItemID,这将影响到eBay返利政策。
eBay上使用描述一个刊登的唯一标识。一个刊登可以产生多笔交易,但是ItemID是唯一不变的。
eBay API参考:
eBay API: GetOrders
Paramater: OrderArray.Order.TransactionArray.Transaction.Item.ItemID
--|eBayBuyerID String() N 当前Transaction对应的eBay Buyer ID。
eBay Buyer ID为选填。
eBay API参考:
eBay API: GetOrders
Paramater: OrderArray.Order.BuyerUserID
--|productNum Integer() Y 要发货的某个商品的单品数量。数量必须>0。
deliverySide String(2) O 提货方
PL代表卖家自提
CY代表第三方物流公司自提
使用自提出库的物流产品时必填
注意:本入参的值不能为空,若不入参请去除该字段
thirdPartyLogistics String(100) O 第三方物流公司名称
当提货方(deliverySide)为:CY时必填 
当提货方为(deliverySide):PL时去除该字段
trackingNoBOL String(50) N 第三方物流公司快递单号或BOL
当提货方(deliverySide)为:CY时选填 
当提货方(deliverySide)为:PL时去除该字段
请求示例
1.使用DHL Paken Service的标准海外仓出库 
{
	"action": "createOutboundOrder",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "3BC06D7F5771E937E2D276F79BD7716C",
	"data": {
		"doorplateNumbers":"0",
                "address1": "817995256 Postfiliale 560.",
		"address2": "",
		"city": "Herten NRW",
		"deliveryWayID": "1010308",
		"eBayOrderID": "",
		"emailAddress": "abc@winit.com",
		"phoneNum": "15900001111",
		"productList": [{
			"eBayBuyerID": "",
			"eBayItemID": "",
			"eBaySellerID": "",
			"eBayTransactionID": "",
			"productCode": "auto_sku_005",
			"productNum": "1",
			"specification": ""
		}],
		"recipientName": "test",
		"region": "",
		"repeatable": "Y",
		"sellerOrderNo": "testforpaketservice",
		"state": "DE",
		"warehouseID": "1000089",
		"zipCode": "45701"
          
	},
	"format": "json",
	"language": "zh_CN",
	"platform": "OWNERERP",
	"sign": "4026B2FA3B4443377DCF60D124049526",
	"sign_method": "md5",
	"timestamp": "2016-06-16 00:19:26",
	"version": "1.0"
}
	   
	   2.带有增值服务(追踪守护)的入参示例 
{
    "action":"createOutboundOrder",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"38B87482C92FFEF0F10292B7AFA44087",
    "data":{
        "address1":"Körschstraße 7",
        "address2":"",
        "city":"Kipfenberg",

        "deliveryWayID":"2000003",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "phoneNum":"15900001111",
        "VATNo":"",
        "VASList": [{
	    "serviceCode": "OSF777778",
	    "attrList": [{
		"attrCode": "ISA",
		"attrValue": "50"
	    }]
        }],
          "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"
}
3.门牌号填写示例标准海外仓出库单 
{
	"action": "createOutboundOrder",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "E6C160EA5C464814D2BBDF4EC73B4ADE",
	"data": {
		"doorplateNumbers":"560",
                "address1": "817995256 Postfiliale .",
		"address2": "",
		"city": "Herten NRW",
		"deliveryWayID": "1010308",
		"eBayOrderID": "",
		"emailAddress": "abc@winit.com",
		"phoneNum": "15900001111",
		"productList": [{
			"eBayBuyerID": "",
			"eBayItemID": "",
			"eBaySellerID": "",
			"eBayTransactionID": "",
			"productCode": "auto_sku_005",
			"productNum": "1",
			"specification": ""
		}],
		"recipientName": "test",
		"region": "",
		"repeatable": "Y",
		"sellerOrderNo": "testforpaketservice",
		"state": "Germany",
		"warehouseID": "1000089",
		"zipCode": "45701"
          
	},
	"format": "json",
	"language": "zh_CN",
	"platform": "OWNERERP",
	"sign": "41375B644153BC2E941FB3C7FB2CBC0A",
	"sign_method": "md5",
	"timestamp": "2016-06-16 00:19:26",
	"version": "1.0"
}
4.自提出库单 
{
    "action":"createOutboundOrder",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"F15D328268B5152DAD44032E890035BB",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"aaaaaaa",
        "city":"Bayswater North",
        "deliveryWayID":"1010520",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "insuranceTypeID":"1000000",
        "phoneNum":"15900001111",
         "deliverySide":"CY",
        "thirdPartyLogistics":"TEST",
        "trackingNoBOL":"TEST20190715",
        "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":"OWNERERP",
    "sign":"928E0EB7BE89E36034C1CCDF8A108530",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}
5.销毁出库单 
{
    "action":"createOutboundOrder",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"83E707E85C50B737D20EFFBDF114813D",
    "data":{
        "deliveryWayID":"2000974",
        "productList":[
            {
                    "productCode":"auto_sku_001",
                "productNum":"1",
                "specification":""
            }
        ],
      "recipientName":"00000",
      "zipCode":"00000",
          "city":"000000",    
             "state":"0000",
             "address1":"1 Stafford Crt.",
        "repeatable":"Y",
        "sellerOrderNo":"testforScrapService",
           "warehouseID":"1000001"   
           
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"512DB482E8E45F86ECFDA1BDAD670481",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}
 
     
返回出参
名称 类型 必填 说明 示例
outboundOrderNum String(80) Y 出库订单号 0
splitType
String() BW:仓群间拆单
WW:仓群内拆单
NONE:不拆单

outboundOrderNums
Array Y 出库订单号列表,拆单时返回多个

返回参数说明 正确的返回结果:出库单号,出库单状态。 错误的返回结果:错误码,错误信息

返回示例
{
   "code": 0,
   "msg": "操作成功",
   "data":    {
      "splitType": "NONE",
      "outboundOrderNums": ["WO1041628364"],
      "outboundOrderNum": "WO1041628364"
   }
}
 
     
v