库存调整接口调用示例

说明：本文档主要用来解释说明库存调整接口传入方式，并提供对应参数的请求 JSON 示例，SDK 调用代码示例，具体常规参数传入请参考接口文档：
https://doc.youzanyun.com/doc#/content/API/2-434/detail/api/0/248

参数说明：
order_items：是 List 格式，商品明细封装成 JSON 在 List 中传入
库存调正不涉及到金额，如下 3 个字段已废弃：
with_tax_cost、with_tax_amount、with_tax_income

sku_code：商品无规格传入商品编码，有规格传入规格编码

JSON 请求示例：

{  
"retail_source":"XXX",  
"create_time":"yyyy-MM-dd HH🇲🇲ss",  
"source_order_no":"商家自定义（唯一不重复）",  
"order_items":[  
        {  
            "quantity":"10",  
            "sku_code":"商品编码/规格编码"  
        }  
    ],  
"warehouse_code":"仓库编码"  
}

一、SDK 方式调用示例

1）代码示例：

    @Test
    public void spuCreate() throws SDKException{
        DefaultYZClient yzClient = new DefaultYZClient();
        Token token = new Token("token");
        YouzanRetailOpenStockAdjust youzanRetailOpenStockAdjust = new  YouzanRetailOpenStockAdjust(); 
        //创建参数对象,并设置参数 
       YouzanRetailOpenStockAdjustParams youzanRetailOpenStockAdjustParams = new  YouzanRetailOpenStockAdjustParams(); 
       youzanRetailOpenStockAdjust.setAPIParams(youzanRetailOpenStockAdjustParams); 
       YouzanRetailOpenStockAdjustResult result = yzClient.invoke(youzanRetailOpenStockAdjust, token, 
       YouzanRetailOpenStockAdjustResult.class);
       System.out.println(JSON.toJSONString(result));
    }

二、HTTP 方式调用示例

以 Postman 工具为例

调用报错说明

1.

{
"code": 234000003,
"data": null,
"success": false,
"message": "明细中的商品不存在: [BM5184320247]"
}

错误原因：
1）传入的商品编码或规格编码不对
2）order_items 参数传入的格式不对系统无法解析商品明细数据

解决方式：
1）传入的编码请确认正确无误，无规格的商品传商品编码 ，有规格的商品传规格编码
2）参考报文示例调整请求报文

2.

{"code": 223001004, 
"data": null,
"success": false,
"request_id": null,
"message": "已经处理成功，请直接返回列表页面查看"}

错误原因：传入的 source_order_no 要唯一不重复，如果重复传入会报这个提示，实际调用未成功

解决方式：重新生成 source_order_no 值传入，保证唯一不重复

3.

{  
"code":223005003,  
"success":false,  
"message":"出库校验不通过"  
}

错误原因：商品信息在入参对应的仓库里没有库存

解决方式：
先确认该商品的库存具体分布在哪个仓库里，查看方式路径：零售连锁店铺后台-库存-库存管理-库存查询
1）调整入参的仓库编码，传入有该商品库存的库存编码
2）给仓库添加该商品的库存

4.

{  
"code":223004016,  
"success":false,  
"message":"重复的sku"  
}

错误原因：请求入参中编码重复

解决方式：
编码要唯一不重复，请仔细检查剔除重复的部分重新调用接口

工单提交流程

若问题还是无法解决，可以提交工单咨询，工单使用指南