You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
chenchuchuan
4184b5aeaa
fix(yqn): 修复出库链路四处参数丢失 / 语义错误
逐字段审计「标准出入参 ↔ 运去哪出入参」后发现的问题,只修能明确判定为
bug 的,不涉及模型结构调整:
1. 平台面单文件从未下发
OutboundCommand.labelContentBase64 无任何映射,attachInfoItems 整类
从未被构造。结果是 labelMode=PLATFORM_LABEL 校验通过、面单一个字节
都没发,仓没有面单可打。现在映射为 attachInfoItems(type=0 面单),
去掉 data URI 头、从 MIME 取 fileType;单包裹时带 packageNo。
同时加了「PLATFORM_LABEL 必须给面单内容」的校验,只声明模式不给文件
会直接拒绝,不再静默失败。
2. 声明了 SPLIT 但没有对应字段
运去哪下单接口没有拆单字段,splitOrder 无法下发,却声明了
WarehouseCapability.SPLIT。撤掉该能力位,避免调用方以为能控制拆单。
3. 出库查询把 orderRef 当来源单号
query() 用 firstNonBlank(providerOrderId, orderRef),而 API 128 只按
来源单号查;orderRef 是平台单号,传进去查不到或查错单。现在只接受
providerOrderId,并在报错里说明原因。
4. 回查路径上 OutboundOrder 三个字段恒空
providerOrderId 在 API 128 里没有(只有 API 123 创建时返回),
labelMode 与 requestedAt 也不回传。labelMode 之前直接走构造器默认值
WAREHOUSE_LABEL,会把平台面单订单报成仓面单。改为由调用方显式传入
(get/query 传 null 时按仓自有面单兜底),并给 PackageResult 补
carrierCode(包裹级承运商 code,之前只映射了名称)。
5. 顺带补上现成落点没赋值的两个字段
shopName → channelAccount、sfp → isPrime(1/2),之前 DTO 有字段
却从不 set,多店铺与 SFP 场景静默失效。
文档补充:
- InventoryCapable.query / OutboundQuery.orderRef 标注「并非所有仓支持,
过滤可能不生效」,按 SKU 过滤目前在 YQN 侧完全未实现
新增 YqnOutboundPayloadTest(9 个)覆盖面单附件、data URI、两种面单模式、
店铺/SFP、查询语义、SPLIT 撤销。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
| .. |
|
src/main/java/common/ecommerce/warehouse
|
fix(yqn): 修复出库链路四处参数丢失 / 语义错误
|
2 weeks ago |
|
pom.xml
|
feat(warehouse): 新增仓库域 SDK 内核与运去哪 P1 出库闭环
|
2 weeks ago |