lml
|
b634ff2e93
|
feat(hengjian): 对接销毁计划创建 / 查询(路径待真机确认)
⚠ 这两个路径在测试环境真机返回 404 No handler found(2026-11-17),
文档路径及 26 个变体全试过;同环境其它接口正常响应,不是网络问题。
代码按文档实现,路径常量加了显式警告,联调时只需改一处。
- 创建:hopeDestroyData 字段名照抄(Data 不是 Date);orderNo 不传
(文档标必填但示例没有,仓方自生成);响应无 data,不回仓单号也不回状态
- 查询:请求体是裸数组;data 也是数组且查不到的单号不返回;
按来源单号查(示例里数组的值正是响应里的 sourceNo),也兼容仓方计划单号
- 新增 HengjianDestructionStatus:7 个状态值精确匹配;core 没有销毁状态
枚举,保留仓方码 + 中文名,不硬造跨仓枚举
- core DestructionCommand 补 lineName,DestructionOrder 补
lineName / hopeDestroyDate / createdAt
验证:mvn test 全量通过,恒健 329 个用例(+16)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
5 days ago |
lml
|
4bcd8d54d9
|
feat(hengjian): 对接退货计划创建 /v1/saleReturn/thirdParty/saveReturnPlan
- 新增 HengjianReturnPlanCreateDtos + HengjianReturnMapper,实现
WarehouseReturnCapable.create,声明 RETURN
- 请求是双层包裹:业务字段全在 params 下(与其它接口不同)
- 该接口无 token 时直接 403、不做参数校验,必填项按文档字段表实现并在
本地拒绝(orgWarehouseCode / returnSkuArr / 每行四项),待真机带 token 验证
- tracking 挂在行上而统一模型是命令级:行级优先、否则退回命令级
- treatmentMethodForAppearanceDamage 文档标 integer、示例给 "2",按字符串下发
- 响应只回头级信息,不回明细行——保持空列表不凭空造
- 新增 HengjianReturnPlanStatus:8 个值精确匹配,20 待处理与 35 处理中不合并;
并注明 handlingStatus(5/10/15/20)是另一套码表
- core ReturnCommand 补 7 个字段、ReturnCommandLine 补 3 个字段并加两个
Builder 重载;其它仓不读,行为不变
验证:mvn test 全量通过,恒健 275 个用例(+16)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
5 days ago |
lml
|
94b69a021d
|
feat(hengjian): 对接调拨计划创建 / 查询 / 取消
三个接口真机均确认存在:create 的参数校验可逐步推进、cancel 缺 sourceNo 回
"Required String parameter 'sourceNo' is not present"、findByPage 无参数回 403。
- 创建:真机确认必填 outOrgWarehouseCode / inOrgWarehouseCode /
estimateOutboundTime / estimateInboundTime;文档另标的 projectUnicode /
transportationType / inventoryType / isLabel / receiveStore / shipTo* 真机不校验,
按选填实现
- details[].qty 文档标 STRING:按字符串下发;查询响应是数字,两个 DTO 各声明
- 统一模型是 LocalDate,恒健要 yyyy-MM-dd HH:mm:ss:补当天 00:00:00 不编造时刻
- inOrgWarehouseCode=Other 表示外部仓库,映射 TransferType.OUTBOUND
- 响应 data 是字符串单号,拿不到即报错;创建不回状态,status 保持 UNKNOWN
- 查询:分页四件套必填、rows 上限 100 拒绝不截断;过滤参数都是单值,多给只取首个
- 取消走 GET + query,落在 deleteTransfer;仓方拒绝原样抛业务异常
- 新增 HengjianTransferStatus:13 个值精确匹配,100 取消中与 110 已取消不合并
- core 补 TransferQuery 模型 + TransferCapable.queryTransfers + 门面,
TransferCommand 补 5 字段、TransferOrder 补 projectCode/attachments
验证:mvn test 全量通过,恒健 259 个用例(+21)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
5 days ago |
lml
|
8f7d703f2f
|
feat(hengjian): 对接入库计划详情 /v1/inbound/getInboundPlanInfo 与列表 getInboundPlanPage
- 两个接口回的对象字段完全一致,共用一份 DTO 与映射
- 详情:真机确认 orderNo 必填;单号既可是仓方计划单号也可是来源单号;
data 为空返回 null
- 列表:状态过滤转数字码,认不出的状态拒绝不猜;时间区间是单值字符串
"yyyy-MM-dd ~ yyyy-MM-dd";页大小上限 200 超限拒绝
- 新增 HengjianInboundStatus:计划单码表 0/5/6/8/10/15/20/25/70/100,
同时认数字串与中文名;收货单的 0/70/90 是另一套码表,不混用
- core 新增 InboundQuery(仓/状态/单号/三种时间窗/库存类型/shipmentId)
与 InboundCapable.queryInbounds() + 门面 queryInbounds();
InboundCapable.query(cursor) 共用同一实现
- 数量三层 plan/packed/received 直接搬运不重算;可售/不可售分开映射,
缺失时按可售兜底但总数一致
- 收货单 inboundOrderList 落成 INBOUNDED 阶段批次,库存类型保持 null
验证:mvn test 全量通过,恒健 238 个用例(+18)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
5 days ago |
lml
|
a6226a37cc
|
feat(hengjian): 对接订单详情 /v1/saleOrder/findOne 与订单列表 /v1/saleOrder/findByPage
- 新增 HengjianOrderDetailDtos / HengjianOrderListDtos / HengjianOrderMapper,
实现 OutboundCapable.get / query / checkCancel / packages
- 新增 HengjianOrderStatus:8 个 orderStatusEnum 值精确匹配,未识别归 UNKNOWN;
core OutboundStatus 追加 REFUNDED(180)——退款与取消语义不同,合并会分不清是否已发货
- 详情不回 orderId:providerOrderId 保持 null,不编造;列表是唯一回 orderId 的接口
- skuAmount 是行总额落 totalAmount;恒健不回申报单价,declareValue 留空
- 列表:时间/单号二者必填其一(否则本地拒绝)、跨度上限 30 天、rows 截断 100、
状态过滤显式拒绝;游标是页码,末页以仓方 last 为准
- 时间按 UTC 解析(文档声明 utc),不用仓时区
- 包裹从详情 shipmentPackages 提取,按 trackingNo 去重且实际包裹优先
- 取消预判按状态推断,查不到单判 BLOCKED 而不是猜 FREE;cancel 仍未接入
- 只读探针补订单详情 / 订单列表用例
验证:mvn test 全量通过,恒健 99 个用例 + 2 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
lml
|
4aa311feb8
|
feat(warehouse): 新建恒健适配器骨架并接入只读基础资料
- 新增 warehouse-sdk-hengjian 模块,注册 WarehouseProvider.HENGJIAN
- 接入仓库目录、全量物流渠道、按仓物流渠道三个只读接口
- 信封校验覆盖三种真机形态:正常业务信封、HTTP 200 + code=999999、
HTTP 500 + 「未知的账户」;后两者映射为 AuthException
- 能力位只声明 DIRECTORY / LOGISTICS_PRODUCT,未接接口不声明
- 新增只读探针(默认跳过,凭据走系统属性)与接入文档
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |