1 请求参数
请求 URL
POST http://47.101.175.115:7070/franchiser/api/instock/modify
参数列表
参数名 | 类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴 AppId | 对接时,由 EM 生成并提供 |
timestamp | String | 是 | 当前时间戳 | |
sign | String | 是 | 接口签名 | 如何计算生成见示例代码 |
request_data | Object | 是 | 接口请求 json 数据 | 订单及明细相关信息 |
-request_data 参数列表 | 说明 | 示例 | ||
instockno | String | 是 | 入库单号 | RK202509160001 |
warehouseid | int | 否 | 入库仓库 ID,从接口[仓库列表]中获取 | 22 |
instockType | int | 否 | 入库方式,3 其他入库 | 3 |
indatetime | String | 否 | 具体到天,如: | 2025-09-16 |
othersource | String | 否 | 入库来源 | |
remark | String | 否 | 入库单备注 | |
items | jsonArray | 否 | 订单明细 json 数组 | [{“outerpcode”:”ERP_1113004”,”mainmeasunitqty”:”10”,”remark”:”接口导入订单”}] |
– outerpcode | String | 条件 | ERP 编码,用于与 EM 系统中的产品匹配,修改items时必传 | |
– mainmeasunitqty | int | 条件 | 数量,修改items时必传 | |
–remark | String | 否 | 订单明细备注 |
request_data 请求数据示例:
{
"instockType": 3,
"warehouseid" : 5,
"indatetime": "2025-09-16",
"othersource": "入库来源",
"remark": "这是入库单备注信息",
"items": [{
"outerpcode" : "02981-6601001",
"mainmeasunitqty" : 6,
"remark": "入库单明细备注"
}]
}
2 请求示例代码(Java)
@Test
public void modifyInstock() throws Exception {
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", SystemConfig.testAppKey);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("request_data", requestData_create2); //json格式
data.put("timestamp", timestamp.toString());
data.put("sign", CheeliUtils.Sign(data, SystemConfig.testAppSecret));
// 调用服务API
String response = CheeliUtils.doHttpRequest(SystemConfig.modifyInstockUrl, data);
System.out.println(response);
}
3 返回结果如下:
3.1 请求成功
{"statusCode":0,"message":"操作成功","data":"RK202509160004"}
3.2 请求失败
{"statusCode":1,"message":"已审核入库单,不能编辑","data":null}
{"statusCode":1,"message":"无单号为RK2025091600031的入库单,请检查","data":null}
{"statusCode":1,"message":"入库单号不能为空","data":null}
说明: statusCode 为 0 表示成功,非 0 为失败,message 会包含失败原因,data 为导入成功的订单号
文档更新时间: 2025-09-16 19:09 作者:hanson