API
创建入库单-新
更新时间: 2024-05-16 18:54:08 访问次数:20778

接口说明

使用本接口可以直接下海外仓入库单至“已下单”状态。
根据入库单类型不同,入参存在差异。填写入参请详细阅读《海外仓入库时序图和API列表》
创建入库单旧和新的区别:新的inspectionWarehouseCode和exportDeclarationType是必填的,
旧已经停止维护,请用户尽快转换使用新的接口

接口名称

winit.wh.inbound.order.create

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
sellerOrderNo String(50) N 客户订单号
orderType String(30) Y 订单类型编码
SD:标准海外仓入库
DW:直发海外验入库
DI:直发国内验入库
SD
winitProductCode String(32) Y Winit产品编码
[查询头程服务]的Winit产品编码
OW01010334
inspectionWarehouseCode String(50) Y 验货仓编码
[查询验货/目的仓]仓库编码
直发自验入库-非Winit承运:CSIW01(客户自验仓)
GZ0001
destinationWarehouseCode String(40) Y 目的仓编码
[查询验货/目的仓]仓库编码
US0001
logisticsPlanNo String(40) O 物流计划编码
[查询物流计划]的物流计划编码
头程通过Winit承运的时(WINIT产品名称中含有“WINIT头程”字样),必填
头程通过卖家自发的时,不需要填写,删除整个入参
198402
exportDeclarationType String(50) O 出口报关类型编码
[查询出口报关-EOR类型]的EOR类型编码(CODE)
Winit承运时:必填
卖家直发时:无需填,整个字段无需传入
CEOR
exporterCode String(40) O 出口商编码
通过查询进/出口商接口查询获得
当exportDeclarationType为:TEOR-第三方出口商或者FEOR-金融出口商,无需填(整个字段无需传入)
当exportDeclarationType为:CEOR-自有出口商,必填且只能填写非Winit的出口商
importDeclarationRuleCode String(50) O 进口报关规则编码
[查询进口报关-IOR规则]的进口报关规则编码的EOR类型编码(CODE)
Winit承运时:必填
卖家直发时:无需填,整个字段无需传入
CIOR
importerCode String(40) O 进口商编码
通过查询进/出口商接口查询获得
当importDeclarationRuleCode为:TIOR-第三方进口商的时候,无需填(整个字段无需传入)
当importDeclarationRuleCode为:CIOR-自有进口商的时候,必填且只能填写非Winit的进口商
注意:当目的国是英国或德国时,无论卖家直发还是WINIT承运,都必填
stockType String(30) N 库存类型,
2C:toC入库
2B:toB入库 非必填,卖家需要开启2B,2C库存管理才能使用,一般不入参
测试sandbox环境默认入参2C
2C
isForecastOrder String(1) N 是否无箱单明细的预报订单,Y/N
不传入时默认为否
若传Y,则需要填写planMerchandiseList(必填)orderIdentificationCodeList(必填)valueAddedService(选填)
若传N或不传,则需要填写packageList(必填)
packageList Array Y 有箱单,商品信息list
-|sellerCaseNo String(20) Y 卖家箱号
-|thirdPartyCaseNo String(50) N 自定义包裹条码(第三方箱号barcode)
注意:贴在实物包裹上的非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)
卖家下单数据
-|isAutoBoxStorage String(30) N 已弃用
是否使用自动组箱存储增值服务,Y/N。默认不使用
入参Y后,仅满足下述条件时,才会自动按箱产品存储:
1、包裹内为单一产品
2、包裹等级为A或A+包裹
3、使用海外验入库
4、万邑通仓库确认包裹满足SKU包裹级库存标准
-|merchandiseList Array Y 包裹中的商品信息
-|-|merchandiseCode String(255) Y 商品编码
[查询入库可选商品]的商品编码
3010011818-20
-|-|specification String(255) N 商品规格
注意:若规格存在,则必填;若不存,则可不填
-|-|skuType String(30) N SKU类型
SINGLE:单一商品
SUITE:套装商品
BOX:箱商品
BOX
-|-|standardPartsQty Integer O 标准件数
当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时,必填
当SKU类型(skuType)为单一商品(SINGLE)时,可不填,不填则默认为1
10
-|-|quantity Integer Y 数量
当SKU类型(skuType)为单一商品(SINGLE)时,单品件数
当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时,套数或箱数
-|-|productionBatch String(255) O 产品批次号
仅开通了保质期管理或生产批次管理的SKU可填
-|-|productionDate String(30) O 生产日期,YYYY-MM-DD
仅开通了保质期管理或生产批次管理的SKU可填
-|-|expirationDate String(30) O 失效日期,YYYY-MM-DD
仅开通了保质期管理或生产批次管理的SKU可填
-|-|barcodeValue String(30) O 条码值
开通条码值白名单权限,且商品为条码值管理时,必填
-|-|itemList Array O 包裹中商品的实物单品条码信息。以下为itemList的子节点
-|-|-|itemSerno String(128) O 单品条码
即下单商品(套装)对应的实物条码。
注意:
1、当下单商品的SKU类型(skuType)为套装商品(SUITE),且其管理方式为单品化管理(SI)时,必填;其他情形,不填。
2、支持2种格式条码:Winit单品条码(S码)、第三方单品条码(非Winit)。
3、第三方(非Winit)单品条码,需全局唯一性,保证海外仓可扫描识别。
-|-|-|originItemSerno String(128) O 源单一商品的单品条码
即指下单商品的源单一商品的实物条码。
注意:
1、当下单商品SKU类型(skuType)为箱商品(BOX)\套装商品(SUITE),且箱/套内的源单一商品(SINGLE)的管理方式为单品化管理(SI)时,必填;
2、支持2种格式条码:Winit单品条码(S码)、第三方单品条码(非Winit)。
3、第三方(非Winit)单品条码,需全局唯一性,保证海外仓可扫描识别。
-|-|inventoryAttribute Array O 库存属性集合list
-|-|-|tagName String(50) Y 库存属性编码。
stockOrg-库存组织
stockOwner-货主
-|-|-|tagValue String(50) Y 库存属性值。
planMerchandiseList Array O 无箱单,必填商品信息list
-|merchandiseCode String(255) Y 商品编码
[查询入库可选商品]的商品编码
3010011818-20
-|specification String(255) N 商品规格
注意:若规格存在,则必填;若不存,则可不填
-|skuType String(30) Y SKU类型
SINGLE:单一商品
SUITE:套装商品
BOX:箱商品
SINGLE
-|standardPartsQty Integer O 标准件数
注意:
当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时,必填。
当SKU类型(skuType)为单一商品(SINGLE)时,可不填,不填则默认为1
1
-|quantity Integer Y 数量
orderIdentificationCodeList Array O 无箱单,必填订单识别码清单信息
-|type String(30) Y 识别码类型
TRACKING_NO 快递单号
ORDER 入库单号
OTHER 其他
-|code String(128) N 识别码,当识别码为快递单号或其他时必填
-|expressCompany String(128) N 物流公司
注意:当识别码类型为快递(TRACKING_NO)时需填写。
取值如下:
UPS
DHL
TNT
FEDEX
Others - 其他
valueAddedService object O 无箱单,选填入库增值服务
-|shelveAsDefectiveProducts String(1) N 直接上架到不良品区服务
Y:启用服务
N:不启用
不传入则默认不启用
-|singleToBoxService String(1) N 单一转箱产品存储服务
Y:启用服务
N:不启用
不传入则默认不启用
dispatchInfo Object O 提货/验货信息list
入库单类型为SD-标准海外仓入库时必填
-|inspectionType String(32) N 验货方式
VI:上门验货(已停用)
WI:验货仓验货
-|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”
“09:00:00-12:00:00”段:需要提前15个小时预约
“14:00:00-16:00:00”段:需要提前2个小时预约
“15:00:00-17:00:00”段:需要提前3个小时预约
“16:00:00-18:00:00”段:需要提前4个小时预约
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”
“09:00:00-12:00:00”段:需要提前15个小时预约
“14:00:00-16:00:00”段:需要提前2个小时预约
“15:00:00-17:00:00”段:需要提前3个小时预约
“16:00:00-18:00:00”段:需要提前4个小时预约
2019-06-25 12:00:00
-|pickupAddressCode String(30) O 提货/验货地址编码
通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到;
下列情况下必填:
1,验货方式为上门验货;
2,验货方式为验货仓验货并且提货方式为上门提货
-|expressVendorCode String(30) O 发货供应商编码
提货方式(pickupType)为自发物流(S)时,发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人编码
LB
-|expressVendorName String(50) O 发货供应商名称
提货方式(pickupType)为自发物流(S)时,发货供应商编码和发货供应商名称其中之一必填,取 [查询发货供应商]的承运人名称
龙邦
-|expressNo String(30) N 快递单号
提货方式(pickupType)为自发物流(S)时必填
directForecastInfo Object O 直发预报信息list
卖家直发必填,否则可以直接不填写
-|expectedSendWarehouseWay String(60) Y 预计送仓方式:
FCL:整柜
LCL:散货
Express:快递
FCL
-|transportAgent String(60) N 快递公司
当预计送仓方式为快递(Express)时,填写,非必填
UPS取值编码:UPS
DHL取值编码:LG_DHL
TNT取值编码:LG_TNT
FEDEX取值编码:DIRECT007
LG_DHL
-|expectedSendWarehouseTime String(60) Y 预计送仓时间
格式yyyy-MM-dd
2019-08-12
-|preparedOffPortDate String(30) Y 预计离港时间(即预计起航时间)
格式yyyy-MM-dd
2019-07-10
-|preparedArrivePortDate String(60) Y 预计到港时间
格式yyyy-MM-dd
2019-07-12
sendPortInfo Object O 送港信息list
只有WINIT头程才需要填写 (产品名称中含有“WINIT头程”字样)
-|sendPortType String(50) Y 送港类型
WINIT:winit送港;
SELF:自送港
-|sendPortDate String O 送港时间
格式yyyy-MM-dd
当送港类型是WINIT送港时,无需填;
当送港类型是自送港时,必填;
-|pickupCartonAddressCode String(50) O 提柜地址编码
与提货地址编号相同,通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到;
当送港类型是WINIT送港时,必填;
当送港类型是自送港时,无需填,整个字段无需传入;
-|containerNo String(50) N 柜号
当送港类型是WINIT送港时,无需填,整个字段无需传入;
当送港类型是自送港时,可填;
-|sealNo String(50) N 铅封号
当送港类型是WINIT送港时,无需填,整个字段无需传入;
当送港类型是自送港时,可填;

