开发者文档
创建海外仓入库单接口

1.接口说明

使用本接口可以直接下海外仓入库单至“已下单”状态

2.使用场景

创建海外仓入库单,仅支持入库单。

3.请求说明

URL

http://openapi.winit.com.cn/openapi/service

接口测试 

http://openapi.sandbox.winit.com.cn/openapi/service

请求方法

action:winit.wh.inboundOrder.create

验证方式

Token,md5

格式

json

http请求方式

http,post

请求数限制

默认每分钟300,有需要可以申请加大

4.请求入参

名称

类型

必填

说明

示例

orderType

String(20)

Y

入库单类型:

SD-标准海外仓入库

DW-直发海外验入库

DI-直发国内验入库

LI-本地仓入库


winitProductCode

String(50)

Y

Winit产品编码(如:海运散货经济型) 

参照“002查询WINIT产品”

destinationWarehouseCode

String(50)

Y

目的仓编码

参照“004查询目的仓接口”

sellerOrderNo

String(50)

N

客户订单号


inspectionWarehouseCode

String(50)

Y

验货仓编码

参照“003查询验货仓接口”

importerCode

String(50)

Y

进口商编码

参照“007查询进口商接口”

exporterCode

String(50)

Y

出口商编码

参照“008查询出口商接口”

logisticsPlanNo

String(50)

Y

物流计划编码

参照“006查询物流计划接口”

dispatchInfo

以下为dispatchInfo的子节点

Y

提货/验货信息。

入库单类型为SD/DI/LI时必填


-|inspectionType

String(50)

Y

验货方式:

VI-上门验货

WI-验货仓验货


-|pickupType

String(50)

Y

提货方式:

上门提货:P,

自发物流:S


-|reservePickupDateFrom

String(50)

Y

提货开始时间,格式:yyyy-MM-dd   HH:mm:ss,下列情况下必填:

1、  验货方式为上门验货;

2、验货方式为验货仓验货并且提货方式为上门提货

2016-09-09 14:00:00

-|   reservePickupDateTo

String(50)

Y

提货结束时间,格式:yyyy-MM-dd   HH:mm:ss,下列情况下必填:

1、  验货方式为上门验货;

2、验货方式为验货仓验货并且提货方式为上门提货

2016-09-09 16:00:00

-| pickupAddressCode

String(50)

Y

提货/验货地址编码,下列情况下必填:

1、  验货方式为上门验货;

2、验货方式为验货仓验货并且提货方式为上门提货

参照“011查询提货地址接口”

如果没有提货地址,需要先添加验货或者提货地址,地址审核需要1个工作日

 

-|expressVendorCode

String(50)

Y

发货供应商编码,提货方式为自发物流时,发货供应商编码和发货供应商名称其中之一必填

参照“010查询发货供应商接口”

-|expressVendorName

String(50)

Y

发货供应商名称,提货方式为自发物流时,发货供应商编码和发货供应商名称其中之一必填


-|expressNo

String(50)

Y

快递单号,提货方式为自发物流时必填


packageList

以下为packageList的子节点

Y

箱单信息


-|sellerCaseNo

String(50)

Y

卖家箱号


-|sellerWeight

Numberic(10,4)

Y

包裹重量(KG)

卖家提供

-|sellerLength

Numberic(10,2)

Y

包裹长(CM)


-|sellerWidth

Numberic(10,2)

Y

包裹宽(CM)


-|sellerHeight

Numberic(10,2)

Y

包裹高(CM)


-|merchandiseList

以下为merchandiseList的子节点

Y

包裹中的商品信息


--|merchandiseCode

String(255)

Y

商品编码

参照“005查询可选商品接口”

--|specification

String(255)

N

商品规格

注意:若规格存在,则必填;若不存,则可不填


--|quantity

Integer

Y

数量


5、返回出参:

名称

类型

说明

示例

orderNo

String(64)

入库单号


 

6、请求示例


{
"action":   "wh.inboundOrder.create",
    "app_key": "rebecca",
    "data": {
        "sellerOrderNo":   "99999999",
        "inspectionWarehouseCode":   "SZ001",
        "destinationWarehouseCode":   "US001",
        "winitProductCode":   "VT-01",
        "importerCode":   "99999999",
        "exporterCode":   "S0900001",
        "logisticsPlanNo": "10001",
        "orderType":   "SD",
        "dispatchInfo": 
         {
                "inspectionType":   "WI",
                "pickupType":   "S",
                "pickupAddressCode": "100",
                "reservePickupDateFrom": "2016-09-09   14:00:00",
                "reservePickupDateTo": "2016-09-09   16:00:00",
                  "expressVendorCode": "LB",
                  "expressVendorName": "龙邦",
                "expressNo":   "LB0001"
         },
        "packageList": [
            {
                "sellerCaseNo":   "a0001",
                "sellerWeight":   "10.5",
                "sellerLength":   "10.5",
                "sellerWidth":   "15.2",
                "sellerHeight":   "15.5",
                "merchandiseList":   [
                    {
                          "merchandiseCode": "AT-UA",
                          "specification": "01",
                        "quantity":   "100"
                    }
                ]
            }
        ]
    },
    "format": "json",
    "platform": "Yangguang",
    "sign_method": "md5",
    "timestamp": "2015-08-11   10:48:39",
    "version": "1.0",
    "sign":   "00000000000000000000000000000000",
    "language": "zh_CN"
}

返回结果示例

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


 

返回参数说明

正确的返回结果:订单号。

错误的返回结果:错误码,错误信息