API
创建出库单(确认中)
更新时间: 2021-09-28 01:10:14 访问次数:17622

接口说明

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

接口英文名称

createOutboundOrder

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

名称 类型 必填 说明 示例
warehouseID String(10) Y 万邑通海外仓ID
通过接口queryWarehouse查询
1000001
sellerOrderNo String(60) N 卖家订单号
repeatable String(1) Y sellerOrderNo是否允许重复
Y:允许重复
N:不允许重复
推荐填写N
deliveryWayID String(20) Y 最后一公里派送方式ID
物流渠道,可通过接口queryDeliveryWay查询出参中的deliveryID
1010308
insuranceTypeID String() N 最后一公里派送方式所用保险类型ID
默认为1000000,已停用,不用入参
isShareOrder String() N 是否分销订单
已停用,不用入参
fromBpartnerId Integer N 分销人
已停用,不用入参
buyerCompany String(100) N 收件人公司名称
美国DGM渠道收件人公司为必填,要求为英文收件人公司(详细要求见价卡)
recipientName String(255) Y 收件人姓名
来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum String(128) O 收件人电话
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 门牌号
根据物流渠道不同,门牌号需要必填
可通过接口queryDeliveryWay查询
VATNo String(128) O 卖家VAT号,需先注册进口商(万邑联-个人中心-服务设置- 出口商/进口商管理-查看-VAT信息-VAT)
1)英国发欧盟,欧盟发英国的订单,根据渠道要求是否必填
2)渠道未要求必填的订单,如为英国出库订单,可填写
iossNo String(128) N IOSS编码
salesAmount BigDecimal(6,2) N 销售金额
限制0.01-999999.99
currency String(128) N 销售金额币种
receiverVATEORINo String(100) N 收件人VAT/EORI
deliverySide String(2) 0 提货方
PL代表卖家自提
CY代表第三方物流公司自提
使用自提出库的物流产品时必填
注意:本入参的值不能为空,若不入参请去除该字段
thirdPartyLogistics String(100) 0 提货方
第三方物流公司名称
当提货方(deliverySide)为CY时必填
当提货方为(deliverySide)PL时去除该字段
trackingNoBOL String(50) N 第三方物流公司快递单号或BOL
当提货方(deliverySide)为CY时选填
当提货方(deliverySide)为PL时去除该字段
商品列表productList
productCode String(100) Y 商品编码
winit注册的商品编码(SKU)
specification String(255) N 规格
如果商品在winit注册时填写了规格,则为必填项,否则不传。
eBayTransactionID Long N eBay交易ID
详见电商平台订单相关字段说明
eBaySellerID String() N eBay Seller ID
eBayItemID Long N eBay ItemID
eBayBuyerID String() N eBay Buyer ID。
productNum Integer() Y 单品数量,数量必须>0。
增值服务列表VASList
serviceCode Array Y 值服务编码
可查询通过接口queryDeliveryWay查询出参中的serviceCode
增值服务输入详见 增值服务参数赋值说明
增值明细信息VASList.attrList
attrCode String() Y 增值服务属性code
可查询通过接口queryDeliveryWay查询出参中的attrCode
attrValue String(20) Y 增值服务值
请求示例
1.使用DHL Paken Service的标准海外仓出库 
{
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "D98D562FD584C495C783626718A817DB",
    "data": {
        "doorplateNumbers": "0",
        "address1": "123.",
        "address2": "",
        "city": "Herten NRW",
        "deliveryWayID": "1010308",
        "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": "05CA30465CAB1BA2664E3CAAB5A7D7C6",
    "sign_method": "md5",
    "timestamp": "2016-06-16 00:19:26",
    "version": "1.0"
}
        
        2.带有增值服务(追踪守护)的入参示例 
 {
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "46DDE467FC4190D4CE3606297741391C",
    "data": {
        "address1": "Körschstraße 7",
        "address2": "",
        "city": "Kipfenberg",
        "deliveryWayID": "2000003",
        "emailAddress": "abc@winit.com",
        "phoneNum": "15900001111",
        "VATNo": "",
        "iossNo": "",
        "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": "1BBFBF251D88DE97C9C20F87CEBC97A1",
    "sign_method": "md5",
    "timestamp": "2016-06-16 00:19:26",
    "version": "1.0"
}
 3.门牌号填写示例标准海外仓出库单 
 {
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "55CA99DA6D6660F3D0D701C262E73FEB",
    "data": {
        "doorplateNumbers": "560",
        "address1": "817995256 Postfiliale .",
        "address2": "",
        "city": "Herten NRW",
        "deliveryWayID": "1010308",
        "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": "DD8B88792B65B87DB22F75E6DB0357D8",
    "sign_method": "md5",
    "timestamp": "2016-06-16 00:19:26",
    "version": "1.0"
}
 4.自提出库单 
{
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "038A7C3888E75DB2AB93412C2EB4023E",
    "data": {
        "address1": "1 Stafford Crt.",
        "address2": "aaaaaaa",
        "city": "Bayswater North",
        "deliveryWayID": "1010520",
        "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": "2C9DA70C48129D841E691AAB599199AC",
    "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"
 }
6.带有收件人公司的出库单 { "action": "createOutboundOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "70E63CCC5811432939E58D9E9A64BDF7", "data": { "address1": "3647 Old State Route 32.", "address2": "aaaaaaa", "city": "Williamsburg", "deliveryWayID": "1024659", "eBayOrderID": "", "emailAddress": "abc@winit.com", "insuranceTypeID": "1000000", "buyerCompany": "testforCompany", "phoneNum": "15900001111", "deliverySide": "CY", "thirdPartyLogistics": "TEST", "trackingNoBOL": "TEST20190715", "productList": [ { "eBayBuyerID": "98877456rere", "eBayItemID": "", "eBaySellerID": "", "eBayTransactionID": "", "productCode": "auto_sku_001", "productNum": "1", "specification": "" } ], "recipientName": "mingbao", "region": "OH", "repeatable": "Y", "sellerOrderNo": "PowerSellerABC123", "state": "US", "warehouseID": "1008190", "zipCode": "45176-9501", "isShareOrder": "N", "fromBpartnerId": "111" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "7E10C14B8A54CEE240377E7246861937", "sign_method": "md5", "timestamp": "2016-06-16 00:19:26", "version": "1.0" }
7.带有订单包装方式的出库单 { "action": "createOutboundOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "46198177957FC25A18553B19F654CC60", "data": { "deliveryWayID": "20001911", "emailAddress": "abc@winit.com", "phoneNum": "15900001111", "VATNo": "", "iossNo": "", "VASList": [ { "serviceCode": "OSF24WW008", "attrList": [ { "attrCode": "ORDER_PMT", "attrValue": "CARTON_BOX" } ] } ], "productList": [ { "eBayBuyerID": "98877456rere", "eBayItemID": "34342145", "eBaySellerID": "99887rtrtr66123", "eBayTransactionID": "243177766", "productCode": "auto_sku_002", "productNum": "1", "specification": "" } ], "address1": "Körschstraße 7", "address2": "", "city": "Williamsburg", "recipientName": "mingbao", "region": "OH", "repeatable": "Y", "sellerOrderNo": "PowerSellerABC123", "state": "US", "warehouseID": 1008190, "zipCode": "45176-9501", "isShareOrder": "N", "fromBpartnerId": "111" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "9219887EE50609F2DBD329F3FAA23864", "sign_method": "md5", "timestamp": "2016-06-16 00:19:26", "version": "1.0" }
8.带订单销售金额和收件人VAT/EORI { "action": "createOutboundOrder", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "75523196D136C37A4A1AD62402BAA913", "data": { "deliveryWayID": "20001911", "emailAddress": "abc@winit.com", "phoneNum": "15900001111", "VATNo": "", "iossNo": "", "salesAmount": "10000", "currency": "USD", "receiverVATEORINo": "UK1029304", "productList": [ { "eBayBuyerID": "98877456rere", "eBayItemID": "34342145", "eBaySellerID": "99887rtrtr66123", "eBayTransactionID": "243177766", "productCode": "auto_sku_002", "productNum": "1", "specification": "" } ], "address1": "Körschstraße 7", "address2": "", "city": "Williamsburg", "recipientName": "mingbao", "region": "OH", "repeatable": "Y", "sellerOrderNo": "PowerSellerABC123", "state": "US", "warehouseID": 1008190, "zipCode": "45176-9501", "isShareOrder": "N", "fromBpartnerId": "111" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "6CD42C794C278F96421B5F91031221EE", "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"
    }
 }