API
创建库存调整单v2
更新时间: 2023-09-14 20:24:10 访问次数:386

接口说明

此接口支持调整库存如下:
箱产品/套装产品转单一产品(产品编码开头OSF61)
条码值调整(产品编码开头OSF65)
组织间库存转移(产品编码开头OSF64)

使用场景

仅限开通相关权限后调用,详询客服(库存组织管理、箱/套产品管理、条码值管理)

接口名称

wh.inventoryAdjustment.createOrder.v2

请求说明

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

请求入参

名称 类型 必填 说明 示例
winitProductCode String(50) Y Winit产品编码 OSF611005741
sellerOrderNo String(50) N 客户订单号
warehouseCode String(50) Y 仓库编码
turnInCode String(30) O 转入方编码(库存组织编码)
1、当Winit产品类型为组织间库存转移(OSF64)必填;
2、当Winit产品类型为箱产品/套装产品转单一产品(OSF61),或条码值调整(OSF65)时,且客户启用库存组织时必填,此时turnInCode与turnOutCode必须一致
turnOutCode String(30) O 转出方编码(库存组织编码)
1、当Winit产品类型为组织间库存转移(OSF64)必填;
2、当Winit产品类型为箱产品/套装产品转单一产品(OSF61),或条码值调整(OSF65)时,且客户启用库存组织时必填,此时turnInCode与turnOutCode必须一致
merchandiseList Array Y 商品列表
–|transferOutInfo Object Y 调出信息
–|–|merchandiseCode String(255) Y 商品编码
–|–|specification String255) O 商品规格(当商品注册了规格时,必填)
–|–|quantity String Y 商品数量(库存单元数)
–|–|skuType String(30) Y SKU类型
BOX:箱商品库存单元
SUITE:套装库存单元
SINGLE:单一商品库存单元
注意:
1、当Winit产品类型为箱产品/套装产品转单一产品(OSF61)时,调出商品的SKU类型只能为箱商品(BOX)或套装商品(SUITE),且同一订单下所有商品的调出SKU类型必须一致。
2、其余情况调入调出的SKU类型需保持一致。
–|–|standPartsQty Integer O 标准件数
–|–|barcodeValue String(255) O 条码值
注意:
1、当Winit产品类型为条码值调整(OSF65)时,调入调出的商品信息中,仅支持条码值进行变更,其余商品信息需要保持一致。
2、其余情况调入调出的条码值需保持一致。
–|transferInInfo Object Y 调入信息
–|–|merchandiseCode String(255) Y 商品编码
–|–|specification String255) O 商品规格(当商品注册了规格时,必填)
–|–|quantity String Y 商品数量(库存单元数)
–|–|skuType String(30) Y SKU类型
BOX:箱商品库存单元
SUITE:套装库存单元
SINGLE:单一商品库存单元
注意:
1、当Winit产品类型为箱产品/套装产品转单一产品(OSF61)时,调入商品的SKU类型只能为单一产品(SINGLE)。
2、其余情况调入调出的SKU类型需保持一致。
–|–|standPartsQty Integer O 标准件数
–|–|barcodeValue String(255) O 条码值
注意:
1、当Winit产品类型为条码值调整(OSF65)时,调入调出的商品信息中,仅支持条码值进行变更,其余商品信息需要保持一致。
2、其余情况调入调出的条码值需保持一致。

请求示例

箱/套装转单一产品:OSF61

  1. {
  2. "action": "wh.inventoryAdjustment.createOrder.v2",
  3. "app_key": "rebecca",
  4. "data": {
  5. "sellerOrderNo": "liao1028",
  6. "winitProductCode": "OSF611005741",
  7. "warehouseCode": "US0001",
  8. "turnOutCode": "nj",
  9. "turnInCode": "bj",
  10. "merchandiseList": [
  11. {
  12. "transferOutInfo": {
  13. "merchandiseCode": "liaowl1002",
  14. "specification": "",
  15. "skuType": "BOX",
  16. "standPartsQty": 10,
  17. "barcodeValue": "T00001",
  18. "quantity": "1"
  19. },
  20. "transferInInfo": {
  21. "merchandiseCode": "liaowl1003",
  22. "specification": "",
  23. "skuType": "SINGLE",
  24. "standPartsQty": 10,
  25. "barcodeValue": "T00001",
  26. "quantity": "10"
  27. }
  28. }
  29. ]
  30. },
  31. "format": "json",
  32. "language": "zh_CN",
  33. "platform": "OWNERERP",
  34. "sign": "00000000000000000000000000000000",
  35. "sign_method": "md5",
  36. "timestamp": "2020-05-18 20:09:05",
  37. "version": "1.0"
  38. }

库存组织调整:OSF64

  1. {
  2. "action": "wh.inventoryAdjustment.createOrder.v2",
  3. "app_key": "rebecca",
  4. "data": {
  5. "sellerOrderNo": "liao1028",
  6. "winitProductCode": "OSF641006365",
  7. "warehouseCode": "US0001",
  8. "turnOutCode": "nj",
  9. "turnInCode": "bj",
  10. "merchandiseList": [
  11. {
  12. "transferOutInfo": {
  13. "merchandiseCode": "liaowl1002",
  14. "specification": "",
  15. "skuType": "BOX",
  16. "standPartsQty": 10,
  17. "barcodeValue": "T00001",
  18. "quantity": "1"
  19. },
  20. "transferInInfo": {
  21. "merchandiseCode": "liaowl1002",
  22. "specification": "",
  23. "skuType": "BOX",
  24. "standPartsQty": 10,
  25. "barcodeValue": "T00001",
  26. "quantity": "1"
  27. }
  28. }
  29. ]
  30. },
  31. "format": "json",
  32. "language": "zh_CN",
  33. "platform": "OWNERERP",
  34. "sign": "00000000000000000000000000000000",
  35. "sign_method": "md5",
  36. "timestamp": "2020-05-18 20:09:05",
  37. "version": "1.0"
  38. }

条码值调整:OSF65

  1. {
  2. "action": "wh.inventoryAdjustment.createOrder.v2",
  3. "app_key": "rebecca",
  4. "data": {
  5. "sellerOrderNo": "liao1028",
  6. "winitProductCode": "OSF651006365",
  7. "warehouseCode": "US0001",
  8. "turnOutCode": "nj",
  9. "turnInCode": "bj",
  10. "merchandiseList": [
  11. {
  12. "transferOutInfo": {
  13. "merchandiseCode": "liaowl1002",
  14. "specification": "",
  15. "skuType": "BOX",
  16. "standPartsQty": 10,
  17. "barcodeValue": "T00001",
  18. "quantity": "1"
  19. },
  20. "transferInInfo": {
  21. "merchandiseCode": "liaowl1002",
  22. "specification": "",
  23. "skuType": "BOX",
  24. "standPartsQty": 10,
  25. "barcodeValue": "T00002",
  26. "quantity": "1"
  27. }
  28. }
  29. ]
  30. },
  31. "format": "json",
  32. "language": "zh_CN",
  33. "platform": "OWNERERP",
  34. "sign": "00000000000000000000000000000000",
  35. "sign_method": "md5",
  36. "timestamp": "2020-05-18 20:09:05",
  37. "version": "1.0"
  38. }

返回出参

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

名称 类型 必传 说明 示例
orderNo String N 订单号

返回示例

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