接口说明

本接口可以创建出库单并提交至“确认中”状态。

“确认中”的出库单无法修改

使用场景

1、标准出库单/自提出库/销毁，对接此接口

2、3PL三方面单出库，对接此接口下单。为确保订单能够及时出库，请在下单后5分钟内补充推送面单文件，可通过出库上传附件接口推送面单文件

3、若订单需要补充增值文件，对接此接口下单后，需通过出库上传附件接口推送文件

接口名称

createOutboundOrder

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，有需要可申请加大。
接口版本version	2.0 当前版本（修改电商平台入参相关字段） 1.0 预计2023年6月停用，查看历史版本

请求入参

名称	类型	必填	说明	示例
sellerOrderNo	String(60)	N	卖家订单号
commandType	String(128)	N	指令类型： 1、SUBMITTED => 下单直接提交 2、DRAFT => 保存为草稿未传值时默认“下单直接提交”
repeatable	String(1)	Y	sellerOrderNo是否允许重复 Y:允许重复 N:不允许重复推荐填写N
warehouseID	String(10)	Y	万邑通海外仓ID 通过接口queryWarehouse查询	1000001
deliveryWayID	String(20)	Y	Winit产品编码最后一公里派送方式编码是Winit尾程服务的唯一标识符，代表客户选择的物流派送渠道。调用时需传入对应编码，系统将根据编码执行预设的物流策略。可通过接口queryDeliveryWay查询出参中的deliveryID	1010308
state	String(50)	Y	收件人国家名称 1.可填写英文全称 2.可填写ISO国家二字码
city	String(50)	Y	收件人城市
region	String(50)	Y	收件人州名称
zipCode	String(10)	Y	收件人邮政编码详见收件信息-邮编格式说明
address1	String()	Y	收件人街道1 根据物流渠道不同，填写的要求不相同
address2	String(100)	N	收件人街道2 根据物流渠道不同，填写的要求不相同
doorplateNumbers	String(10)	O	门牌号根据物流渠道不同，门牌号需要必填
recipientName	String(255)	Y	收件人姓名来自于由eBay买家提供收货地址。收件人姓名不可为空
phoneNum	String(128)	O	收件人电话
emailAddress	String(50)	N	收件人电子邮箱
buyerCompany	String(100)	N	收件人公司名称美国DGM渠道收件人公司为必填，要求为英文收件人公司（详细要求见价卡）
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	销售金额币种
receiverVATNo	String(100)	N	收件人VAT
receiverVATEORINo	String(100)	N	收件人VAT/EORI，已弃用
deliverySide	String(2)	O	提货方 PL代表卖家自提 CY代表第三方物流公司自提使用自提出库的物流产品时必填注意：本入参的值不能为空，若不入参请去除该字段
thirdPartyLogistics	String(100)	O	提货方第三方物流公司名称当提货方（deliverySide）为CY时必填当提货方为（deliverySide）PL时去除该字段
trackingNoBOL	String(50)	N	第三方物流公司快递单号或BOL 当提货方（deliverySide）为CY时选填当提货方（deliverySide）为PL时去除该字段
storeType	String(100)	N	电商平台类型仅限字母数字和空格枚举值：详见电商平台列表
platformAccount	String(128)	N	电商平台账号ID 详见电商平台字段说明	US-A16Q3SBG9UE1XO
platformOrderId	String(128)	N	电商平台订单ID 详见电商平台字段说明	112-345-1432
productList	Array	Y	商品列表
– productCode	String(100)	Y	商品编码 winit注册的商品编码(SKU)
– specification	String(255)	N	规格如果商品在winit注册时填写了规格，则为必填项，否则不传。
– productNum	Integer()	N	单品数量，数量必须>0。注意：若不入参SKU类型及库存单元标准件数，则该字段必填若入参了outboundQuantity出库箱数，则该字段不可填
– skuType	String(32)	N	SKU类型 SINGLE：单一产品 SUITE：套装产品 BOX：箱产品
– skuStandardQuantity	Integer(10)	N	库存单元标准件数
– thirdPartyBarcode	String(128)	N	第三方条码
– outboundQuantity	Integer(10)	N	出库箱数如果入参了SKU类型，出库箱数为必传值
– inventoryAttribute	Array	N	库存属性list
– – tagName	String()	O	库存属性CODE值如下: stockGrade 商品等级 stockOrg（当卖家开通库存组织管理必填，未开通权限之前入参无效） stockOwner 货主编码
– – tagValue	String()	O	当tagName为stockGrade时，入参商品等级 GOOD：良品（必须大写） DEFECTIVE：不良品（必须大写）当tagName为stockOrg时，入参库存组织编码当tagName为stockOwner时，入参货主编码
– platformTransactionId	String	N	若若电商平台类型选择为eBay，请填写订单在平台的transation ID；若电商平台类型选择为TikTok，请填写订单在平台的Package ID。详见电商平台字段说明
– platformItemId	String	N	若电商平台类型选择为eBay，请填写商品在平台的Item ID；若电商平台类型选择为TikTok，请填写商品在平台的Product ID。详见电商平台字段说明
– platformSellerId	String()	N	若电商平台类型选择为eBay，请填写eBay Seller ID
– platformBuyerId	String()	N	若电商平台类型选择为eBay，请填写eBay Buyer ID。
packageMode	String()	N	出库加包装已弃用，请参考增值服务VASList PACKAGING_WINIT：WINIT标准包装 PACKAGING_CUSTOMER：客制包装 CUSTOM_LOGISTICS：WINIT标准&客制包装 NO：无包装
packageMerchandiseCode	String()	N	指定包材出库商品编码已弃用，请参考增值服务VASList
packageType	String()	N	包材类型已弃用，请参考增值服务VASList COURIER_SATCHEL：快递袋 PADDED_ENVELOPE：气泡袋 CARTON_BOX：纸箱 NO：无包装
VASList	Array	N	增值服务列表
– serviceCode	String()	N	值服务编码可查询通过接口queryDeliveryWay查询出参中的serviceCode 增值服务输入详见增值服务参数赋值说明
– VASList.attrList	Array	N	增值明细信息
– – attrCode	String()	N	增值服务属性code 可查询通过接口queryDeliveryWay查询出参中的attrCode ISA：投保金额 PACKAGE_MODE：出库加包装 PACKAGE_MERCHANDISE_CODE：指定包材出库商品编码 PACKAGE_TYPE_MATERIAL：包材类型
– – attrValue	String(20)	N	增值服务值

