API
创建入库单-新
更新时间: 2020-06-23 16:04:04 访问次数:13956
接口说明
使用本接口可以直接下海外仓入库单至“已下单”状态。
如何填写入参请详细阅读《海外仓入库时序图和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时必填,以下为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 | 入库单号 |
返回参数说明 正确的返回结果:订单号。 错误的返回结果:错误码,错误信息。
关键词