chenchuchuan
|
dc4db1c208
|
refactor: 连接配置收敛到 SecretProvider,调用点只传身份
调用方不再每次构造 ChannelConnection 传地址和密钥,改为:
- 账户只保留业务字段(warehouseCode / provider / providerWarehouseId / credentialRef)
- 密钥与地址由 SecretProvider 按 credentialRef 统一提供
- 门面新增免连接重载:sdk.warehouses(code)、sdk.salesOrders(key) 等
主要改动:
- ChannelSecret 承接 endpointBaseUrl / auxEndpointBaseUrl,与密钥一起配置
- WarehouseAccount 删除 timeZone / endpointBaseUrl / auxEndpointBaseUrl
- ChannelAccount 增加 endpointBaseUrl
- PlatformAdapter / WarehouseAdapter 新增 defaultEndpointBaseUrl(),适配器提供内置默认地址
(运去哪 / 信仓 / 恒健 / 领星取生产地址;易达云生产地址未定,返回 null)
- WarehouseConnection 不再无条件覆盖凭据里的地址,凭据已有地址时优先采用
- 两个门面的 Builder 新增 secretProvider(...),未注入时仍可用带连接的老入口
- 旧签名(带 connection)全部保留,向后兼容
适配器内部未改动:它们只消费 ctx.secret() / ctx.endpointBaseUrl(),
来源由调用方传入改为门面装配。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 days ago |
chenchuchuan
|
5bbfb33261
|
docs: 写清 SKU 口径——建档下发的那串,之后全程用它
核心结论(代码注释 + 文档都补上):
- 建档时 skuOf() = providerSku 优先,为空才回退 omsSku
易达云写到 skuCode 字段、运去哪写到 sku 字段
- 仓方一旦落库,之后 查商品 / 下单 / 查库存 都必须传同一串
- 所以「仓侧 SKU」不一定等于 OMS SKU:
给了 providerSku(如 AP0000X9US0010601)则两者不同;没给则同名
- SDK 不做 OMS→仓侧转换(映射表在宿主手里,静默转换会静默查空)
补注释的位置:
- WarehouseProduct.providerSku 字段与 getter
- ProductQuery.providerSkus / InventoryQuery.providerSkus
- YqnProductMapper.skuOf / EdayunProductMapper.skuOf(含真机证据说明)
- 两个适配器的商品查询方法 javadoc
- YqnOutboundMapper / EdayunOrderMapper 的出库行 SKU 赋值处
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
b5e94c1157
|
feat: 运去哪 / 易达云 商品查询接口
统一模型新增:
- ProductQuery:providerSkus(仓侧 SKU)/ barcode / 创建时间窗 / 分页,
单次上限 100 个 SKU
- ProductInfo:查询结果(仓侧 SKU、条码、尺寸重量、装箱、状态、创建时间)
- WarehouseProductCapable.query(...) 默认抛不支持;门面 queryProducts(ProductQuery)
运去哪(API 113 /v1/product/findPage):
- **页码从 0 开始**(文档原文),游标即页码、不做 ±1 换算
- 单页上限 100、skuList 上限 100
- 该接口没有条码 / 时间窗过滤,传了本地拒绝
- 翻页优先 last,其次 number+1 < totalPages,最后按满页兜底
- cost 没有 currency 时不成 Money(避免丢单位)
易达云(/webApi/skuInfo/v1/listProductPage):
- skuCode 是逗号拼接的单个字符串,一次最多 50 个,超了本地拒绝
- 页码从 1 开始、单页上限 200
- 尺寸取**实际值**,缺失才回落 forecast*(真机 ybtest:实际 55 vs 预报 10,差 5 倍)
- 「查询无数据」按空页处理,不抛异常(与轨迹接口同口径)
- 查询条件全空时仓方默认查最近一个月,本地不补默认值
真机验证(2026-11-17):
- 易达云:不带时间窗 total=52244;skuCode=ybtest 命中 1 行;
30 天窗口 + 2021 年建的 SKU → 「查询无数据」;10 年窗口正常命中
- 运去哪:未提供 x-api-key,只做了离线单测
SKU 口径已确认并写入文档:两边都传仓侧 SKU(建档下发的 providerSku,
为空时才是 omsSku),SDK 不做 OMS→仓侧转换。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
7629a52ab8
|
fix(edayun): 修 CR 发现的三个真 bug 与若干语义问题
Critical:
1. EdayunRmaListMapper 静默丢弃调用方的仓库过滤——账户绑了数字仓 id 时,
传入不同的 warehouseCode 会被忽略,结果反而变宽。改为冲突时本地拒绝。
2. EdayunTrackMapper 把 track.receiver(收件人)映射到 signedBy(签收人),
导致每个在途包裹都被判成已签收。易达云响应没有签收人字段,改为不填。
3. 退货详情 / 列表用 warehouseName(美西1仓)当 warehouseCode,宿主拿它
equals / 回传查询会全线失效。改为只用仓编码,缺失直接回退 OMS 仓编码。
Important:
4. EdayunReturnMapper 静默丢弃 returnReason / estimatedReceiveDate /
lineName——三个字段易达云都不支持,改为本地拒绝并说明原因。
5. WarehouseDirectoryCapable.carrierDirectory 默认实现把 carriers() 的码
包装成假的两层结构(carrierId == nameEn == FEDEX-G),改成默认抛不支持。
6. EdayunAdapter.printSkuLabel 改包级可见:SKU_LABEL 未声明,门面够不到,
留 public 会让调用方误以为能用。
7. products(warehouseCode) 之前完全忽略入参;改为显式优先,且必须数字。
8. 删掉 EdayunCarrierTest.warehousesAreUnsupported——它断言的是相反行为,
能过只是因为没注册路由。
9. EdayunAdapter 类注释还写着「已实现:商品建档、创建出库单」。
Minor:EdayunAdapterFactory 重复 import、CaseMarkPrintCapable javadoc 写的
BARCODE_PRINT 不存在、TODO.md 表格分隔行丢失、EdayunInventoryTest 合并残留
换行错乱。
新增回归用例:仓库过滤冲突 / 一致、三个不支持字段被拒。
验证:全仓 mvn test 通过;易达云 304 个用例全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
8dabf9fb1b
|
test(edayun): 补 SDK 装配链路冒烟(离线,按业务场景)
从门面 WarehouseSdk 走一遍,覆盖:
- 装配:能力位全量断言(12 个已声明 + 3 个必须为假)、工厂能建出适配器
- 场景 1 主数据:仓库 / 承运商 / 物流产品(-998 已跳过)
- 场景 2 发货:试算 → 建单 → 查单 → 面单 → 取消前校验 → 取消,
外加建单幂等(同一 outboundRequestNo 只打一次仓方)
- 场景 3 库存:safeStock 缺失映射为 -1
- 场景 4 退货:建单 → 详情 → 列表 → 取消
- 场景 5 单据 / 轨迹 / 打印:BOL、节点与运单级轨迹(上网/妥投时间)、
箱唛、入库单
- 未实现能力(调拨 / 退货检验后处理)必须抛,不返回空
不联网:用 RecordingTransport + 真实报文样本。适配器直接注册(传输层可替换),
另用一例单独验证工厂路径能 build 出适配器。
验证:9 个用例全绿;全仓 mvn test 通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
5dce79ea32
|
fix(edayun): 修正 SKU 标端点路径(去掉 ContentType 后缀)
正确路径是 /webApi/entryInfo/v1/newPrintCaseMark,之前按文档写成了
newPrintCaseMarkContentType,PR 环境一直报「接口不存在或未启用」,
被误判成「真机未启用」。
改路径后重测:接口存在且能过参数校验(缺 pageSize 报「纸张不能为空」、
缺 madeInChina 报「产地标签不能为空」),但补全后一律「内部服务器错误」,
试过 6 种 pageSize、madeInChina 0/1、separation、箱序号区间、skuCode、
caseCodeList、甚至不存在的 entryCode,返回都一样——说明是仓方内部异常,
不是我们的参数问题。因此仍然只有单测覆盖,TODO #68 保留。
Co-Authored-By: Claude <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 |
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
|
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 |
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 |
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>
|
5 days 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 |
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 |
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 |
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 |
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
|
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 |