请求示例

1.标准海外仓入库

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "526482E2C51794D8BAB64F106AE94F63",
  6. "data": {
  7. "sellerOrderNo": "99999999",
  8. "inspectionWarehouseCode": "SZ0001",
  9. "destinationWarehouseCode": "US0001",
  10. "winitProductCode": "OW01010343",
  11. "importerCode": "IR0000000586",
  12. "exporterCode": "ER0000001405",
  13. "importDeclarationRuleCode": "CIOR",
  14. "exportDeclarationType": "CEOR",
  15. "logisticsPlanNo": "198402",
  16. "orderType": "SD",
  17. "dispatchInfo": {
  18. "inspectionType": "WI",
  19. "pickupType": "P",
  20. "pickupAddressCode": "12",
  21. "reservePickupDateFrom": "2019-06-25 09:00:00",
  22. "reservePickupDateTo": "2019-06-25 12:00:00",
  23. "expressVendorCode": "12",
  24. "expressVendorName": "龙邦",
  25. "expressNo": "LB0001"
  26. },
  27. "packageList": [
  28. {
  29. "sellerCaseNo": "qyk001",
  30. "thirdPartyCaseNo": "third2019062101",
  31. "sellerWeight": "0.01",
  32. "sellerLength": "18.00",
  33. "sellerWidth": "15.00",
  34. "sellerHeight": "2.00",
  35. "merchandiseList": [
  36. {
  37. "merchandiseCode": "iphoned6",
  38. "specification": "",
  39. "quantity": "1"
  40. }
  41. ]
  42. }
  43. ]
  44. },
  45. "format": "json",
  46. "platform": "OWNERERP",
  47. "sign_method": "md5",
  48. "timestamp": "2015-08-11 10:48:39",
  49. "version": "1.0",
  50. "sign": "8E8293A48AFFFB4467DB27D15CC91598",
  51. "language": "zh_CN"
  52. }

2.直发国内验-自验卖家直发

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "245002566@qq.com",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "8A4887740E73FA577C37314668A4C42B",
  6. "data": {
  7. "orderType": "DI",
  8. "winitProductCode": "OW01021351",
  9. "destinationWarehouseCode": "US0001",
  10. "inspectionWarehouseCode": "CSIW01",
  11. "sellerOrderNo": "567787",
  12. "packageList": [
  13. {
  14. "merchandiseList": [
  15. {
  16. "merchandiseCode": "AA30108WM",
  17. "specification": "",
  18. "quantity": "1"
  19. }
  20. ],
  21. "sellerCaseNo": "1",
  22. "thirdPartyCaseNo": "1234567801111",
  23. "sellerHeight": "2",
  24. "sellerLength": "1.00",
  25. "sellerWeight": "1",
  26. "sellerWidth": "1"
  27. }
  28. ],
  29. "directForecastInfo": {
  30. "preparedOffPortDate": "2020-02-20",
  31. "preparedArrivePortDate": "2020-02-27",
  32. "expectedSendWarehouseTime": "2020-04-30",
  33. "expectedSendWarehouseWay": "Express",
  34. "transportAgent": "UPS",
  35. " inventoryAttribute": [
  36. {
  37. "tagName ": "stockOrg",
  38. "tagValue": "AAA"
  39. },
  40. {
  41. "tagName ": "stockOwner",
  42. "tagValue": "XXX"
  43. }
  44. ]
  45. }
  46. },
  47. "format": "json",
  48. "language": "zh_CN",
  49. "platform": "OWNERERP",
  50. "sign": "3D434C2110F06BDBA022E1F3D6074C6E",
  51. "sign_method": "md5",
  52. "timestamp": "2016-09-23 16:26:39",
  53. "version": "1.0"
  54. }

