API
- OpenAPI(Winit) 概述
- 海外仓(OSWH) API接口
- ISP全球直发快递API
- 海外仓API(OSWH)
- 海外仓-商品
- 海外仓-入库
- 海外仓-出库
- 海外仓出库API对接时序
- WO01.仓库代码查询
- WO02.海外仓总库存查询
- WO03.派送方式查询
- WO05.预估派送费用查询(新)
- WO05.预估派送费用查询
- WO06.德国地址校验接口
- WO07.创建海外仓出库单(确认中)
- WO08-1.创建海外仓出库单(草稿)
- WO08-2.提交作废海外仓出库单
- WO08.修改海外仓出库单
- WO09.修改出库单商品信息
- WO10.出库单列表查询
- WO11.海外仓出库单查询
- WO12-1.轨迹查询(库内+尾程派送)
- WO12.轨迹查询(库内)
- WO13.海外仓库存DOI查询
- WO13-1.查询DOI库存详情
- WO05-1.预计运费-新
- WO06-1.EGD订单担保校验接口
- 海外仓出库API列表
- 尾程派送方式代码
- 万邑邮选API(ISP)
WO07.创建海外仓出库单(确认中)
更新时间: 2017-11-22 17:17:30 访问次数:751
接口说明
通过本接口用户可以创建出库单并提交至“确认中”状态。当出库单状态在“确认中”后不能再更改状态。
使用场景
用户可使用本接口创建出库单至“确认中”,一次请求仅支持创建一个出库单。
备注
附: 一、特殊尾程派送方式参数赋值说明 1.尾程派送服务DHL Packet Service收件人地址填写邮局自提柜时 address1填写邮局 address2填写自提柜编号 doorplateNumbers填写门牌号 例:收件人地址为邮局“Postfiliale”,地址门牌号为“520”,邮局自提柜编号为“800811570” 二、DE DPD尾程派送服务新增“门牌号”强制校验说明 DE Warehouse尾程派送服务(如下)“门牌号[doorplateNumbers]”强制校验不能为空,未填写将提示下单错误,请进行填写或为空值时使用默认值。 派送方式:DPD International Parcels (2-8 business days) 派送方式ID:1000213
请求说明
URL | http://api.winit.com.cn/ADInterface/api |
接口测试 | http://erp.sandbox.winit.com.cn/ADInterface/api |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
warehouseID | String() | Y | 万邑通海外仓ID,唯一,可查询。 | |
eBayOrderID | String() | N | eBay OrderID 用于标识一条唯一的eBay 订单,这个订单可以包含一个或多个商品交易(一个交易对应一个eBay 上的Transaction_ID + Item_ID). 当买家在一个时间向同一卖家购买多种商品,eBay 将会基于这些交易(Transaction)生成一个唯一订单号(OrderID)。当买家一次仅仅购买一种商品(一个ItemID)时,则此OrderID 与此笔交易一一对应。 在使用CompleteSale 接口时,OrderID 被用于定位一笔订单。 | |
repeatable | String(1) | Y | 用户授权此海外仓出库单是否可重复。是否允许重复不可为空。 eg. 可重复则取值 ‘Y’ 不可重复则取值‘N’ 我们根据eBay对一个Shipping Order唯一性验证规则制定相应的海外仓出库单唯一性验证规则如下: 当一个海外仓出库单对应的eBay OrderID, eBay TransactionID, eBayItemID 组合唯一时,我们确认此出库单为唯一。作废订单也将被记录并实施验证。 例外情况: 当用户由于业务需要重复发送一个海外仓出库单时,可将repeatable设为‘Y’,则以上唯一性验证失效,此时系统不阻止重复下单。repeatable设为‘N’时则唯一性验证生效。 | |
deliveryWayID | String() | Y | 最后一公里派送方式ID。最后一公里派送方式ID不可为空。 可查询 | |
insuranceTypeID | String() | Y | 最后一公里派送方式所用保险类型ID。保险类型ID不可为空。默认为1000000 | |
sellerOrderNo | String() | N | 卖家订单号 | |
recipientName | String() | Y | 收件人姓名,来自于由eBay买家提供收货地址。收件人姓名不可为空 | |
phoneNum | String() | Y | 收件人电话 | |
zipCode | String() | Y | 邮政编码 | |
emailAddress | String() | N | 收件人电子邮箱 | |
state | String() | Y | 收件人国家名称,可使用国家英文全称或是ISO国家代码。收件人国家不可为空 | |
region | String() | Y | 收件人州名称。收件人州不可为空 | |
city | String() | Y | 城市 | |
address1 | String() | Y | 收件人街道1 | |
address2 | String() | N | 收件人街道2 | |
doorplateNumbers | String() | N | 派送方式为DHL、UK DPD,门牌号必填 | |
productList | Array | 出库商品列表,以下为子节点 | ||
--|productCode | String() | Y | 产品编码。产品编码不可为空,指SKU | |
--|specification | String() | N | 规格(如果此产品注册时填写了该字段,那么此为必填项,否则无法准确定位您注册的产品。如果您在注册产品时没有填写该字段,则在XML中去掉‘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 | |
--|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。 | |
--|isShareOrder | String(1) | N | 共享单(Y/N) | |
--|fromBpartnerId | Integer | N | 共享人(共享单为Y,必填 |
请求示例
请按以下示例调用,用于验证是否使用UTF-8字符编码,提交成功后请将出库订单号提供给技术并要求在后台确认订单数据是否显示正常,相关公告请见:http://developer.winit.com.cn/Index/index.php?s=Index/index/id/226/l/zh-cn。 { "action":"createOutboundOrder", "app_key":"rebecca", "data":{ "address1":"Körschstraße 7", "address2":"", "city":"Kipfenberg", "deliveryWayID":"2000003", "eBayOrderID":"3298473480", "emailAddress":"abc@winit.com", "insuranceTypeID":1000000, "phoneNum":"15900001111", "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" } 其它用例 { "action":"createOutboundOrder", "app_key":"rebecca", "data":{ "address1":"1 Stafford Crt.", "address2":"aaaaaaa", "city":"Bayswater North", "deliveryWayID":"1010520", "eBayOrderID":"3298473480", "emailAddress":"abc@winit.com", "insuranceTypeID":1000000, "phoneNum":"15900001111", "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":"SELLERERP", "sign":"00000000000000000000000000000000", "sign_method":"md5", "timestamp":"2016-06-16 00:19:26", "version":"1.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
outboundOrderNum | String(80) | Y | 出库订单号 | 0 |
返回参数说明 正确的返回结果:出库单号,出库单状态。 错误的返回结果:错误码,错误信息