lml
|
93e85bfeb7
|
feat(hengjian): 对接入库箱标生成 /v2/inbound/boxLabelGenerate
真机确认必填五项:inboundPlanOrderNo / type / pageSize / isIndexNo /
isOriginCountry(空 body 时仓方一次性列出全部缺失项);paperType 与
fileNamingType 选填。
- 响应无 data:只有 code/message,不回任务号也不回文件,文件要去
入库计划详情的 packingLabelUrl 取。所以 LabelPrintTask.taskNo 恒为
null,不代表调用失败
- 份数口径不同:twoCopies → type 1 一式一份 / 2 一式两份,是份数码
不是布尔
- 恒健没有 sizeType / downloadMode 口径,改用 paperType(1 A4 /
2 10×10);labelsPerPage 直接映射 pageSize
- isIndexNo / isOriginCountry 仓方标必填,统一模型是 null-able:
null 时本地拒绝而不是猜——猜「是」每箱多印一行,猜「否」漏印
- core LabelPrintTask.taskNo 改为可空;BoxLabelCommand 补
showIndexNo / showOriginCountry / paperTypeCode / fileNamingType
顺带修正一处笔误:AddressClassificationCapable 的 @param city
被改成「必」,恢复为「必填」。
验证:mvn test 全量通过,恒健 340 个用例(+11)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |
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>
|
3 days ago |
lml
|
1325314957
|
fix(hengjian): 异动单查询补齐未映射字段,并修正 changeRequestNo 语义
服务端字段原先只映射了一部分,排障要看的几组被丢掉了:
- 来源三维各存各的:sourceId / sourceNo / sourceOrderType,
orderNo 取 sourceNo(我们下发的单号落在那里),upstreamNo 不再合并进来
——合并就分不清哪一层出的问题
- 收件人对照:originalRecipient* / newRecipient* 三项都保留,
换址场景要能看到「原 → 新」
- carrierIsAcceptance 补齐并加 carrierAccepted():恒健是 1 否 / 2 是,
不是 0/1;缺失或非法值返回 null(未知),不猜
- trackingLabel 补齐并加 recalling()(1 召回中)
- errorStatus 与 errorMessage 分开保留:码用于判断、文本用于展示
- customerRemark / acceptanceRemark 两个字段不合并
修正 changeRequestNo 语义:查询响应里仓方不回 OMS 申请号,
原先把它填成仓单号,会让调用方误以为两者相等。现改为查询结果为 null,
创建结果仍填(那才是真的 OMS 单号)。字段改为允许 null。
验证:mvn test 全量通过,恒健 313 个用例(+8)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |
lml
|
757b058697
|
feat(hengjian): 对接订单上传附件 /v1/saleOrder/createAttachment
- 新增 HengjianOrderAttachmentDtos,在 OutboundCapable 上加
uploadAttachments()(default 拒绝),恒健覆盖
- 门面新增 outbound().attachment(ref, list):写操作走幂等守卫,
业务键是「单号 + 附件名 + attachment」——同附件重传幂等、
不同附件各自一次(只用单号做键会让第二次附件被判成重复)
- 请求平铺;type 在这个接口是 INTEGER 0~6(创建订单那边标 STRING,
两页不一致),认不出即拒绝,不猜
- 给了 contentBase64 时忽略 url 并剥掉 data: 前缀(仓方语义)
- 真机无 token 时直接 403、不做参数校验,必填项按文档实现:
orderNo + 非空列表,每行 name/type 必填、url 与 file 二选一
- 响应无 data,只有 code/message
验证:mvn test 全量通过,恒健 305 个用例(+12)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |
chenchuchuan
|
c8f471352b
|
Merge branch 'master' of common-ecommerce
冲突处理:
- WarehouseCapability:远端新增 ADDRESS_CLASSIFICATION(260),本地的
CASE_MARK_PRINT 顺延到 270(码值只增不改,不复用)
- WarehouseOperations:两边新增的 import 都保留,去掉重复
适配远端新增后的编译错误:
- WarehouseReturnCapable.queryReturns 签名从 String cursor 改成 ReturnQuery
是本地改动,远端的 yqn / hengjian 实现还按老签名。yqn 只是抛不支持,
改签名即可;hengjian 把 ReturnQuery 的 cursor 转给 queryReturnsAdvanced,
并对其不支持的维度(时间窗 / 单号 / SKU / 状态)显式拒绝——静默忽略会
让调用方以为筛过了。
验证:全量 mvn test 通过(293 个用例,4 个探针跳过)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
lml
|
5169fb3107
|
feat(hengjian): 对接退货详情 / 列表 / 处理单列表 / 填写处理方式
四个接口真机均确认存在,但都不做参数校验(thirdParty 那两个回 403,
handlePage / handlingMethod 回 500+999999),必填项按文档实现。
- 请求形态两套:thirdParty 两个是双层包裹 params,handlePage 与
handlingMethod 是平铺;发错形态仓方当成空请求
- 详情:SKU 明细落 lines,换标明细 changeSku 落 newSku;
待处理 / 已处理列表不塞进 lines(那是 SKU 维度)
- sourceType 两页文档顺序相反(创建页 1 无来源、详情页 1 销售),
适配器不解释,原值保留在 type()
- 列表:page/size 文档标 string 转字符串下发;状态过滤是单值,多给即拒绝;
仓库 code 收逗号拼接;RETURNING 对应 20 或 35,无法唯一映射返回 null
- 处理单列表:过滤条件全是数组;返回仓方处理行(无对应统一模型);
时间戳是 ISO 带时区,解析转换后使用
- 处理方式:四项定位(returnPlanNo+returnNo+erpSku+tracking)不用行 id;
两级处理方式;继续拍照必须给 photosQuantity
- core ReturnProcessCommand:lineId 改 Long 可空、disposition 改可空
(与 primaryHandlingMethod 至少给一个)、补 6 个字段;运去哪缺 lineId 时
在适配器里显式拒绝,已加守卫
验证:mvn test 全量通过,恒健 293 个用例(+18)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
f66720f6be
|
feat(edayun): 对接仓库清单(权限内 / 全量激活)
两个接口用途不同,不要混用:
- POST /webApi/warehouse/listWarehouseHasPerm → warehouses(ctx)
当前客户有权限的仓(实测 69 条,跳过 -999 后 68)
- POST /webApi/warehouse/listActive → activeWarehouses(ctx, inbound)
平台全量激活仓(118 条),**含当前客户没授权的**
有权限的 68 个仓里有 50 个不在 listActive 结果里,所以给客户选仓必须用前者。
-999 是「智能分仓」哨兵值(divideWarehouse),不是真实仓,映射时跳过——
和物流产品接口的 -998 是同一套路。
listActive 的 warehouseOperationType:0 尾程 111 条 / 1 头程 7 条 /
不传 118 条(文档说必填,实测不传也通)。
统一模型口径:warehouseCode 放仓编码(USLA),数字 id 进 providerWarehouseId。
listActive 比 listWarehouseHasPerm 多 30 个字段(容量 / 营业时间 / 负责人邮箱等),
DTO 只声明统一模型用得上的十几个,其余由 Jackson 忽略。
顺带把之前 warehouses() 的显式拒绝换成真实实现,DIRECTORY 能力位从此完整。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
17ef1c574a
|
feat(edayun): 对接客户自有物流服务(承运商)清单
POST /webApi/carrier/v1/listCarrierByWarehouse → List<WarehouseCarrier>
返回两层:承运商(carrierId / 名称中英文)→ 物流服务(logisticId / 名称)。
自提单下单时 carrierName 可以填承运商名,也可以用某个物流服务的名字。
统一模型新增 WarehouseCarrier;能力挂在
WarehouseDirectoryCapable.carrierDirectory(门面 carrierDirectory())。
原有的 carriers()(List<String>,只有码)保留不动——carrierDirectory 的
默认实现会把码包装成无名条目,能给出结构的仓覆盖它。
ownLogisticList 文档写成对象、真机返回数组,DTO 按 List 收。
真机(2026-11-16):仓 2 返回 11 个承运商(FedEx 下 12 个物流服务);
不传仓 22 个;countryCode=US 10 个。
顺带:易达云没有仓库列表接口,warehouses() 显式抛不支持,
不返回空列表——空列表和「没有仓」调用方分不清。DIRECTORY 能力位
目前只覆盖承运商这一半。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
b675dd67e0
|
refactor(edayun): 修正 printBarcode / newPrintCaseMark 的语义归属
仓方确认两个端点名与实际打印的东西是反的:
- /webApi/skuInfo/v2/printBarcode → 实际是箱唛(外箱标)
- /webApi/entryInfo/v1/newPrintCaseMark* → 实际是 SKU 标
代码按实际语义命名(端点不变):
- printCaseMarks(...) + CaseMarkPrintCommand / CaseMarkPaperSize / CASE_MARK_PRINT
- printSkuLabel(...) + EdayunSkuLabelDtos / EdayunSkuLabelMapper / EdayunSkuLabelPaper
纸张尺寸真机实测(MediaBox)发现文档标称有错:
pageSize=2 文档说 6×4cm,实测 100×150mm
pageSize=3 文档说 A4, 实测 60×40mm
枚举按实测尺寸命名,码值原样保留。
其余三个尺寸与文档一致:0→70×30、1→100×60。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 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>
|
4 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>
|
4 days ago |
chenchuchuan
|
fed2c0d4fc
|
feat(edayun): 对接打印箱唛(真机未启用)
POST /webApi/entryInfo/v1/newPrintCaseMarkContentType → WarehouseLabel
与入库箱标(inbound().printBoxLabel)的区别:那个是运去哪风格的异步任务
(只回任务号),易达云这个同步返回 PDF 地址。
纸张码值不连续:100×100=4、100×150=2、A4=5。统一枚举 LabelSizeType 原来
只有 100×100 / 100×150 / 104×98,这次补 A4(运去哪不支持 A4,不影响它)。
统一模型的 BoxLabelCommand 没有「选哪些箱」,所以默认整单打印;
部分箱用 printCaseMarks 的 CaseSelection 重载(系统箱号 / SKU /
箱序号区间 / 客户箱号区间四选一,全空本地拒)。
madeInChina 与 separation 是易达云特有语义、统一模型没有对应概念,默认关——
猜「打」会让每箱多一行。
真机(2026-11-16):该接口在 PR 环境报「接口不存在或未启用」;
去掉 ContentType 后缀的 newPrintCaseMark 能过参数校验(缺 pageSize 报
「纸张不能为空」、缺 madeInChina 报「产地标签不能为空」),但补全后一律
「内部服务器错误」。所以映射是按文档写的,只有单测覆盖,见 TODO #68。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
5124ff85d1
|
docs(edayun): 补退货 / BOL / 物流产品 / 轨迹 / 条码的实测结论
README 新增五节,每节都包含「真机验证」小节与实际返回:
- 退货四接口:状态码表(来自列表文档)、时间窗是字符串、checkList 优先、
data=false 是仓方拒绝、详情三处文档类型不符
- BOL:与入库 BOL 的区别、11=已妥投、PR 无数据
- 物流产品:-998 是哨兵值、applicableBusiness 只能固定 1、各口径条数
- 物流轨迹:请求体是纯数组、「未匹配到轨迹」不是错误、上网/妥投时间口径
- 条码打印:与入库贴标的区别、本地提前挡的两条、四种纸张
库存一节补了真机结论:pageSize 静默截断到 500、页码越界重复返回最后一页、
safeStock 大量为 null、数字字段全是字符串。
TODO 从 37 条增到 67 条,主要新增:退货状态码表 / 行 id 缺失、BOL 状态码表、
物流产品码表与哨兵值、轨迹 eventStatus、条码 OSS 链接有效期。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
d8b3bdec55
|
feat(edayun): 对接商品条码打印
POST /webApi/skuInfo/v2/printBarcode → WarehouseLabel
与入库 SKU 贴标(inbound().printSkuLabel)不是一回事:
- 那个绑定入库计划单、14 种小纸尺寸、异步返回任务号
- 这个按任意 SKU 打、4 档纸张、同步返回 PDF 地址
纸张集合完全不重叠,所以新建 BarcodePaperSize 而不是复用 SkuLabelSizeType。
新增 core 层 BarcodePrintCapable / BarcodePrintCommand / BarcodePaperSize,
能力位 BARCODE_PRINT,门面 printBarcodes(cmd)。
本地提前挡两条(仓方对这两条的返回都是「内部服务器错误」,看不出原因):
- SKU 数 > 50(仓方提示「最多打印50个SKU」)
- 份数 <= 0
isPrintSkuName 只在 true 时下发,false 交给仓方默认。
真机(2026-11-16):ybtest + A4 拿到真实 PDF;四种纸张尺寸都 code=200。
其余实测校验:缺 productInfos →「产品信息不能为空」、缺 pageSize →
「纸张尺寸不能为空」、pageSize 非法 / num=0 →「内部服务器错误」、
SKU 不存在 →「sku=XXX信息不存在」。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 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>
|
4 days ago |
chenchuchuan
|
6ba1cb408a
|
feat(edayun): 对接物流轨迹查询
POST /webApi/track/getTrackInfoList → List<TrackEvent> / TrackingInfo
请求体是纯字符串数组 [1Z111,1Z222],没有包装对象——文档把字段名留空了,
示例 [{"": [...]}] 是自动生成的占位,真机只有纯数组能通。
「未匹配到轨迹」按空结果处理:仓方回 code=500,但对调用方来说和
「运单刚生成、还没揽收」是同一件事,抛异常会让宿主无法区分真失败与还没轨迹。
track 返回空列表,trackShipment 返回 null;其它 500 仍抛。
TrackingInfo 新增 firstOnlineAt / deliveredAt:文档说「主要关注上网时间跟妥投时间」,
这两个是带时区的字符串(GMT-04:00),而节点时间是毫秒,同一响应里口径混杂。
字符串按 timeZone 解析,解析失败留 null;认不出时区按 UTC,不猜成仓所在时区。
真机(2026-11-16):文档示例单号、出库单里的真实跟踪号、账户流水里的 20 个单号
全部「未匹配到轨迹」,PR 环境没有可查到的轨迹,映射只有单测覆盖。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
3c7ff77488
|
feat(edayun): 对接物流产品清单
POST /webApi/order/listByLogisticProductHasPerm → List<LogisticsProduct>
复用已有的 LogisticsProductCapable.products(),能力位 LOGISTICS_PRODUCT。
关键点:productId = -998 是「使用分物流规则」的哨兵值,不是真实产品,
映射时跳过——否则宿主的渠道清单里会多一个查不到的 id。
applicableBusiness 固定 1(店铺订单):统一模型不区分业务类型。
文档说 warehouseId 必填,实测不传会返回全账号的产品(162 条 vs 仓 2 的 36 条),
所以只在 providerWarehouseId 是数字时才下发。
统一模型只有编码 / 名称 / 是否跨国三个字段;易达云不回跨国标记,恒 false。
承运商类型、派单方式、面单获取方式、增值服务选项都只在 DTO 里。
真机(2026-11-16,仓 2):店铺订单 36 条、平台仓订单 23 条、退货单 35 条;
不传业务类型 37 条(含 -998);不传仓 162 条。-998 每次都出现,确认是哨兵值。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
59aec58ffa
|
feat(edayun): 对接 BOL 查询(平台仓订单)
POST /webApi/fbaOrder/v1/getOrderBolList → List<BolDocument>
与入库 BOL 不是一回事:
- inbound().bols() 是头程入库计划单的文件地址(List<String>)
- 本接口针对平台仓 / 店铺订单,带提货状态、约定/实际提货量与 POD 签收凭证
方法名用 orderBols 而不是 bols:InboundCapable 已有同参数、返回值不同的方法,
同一适配器实现两者时擦除后无法区分。
新增 core 层 BolCapable + BolDocument,门面 orderBols(providerOrderNo),
能力位 BOL。
状态码表只有 11=已妥投 是文档确认的,其余按 statusName 中文名兜底,
认不出归 UNKNOWN 并把原值留在 rawStatus。
真机(2026-11-16):FBA473182144 返回 code=200 但 bolList=null,
PR 环境没有 BOL 数据,映射目前只有单测覆盖。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
9e06b5873e
|
feat(edayun): 对接退货单创建 / 详情 / 取消 / 列表
四个接口:
- 创建退货单 POST /webApi/rma/info/v1/saveAndPublish(只支持 returnType=2 自行退回,
另三种要退货人地址或亚马逊单号,标准模型没有)
- 退货单详情 POST /webApi/rma/info/v1/getOrderDetail
- 取消退货单 POST /webApi/rma/info/v1/cancel
- 退货单列表 POST /webApi/rma/info/v1/selectRmaInfoList
统一模型侧:
- WarehouseReturnCapable.cancel 从 void 改成 boolean(返回值要能表达「仓方拒绝」),
目前只有易达云实现,改动安全
- queryReturns 签名从 (ctx, cursor) 改成 (ctx, ReturnQuery),
新增 ReturnQuery + ReturnQueryNoType(退货单号 / 出库单号 / 平台订单号)
- 门面 returns().query(ReturnQuery) / returns().cancel(providerReturnNo),
cancel 走幂等守卫
关键口径:
- 创建响应 data 就是仓侧 RMA 单号(运去哪只回 code/message)
- 取消响应 data 是布尔;code=200 + data=false 是仓方拒绝,抛异常而不是静默返回 false
- 列表时间是字符串 yyyy-MM-dd HH:mm:ss,按仓方时区解释,不是毫秒
- 列表只认单个 status,多状态本地拒绝并提示拆查询
- 详情明细优先 checkList(仓实际收到),没有才回落 skuList(买家预报)
- 状态码表来自列表文档:-1/0/1/2/3/4/5/6/7,之前只能按中文名猜
真机(2026-11-16,仓 2):列表返回 10 条 RMA,状态分布 -1/0/1/3/4/5/6 全部对上码表;
详情实测三处与文档不符——skuList.skuNum 文档标 string 实际 number、
valueAddedServices 标 number 实际字符串、picUrls 标 string 实际 JSON 数组,
DTO 已按真机类型调。创建 / 取消是写操作,未在真机执行。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
8b3fa466af
|
fix(edayun): 库存 safeStock 缺失记 -1、出库单补保价映射
库存查询真机实测(500 行采样):
- safeStock 有 430 行为 null,原实现映射成 0,与「安全库存真的是 0」无法区分。
统一模型的约定是「仓方未给时为 -1」,改成 -1 并补两个用例。
- 其余数字字段虽然文档标 number,真机全是字符串("15499"),DTO 用 Integer
由 Jackson 自动转换,无需改动。
创建出库单:
- 文档的 addService 支持 is_insurance,标准模型有 OutboundLine.insuredAmount。
任意商品行带保价即整单下发 is_insurance(addService 是订单级开关,
易达云没有行级保价)。
顺带把 EdayunAdapterTest 的能力位断言改成「只断言恒有 / 恒无的能力」,
避免每加一个接口都要改它。
测试:EdayunInventoryTest +2、EdayunOrderTest +3。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
lml
|
70ae09d7c8
|
feat(hengjian): 对接入库计划创建 /v1/inbound/createInboundPlan
- 新增 HengjianInboundCreateDtos + HengjianInboundMapper,实现
InboundCapable.create,声明 INBOUND
- 真机确认必填 orderNo / warehouseCode / inventoryType / productItems;
文档标必填的 currency 真机不校验,按选填实现
- 响应不回仓单号(只有 code/message),providerInboundId 保持 null,
不拿来源单号顶替
- 柜型按恒健的四个独立字段映射(20GP/40GP/40HQ/45HQ + 各自箱号);
认不出的柜型直接拒绝,静默丢弃等于少报柜数
- 装箱信息映射 cartonItems(尺寸 cm / 重量 g),空则不传
- 入库查询 / 分页未接,显式抛异常而非返回 null
- core InboundCommand 补 6 个恒健协议字段(documentStatus / purchaseOrderNos /
actualShipDate / goodsType / shippingCompanyName / containers),
其它仓不读,行为不变
验证:mvn test 全量通过,恒健 220 个用例(+17)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
lml
|
d126757e80
|
feat(hengjian): 对接库存查询 / 批量分页 / 库存变动流水
三个接口真机均确认存在(无 token 时返回各自的 Unauthorized 文案,
与 404 对照组可区分)。
按 SKU 查 /v1/inventory/getInventory、批量分页 /v2/inventory/get_inventory_by_page
- 恒健有两个库存接口且能力不同,统一模型只有一个 query(),按条件分流:
给 providerSkus 走按 SKU(不分页),只给 warehouseCodes 走分页
- 两个都给 → 拒绝(恒健无此接口);都不给 → 拒绝(不退化成整仓全量);
给 updatedAfter / inventoryType / includeZeroStock → 拒绝(不支持)
- 分页接口 rows 上限 500(文档明写),超过拒绝不截断
- 字段名两套:字段表写 snake_case、示例写 camelCase,DTO 用 @JsonAlias 同时接住
- data 形状两套:对象(含 content)与数组,用 JsonNode 判形状后分流
- updatedAt 缺失时报错而非填 EPOCH——快照时间是对账对齐依据
- syncStrategy = FULL_PULL_DIFF:两个接口都没有增量入参
库存变动流水 /v1/inventory/task/query
- 真机确认 skus / beginDateTime / endDateTime 必填,缺项回 MethodArgumentNotValidException
- 日期跨度按「含首尾」口径算:10-01~10-30 合法(30 天),10-01~10-31 非法
- rows 上限 100(文档明写)
- 新增 core 模型 InventoryMovement / InventoryMovementQuery / queryMovements()
- changeQty 按原值保留不转符号;单据类型与变动方向保留仓方原文不归一
- 单行缺 sku / createTime 时跳过该行而非整页失败
验证:mvn test 全量通过,恒健 203 个用例(+23)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
lml
|
73892d6052
|
feat(hengjian): 对接运费测算与地址属性识别
两个接口都在 /v2/api/shipping 下,真机均确认可用(无 token 时的
参数校验响应与 404 对照组可区分)。
运费测算 /v2/api/shipping/calculate
- 真机确认必填项是包裹四项 + 两个单位 + 收货方五项;文档标必填的
shipper* 系列实际可不传
- 单位 cm/g 与统一模型一致,不换算
- 包裹尺寸在恒健是 INTEGER,厘米值四舍五入(截断会让报价偏低)
- totalRate 取 conversionTotalRate(折算价 / 客户实付),
不取 originalTotalRate(承运商牌价)
- 恒健不按仓返回,统一结果只有一个实例,仓编码用账户仓填充
地址属性 /v2/api/shipping/addressClassification
- 新增能力位 ADDRESS_CLASSIFICATION + AddressClassificationCapable
+ core 枚举 AddressType(BUSINESS/RESIDENTIAL/MIXED/UNKNOWN)
- 真机确认 street1/zip/city/state/country 五项必填,本地先挡
- 认不出归 UNKNOWN 不猜;MIXED 在 residential() 里按住宅计
- 文档域名写的是 open-api.thebizark.com(别家),真机确认本仓域名可用
顺带修 core 缺陷:FeeEstimateQuery.logisticsServiceCode 原为构造期必填,
而恒健允许不传(由仓报全部渠道)。改为选填,并新增 hasLogisticsServiceCode();
运去哪要求必填,改为在它的 mapper 里校验,不影响既有行为。
验证:mvn test 全量通过,恒健 180 个用例(+14)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
lml
|
a4c38a4408
|
feat(warehouse): 补齐文档有而模型缺的入参,恒健已接接口全部可传
对照恒健接口文档逐个核对后,发现上一轮只修了「有字段但不生效」,
还有一批「模型里压根没字段、调用方传不进来」。这次补齐:
OutboundCommand(下单,5 项 + 附件列表)
- paidAt / pickupTime / directFulfillment / thirdPartyAccount / warehouseRemark
- warehouseRemark 与 remark 是两个字段:前者给仓作业看(恒健 warehouseRemark),
后者是客户备注(customerRemark),不能合并
- attachments: List<WarehouseAttachment>,支持 URL 与 base64 的通用附件,
与平台面单快捷入口 labelContentBase64 并存
- WarehouseAttachment 补 contentBase64(下发用;查询回来恒为 null)
OutboundQuery(列表查询,5 个维度)
- channel / channelAccount / poNo / providerOrderIds / updatedAfter+updatedBefore
- updatedAfter/Before 是独立的更新时间窗,与创建时间窗 after/before 分开——
增量同步按更新时间更准
WarehouseProduct(商品建档,2 项)
- imageUrls:产品测量图(复核长宽高),不是商品主图 imageUrl
- specialOuterPackaging:特殊外包装布尔开关,不是 packageStyle 三选一
二者原先被判为「语义不同不能顶替」直接丢弃,现在各有独立字段
恒健侧同步映射,并对不完整的附件(缺 name/type/url+base64)本地拒绝。
验证:mvn test 全量通过,恒健 166 个用例(+9)通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
lml
|
53c296c12f
|
fix(warehouse): 排序/分页/仓过滤改为可配,停止静默吞参数与静默截断
审计恒健已接接口时发现的四类问题,一并修正:
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>
|
4 days ago |
lml
|
456834ea2c
|
Merge remote-tracking branch 'origin/master'
|
4 days ago |
lml
|
1c3a99a8c6
|
feat(hengjian): 对接仓储费 / 尾程费 / 作业费三个计费明细接口
- 新增三个 DTO + HengjianFeeMapper,实现 WarehouseFeeCapable.settlements,
声明 FEE_SETTLEMENT
- 三个接口行结构不同、统一方法只有一个返回类型,因此必须由
FeeQuery.costType 指定查哪一类;不指定即拒绝,不「三个都查再合并」——
合并会让调用方误以为拿到完整账单
- VALUE_ADDED(增值服务费)恒健无对应接口,显式拒绝
- 过滤条件全空时本地拒绝(等于拉全量账单);金额缺失的行跳过而非记 0 元
- 费用类型由接口决定,不靠 settlementName 猜(作业费名形如「退货入库->入库费->…」)
- FeeQuery 补分页(pageCursor / pageSize)与 toBuilder:三个接口都是分页的,
原来返回 List 不带游标,调用方无法翻页
- 只读探针补计费用例(-Dhengjian.probe.feeType=STORAGE|LAST_MILE|OPERATION)
真机确认三个路径均存在(无 token 时返回对应的 Unauthorized 文案)。
验证:mvn test 全量通过,恒健 149 个用例 + 4 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
d3633f58ef
|
feat(edayun): 对接仓租明细 / 费用试算 / 库存查询 / 入库单
- 仓租费用明细 POST /webApi/order/cost/v1/selectUserRentDetailList
新增 FeeCapable.storageRents(),按 SKU + 计费日返回仓储费
- 费用试算 POST /webApi/estimate/v1/trial
- 库存查询 POST /webApi/userSkuStock/v1/queryInventory
- 创建 / 编辑自发入库单 POST /webApi/entryInfo/v1/saveEntrySpontaneousOrder
- 查询入库单 SKU 明细 POST /webApi/entryInfo/v1/selectEntrySkuGoodsDetail
- 抽出 EdayunQueryWindows 统一时间窗构造与校验
- 文档补充各接口实测结论与遗留问题(TODO #14-#37)
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
lml
|
62a25a9f67
|
feat(hengjian): 对接物流异动单创建 / 查询(trackingChange)
- core 新增能力位 TRACKING_CHANGE、TrackingChangeCapable、TrackingChangeCommand /
TrackingChangeOrder、TrackingChangeHandleType(召回 / 换址 / 在途异常)
- 门面新增 createTrackingChange(写操作,走幂等守卫)与 getTrackingChange
- 恒健新增两个 DTO + HengjianTrackingChangeMapper,实现 createChange / getChange
- 纠正查询路径:文档写 /v1/saleOrder/findOrder,真机 404;
实际是 /v1/trackingChange/findOrder(已写入常量与文档)
- 真机确认 orderNo 必填(文档标「否」);四项必填本地校验,
换址三项缺哪个报哪个
- 异动单受理状态与运单物流状态分两个字段保存(orderStatus / logisticsStatus),
不互相覆盖
- 修正信封:999999 是通用失败码(参数校验失败也回它),只有 message 含授权
字样时才判认证失败,避免参数错误导致宿主白刷凭据
- 探针:查询(只读)+ 创建(写,需一对真实匹配的单号与运单号)
验证:mvn test 全量通过,恒健 129 个用例 + 4 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
lml
|
5fe33db101
|
feat(hengjian): 对接订单取消 /v1/saleOrder/cancel
- 新增 HengjianCancelOrderDtos,实现 OutboundCapable.cancel
- 恒健要求 orderId + orderNo 双键必填,统一模型允许只给一个:
缺哪个先用列表接口补(详情不回 orderId),补不到则本地拒绝,
不发必然被仓方拒的取消请求
- 列表补回的结果逐条精确比对单号 / id 才用,避免近似结果取消错单
- orderId 用 Long(文档标 INTEGER,九位 id 用 int 会静默错单)
- 仓方拒绝取消抛 OutboundCancelBlockedException;认证失败不包装成不可取消
- checkCancel 把 UNKNOWN 也判 BLOCKED,认不出的状态不凭猜下写请求
- 移除已无调用方的 unsupportedOutbound 辅助方法
- 写探针补取消与取消预判用例(需 -Dhengjian.probe.cancelOrderNo)
验证:mvn test 全量通过,恒健 109 个用例 + 2 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week 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 |
chenchuchuan
|
12718ec376
|
Merge branch 'master' of http://124.222.6.97:3000/chencc/common-ecommerce
|
1 week ago |
chenchuchuan
|
fbf2363c06
|
feat(edayun): 对接查询订单费用明细
POST /webApi/order/cost/v1/selectOrderCostInfoList → List<BillingDocument>
与交易明细(accountFlow/list)是两回事:
- 交易明细 = 账户流水,带余额,金额为负表示扣费
- 订单费用 = 按订单拆的报价,带应收/折扣/实付与计费重、分区
三处关键口径:
1. **金额取实付**(realPayPrice = 应收 - 折扣)。应收只是报价,
对账要以实际发生为准。三个金额都保留在 DTO 里。
2. **一个订单展开成多条**。响应是 rows → chargeDetails → feeDetails,
按计费项展开,多条记录 documentNo 相同、靠 feeName 区分。
只有汇总没有 feeDetails 时按汇总记一条。
3. **单号类型要配合**(type: 0 订单号 / 1 平台单号 / 2 追踪号)。
统一模型新增 FeeQueryNoType 枚举与 FeeQuery.noType(),
不支持的类型显式拒绝——静默按别的口径查会让对账金额对不上。
时间窗 ≤3 个月(文档约束),无单号且无时间窗时本地拒绝。
能力接口新增 WarehouseFeeCapable.orderCosts(默认抛不支持),
门面 fees().orderCosts(query)。
顺带补 BillingDocument 里遗漏的 serialNumber() / accountBalance() getter
(上一提交只加了字段没加 getter,测试编译不过)。
测试 12 个。只跑 edayun 模块:93 个全绿;yqn / xincang 未受影响。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
lml
|
586d9c5eb8
|
feat(hengjian): 对接创建销售发货单 /v1/saleOrder/create
- 新增 HengjianCreateOrderDtos + HengjianOutboundMapper,实现 OutboundCapable.create,
声明 OUTBOUND 与 PLATFORM_LABEL_DELIVERY 能力位
- 时间按 UTC 的 yyyy-MM-dd HH:mm:ss 输出(文档明确 utc),不用仓时区——
那个时区是给仓方回传的无时区本地时间用的,方向相反
- skuAmount 取「行总额」:有 totalAmount 直接用,否则申报单价 × 数量
- isSignature 挂在行上且必填:取命令的布尔值套到每一行,成人 / 间接签收
统一映射成直接签收(1),比静默降成 0 安全
- attachInfoItems 必填:无附件发空数组;平台面单剥掉 data: 前缀后进 file
- 必填字段(地址六项 / 城市 / createdAt / 产品行)本地拒绝,不发无效请求
- 响应只回 data.orderId,拿不到即报错——取消接口同时要 orderId 与 orderNo
- 查询 / 取消 / 包裹仍显式拒绝,不返回 null;写探针增加建单用例
- 文档补建单口径与两页文档不一致处
验证:mvn test 全量通过,恒健 74 个用例 + 2 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
ad41104cc6
|
feat(edayun): 对接查询交易明细(POST /webApi/accountFlow/list)
三条与其它仓不同的口径,都做了针对性处理:
1. **同一单号的同一计费项有多条流水,不能去重**。
文档原文说明这一点,所以每条流水映射成一条 BillingDocument,
靠新增的 serialNumber()(账户流水号)区分。按单号去重会丢账。
2. **金额是 string 且可为负**。billingAmount="-0.500" 是扣费,
正数是充值 / 退费。用 BigDecimal 解析保留符号,不取绝对值。
3. **币种有两个**:accountCurrency(账户币种,优先)与 originalCurrency
(原币)。跨币种账户时两者不同,靠 exchangeRate 换算。
统一模型扩展:
- FeeQuery 新增 settledAfter / settledBefore(计费时间窗,毫秒)。
与已有的 snapshotStartDate(运去哪按仓储费快照查)语义不同,
Javadoc 写明不要互相替代。
- BillingDocument 新增 serialNumber(流水号)与 accountBalance(变动后余额)。
查询约束在本地校验:
- 没给业务单号时时间段必填,且不能超过 180 天
- pageNum / pageSize 必填,当前固定第 1 页 / 每页 200(上限)
- 超过 200 条的翻页待确认(已记 TODO)
计费项分类按 billingCode 关键字推断,认不出归 null 不猜。
测试 10 个。只跑 edayun 模块:81 个全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
274425c0e5
|
feat(edayun): 对接取消前校验与取消订单
两个接口请求体同构(orderNo / poNumber 二选一,orderNo 优先级更高):
- POST /webApi/order/v1/checkCancelStatus → CancelEligibility
- POST /webApi/order/v1/cancelOrder → CancelResult
enums/EdayunCancelStatus 按文档口径映射:
- Published → FREE(可不收费取消)
- Shipment → CHARGED(可取消但收费)
- Cancelled / InterceptSuccess / InterceptProcessing / InterceptFailure /
UnableCancel → BLOCKED
- 未知值 → BLOCKED(取消不可逆,认不出时宁可拒绝)
**文档笔误**:响应说明里 InterceptSuccess 出现两次(一次成功一次失败)。
按订单状态字典命名,失败按 InterceptFailure 处理,已在枚举 Javadoc 注明。
cancel 的 data=false 不当异常:表示仓侧拒绝,msg 带原因,回填到 rawStatus。
不做「CHARGED 必须 acceptCharge」的强制拦截——校验与取消是两次调用,
中间状态可能变化,是否继续由宿主决定。
测试 15 个(状态映射 5 + 请求响应 10)。只跑 edayun 模块:71 个全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
03f4773cb8
|
feat(edayun): 对接查询出库单与查询面单
两个接口:
- POST /webApi/order/v1/getOrderInfo → OutboundOrder
- POST /webApi/order/v1/getOrderLabel → List<PackageResult>(含 labelRef)
enums/EdayunOrderStatus:文档给了 24 个状态,按「宿主是否需要区分」折叠:
- ReadyToShip → SUBMITTED,Shipment → PICKING
- Shipped / Online / Delivered / Returns → SHIPPED(文档定义的「已发货」)
- Cancelled / InterceptSuccess → CANCELLED(文档定义的「已取消」)
- 其余 19 个异常类 → EXCEPTION,具体原因在 errorMsg / rawStatus
精确匹配不做子串:Shipment(发货中)不能因为含 Ship 就判成已发货。
adapter/EdayunOrderQueryMapper:
- 订单详情映射:poNumber→来源单号、orderNo→仓侧单号;毫秒时间戳;
SN 按 SKU 汇总;包裹 fileUrl 转附件;0/1 旗标 null 保持 null
- 面单映射:trackingNo 与 labels 按逗号位置一一对应到 PackageResult
- 地址优先取二字码(destProvince),全称兜底
适配器 get / packages 已实现;query / cancel / checkCancel 仍显式不支持。
测试 15 个(状态映射、地址口径、SN、旗标 null、多包裹对应、空面单)。
只跑 edayun 模块:56 个测试全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
lml
|
fc1753165d
|
feat(hengjian): 对接商品创建 / 编辑 /v1/product/save
- 新增 HengjianProductSaveDtos + HengjianProductMapper,声明 PRODUCT 能力位
- 保存语义:同 SKU 再调即更新,不区分 create/update;响应无 data,
status 固定 SAVED、rawStatus 取仓方 message,不编 ADDED/UPDATED
- 恒健必填项(nameEn / description / packingType / 外箱四项 / packedQty)
在本地拒绝,缺项一个请求都不发
- 三组尺寸(产品 / 单品 / 外箱)各归各位,不做回退填充
- 不发送恒健没有语义对应的字段:imageUrl(恒健是测量图)、packageStyle、
SN / 批次 / HS / 原产国 / 链接 / 客退 / 品类
- 新增写探针(默认跳过,另需 -Dhengjian.probe.write=true)验证保存幂等
- 文档补商品保存的字段口径与本地校验清单
验证:mvn test 全量通过,恒健 48 个用例 + 2 个探针跳过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
15605b58db
|
feat(edayun): 对接创建出库单(POST /webApi/order/v1/createOrder)
- dto/EdayunCreateOrderDtos:按文档建模,含地址 / 商品行 / 增值服务附件 /
打包数据 / 卡车约车等子结构
- adapter/EdayunOrderMapper:字段映射
- adapter/EdayunAdapter:实现 create,声明 OUTBOUND 能力位
(get/query/cancel/packages 显式抛不支持,文档还没给)
四处容易错的口径:
1. 幂等键是 poNumber。文档要求「取消重推时平台单号保持不变」,
映射自 orderRef,缺失时退回 outboundRequestNo,不能为 null。
2. promiseShipTime 是毫秒时间戳,不是秒。
3. destProvinceName 要州全称(California),不是二字码(CA)。
当前原样透传,调用方需自己给全称——映射表待业务确认。
4. 面单要文件 URL,不是 base64。传 base64 在本地就拒绝,
提示先上传拿 URL,避免发出去被仓方以「不可访问」拒绝。
另:unitPrice 是单价,直接取 declareValue 不乘数量(与运去哪的 skuAmount
总额口径相反);signatureRequired 映射到 addService 的 is_signature。
测试 11 个。edayun 模块 40 个测试全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
lml
|
c5d9c768a9
|
refactor(xincang): 按接口拆分 DTO,XincangDtos 拆成 16 个文件
XincangDtos 单文件 1601 行、40 个内嵌类、覆盖 14 个接口,超出
onboarding-checklist「一个接口一个文件」的约定。按接口切成 16 个文件,
最大的 XincangForecastDetailDtos 约 220 行。
- Attachment 归到 XincangUploadDtos(upload.files 返回的对象,转运 /
商品原样回传),跨文件引用用 XincangUploadDtos.Attachment 限定
- UploadResponse / UploadData 保留(此前无调用方,按约定留作已定义未接入)
- 字段、@JsonProperty、@JsonInclude / @JsonIgnoreProperties 原样搬移,
序列化行为不变
- 4 处 mapper 的 javadoc 引用改为新类名;README 的 dto 目录说明同步
验证:mvn test 全量通过(信仓 118 个用例 + 3 个探针跳过)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
c96b43faed
|
feat(edayun): 对接创建产品(POST /webApi/skuInfo/v1/createProduct)
- dto/EdayunCreateProductDtos:按文档建模,含组合产品 / 证书 / 图片 /
申报 / 批次等子结构;字段名是驼峰(与 token 接口的下划线风格不同)
- enums/EdayunYesNo:0 是 / 1 否 的统一封装。这个口径与直觉相反,
单独成枚举避免各处手写 x ? 0 : 1 把方向写反
- enums/EdayunDeclarationType:出口 / 进口(文档未给码值,按示例推断 0/1)
- adapter/EdayunProductMapper:g → kg 换算;反向标志统一走 EdayunYesNo;
申报信息按「出口=原产国 + 进口=US」组两条,缺值时整组不下发
- adapter/EdayunAdapter:实现 createOrUpdate,声明 PRODUCT 能力位
- 请求头从单独的小写 token 改为文档写的 Authorization: Bearer <token>
(实测两者都接受,以文档为准)
测试 9 个:字段映射、g→kg、brandFlag 反向、默认不带电、序列号与批次标志、
申报信息缺值不下发、图片、枚举码值、能力位。
探针 EdayunCreateProductProbeTest:默认 dry-run 只打印报文,真跑需
-Dedayun.probe.write=true,且用 PROBE- 前缀的随机 SKU 避免撞车。
全量 544 个测试通过。
Co-Authored-By: Claude <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 |
chenchuchuan
|
5962988f86
|
feat(edayun): token 接口真机验证通过,按实际报文修正解析
真机调用(PR 环境):
POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
{"client_id":"openapi-test","client_secret":"123456"}
→ HTTP 200 {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
文档与实际不符的两处,已按实测调整:
1. 响应是**扁平结构**,没有 code、没有 data 包裹。
原来强制要求 code,会把成功当失败。改为:缺 code 不算失败,
交给「有没有 access_token」判断;显式给了非 200 的 code 才判失败。
2. 响应**没有有效期字段**(文档说「永久,建议留窗口刷新」),也没有
refresh_token。expiresAt 改为明确的估算值语义:让 TokenManager 定期
重登一次,不是真的到期。
DTO 补了顶层 access_token / token_type / scope,data 保留为兼容分支。
探针 EdayunTokenProbeTest 实跑结果:token 取到(脱敏输出)、
tokenType=bearer、剩 7200 秒、refreshToken=null。
测试 13 个(新增 acceptsFlatShapeWithoutCode 固化实测形态;
missingCodeIsRejected 改为 missingCodeWithoutTokenIsRejected,
报「no access token」而不是「no code」)。
全量 535 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
c07d848628
|
feat(edayun): 补测试环境基址 + 免签请求重载 + token 探针
- EdayunConstants.PR_BASE_URL 填成
https://test.omniselling.com.cn/saas-service/openapi/microService
- HEADER_TOKEN 的 Javadoc 写明「仅业务接口使用」:POST /oauth/token 本身不带
这个头,文档里那行是全局头定义,不是该接口的参数(已确认)
- EdayunRequestFactory.businessUnsigned(...):测试环境可直接把
openApiAdminSecret 当 sign 传,不必算 MD5;生产走带 appSecret 的重载
新增 EdayunTokenProbeTest(默认跳过):
- probeToken:真实调用 /oauth/token,打印 token 脱敏、tokenType、过期时刻、
剩余秒数、是否带 refreshToken;异常只打印不抛出
- probeSignatureShape:不联网,核对 MD5(body + "." + appSecret) 形态
凭据一律走系统属性,不入库:
-Dedayun.probe.clientId / clientSecret / appSecret
全量测试仍绿(533)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
e522c08377
|
feat(edayun): 对接获取 token(POST /oauth/token)
按文档实现鉴权第一段:
- auth/EdayunTokenClient:POST /oauth/token,body 用 client_id / client_secret
(下划线风格照文档),无业务请求头
- http/EdayunRequestFactory:构造 token 请求;另备了业务请求构造(token / appKey /
timestamp / sign 四个头)与 sign() = MD5(body + "." + appSecret)
- adapter/EdayunAdapter.token(ctx):走 TokenManager 缓存,按 appKey + clientId 维度
- 工厂构造函数接收 TokenStore / LockProvider / Clock,与信仓同构
**文档只给了 code 取值(200/500/503/504),没给响应体结构**,所以做了兼容:
优先 data.access_token + data.expires_in,其次 data.expiry(绝对时刻),
再其次顶层 token;都没有则失败并带出截断的原始报文,不猜。
有效期同样三级兜底,最后按 2 小时(常量里标了「待联调确认」)。
错误分级:
- 500 明确失败,不重试
- 503 网关无效 / 504 超时,标记 retryable
- HTTP 非 2xx 单独处理,5xx(除 504)可重试
测试 12 个:请求形状、三种响应形态、无 token、500 不可重试、
503/504 可重试、缺 code、非 2xx、凭据缺失不发请求、MD5 签名(独立实现对照)、
空 body 签名。
全量 533 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
8d76933a8d
|
Merge branch 'feature/supplier-lingxing' of http://124.222.6.97:3000/chencc/common-ecommerce into feature/supplier-lingxing
|
1 week ago |
lml
|
85e1fed8d4
|
docs(warehouse): 新增信仓接入汇总文档
参照 docs-warehouse/yqn/README.md 的结构,补一份信仓的:
- 基本信息:测试端点、query token 鉴权、2h 无 refresh、客户级 token、
成功判定(errno + rst.code)、北京时间、英寸/磅/美元
- 接口清单:19 个已对接接口与能力位,另列 3 个已声明常量但未接入的
- 业务流程:出库 / 转运 / 头程预报 / 商品四条链路的分步说明
- 枚举映射:订单 12 码、转运 8 码、预报 10 码、order_type 两套字典
并标注转运「列表与详情码表不一致」的差异
- 字段口径:ckh 唯一、amount 必填美元、po / rfc_sku_count 兜底规则、
is_pallet 必填、库存单仓限制等 13 条
- 平台限制与协议待核对:生产域名缺失、限流未公开、
calculate_order_v3 的 GET + JSON body 与 OkHttp 冲突
- 联调探针:三个探针的运行命令与全部可选属性,标明哪些会留数据
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
lml
|
6df61b8efc
|
Merge remote-tracking branch 'origin/feature/supplier-lingxing' into feature/supplier-lingxing
# Conflicts:
# warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/WarehouseProduct.java
# warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/InboundOrder.java
# warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/OutboundOrder.java
# warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/TransferOrder.java
# warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnInboundMapper.java
# warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnProductMapper.java
# warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnTransferMapper.java
|
1 week ago |
chenchuchuan
|
ae25e73b50
|
feat(edayun): 新建易达云适配器骨架
按 docs-warehouse/onboarding-checklist.md 阶段 1 搭好模块:
- warehouse-sdk-edayun:pom、注册到根 modules
- EdayunConstants:端点 / 限流(带 TODO 占位,等文档)
- EdayunAdapter / EdayunAdapterFactory:类型就绪,能力位为空
- dto / enums / http / webhook 四个包的 package-info 写明约定,
后续按约定往里填
骨架阶段的行为:任何业务调用抛 WarehouseUnsupportedCapabilityException。
未实现的能力不声明——声明了就必须有实现,否则调用方看能力位会以为能用。
测试 EdayunAdapterTest(5 个):适配器标识、能力位为空、注册后可解析、
未实现能力显式拒绝、能力查询不触发真实 API。
文档 docs-warehouse/edayun/README.md 记了当前状态和 8 项待确认
(文档、测试环境、鉴权、限流、能否走写、回调、费用口径、库存同步)。
全量 510 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
a82379cc07
|
docs: 接入清单补充「出入参怎么处理」和「枚举怎么处理」
两节详述,都是这段时间实际踩出来的规则:
出入参(阶段 2.5):
- 三层各管什么:DTO 只反序列化、Mapper 做换算与映射、标准模型不认识任何仓
- 入参四种情况分别怎么处理(直搬 / 换算 / 码值映射 / 平台没有)
- 出参必做四件事:rawStatus 必填、sourceProvider 必填、认不出归 UNKNOWN、
平台没给的不伪造
- 平台有模型没有 / 模型有平台没有 分别怎么标注
- 子结构别图省事重复建(退货 Attachment 合并的教训)
枚举(阶段 2.6):
- 为什么必须两层(只放 core 会认识仓方码,只放适配器宿主没法统一 switch)
- 底层枚举规则:code 步长 10、UNKNOWN 固定 0、只追加不合并、不含仓方码
- 平台枚举规则:精确匹配不用 contains、未知归 UNKNOWN、容器类型按原样、
提供反向 codeOf
- 三套码表不能混(运去哪退货三套)
- 状态码依赖上下文时把 (type, status) 一起带出去
- 什么时候不建枚举(>50 个透传、按中文名归类、只展示用)
- 枚举测试必须覆盖什么(全量映射 / 未知兜底 / 精度陷阱)
文档索引同步更新。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |