API
创建入库单-新
更新时间： 2020-06-23 16:04:04 访问次数：12737
无标题文档
接口说明

使用本接口可以直接下海外仓入库单至“已下单”状态。
如何填写入参请详细阅读《海外仓入库时序图和API列表》
创建入库单旧和新的区别：新的inspectionWarehouseCode和exportDeclarationType是必填的，
旧已经停止维护，请用户尽快转换使用新的接口

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试
 https://sandboxopenapi.winit.com.cn/openapi/service 
接口名winit.wh.inbound.order.create
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000，有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
orderType String(30) Y 订单类型编码
SD-标准海外仓入库
DW-直发海外验入库
DI-直发国内验入库
 SD
winitProductCode String(32) Y Winit产品编码
取[查询头程服务]的Winit产品编码		 OW01010334
destinationWarehouseCode String(40) Y 目的仓编码
取[查询验货/目的仓]仓库编码		 US0001
sellerOrderNo String(50) N 客户订单号
inspectionWarehouseCode String(50) Y 验货仓编码
取[查询验货/目的仓]仓库编码
直发自验入库-非Winit承运：CSIW01(客户自验仓) 		GZ0001
importDeclarationRuleCode String(50) O 进口报关规则编码
取[查询进口报关-IOR规则]的进口报关规则编码的EOR类型编码(CODE)
Winit承运时：必填
卖家直发时：无需填，整个字段无需传入 		CIOR
exportDeclarationType
 String(50)
 O 出口报关类型编码
取[查询出口报关-EOR类型]的EOR类型编码(CODE)
Winit承运时：必填
卖家直发时：无需填，整个字段无需传入 		CEOR
importerCode String(40) N 进口商编码
通过查询进/出口商接口查询获得
当importDeclarationRuleCode为：TIOR-第三方进口商的时候，无需填(整个字段无需传入)
当importDeclarationRuleCode为：CIOR-自有进口商的时候，必填且只能填写非Winit的进口商

注意：当目的国是英国时，无论卖家直发还是WINIT承运，都必填
exporterCode String（40) N 出口商编码
通过查询进/出口商接口查询获得
当exportDeclarationType为：TEOR-第三方出口商或者FEOR-金融出口商，无需填(整个字段无需传入)
当exportDeclarationType为：CEOR-自有出口商,必填且只能填写非Winit的出口商
logisticsPlanNo String(40) O 物流计划编码
取[查询物流计划]的物流计划编码
头程通过Winit承运的时候必填
头程通过卖家自发的时候不需要填写，删除整个入参
WINIT产品名称中含有“WINIT头程”字		 198402
stockType String(30) N 库存类型，
2C:toC入库
2B:ToB入库 非必填，卖家需要开启2B，2C库存管理才能使用，一般不入参
测试sandbox环境默认入参2C		 2C
dispatchInfo 提货/验货信息。入库单类型为SD/DI时必填,以下为dispatchInfo的子节点
-|inspectionType String(32) N 验货方式
VI-上门验货（已停用）
WI-验货仓验货
如何填写入参请详细阅读《海外仓入库时序图和API列表》
-|pickupType String(32) N 提货方式
上门提货：P， 自发物流：S
-|reservePickupDateFrom String(30) N 提货开始时间
格式：yyyy-MM-dd HH:mm:ss，下列情况下必填：
1，验货方式为上门验货；2，验货方式为验货仓验货并且提货方式为上门提货
提货时间段，一般为："09:00:00-12:00:00", "14:00:00-16:00:00", "15:00:00-17:00:00","16:00:00-18:00:00"		 2019-06-25 09:00:00
-|reservePickupDateTo String(50) N 提货结束时间
格式：yyyy-MM-dd HH:mm:ss，下列情况下必填：
1，验货方式为上门验货；2，验货方式为验货仓验货并且提货方式为上门提货

