Browse Source
审计恒健已接接口时发现的四类问题,一并修正:
1) sort 被写死成 desc。文档里 sidx「可写死 id」、sort 明确是 asc/desc 两值,
而 OutboundQuery 根本没有排序字段,调用方无处表达。
→ core 新增 SortDirection 与 OutboundQuery.sortField / sortDirection;
恒健未指定时用文档默认(sidx=id、sort=desc),指定则透传。
2) 静默吞参数:orderRef / providerSku / noType 传了不生效也不报错。
→ 三者均改为显式拒绝(与同方法里 statuses 的处理一致)。
3) 静默截断:rows 超 100、计费 size 超 200 被悄悄改小,
调用方按自己的 pageSize 判末页会误判「还有下一页」,导致漏账。
→ 改为超限直接报错。rows=100 是文档明写上限;size=200 是我编的保守值,
已在注释标注待真机确认。
4) 计费仓过滤写死账户仓。恒健接口参数本就是复数 orgWarehouseCodes,
写死会让调用方无法表达「全部仓」或「其中几个仓」。
→ FeeQuery 新增 warehouseCodes(与 InventoryQuery 同口径),
非空用调用方的,空才退回账户仓。
验证:mvn test 全量通过,恒健 157 个用例(+8)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
master
10 changed files with 354 additions and 38 deletions
@ -0,0 +1,47 @@
@@ -0,0 +1,47 @@
|
||||
package common.ecommerce.warehouse.enums; |
||||
|
||||
/** |
||||
* 查询排序方向。 |
||||
* |
||||
* <p>只表达业务语义(升序 / 降序),仓方的字面量({@code asc/desc}、{@code 1/0}、 |
||||
* {@code ASCENDING} 等)由适配器映射。<b>排序字段本身不进枚举</b>——那是仓方字典, |
||||
* core 不认识任何仓的字段名。</p> |
||||
* |
||||
* <p>与能力位同构:适配器不支持排序时忽略该字段并保持仓方默认,调用方不应假定 |
||||
* 排序一定生效;需要强保证时应改用 {@code query} 之外的显式接口。</p> |
||||
*/ |
||||
public enum SortDirection { |
||||
|
||||
/** 升序。 */ |
||||
ASC(10, "升序"), |
||||
/** 降序。 */ |
||||
DESC(20, "降序"); |
||||
|
||||
private final int code; |
||||
private final String label; |
||||
|
||||
SortDirection(int code, String label) { |
||||
this.code = code; |
||||
this.label = label; |
||||
} |
||||
|
||||
/** 落库用的稳定码;由 SDK 分配,永不复用、永不重排。 */ |
||||
public int code() { |
||||
return code; |
||||
} |
||||
|
||||
/** 中文显示名。 */ |
||||
public String label() { |
||||
return label; |
||||
} |
||||
|
||||
/** 按落库码反查;未知返回 null。 */ |
||||
public static SortDirection ofCode(int code) { |
||||
for (SortDirection d : values()) { |
||||
if (d.code == code) { |
||||
return d; |
||||
} |
||||
} |
||||
return null; |
||||
} |
||||
} |
||||
Loading…
Reference in new issue