已停用字段：

insuranceTypeID最后一公里派送方式所用保险类型ID ，默认为1000000；isShareOrder是否分销订单；fromBpartnerId分销人

请求示例

{
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "D98D562FD584C495C783626718A817DB",
    "data": {
        "storeType": "tiktok",
        "platformOrderId": "order1",
        "platformAccount": ""account1",
        "doorplateNumbers": "0",
        "address1": "123.",
        "address2": "",
        "city": "Herten NRW",
        "deliveryWayID": "1010308",
        "emailAddress": "abc@winit.com",
        "phoneNum": "15900001111",
        "productList": [
            {
                "productCode": "auto_picking_001",
                "productNum": "1",
                "specification": "",
                "platformTransactionId": "t1",
                "platformItemId": "i1",
                "platformSellerId": "s1",
                "platformBuyerId": "b1"
            }
        ],
        "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": "2.0"
}

不良品出库

{
    "action": "createOutboundOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "D98D562FD584C495C783626718A817DB",
    "data": {
        "warehouseCode": "US0001",
        "shipperOrderNo": "不良品下单",
        "isRepeat": "Y",
        "storeType": "ebay",
        "VATNo": "",
        "iossNo": "",
        "buyerCompany": "万邑通 ",
        "receiverCountry": "US",
        "receiverCity": "mayo",
        "receiverState": "FL",
        "receiverName": "apitestlong001",
        "receiverPostcode": "32066",
        "receiverHouseNo": "No.320",
        "receiverAddressLine1": "address1 Postfiliale 560",
        "receiverAddressLine2": "",
        "receiverPhone": "1234567890",
        "receiverEmail": "1receivertest@winit.com.cn",
        "productList": [
             {
                "productCode": "buliang002",
                "inventoryAttribute":[
                {
                    "tagName":"stockGrade",
                    "tagValue":"DEFECTIVE"
                }
            ],
                "specification": "",
                "productNum": "1",
                "platformTransactionId": "",
                "platformItemId": "",
                "platformSellerId": "",
                "platformBuyerId": "",
                "skuType": "",
                "skuStandardQuantity": "",
                "thirdPartyBarcode": "",
                "outboundQuantity": "",
                "packingBatchNo": "",
                "batchDate": ""
            }
        ],
        "deliveryWayID":"2303043",
        "warehouseID":"1000008",
        "repeatable": "Y",
        "recipientName": "test",
        "zipCode":"32066",
        "state":"US",
         "region":"FL",
        "city":"Mayo",
        "address1":"testaddress001",
        "emailAddress": "abc@winit.com",
        "phoneNum": "15900001111",
        "pickUpSupplier": "",
        "logisticsSupplierName": "",
        "selfPickTrackingOrBOLNo": ""
    }
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "05CA30465CAB1BA2664E3CAAB5A7D7C6",
    "sign_method": "md5",
    "timestamp": "2016-06-16 00:19:26",
    "version": "2.0"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必填	说明
orderNo	String(80)	Y	出库订单号
splitType	String()	Y	BW：仓群间拆单 WW：仓群内拆单 NONE：不拆单
orderNoList	Array	Y	出库订单号列表，拆单时返回多个

返回示例

{
    "code": 0,
    "msg": "操作成功",
    "data":    {
       "splitType": "NONE",
       "outboundOrderNums": ["WO1041628364"],
       "outboundOrderNum": "WO1041628364"
    }
 }

关键词

WO07.创建海外仓出库单（确认中）——停止维护