提货时间段，一般为："09:00:00-12:00:00", "14:00:00-16:00:00", "15:00:00-17:00:00","16:00:00-18:00:00"		 2019-06-25 12:00:00
-|pickupAddressCode String(30) O 提货/验货地址编码
下列情况下必填：
1，验货方式为上门验货；2，验货方式为验货仓验货并且提货方式为上门提货
-|expressVendorCode String(30) O 发货供应商编码
提货方式(pickupType)为自发物流(S)时，发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人编码		 LB
-|expressVendorName String(50) Y 发货供应商名称
提货方式(pickupType)为自发物流(S)时，发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人名称		 龙邦
-|expressNo String(30) N 快递单号
提货方式(pickupType)为自发物流(S)时必填
packageList 箱单信息,以下为packageList的子节点
-|sellerCaseNo String(20) Y 卖家箱号
-|thirdPartyCaseNo String(50) N 自定义包裹编号（第三方箱号）
注意：贴在实物包裹上的非Winit箱号，需全局唯一性，保证海外仓可扫描识别。
-|sellerWeight Numberic(10,4) Y 包裹重量(KG)
卖家下单数据
-|sellerLength Numeric(10,2) Y 包裹长(CM)
卖家下单数据
-|sellerWidth Numeric(10,2) Y 包裹宽(CM)
卖家下单数据
-|sellerHeight Numberic(10,2) Y 包裹高(CM)
卖家下单数据
-|merchandiseList 包裹中的商品信息,以下为merchandiseList的子节点
-|-|merchandiseCode String(255) Y 商品编码
取 [查询入库可选商品]的商品编码		 3010011818-20
-|-|specification String(255) N 商品规格
注意：若规格存在，则必填；若不存，则可不填
-|-|quantity Integer Y 数量
-|-|validDate String N 商品有效期
本批入库商品的商品有效时间
格式：YYYY-MM-DD
填写后需要开发商品有效期管理的卖家才能使用，一般不入参		 2020-01-01
directForecastInfo 直发预报信息,以下为子节点,卖家直发必填否则可以直接不填写
-|preparedOffPortDate String（30） Y 预计离港时间(即预计起航时间)
格式yyyy-MM-dd		 2019-07-10
-|preparedArrivePortDate String（60） Y 预计到港时间
格式yyyy-MM-dd 		2019-07-12
-|expectedSendWarehouseWay String（60） Y 预计送仓方式：
整柜 - FCL
散货 - LCL
快递 - Express 		FCL
-|expectedSendWarehouseTime String（60） Y 预计送仓时间
格式yyyy-MM-dd 		2019-08-12
-|transportAgent String（60） N 快递公司(当预计送仓方式为[快递]时，填写,非必填)
UPS取值编码：UPS
DHL取值编码：LG_DHL
TNT取值编码：LG_TNT
FEDEX取值编码：DIRECT007 		LG_DHL
sendPortInfo String（30） O 送港信息,以下为子节点
只有WINIT头程才需要WINIT产品才需要填写
WINIT产品名称中含有“WINIT头程”字
-|sendPortType String(50) Y 送港类型
WINIT - winit送港；
SELF - 自送港
-|sendPortDate String Y 送港时间
格式yyyy-MM-dd
当送港类型是WINIT送港时，非必填；
当送港类型是自送港时，必填；
-|pickupCartonAddressCode String(50) O 提柜地址编码
与提货地址编号相同，通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到；
当送港类型是WINIT送港时，必填；
当送港类型是自送港时，无需填，整个字段无需传入；
-|containerNo String(50) N 柜号
当送港类型是WINIT送港时，无需填，整个字段无需传入；
当送港类型是自送港时，可填；
-|sealNo String(50) N 铅封号
当送港类型是WINIT送港时，无需填，整个字段无需传入；
当送港类型是自送港时，可填；
请求示例
1.标准海外仓入库：

 {
    "action":"winit.wh.inbound.order.create",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"526482E2C51794D8BAB64F106AE94F63",
    "data":{
        "sellerOrderNo":"99999999",
        "inspectionWarehouseCode":"SZ0001",
        "destinationWarehouseCode":"US0001",
        "winitProductCode":"OW01010343",
        "importerCode":"IR0000000586",
        "exporterCode":"ER0000001405",
        "importDeclarationRuleCode":"CIOR",
        "exportDeclarationType":"CEOR",
        "logisticsPlanNo":"198402",
        "orderType":"SD",
        "dispatchInfo":{
            "inspectionType":"WI",
            "pickupType":"P",
            "pickupAddressCode":"12",
            "reservePickupDateFrom":"2019-06-25 09:00:00",
            "reservePickupDateTo":"2019-06-25 12:00:00",
            "expressVendorCode":"12",
            "expressVendorName":"龙邦",
            "expressNo":"LB0001"
        },
        "packageList":[
            {
                "sellerCaseNo":"qyk001",
                "thirdPartyCaseNo": "third2019062101",
                "sellerWeight":"0.01",
                "sellerLength":"18.00",
                "sellerWidth":"15.00",
                "sellerHeight":"2.00",
                "merchandiseList":[
                    {
                        "merchandiseCode":"iphoned6",
                        "specification":"",
                        "quantity":"1"
                    }
                ]
            }
        ]
    },
    "format":"json",
    "platform":"OWNERERP",
    "sign_method":"md5",
    "timestamp":"2015-08-11 10:48:39",
    "version":"1.0",
    "sign":"8E8293A48AFFFB4467DB27D15CC91598",
    "language":"zh_CN"
}

 
2.标准存储仓入库

 
{
	"action": "winit.wh.inbound.order.create",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "8D360CE2D2DD4B133357F2EFD4CD6B32",
	"data": {
		"orderType": "SE",
		"winitProductCode": "SSW111345",
		"destinationWarehouseCode": "US0001",
		"sellerOrderNo": "Ajj",
		"inspectionWarehouseCode": "SZ0001",
		"importDeclarationRuleCode": "",
		"importerCode": "IR0000000586",
		"exporterCode": "ER0000001405",
		"logisticsPlanNo": "198402",
		"dispatchInfo": {
			"pickupType": "S",
			"inspectionType": "WI",
			"pickupAddressCode": "zdw001",
			"reservePickupDateFrom": "2019-06-27 16:00:00",
			"reservePickupDateTo": "2019-06-27 18:00:00",
			"expressVendorCode": "LB",
			"expressVendorName": "龙邦",
			"expressNo": "564569"
		},
		"packageList": [{
				"merchandiseList": [{
					"merchandiseCode": "FGBX001",
					"quantity": "2",
					"specification": ""
				}],
				"sellerCaseNo": "2",
				"thirdPartyCaseNo": "20190621001",
				"sellerHeight": "44",
				"sellerLength": "44",
				"sellerWidth": "44",
				"sellerWeight": "20"
			}

		]
	},
	"format": "json",
	"language": "zh_CN",
	"platform": "OWNERERP",

	"sign": "F41B16D61D5485302B07ABB79CB7B5D9",
	"sign_method": "md5",
	"timestamp": "2016-09-23 16:26:39",
	"version": "1.0"
}

