创建库存调整单v2
更新时间: 2023-09-14 20:24:10 访问次数:761
接口说明
此接口支持调整库存如下:
箱产品/套装产品转单一产品(产品编码开头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"
}
}