万邑通开发者网站 - 创建出库单（草稿）

API

创建出库单（草稿）—已停用

更新时间： 2019-11-18 22:35:37 访问次数：10855

接口说明

通过本接口用户可以创建出库单（草稿状态）。

接口英文名称

createOutboundInfo

常用工具

使用场景

本接口支持创建标准出库单、自提出库单、销毁出库单、商品下架
一次请求仅支持创建一个出库单。

备注

一、特殊尾程派送方式参数赋值说明
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"
}] }],

二、欧洲尾程派送服务“门牌号“[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仓库进行自提。
入参说明：
PL:必填：deliverySide；
CY:必填：deliverySide，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	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。

请求入参

名称	类型	必填	说明	示例
warehouseID	String()	Y	万邑通海外仓ID 通过接口queryWarehouse查询得到出参：warehouseID
eBayOrderID	String()	N	eBay OrderID eBay的订单号，若为eBay订单请务必准确填写eBayOrderID ,eBaySellerID，eBay TransactionID ,eBayItemID,这将影响到eBay返利政策。使用eBay的CompleteSale接口时，OrderID可以用于定位一笔订单。
sellerOrderNo	String()	N	卖家订单号
repeatable	String(1)	Y	卖家订单号sellerOrderNo是否允许重复 Y:允许重复 N:不允许重复推荐填写N
deliveryWayID	String()	Y	最后一公里派送方式ID 物流渠道，可查询通过接口queryDeliveryWay查询出参中的deliveryID
insuranceTypeID	String()	N	最后一公里派送方式所用保险类型ID 默认为1000000，已停用，不用入参
isShareOrder	String()	N	是否分销订单已停用，不用入参
fromBpartnerId	Integer	N	分销人已停用，不用入参
buyerCompany	String(100)	N	收件人公司名称来自于由eBay买家提供收货地址。收件人姓名不可为空
recipientName	String(255)	Y	收件人姓名来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum	String(128)	Y	收件人电话
zipCode	String()	Y	邮政编码
emailAddress	String(50)	N	收件人电子邮箱
state	String(50)	Y	收件人国家名称 1.可填写英文全称 2.可填写ISO国家二字码
region	String(50)	O	收件人州名称 1.可填写州的英文全称 2.可填写州的英文缩写根据物流渠道不同，对
city	String(50)	Y	城市
address1	String()	Y	收件人街道1 根据物流渠道不同，填写的要求不相同
address2	String()	N	收件人街道2 根据物流渠道不同，填写的要求不相同
doorplateNumbers	String()	O	门牌号根据物流渠道不同，门牌号需要必填派送方式为德国的DHL、UK DPD，门牌号为必填详细见备注第二点
VATNo	String()	O	卖家VAT号出库仓库在UK的出库单，要求填写VAT，英国海关要求
VasList	Array		增值服务列表，根据选择的物流渠道是否支持增值服务（通过接口queryDeliveryWay出参serviceCode的value就为增值服务，当非空是，可根据需要购买或者放弃购买增值服务
--\|serviceCode	Array	Y	增值服务编码，目前的增值服务为：追踪守护服务OSF777778	OSF777778
--\|attrList	Array		增值服务选项，以下为子节点
--\|--\|attrCode	String()	N	增值服务属性code 可查询通过接口queryDeliveryWay返回出参attrCode 目前暂时是ISA 投保金额ISA的最小值：1，最大是10000	ISA
--\|--\|attrValue	String()	N	增值服务值投保金额ISA的最小值：1，最大是10000
productList	Array		出库商品列表,以下为子节点
--\|productCode	String()	Y	商品编码 winit注册的商品编码(SKU)
--\|specification	String()	N	规格如果商品在winit注册时填写了规格，则为必填项，否则无法准确定位您注册的产品。如果您在注册商品时没有填写该字段，则在入参中去掉‘Specification’字段。
--\|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
--\|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	商品数量指定SKU的商品数量，必须>0
deliverySide	String(2)	O	提货方 PL代表卖家自提 CY代表第三方物流公司自提使用自提出库的物流产品时必填注意：本入参的值不能为空，若不入参请去除该字段
thirdPartyLogistics	String(100)	O	第三方物流公司名称当提货方为：CY时必填当提货方为：PL时去除该字段
trackingNoBOL	String(50)	N	第三方物流公司快递单号或BOL 当提货方为：CY时选填当提货方为：PL时去除该字段

请求示例

Json
XML

1.使用DHL Paken Service的标准海外仓出库 
{
	"action": "createOutboundInfo",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "9D483B443D26009A2DB34C1681F70839",
	"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": "Germany",
		"warehouseID": "1000089",
		"zipCode": "45701"
          
	},
	"format": "json",
	"language": "zh_CN",
	"platform": "OWNERERP",
	"sign": "B70E527C420DD931A648ABEB8EC4A640",
	"sign_method": "md5",
	"timestamp": "2016-06-16 00:19:26",
	"version": "1.0"
}
2.有增值服务（追踪守护）海外仓出库 
									 {
    "action":"createOutboundInfo",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"C10DA45F7BC2E755FFC39A77954B31F5",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"82 Worendo Street",
        "city":"Bayswater North",
        "deliveryWayID":"2000003",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "phoneNum":"15900001111",
       "VASList":[{    
      "serviceCode":"OSF777778",
      "attrList":[{
          "attrCode":"ISA",
          "attrValue":"50"
}]   }],
        "VATNo":"",
        "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"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"94B6A260A4E09FDF0EC013D1B47E8F49",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}
3.门牌号填写示例标准海外出库单  
{
	"action": "createOutboundInfo",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "4A1C19B86D7EEAF2242ADFCBBBF54ADF",
	"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": "38E2C326CA130285C91A57BA27BFDFD5",
	"sign_method": "md5",
	"timestamp": "2016-06-16 00:19:26",
	"version": "1.0"
}
4.自提出库 
{
    "action":"createOutboundInfo",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"BAA3C7A79B7D5321E06D22801F714C7D",
    "data":{
        "address1":"1 Stafford Crt.",
        "address2":"82 Worendo Street",
        "city":"Bayswater North",
        "deliveryWayID":"2000970",
        "eBayOrderID":"3298473480",
        "emailAddress":"abc@winit.com",
        "phoneNum":"15900001111",
        "VATNo":"",
        "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"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"5BC3B1469007706559C205C913AB6AC8",
    "sign_method":"md5",
    "timestamp":"2016-06-16 00:19:26",
    "version":"1.0"
}

返回出参

名称	类型	必填	说明	示例
outboundOrderNum	String(80)	Y	出库订单号	0

返回参数说明正确的返回结果：出库单号，出库单成功。错误的返回结果：错误码，错误信息

返回示例

Json
XML

{
   "code": "0",
   "msg": "操作成功",
   "data": {"outboundOrderNum": "WO0000003151"}
}

关键词

WO08-1.创建海外仓出库单（草稿）——已停用