3.直发国内验入库-winit验货
 
{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"94E8EAD202D07EC9A427A1A4255EBFE7",
    "data": {
        "orderType": "DI",
        "winitProductCode": "OW01020387",
        "destinationWarehouseCode": "US0001 ",
        "sellerOrderNo": "tet09068",
        "inspectionWarehouseCode": "SZ0001",
        "importDeclarationRuleCode": "",
        "dispatchInfo": {
            "inspectionType": "WI",
            "pickupType": "S",
            "reservePickupDateFrom": "",
            "reservePickupDateTo": "",
            "pickupAddressCode": "",
            "expressVendorCode": "LB",
            "expressVendorName": "龙邦",
            "expressNo": "5756"
        },
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "LCD-IP5c-02",
                        "specification": "",
                        "quantity": "1"
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par20190321",
                "sellerLength": "19",
                "sellerWidth": "12",
                "sellerHeight":"1",
                "sellerWeight": "0.06"
 
            }
        ],
        "directForecastInfo": {
             "preparedOffPortDate": "2019-07-10",
             "preparedArrivePortDate": "2019-07-12"
        }
    },
 
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "BA730F7F5217E32123FA9176125144BB",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}
 
4.直发国内验入库-自验-卖家直发 

 
  {
    "action": "winit.wh.inbound.order.create",
    "app_key": "245002566@qq.com",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "8A4887740E73FA577C37314668A4C42B",
    "data": {
        "orderType": "DI",
        "winitProductCode": "OW01021351",
        "destinationWarehouseCode": "US0001",
        "inspectionWarehouseCode": "CSIW01",
        "sellerOrderNo": "567787",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "AA30108WM",
                        "specification": "",
                        "quantity": "1"
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "1234567801111",
                "sellerHeight": "2",
                "sellerLength": "1.00",
                "sellerWeight": "1",
                "sellerWidth": "1"
            }
        ],
        "directForecastInfo": {
            "preparedOffPortDate": "2020-02-20",
            "preparedArrivePortDate": "2020-02-27",
            "expectedSendWarehouseTime": "2020-04-30",
            "expectedSendWarehouseWay": "Express",
            "transportAgent": "UPS",
            " inventoryAttribute": [
                {
                    "tagName ": "stockOrg",
                    "tagValue": "AAA"
                },
                {
                    "tagName ": "stockOwner",
                    "tagValue": "XXX"
                }
            ]
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "3D434C2110F06BDBA022E1F3D6074C6E",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

5.直发国内验入库--自验--winit头程 

 
{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"65624DB16E3DFA9B372F9F6F82EE627E",
    "data": {
        "orderType": "DI",
        "winitProductCode": "OW01021405",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "LCD-IP5c-02",
                        "specification": "",
                        "quantity": "1"
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par2019062102",
                "sellerHeight": "10",
                "sellerLength": "10",
                "sellerWeight": "10",
                "sellerWidth": "1"
            }
        ],
        "importerCode": "IR0000000586",
        "exportDeclarationType":"",
        "exporterCode": "ER0000001405",
        "logisticsPlanNo": "198402",
        "sendPortInfo": {
            "sendPortType": "WINIT",
            "pickupCartonAddressCode": "zdw001",
            "sendPortDate": "2019-06-24",
            "containerNo": "1",
            "sealNo": "2"
        }
    },
 
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "8B06C217C151D24A7AC60F556A711741",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}
 
 
 6.直发海外验入库 --卖家直发 

 
 {
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"DB49AF3868EF493199827F0BA141582C",
    "data": {
        "orderType": "DW",
        "winitProductCode": "OW01030329",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "4BAR002A",
                        "quantity": "1",
                        "specification": ""
                    }
                ],
                "sellerCaseNo": "11",
                "thirdPartyCaseNo": "third_caseNo1_par20190701",
                "sellerHeight": "1",
                "sellerLength": "1",
                "sellerWeight":"1",
                "sellerWidth": "1"
            }
        ],
        "directForecastInfo": {
            "preparedOffPortDate": "2019-07-10",
            "preparedArrivePortDate": "2019-07-11",
			"expectedSendWarehouseTime": "2020-04-30",
			"expectedSendWarehouseWay": "Express",
			"transportAgent":"UPS"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "7A3CD72759832E3E82B33A6549D2DE3E",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}
 
  7.直发海外验入库--winit头程 

 
{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"2BAEE864F4B042926DD409BBA61C340C",
    "data": {
        "orderType": "DW",
        "winitProductCode": "OW01031342",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "216401",
                        "quantity": "1",
                        "specification": ""
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par2019062103",
                "sellerHeight": "1",
                "sellerLength": "2.34",
                "sellerWeight": "0.08879",
                "sellerWidth": "1"
            }
        ],
        "importerCode": "IR0000000586",
        "exportDeclarationType":"",
        "exporterCode": "ER0000001405",
        "logisticsPlanNo": "198402",
        "sendPortInfo": {
            "sendPortType": "WINIT",
            "pickupCartonAddressCode": "12",
            "sendPortDate": "2017-09-15",
            "containerNo": "234",
            "sealNo": "7686"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "9486E1F6891234B179DE903CD7D598D1",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}


 8.直发国内验存储仓--自验-卖家直发 

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"27DF456E70A9BFF9236E72F62925F757",
    "data": {
        "orderType": "SI",
        "winitProductCode": "SSW121381",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "test00",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "FGBX001",
                        "specification": "",
                        "quantity": "2"
                    }
                ],
                "sellerCaseNo": "23",
                "thirdPartyCaseNo": "third_caseNo1_par201906204",
                "sellerLength": "1",
                "sellerWidth": "1",
                "sellerHeight": "1",
                "sellerWeight": "0.01"
            }
        ],
        "directForecastInfo":{
             "preparedOffPortDate":"2019-06-25",
             "preparedArrivePortDate":"2019-06-26",
			 "expectedSendWarehouseTime": "2020-04-30",
			 "expectedSendWarehouseWay": "Express",
			 "transportAgent":"UPS"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "ECEB62EF88E325D0CB09750D7EF8FBD9",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

9.直发国内验存储仓--自验-winit头程  
 
{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"74563C07118C6E869BD72EA58AE02840",
    "data": {
        "orderType": "SI",
        "winitProductCode": "SSW121384",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "importerCode": "IR0000000586",
        "exportDeclarationType":"",
        "exporterCode": "ER0000001405",
        "logisticsPlanNo": "198402",
        "packageList": [
            {
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par20190624",
                "sellerLength": "1",
                "sellerWidth": "1",
                "sellerHeight": "1",
                "sellerWeight": "1",
                "merchandiseList": [
                    {
                        "merchandiseCode": "FGBX001",
                        "specification": "",
                        "quantity": "2"
                    }
                ]
            }
        ],
        "sendPortInfo": {
            "sendPortType": "WINIT",
            "pickupCartonAddressCode": "12",
            "sendPortDate": "2019-06-25",
            "containerNo": "123",
            "sealNo": "33"
        }

    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "9E9090663F9BE90A45ADDFA0FD5DF93B",
    "sign_method": "md5",
    "timestamp": "2019-09-23 16:26:39",
    "version": "1.0"
}

                            

                        

                    

                



                

                    
返回出参

                    

                        
                            

                                名称
                                类型
                                必填
                                说明
                                示例
                            

                        
                        
                            

                                orderNo
                                String(64)
                                Y
                                入库单号
                                
                            


                        
                    

                    

                        返回参数说明
正确的返回结果：订单号。
错误的返回结果：错误码，错误信息。
                    

                


                

                    
返回示例

                    

                        
                        

                            

                                

                                    
{
      "code": "0",
      "data": {
          "orderNo": "W0100000000002324"
      },
      "msg": "操作成功"
}