3.直发国内验入-自验winit头程

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"65624DB16E3DFA9B372F9F6F82EE627E",
  6. "data": {
  7. "orderType": "DI",
  8. "winitProductCode": "OW01021405",
  9. "destinationWarehouseCode": "US0001",
  10. "sellerOrderNo": "autotest001",
  11. "inspectionWarehouseCode": "SZV001",
  12. "importDeclarationRuleCode": "",
  13. "packageList": [
  14. {
  15. "merchandiseList": [
  16. {
  17. "merchandiseCode": "LCD-IP5c-02",
  18. "specification": "",
  19. "quantity": "1"
  20. }
  21. ],
  22. "sellerCaseNo": "1",
  23. "thirdPartyCaseNo": "third_caseNo1_par2019062102",
  24. "sellerHeight": "10",
  25. "sellerLength": "10",
  26. "sellerWeight": "10",
  27. "sellerWidth": "1"
  28. }
  29. ],
  30. "importerCode": "IR0000000586",
  31. "exportDeclarationType":"",
  32. "exporterCode": "ER0000001405",
  33. "logisticsPlanNo": "198402",
  34. "sendPortInfo": {
  35. "sendPortType": "WINIT",
  36. "pickupCartonAddressCode": "zdw001",
  37. "sendPortDate": "2019-06-24",
  38. "containerNo": "1",
  39. "sealNo": "2"
  40. }
  41. },
  42. "format": "json",
  43. "language": "zh_CN",
  44. "platform": "OWNERERP",
  45. "sign": "8B06C217C151D24A7AC60F556A711741",
  46. "sign_method": "md5",
  47. "timestamp": "2016-09-23 16:26:39",
  48. "version": "1.0"
  49. }

4.直发海外验-卖家直发

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"DB49AF3868EF493199827F0BA141582C",
  6. "data": {
  7. "orderType": "DW",
  8. "winitProductCode": "OW01030329",
  9. "destinationWarehouseCode": "US0001",
  10. "sellerOrderNo": "autotest001",
  11. "importDeclarationRuleCode": "",
  12. "packageList": [
  13. {
  14. "merchandiseList": [
  15. {
  16. "merchandiseCode": "4BAR002A",
  17. "quantity": "1",
  18. "specification": ""
  19. }
  20. ],
  21. "sellerCaseNo": "11",
  22. "thirdPartyCaseNo": "third_caseNo1_par20190701",
  23. "sellerHeight": "1",
  24. "sellerLength": "1",
  25. "sellerWeight":"1",
  26. "sellerWidth": "1"
  27. }
  28. ],
  29. "directForecastInfo": {
  30. "preparedOffPortDate": "2019-07-10",
  31. "preparedArrivePortDate": "2019-07-11",
  32. "expectedSendWarehouseTime": "2020-04-30",
  33. "expectedSendWarehouseWay": "Express",
  34. "transportAgent":"UPS"
  35. }
  36. },
  37. "format": "json",
  38. "language": "zh_CN",
  39. "platform": "OWNERERP",
  40. "sign": "7A3CD72759832E3E82B33A6549D2DE3E",
  41. "sign_method": "md5",
  42. "timestamp": "2016-09-23 16:26:39",
  43. "version": "1.0"
  44. }

