万邑通开发者网站 - 创建出库单1.0

API

创建出库单1.0

更新时间： 0000-00-00 00:00:00 访问次数：767

接口说明

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

接口英文名称

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"
    }
 }

关键词