API
- OpenAPI(Winit) 概述
- 海外仓(OSWH) API接口
- ISP全球直发快递API
- 海外仓API(OSWH)
- 海外仓-商品
- 海外仓-入库
- 海外仓-出库
- 海外仓出库API对接时序
- WO01.仓库代码查询
- WO02.海外仓总库存查询
- WO03.派送方式查询
- WO05.预估派送费用查询(新)
- WO05.预估派送费用查询
- WO06.德国地址校验接口
- WO07.创建海外仓出库单(确认中)
- WO08-1.创建海外仓出库单(草稿)
- WO08-2.提交作废海外仓出库单
- WO08.修改海外仓出库单
- WO09.修改出库单商品信息
- WO10.出库单列表查询
- WO11.海外仓出库单查询
- WO12-1.轨迹查询(库内+尾程派送)
- WO12.轨迹查询(库内)
- WO13.海外仓库存DOI查询
- WO13-1.查询DOI库存详情
- WO05-1.预计运费-新
- WO06-1.EGD订单担保校验接口
- 海外仓出库API列表
- 尾程派送方式代码
- 万邑邮选API(ISP)
WI11-1.创建海外仓入库单接口(新)
更新时间: 2017-11-22 16:50:25 访问次数:1300
接口说明
使用本接口可以直接下海外仓入库单至“已下单”状态。
使用场景
创建海外仓入库单,仅支持入库单。
备注
请求说明
| URL | http://api.winit.com.cn/ADInterface/api |
| 接口测试 | http://erp.sandbox.winit.com.cn/ADInterface/api |
| 验证方法 | Token,md5 |
| 格式 | json |
| 字符编码 | UTF-8 |
| http请求方式 | http |
| 请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| orderType | String(50) | Y | 1.SD-标准海外仓入库 2.DW-直发海外验入库 2.1普通直发 2.2 winit头程 3.DI-直发国内验入库 3.1 Winit验货 3.2 自验-卖家直发 3.3自验-winit头程 4.SE-标准存储仓入库 5.SI-直发国内验存储仓入库 5.1 自验-卖家直发 5.2 自验-winit头程 | |
| winitProductCode | String(50) | Y | Winit产品编码(如:OW01010334 海运散货) | 参照“002查询WINIT产品” |
| destinationWarehouseCode | String(50) | Y | 目的仓编码 | 参照“004查询目的仓接口” |
| sellerOrderNo | String(50) | N | 客户订单号 | |
| inspectionWarehouseCode | String(50) | Y | 验货仓编码 | 参照“003查询验货仓接口” |
| importDeclarationRuleCode | String(50) | N | 进口报关规则编码 | |
| importDeclarationType | String(50) | N | 进口报关类型:CI - 客户IOR;TI - 第三方报关 | |
| importerCode | String(50) | N | 进口商编码 | |
| exportDeclarationType | String(50) | N | 出口报关类型:SelfDeclaration - 自报关;CE - 客户EOR;TE - 第三方报关 注意:选择自报关时,不需要传入出口商编码(exporterCode) | |
| exporterCode | String(50) | N | 出口商编码 | |
| logisticsPlanNo | String(50) | Y | 物流计划编码 | 参照“006查询物流计划接口” |
| dispatchInfo | 提货/验货信息。 入库单类型为SD/DI时必填,以下为dispatchInfo的子节点 | |||
| -|inspectionType | String(50) | N | 验货方式: VI-上门验货 WI-验货仓验货 | |
| -|pickupType | String(50) | N | 提货方式: 上门提货:P, 自发物流:S | |
| -|reservePickupDateFrom | String(50) | N | 提货开始时间,格式:yyyy-MM-dd HH:mm:ss,下列情况下必填:1,验货方式为上门提货;2,验货方式为验货仓验货并且提货方式为上门提货 | 2016-09-09 14:00:00 |
| -|reservePickupDateTo | String(50) | N | 提货结束时间,格式:yyyy-MM-dd HH:mm:ss,下列情况下必填:1,验货方式为上门提货;2,验货方式为验货仓验货并且提货方式为上门提货 | 2016-09-09 16:00:00 |
| -|pickupAddressCode | String(50) | Y | 提货/验货地址编码,下列情况下必填:1,验货方式为上门提货;2,验货方式为验货仓验货并且提货方式为上门提货 | |
| -|expressVendorCode | String(50) | Y | 发货供应商编码,提货方式为自发物流时,发货供应商编码和发货供应商名称其中之一必填 | 参照“010查询发货供应商接口” |
| -|expressVendorName | String(50) | Y | 发货供应商名称,提货方式为自发物流时,发货供应商编码和发货供应商名称其中之一必填 | |
| -|expressNo | String(50) | N | 快递单号,提货方式为自发物流时必填 | |
| packageList | 箱单信息,以下为packageList的子节点 | |||
| -|sellerCaseNo | String(50) | Y | 卖家箱号 | |
| -|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 | 商品编码 | 参照“005查询可选商品接口” |
| -|-|specification | String(255) | N | 商品规格 注意:若规格存在,则必填;若不存,则可不填 | |
| -|-|quantity | Integer | Y | 数量 | |
| directForecastInfo | 直发预报信息,以下为子节点 | |||
| -|preparedOffPortDate | String | Y | 预计离港时间,格式yyyy-MM-dd | |
| -|preparedArrivePortDate | String | Y | 预计到港时间,格式yyyy-MM-dd | |
| sendPortInfo | 送港信息,以下为子节点 | |||
| -|sendPortType | String(50) | Y | 送港类型,WINIT - winit送港;SELF - 自送港(自验情况适用) | |
| -|sendPortDate | String | N | 送港时间,(自验情况适用)格式yyyy-MM-dd | |
| -|pickupCartonAddressCode | String(50) | Y | 提柜地址编码(自验情况适用) | |
| -|containerNo | String(50) | Y | 柜号(自验情况适用) | |
| -|sealNo | String(50) | Y | 铅封号(自验情况适用) |
请求示例
6.1标准入库:
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "SD",
"winitProductCode": "OW01010343",
"destinationWarehouseCode": "US0001",
"sellerOrderNo": "test0908",
"inspectionWarehouseCode": "SZ0001",
"importDeclarationRuleCode": "",
"importerCode": "IR0000000368",
"exporterCode": "ER0000000597",
"logisticsPlanNo": "44326",
"dispatchInfo": {
"inspectionType": "WI",
"pickupType": "S",
"reservePickupDateFrom": "2017-09-13 15:00:00",
"reservePickupDateTo": "2017-09-13 17:00:00",
"pickupAddressCode": "zdw001",
"expressVendorCode": "LB",
"expressVendorName": "",
"expressNo": "QQQ"
},
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "LCD-IP5c-02",
"specification": "",
"quantity": 1
}
],
"sellerCaseNo": "0907001",
"sellerLength": 57,
"sellerWidth": 57,
"sellerHeight": 25,
"sellerWeight": 2.4,
}
]
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.2标准存储仓入库
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType":"SE",
"winitProductCode": "SSW111345",
"destinationWarehouseCode": "UKLS",
"sellerOrderNo": "Ajj",
"inspectionWarehouseCode": "SZ0001",
"importDeclarationRuleCode": "",
"exporterCode": "ER002",
"importerCode": "RIR005",
"logisticsPlanNo": "44863",
"dispatchInfo": {
"pickupType": "S",
"inspectionType": "WI",
"pickupAddressCode": "zdw001",
"reservePickupDateFrom": "2017-09-11 16:00:00",
"reservePickupDateTo": "2017-09-11 18:00:00",
"expressVendorCode": "LB",
"expressVendorName": "龙邦",
"expressNo": "564569",
},
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "FGBX001",
"quantity":2,
"specification": ""
}
],
"sellerCaseNo": '2',
"sellerHeight": 44,
"sellerLength": 44,
"sellerWidth": 44,
"sellerWeight": 20,
}
]
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.3直发国内验入库-winit验货
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"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',
"sellerLength": 19,
"sellerWidth": 12,
"sellerHeight": 1,
"sellerWeight": 0.06
}
],
"directForecastInfo": {
"preparedOffPortDate": "2017-09-15",
"preparedArrivePortDate": "2017-09-17"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.4直发国内验入库-自验-卖家直发
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "DI",
"winitProductCode": "OW01021333",
"destinationWarehouseCode": "US0001",
"sellerOrderNo": "567787",
"inspectionWarehouseCode": "SZV001",
"importDeclarationRuleCode": "",
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "LCD-IP5c-02",
"specification": "",
"quantity": 1
}
],
"sellerCaseNo": '1',
"sellerHeight": 2,
"sellerLength": 1.00,
"sellerWeight": 1,
"sellerWidth": 1
}
],
"directForecastInfo": {
"preparedOffPortDate": "2017-09-15",
"preparedArrivePortDate": "2017-09-17"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.5直发国内验入库--自验--winit头程
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "DI",
"winitProductCode": "OW01021405", #OW01021405
"destinationWarehouseCode": "US0001", #US0001
"sellerOrderNo": "autotest001",
"inspectionWarehouseCode": "SZV001",
"importDeclarationRuleCode": "",
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "LCD-IP5c-02",
"specification": "",
"quantity": 1
}
],
"sellerCaseNo": 1,
"sellerHeight": 10,
"sellerLength": 10,
"sellerWeight": 10,
"sellerWidth": 1
}
],
"importerCode": "IR0000000101",
"exportDeclarationType":"",
"exporterCode": "ER0000000597",
"logisticsPlanNo": "44146",
"sendPortInfo": {
"sendPortType": "WINIT",
"pickupCartonAddressCode": "zdw001",
"sendPortDate": "2017-09-10",
"containerNo": "1",
"sealNo": "2"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.6直发海外验入库 --普通直发
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "DW",
"winitProductCode": "OW01030329",
"destinationWarehouseCode": "US0001",
"sellerOrderNo": "autotest001",
"importDeclarationRuleCode": "",
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "4BAR002A",
"quantity": 1,
"specification": ""
}
],
"sellerCaseNo": "11",
"sellerHeight": 1,
"sellerLength": 1,
"sellerWeight":1,
"sellerWidth": 1
}
],
"directForecastInfo": {
"preparedOffPortDate": "2017-09-16",
"preparedArrivePortDate": "2017-09-18"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.7直发海外验入库--winit头程
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "DW",
"winitProductCode": "OW01031342",
"destinationWarehouseCode": "US0001",
"sellerOrderNo": "autotest001",
"inspectionWarehouseCode": "SZV001",
"importDeclarationRuleCode": "",
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "216401",
"quantity": 1,
"specification": ""
}
],
"sellerCaseNo": '1',
"sellerHeight": 1,
"sellerLength": 2.34,
"sellerWeight": 0.08879,
"sellerWidth": 1
}
],
"importerCode": "IR0000000101",
"exportDeclarationType":"",
"exporterCode": "ER0000000597",
"logisticsPlanNo": "44148",
"sendPortInfo": {
"sendPortType": "WINIT",
"pickupCartonAddressCode": "autoTs",
"sendPortDate": "2017-09-15",
"containerNo": "234",
"sealNo": "7686"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.8直发国内验存储仓--自验-直发
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "SI",
"winitProductCode": "SSW121381",
"destinationWarehouseCode": "UKLS",
"sellerOrderNo": "test00",
"inspectionWarehouseCode": "SZV001",
"importDeclarationRuleCode": "",
"packageList": [
{
"merchandiseList": [
{
"merchandiseCode": "FGBX001",
"specification": "",
"quantity": 2
}
],
"sellerCaseNo": 23,
"sellerLength": 1,
"sellerWidth": 1,
"sellerHeight": 1,
"sellerWeight": 0.01
}
],
"directForecastInfo":{
"preparedOffPortDate":"2017-09-15",
"preparedArrivePortDate":"2017-09-22"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
6.9直发国内验存储仓--自验-winit头程
{
"action": "winit.wh.inbound.order.create",
"app_key": "rebecca",
"data": {
"orderType": "SI",
"winitProductCode": "SSW121384",
"destinationWarehouseCode": "UKLS",
"sellerOrderNo": "autotest001",
"inspectionWarehouseCode": "SZV001",
"importDeclarationRuleCode": "",
"importerCode": "IR0000000101",
"exportDeclarationType":"",
"exporterCode": "ER0000000597",
"logisticsPlanNo": "44863",
"packageList": [
{
"sellerCaseNo": '1',
"sellerLength": 1,
"sellerWidth": 1,
"sellerHeight": 1,
"sellerWeight": 1,
"merchandiseList": [
{
"merchandiseCode": "FGBX001",
"specification": "",
"quantity": 2
}
]
}
],
"sendPortInfo": {
"sendPortType": "WINIT",
"pickupCartonAddressCode": "autoTs",
"sendPortDate": "2017-09-11",
"containerNo": "123",
"sealNo": "33"
}
},
"format": "json",
"language": "zh_CN",
"platform": "BJ_YGJT",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2016-09-23 16:26:39",
"version": "1.0"
}
返回出参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| orderNo | String(64) | Y | 入库单号 |
返回参数说明 正确的返回结果:订单号。 错误的返回结果:错误码,错误信息。