5.直发海外验-winit头程

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"2BAEE864F4B042926DD409BBA61C340C",
  6. "data": {
  7. "orderType": "DW",
  8. "winitProductCode": "OW01031342",
  9. "destinationWarehouseCode": "US0001",
  10. "sellerOrderNo": "autotest001",
  11. "inspectionWarehouseCode": "SZV001",
  12. "importDeclarationRuleCode": "",
  13. "packageList": [
  14. {
  15. "merchandiseList": [
  16. {
  17. "merchandiseCode": "216401",
  18. "quantity": "1",
  19. "specification": ""
  20. }
  21. ],
  22. "sellerCaseNo": "1",
  23. "thirdPartyCaseNo": "third_caseNo1_par2019062103",
  24. "sellerHeight": "1",
  25. "sellerLength": "2.34",
  26. "sellerWeight": "0.08879",
  27. "sellerWidth": "1"
  28. }
  29. ],
  30. "importerCode": "IR0000000586",
  31. "exportDeclarationType":"",
  32. "exporterCode": "ER0000001405",
  33. "logisticsPlanNo": "198402",
  34. "sendPortInfo": {
  35. "sendPortType": "WINIT",
  36. "pickupCartonAddressCode": "12",
  37. "sendPortDate": "2017-09-15",
  38. "containerNo": "234",
  39. "sealNo": "7686"
  40. }
  41. },
  42. "format": "json",
  43. "language": "zh_CN",
  44. "platform": "OWNERERP",
  45. "sign": "9486E1F6891234B179DE903CD7D598D1",
  46. "sign_method": "md5",
  47. "timestamp": "2016-09-23 16:26:39",
  48. "version": "1.0"
  49. }

6.直发海外验-无箱单预报

  1. {
  2. "action": "winit.wh.inbound.order.create",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "DB49AF3868EF493199827F0BA141582C",
  6. "data": {
  7. "orderType": "DW",
  8. "winitProductCode": "OW01030329",
  9. "destinationWarehouseCode": "US0001",
  10. "sellerOrderNo": "autotest001",
  11. "importerCode": "RIR001",
  12. "isForecastOrder": "Y",
  13. "valueAddedService": {
  14. "shelveAsDefectiveProducts": "Y",
  15. "singleToBoxService": "Y"
  16. },
  17. "planMerchandiseList": [
  18. {
  19. "merchandiseCode": "4BAR002A",
  20. "specification": "",
  21. "skuType": "BOX",
  22. "standardPartsQty": 2,
  23. "quantity": "1"
  24. }
  25. ],
  26. "orderIdentificationCodeList": [
  27. {
  28. "type": "TRACKING_NO",
  29. "code": "1010001001",
  30. "expressCompany": "UPS"
  31. },
  32. {
  33. "type": "TRACKING_NO",
  34. "code": "1010001002",
  35. "expressCompany": "UPS"
  36. }
  37. ],
  38. "directForecastInfo": {
  39. "preparedOffPortDate": "2019-07-10",
  40. "preparedArrivePortDate": "2019-07-11",
  41. "expectedSendWarehouseTime": "2020-04-30",
  42. "expectedSendWarehouseWay": "Express"
  43. }
  44. },
  45. "format": "json",
  46. "language": "zh_CN",
  47. "platform": "OWNERERP",
  48. "sign": "7A3CD72759832E3E82B33A6549D2DE3E",
  49. "sign_method": "md5",
  50. "timestamp": "2016-09-23 16:26:39",
  51. "version": "1.0"
  52. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必传 说明 示例
orderNo String(64) Y 入库单号

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "orderNo": "W0100000000002324"
  6. }
  7. }