API
创建入库单-新
更新时间: 2019-11-14 17:46:51 访问次数:3668
接口说明

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

接口英文名称

winit.wh.inbound.order.create

使用场景

创建海外仓入库单,仅支持入库单。
如何填写入参请详细阅读《海外仓入库时序图和API列表》

备注

创建入库单旧和新的区别:新的inspectionWarehouseCode和exportDeclarationType是必填的,旧已经停止维护,请用户尽快转换使用新的接口

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试
 http://openapi.sandbox.winit.com.cn/openapi/service 
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
orderType String(50) Y 订单类型编码
SD-标准海外仓入库(Winit国内验货且走Winit头程)
DW-直发海外验入库(Winit海外验货,头程仅限卖家直发)
DI-直发国内验入库(Winit国内验货或者卖家自验,头程仅限卖家直发)
SE-标准存储仓入库(已停用)
SI-直发国内验存储仓入库(已停用)
如何填写入参请详细阅读《海外仓入库时序图和API列表》
SD
winitProductCode String(50) Y Winit产品编码
[查询头程服务]的Winit产品编码
OW01010334
destinationWarehouseCode String(50) Y 目的仓编码
[查询验货/目的仓]仓库编码
US001
sellerOrderNo String(50) N 客户订单号
inspectionWarehouseCode String(50) Y 验货仓编码
[查询验货/目的仓]仓库编码
客户验货仓编码:CSIW01
若使用直发国内验-自验,支持填写客户验货仓编码或者任意验货仓
GZ001
importDeclarationRuleCode String(50) Y 进口报关规则编码
[查询进口报关-IOR规则]的进口报关规则编码的EOR类型编码(CODE)
CIOR
exportDeclarationType
String(50)
Y 出口报关类型编码
[查询出口报关-EOR类型]的EOR类型编码(CODE)
CEOR
importerCode String(50) N 进口商编码
通过查询进/出口商接口查询获得
当importDeclarationRuleCode为:TIOR-第三方进口商的时候,非必填
当importDeclarationRuleCode为:CIOR-自有进口商的时候,必填
exporterCode String(50) N 出口商编码
通过查询进/出口商接口查询获得
当exportDeclarationType为:TEOR-第三方出口商或者FEOR-金融出口商,非必填
当exportDeclarationType为:CEOR-自有出口商,必填
logisticsPlanNo String(50) O 物流计划编码
[查询物流计划]的物流计划编码
头程通过Winit承运的时候必填
头程通过卖家自发的时候不需要填写,删除整个入参
WINIT产品名称中含有“WINIT头程”字
198402
dispatchInfo 提货/验货信息。入库单类型为SD/DI时必填,以下为dispatchInfo的子节点
-|inspectionType String(50) N 验货方式
VI-上门验货(已停用)
WI-验货仓验货
如何填写入参请详细阅读《海外仓入库时序图和API列表》
-|pickupType String(50) N 提货方式
上门提货:P, 自发物流:S
-|reservePickupDateFrom 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 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(50) O 提货/验货地址编码
下列情况下必填:
1,验货方式为上门验货;2,验货方式为验货仓验货并且提货方式为上门提货
-|expressVendorCode String(50) O 发货供应商编码
提货方式(pickupType)为自发物流(S)时,发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人编码
LB
-|expressVendorName String(50) Y 发货供应商名称
提货方式(pickupType)为自发物流(S)时,发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人名称
龙邦
-|expressNo String(50) N 快递单号
提货方式(pickupType)为自发物流(S)时必填
packageList 箱单信息,以下为packageList的子节点
-|sellerCaseNo String(50) Y 卖家箱号
-|thirdPartyCaseNoString()N第三方箱号
注意:全局唯一性要求
-|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 数量
directForecastInfo 直发预报信息,以下为子节点,卖家直发必填否则可以直接不填写
-|preparedOffPortDate String Y 预计离港时间
格式yyyy-MM-dd
2019-07-10
-|preparedArrivePortDate String Y 预计到港时间
格式yyyy-MM-dd
2019-07-12
sendPortInfo O 送港信息,以下为子节点
只有WINIT头程才需要WINIT产品才需要填写
WINIT产品名称中含有“WINIT头程”字
-|sendPortType String(50) Y 送港类型
WINIT - winit送港;
SELF - 自送港
-|sendPortDate String Y 送港时间
格式yyyy-MM-dd
-|pickupCartonAddressCode String(50) Y 提柜地址编码
与提货地址编号相同,通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到;
-|containerNo String(50) N 柜号
-|sealNo String(50) N 铅封号
请求示例
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": "rebecca", "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign":"813946DC11B2B4370BAD1920875054D6", "data": { "orderType": "DI", "winitProductCode": "OW01021333", "destinationWarehouseCode": "US0001", "sellerOrderNo": "567787", "inspectionWarehouseCode": "CSIW01", "importDeclarationRuleCode": "", "packageList": [ { "merchandiseList": [ { "merchandiseCode": "LCD-IP5c-02", "specification": "", "quantity": "1" } ], "sellerCaseNo": "1", "thirdPartyCaseNo": "1234567801", "sellerHeight": "2", "sellerLength": "1.00", "sellerWeight": "1", "sellerWidth": "1" } ], "directForecastInfo": { "preparedOffPortDate": "2019-11-15", "preparedArrivePortDate": "2019-11-17" } }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "B6CCB2C4F052BB4AF725DC4FD2880BA4", "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" } }, "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" } }, "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": "操作成功"
}