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 访问次数:995
接口说明
使用本接口可以直接下海外仓入库单至“已下单”状态。
使用场景
创建海外仓入库单,仅支持入库单。
备注
请求说明
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 | 入库单号 |
返回参数说明 正确的返回结果:订单号。 错误的返回结果:错误码,错误信息。