创建出库单-新1.0
更新时间: 0000-00-00 00:00:00 访问次数:1025
接口说明
本接口可以创建出库单并提交至“确认中”状态。(不支持智能推荐)
"确认中"的出库单无法修改,只可作废。
请求说明
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
接口名称 | wh.outbound.createSubmittedOrder |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
winitProductCode | String(32) | Y | 最后一公里派送方式编码
可通过接口queryDeliveryWay查询 |
OSF810556 |
warehouseCode | String(40) | Y | 仓库编码 仓库编码,通过接口 queryWarehouse对应的warehouseCode 或者通过在页面物流代码,输入万邑通账号和token得到仓库编码 |
DE0001 |
shipperOrderNo | String(40) | N | 卖家订单号 | |
isRepeat | String(1) | Y | shipperOrderNo是否允许重复
Y:允许重复 N:不允许重复 推荐填写N,可避免操作失误重复发货 |
|
inventoryServiceType | String() | N | 库存类型
2B:ToB整箱出库(必须大写) 2C:ToC销售出库(必须大写) 当为空时,默认为2C销售出库 如需2B整箱出库,请联系商务开通权限,未开通不生效 |
|
storeType | String(100) | N | 电商平台类型
ebay, Amazon, wish, Other, |
|
platformOrderId | String(128) | N | 电商平台订单ID
详见电商平台订单相关字段说明 |
112-345-1432 |
platformAccount | String(128) | N | 平台账号ID(电商平台账号)
详见电商平台订单相关字段说明 |
US-A16Q3SBG9UE1XO |
eBaySellerId | String(256) | N | ebay的sellerID
详见电商平台订单相关字段说明 |
testuser_houlingzhong |
eBayBuyerId | String(256) | N | Ebay的buyerID
详见电商平台订单相关字段说明 |
lilazngirl2303 |
ebayID | String(128) | EbayID
详见电商平台订单相关字段说明 |
||
VATNo | String(128) | O | 卖家VAT
卖家VAT号,需先注册进口商(万邑联-个人中心-服务设置- 出口商/进口商管理-查看-VAT信息-VAT) 1)英国发欧盟,欧盟发英国的订单,根据渠道要求是否必填 2)渠道未要求必填的订单,如为英国出库订单,可填写 |
|
iossNo | String(128) |
|
IOSS编码 | |
buyerCompany | String(100) | N | 收件人公司名称
美国DGM渠道收件人公司为必填,要求为英文收件人公司(详细要求见价卡) |
万邑通 |
receiverCountry | String(50) | Y | 收件人国家名称
1.可填写英文全称 2.可填写ISO国家二字码 |
DE |
receiverCity | String(50) | Y | 城市 | Herten NRW |
receiverState | String(50) | Y | 收件人州名称 | |
receiverName | String(60) | Y | 收件人姓名
收件人姓名不可为空 |
huangxh |
receiverPostcode | String(50) | Y | 邮政编码 | 45701 |
receiverHouseNo | String(60) | O | 门牌号
根据物流渠道不同,门牌号需要必填 可通过接口queryDeliveryWay查询 |
0 |
receiverAddressLine1 | String(100) | Y | 收件人街道1
根据物流渠道不同,填写的要求不相同 DHL快递柜收件人地址填写说明 |
817995256 Postfiliale 560 |
receiverAddressLine2 | String(100) | N | 收件人街道2
根据物流渠道不同,填写的要求不相同 |
|
receiverPhone | String(128) | O | 收件人电话 | |
receiverEmail | String(50) | N | 收件人电子邮箱 | xiaohong.huang@winit.com.cn |
salesAmount | BigDecimal(6,2) | N | 销售金额
限制0.01-999999.99 |
|
currency | String(128) | N | 销售金额币种
|
|
receiverVATEORINo | String(100) | N | 收件人VAT/EORI
|
|
商品明细merchandiseList | ||||
--|merchandiseCode | String(64) | Y | 商品编码
winit注册的商品编码(SKU) |
|
--|specification | String(64) | N | 规格
如果商品在winit注册时填写了规格,则为必填项 否则不传 |
|
--|quantity | Integer(16) | Y | 要发货的某个商品的单品数量。数量必须>0。 | |
--|eBayTransactionId | Sring(64) | N | eBay交易ID
详见电商平台订单相关字段说明 |
|
--|eBayItemId | Sring(64) | N | eBay ItemID
详见电商平台订单相关字段说明 |
|
--|merchandiseGrade | Sring(128) | N | 商品等级
GOOD:良品(必须大写) DEFECTIVE:不良品(必须大写) 当卖家开启商品等级(良品/不良品)的时候填入 如需商品等级管理,请联系商务开通权限以及安排业务流程培训,未开通权限之前入参无效 |
|
--|ownerCode | Sring(128) | N | 货主编码
当卖家开启货主管理的时候填入 如需商品货主管理商品,请联系商务开通权限以及安排业务流程培训,未开通权限之前入参无效 |
|
pickUpSupplier | String() | O | 提货方
PL代表卖家自提 CY代表第三方物流公司自提 仅在使用自提出库的物流产品时必填,若不入参请去除该字段 |
|
logisticsSupplierName | String(100) | O | 第三方物流公司名称
当提货方(pickUpSupplier)为:CY时必填 当提货方为(pickUpSupplier):PL时去除该字段 |
|
selfPickTrackingOrBOLNo | String(50) | N | 第三方物流公司快递单号或BOL
当提货方(pickUpSupplier)为:CY时选填 当提货方(pickUpSupplier)为:PL时去除该字段 |
|
增值服务列表VASList | ||||
--|serviceCode |
Array |
Y |
增值服务编码
可查询通过接口queryDeliveryWay查询出参中的serviceCode增值服务 输入详见 增值服务参数赋值说明 |
OSF777778 |
增值明细信息VASList.attrList | ||||
--|--|attrCode |
String() |
Y | 可查询通过接口queryDeliveryWay查询出参中的attrCode | ISA |
--|--|attrValue | String(20) | Y | 增值服务值 | 100 |
请求示例
{ "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "winitProductCode": "OSF810556", "warehouseCode": "DE0001", "shipperOrderNo": "testforpaketservice", "isRepeat": "Y", "inventoryServiceType": "", "storeType": "Amazon", "platformAccount": "US-A16Q3SBG9UE1XO", "platformOrderId": "112-345-1432", "eBaySellerId": "", "eBayBuyerId": "", "VATNo": "", "iossNo": "", "buyerCompany": "万邑通 ", "receiverCountry": "DE", "receiverCity": "Herten NRW", "receiverState": "", "receiverName": "huangxh", "receiverPostcode": "45701", "receiverHouseNo": "0", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn", "salesAmount": "10000", "currency": "USD", "receiverVATEORINo": "UK1029304", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "", "ownerCode": "" } ], "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "VASList": [ { "serviceCode": "OSF777778", "attrList": [ { "attrCode": "ISA", "attrValue": "50" } ] } ] }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "7E01B49A6248103BD10914A4363940BF", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "CC04B2493C7BC3CFAA97DFB7F98D3CFC" } 1.使用DHL Paken Service的标准海外仓出库 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "winitProductCode": "OSF810556", "warehouseCode": "DE0001", "shipperOrderNo": "testforpaketservice", "isRepeat": "Y", "inventoryServiceType": "", "storeType": "ebay", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "iossNo": "", "buyerCompany": "万邑通 ", "receiverCountry": "DE", "receiverCity": "Herten NRW", "receiverState": "", "receiverName": "huangxh", "receiverPostcode": "45701", "receiverHouseNo": "0", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "", "merchandiseGrade": "", "ownerCode": "" } ], "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "VASList": [ { "serviceCode": "OSF777778", "attrList": [ { "attrCode": "ISA", "attrValue": "50" } ] } ] }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "8E46367BC73479683B439F49C085D6B4", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "648B6128B24ACE078D19736F364CC6E1" } 2.带有增值服务(追踪守护)的入参示例 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "US0001", "orderType": "OSF81", "receiverPostcode": "32066", "receiverCountry": "US", "shipperOrderNo": "", "pickUpSupplier": "PL", "logisticsSupplierName": "123", "selfPickTrackingOrBOLNo": "123", "inventoryServiceType": "2C", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "iossNo": "", "VASList": [ { "serviceCode": "OSF777778", "attrList": [ { "attrCode": "ISA", "attrValue": "50" } ] } ], "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF810595", "invoiceUrl": "", "buyerCompany": "万邑通 ", "receiverName": "huangxh", "receiverHouseNo": "", "receiverAddressLine1": "Unit 8/39 Hill Road", "receiverAddressLine2": "", "receiverCity": "mayo", "receiverState": "fl", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "FE51D582CFFB5F1C6C7F786735D89C7F", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "8309DBFCD4CF7236AF4F9E31321BD1FE" } 3.门牌号填写示例标准海外仓出库单 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "DE0001", "orderType": "OSF81", "receiverPostcode": "45701", "receiverCountry": "DE", "shipperOrderNo": "testforpaketservice", "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "inventoryServiceType": "", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "iossNo": "", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF810556", "invoiceUrl": "", "buyerCompany": "万邑通 ", "receiverName": "huangxh", "receiverHouseNo": "560", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverCity": "Herten NRW", "receiverState": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "C4DBE9271FE60498D2E2C141FA2C9835", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "F03028D73D07B777C7498E0916B865BD" } 4.自提出库单 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "US0001", "orderType": "OSF82", "receiverPostcode": "45701", "receiverCountry": "DE", "shipperOrderNo": "testforselfpickup", "pickUpSupplier": "CY", "logisticsSupplierName": "local UPS", "selfPickTrackingOrBOLNo": "", "inventoryServiceType": "", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "iossNo": "", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF820823", "invoiceUrl": "", "buyerCompany": "万邑通 ", "receiverName": "huangxh", "receiverHouseNo": "560", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverCity": "Herten NRW", "receiverState": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "F4D68658878BC8B9AA9CD9A6D4341E20", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "BE76556C25C7EF6EE8768F89A6142FDC" } 4.1自提出库单-第三方面单出库 { "action":"wh.outbound.createSubmittedOrder", "app_key":"cxtestcb@163.com", "data":{ "warehouseCode":"US0001", "shipperOrderNo":"xiaochen", "inventoryServiceType":"2C", "isRepeat":"Y", "VATNo":"123", "merchandiseList":[ { "merchandiseCode":"cxtestmmCCC", "specification":"", "merchandiseGrade":"GOOD", "quantity":"2" } ], "VASList":[ { "serviceCode":"OSF24WW008", "attrList":[ { "attrCode":"ORDER_PMT", "attrValue":"CARTON_BOX" } ] } ], "winitProductCode":"OSF822006556" }, "format":"json", "language":"zh_CN", "platform":"ABC", "sign":"00000000000000000000000000000000", "sign_method":"md5", "timestamp":"2014-07-30 11:03:48", "version":"1.0" } 4.2自提出库(自提2.0) { "action":"wh.outbound.createSubmittedOrder", "app_key":"rebecca", "data": { "warehouseCode":"US0001", "orderType":"OSF82", "receiverPostcode":"32066", "receiverCountry":"US", "shipperOrderNo":"", "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "inventoryServiceType":"", "isEbay":"Y", "isRepeat":"Y", "storeType":" ", "salesAmount":"", "currency":"", "receiverVATEORINo":"", "platformAccount":"", "platformOrderId":"", "eBaySellerId":"", "eBayBuyerId":"", "VATNo":"", "packageMode":"", "packageMerchandiseCode":"", "packageType":"", "consigneeType":"OTHER", "VASList": [ { "serviceCode": "OSF8V1295" } ], "merchandiseList": [ { "merchandiseCode":"chenzc0011", "specification":"", "quantity":"2", "eBayTransactionId":"", "eBayItemId":"" } ], "winitProductCode":"OSF823006602", "invoiceUrl":"", "buyerCompany":"winit ", "receiverName":"huangxh", "receiverHouseNo":"11", "receiverAddressLine1":" 22 boulevard de la paix ", "receiverAddressLine2":"", "receiverCity":"mayo", "receiverState":"fl", "receiverPhone":"13434740696", "receiverEmail":"xiaohong.huang@winit.com.cn" }, "format":"json", "language":"zh_CN", "platform":"ABC", "sign":"00000000000000000000000000000000", "sign_method":"md5", "timestamp":"2014-07-30 11:03:48", "version":"1.0" } 5.销毁出库单 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "US0001", "orderType": "OSF83", "receiverPostcode": "45701", "receiverCountry": "DE", "shipperOrderNo": "testforselfpickup", "pickUpSupplier": "CY", "logisticsSupplierName": "local UPS", "selfPickTrackingOrBOLNo": "", "inventoryServiceType": "", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF830859", "invoiceUrl": "", "buyerCompany": "万邑通 ", "receiverName": "huangxh", "receiverHouseNo": "560", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverCity": "Herten NRW", "receiverState": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "BC9EFBA4B1D45E4EE5E65D1D7B385D2E", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "54D2914BFCC36485028FAA8043F04A49" } 6.带有收件人公司的出库单 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "US0001", "orderType": "OSF81", "receiverPostcode": "32066", "receiverCountry": "US", "shipperOrderNo": "buyerCompany", "buyerCompany": "万邑通 ", "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "inventoryServiceType": "", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF810595", "invoiceUrl": "", "receiverName": "huangxh", "receiverHouseNo": "", "receiverAddressLine1": "3647 Old State Route 32", "receiverAddressLine2": "", "receiverCity": "Mayo", "receiverState": "fl", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "95BB17F6AEE6D3FD6026B1818173BFA2", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "1BBEFE32390EA66E3E3D038745BE0D17" } 7.带有订单包装方式的出库单 { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "warehouseCode": "US0001", "orderType": "OSF81", "receiverPostcode": "32066", "receiverCountry": "US", "shipperOrderNo": "buyerCompany", "buyerCompany": "万邑通 ", "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "inventoryServiceType": "", "isEbay": "Y", "isRepeat": "Y", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "VASList": [ { "serviceCode": "OSF24WW008", "attrList": [ { "attrCode": "ORDER_PMT", "attrValue": "CARTON_BOX" } ] } ], "merchandiseList": [ { "merchandiseCode": "auto_sku_002", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "" } ], "winitProductCode": "OSF810595", "invoiceUrl": "", "receiverName": "huangxh", "receiverHouseNo": "", "receiverAddressLine1": "3647 Old State Route 32", "receiverAddressLine2": "", "receiverCity": "Mayo", "receiverState": "fl", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "BC485BCAB28001EEE913A209D5622E07", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "35CBE32F32A25695EE1B591B897CFFC2" } 8.带订单销售金额和收件人VAT/EORI { "action": "wh.outbound.createSubmittedOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "winitProductCode": "OSF810556", "warehouseCode": "DE0001", "shipperOrderNo": "testforpaketservice", "isRepeat": "Y", "inventoryServiceType": "", "storeType": "ebay", "eBaySellerId": "testuser_houlingzhong", "eBayBuyerId": "lilazngirl2303", "VATNo": "", "buyerCompany": "万邑通 ", "receiverCountry": "DE", "receiverCity": "Herten NRW", "receiverState": "", "receiverName": "huangxh", "receiverPostcode": "45701", "receiverHouseNo": "0", "receiverAddressLine1": "817995256 Postfiliale 560", "receiverAddressLine2": "", "receiverPhone": "", "receiverEmail": "xiaohong.huang@winit.com.cn", "salesAmount": "10000", "currency": "USD", "receiverVATEORINo": "UK1029304", "merchandiseList": [ { "merchandiseCode": "auto_sku_005", "specification": "", "quantity": "1", "eBayTransactionId": "", "eBayItemId": "", "ownerCode": "" } ], "pickUpSupplier": "", "logisticsSupplierName": "", "selfPickTrackingOrBOLNo": "", "VASList": [ { "serviceCode": "OSF777778", "attrList": [ { "attrCode": "ISA", "attrValue": "50" } ] } ] }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "CFE6C77E4066DAAADE028D4817C8030E", "sign_method": "md5", "timestamp": "2014-07-30 11:03:48", "version": "1.0", "client_sign": "D8B8316302A1EC05174311BD8E24D34C" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
orderNo | String(80) | Y | 出库订单号 | 0 |
splitType |
String() | BW:仓群间拆单
WW:仓群内拆单 NONE:不拆单 |
||
orderNoList |
Array | Y | 出库订单号列表,拆单时返回多个 |
返回参数说明 正确的返回结果:出库单号,出库单状态。 错误的返回结果:错误码,错误信息
返回示例