创建库存调整单v2
更新时间: 2023-09-14 20:24:10 访问次数:1343
接口说明
此接口支持调整库存如下:
箱产品/套装产品转单一产品(产品编码开头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
{"action": "wh.inventoryAdjustment.createOrder.v2","app_key": "rebecca","data": {"sellerOrderNo": "liao1028","winitProductCode": "OSF611005741","warehouseCode": "US0001","turnOutCode": "nj","turnInCode": "bj","merchandiseList": [{"transferOutInfo": {"merchandiseCode": "liaowl1002","specification": "","skuType": "BOX","standPartsQty": 10,"barcodeValue": "T00001","quantity": "1"},"transferInInfo": {"merchandiseCode": "liaowl1003","specification": "","skuType": "SINGLE","standPartsQty": 10,"barcodeValue": "T00001","quantity": "10"}}]},"format": "json","language": "zh_CN","platform": "OWNERERP","sign": "00000000000000000000000000000000","sign_method": "md5","timestamp": "2020-05-18 20:09:05","version": "1.0"}
库存组织调整:OSF64
{"action": "wh.inventoryAdjustment.createOrder.v2","app_key": "rebecca","data": {"sellerOrderNo": "liao1028","winitProductCode": "OSF641006365","warehouseCode": "US0001","turnOutCode": "nj","turnInCode": "bj","merchandiseList": [{"transferOutInfo": {"merchandiseCode": "liaowl1002","specification": "","skuType": "BOX","standPartsQty": 10,"barcodeValue": "T00001","quantity": "1"},"transferInInfo": {"merchandiseCode": "liaowl1002","specification": "","skuType": "BOX","standPartsQty": 10,"barcodeValue": "T00001","quantity": "1"}}]},"format": "json","language": "zh_CN","platform": "OWNERERP","sign": "00000000000000000000000000000000","sign_method": "md5","timestamp": "2020-05-18 20:09:05","version": "1.0"}
条码值调整:OSF65
{"action": "wh.inventoryAdjustment.createOrder.v2","app_key": "rebecca","data": {"sellerOrderNo": "liao1028","winitProductCode": "OSF651006365","warehouseCode": "US0001","turnOutCode": "nj","turnInCode": "bj","merchandiseList": [{"transferOutInfo": {"merchandiseCode": "liaowl1002","specification": "","skuType": "BOX","standPartsQty": 10,"barcodeValue": "T00001","quantity": "1"},"transferInInfo": {"merchandiseCode": "liaowl1002","specification": "","skuType": "BOX","standPartsQty": 10,"barcodeValue": "T00002","quantity": "1"}}]},"format": "json","language": "zh_CN","platform": "OWNERERP","sign": "00000000000000000000000000000000","sign_method": "md5","timestamp": "2020-05-18 20:09:05","version": "1.0"}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
| 名称 | 类型 | 必传 | 说明 | 示例 |
|---|---|---|---|---|
| orderNo | String | N | 订单号 |
返回示例
{"code" : "0","msg" : "操作成功","data" : {"orderNo" : "WT010000000210"}}
