API
创建出库单(确认中)-新
更新时间: 2021-06-24 16:05:08 访问次数:6292
Document
接口说明

本接口可以创建出库单并提交至“确认中”状态。(不支持智能推荐)
"确认中"的出库单无法修改,只可作废。

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://openapi.sandbox.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
商品明细merchandiseLis
--|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"
}
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 出库订单号列表,拆单时返回多个

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

返回示例
{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "orderNo": "WO0000012327",
        "orderNoList": [
            "WO0000012327"
        ],
        "splitType": "NONE"
    }
}