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.

4.6 KiB

易达云(EDAYUN)接入

当前状态:骨架

项 状态
模块 ✅ warehouse-sdk-edayun 已建、已注册
适配器 / 工厂 ✅ 类型就绪,能力位为空
获取 token ✅ 已对接(POST /oauth/token)
业务接口 ⬜ 等文档
回调 ⬜ 等文档
真机验证 ⬜ 等测试环境

骨架阶段的行为:任何业务调用都会抛 WarehouseUnsupportedCapabilityException——这是有意为之,不返回空集合。

鉴权(已确认部分)

① POST /oauth/token
     body: { "client_id": "OMS授权用户名", "client_secret": "密码" }
     无业务请求头
     → 返回 token

② 业务请求头
     token      来自 ①
     appKey     测试: 7289ded35b198243883151876eaf3213
     timestamp  毫秒,5 分钟内有效
     sign       MD5(body + "." + appSecret),测试环境可传 openApiAdminSecret 免签

凭据映射(复用 ChannelSecret):

易达云 ChannelSecret
appKey(请求头) appKey()
appSecret(签名用) appSecret()
client_id(换 token) clientId()
client_secret(换 token) clientSecret()

代码位置:

类 职责
auth/EdayunTokenClient 换 token,兼容三种响应形态,按 code 区分可重试
http/EdayunRequestFactory 构造 token 请求与业务请求;sign() 算 MD5
adapter/EdayunAdapter.token(ctx) 走 TokenManager 缓存(按 appKey + clientId 维度)

真机验证(2026-11-12,PR 环境):

POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
Content-Type: application/json
{"client_id":"openapi-test","client_secret":"123456"}

→ HTTP 200
{"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
之前不确定的 实测结论
响应体结构 扁平结构,没有 code、没有 data 包裹
业务码 不返回 code;HTTP 200 + 有 access_token 即成功
有效期 响应里没有有效期字段(文档说「永久,建议留窗口刷新」)
refreshToken 不返回

因此实现调整为:

  • 缺 code 不算失败,交给「有没有 access_token」判断
  • expiresAt 是估算值(按 2 小时兜底),作用只是让 TokenManager 定期重登一次,不是真的到期
  • 兼容分支(data.access_token / 顶层 token)保留,生产确认后可删

待确认(问易达云)

# 要确认
1 业务接口文档(含回调)
2 测试环境:域名、OMS 授权账号、测试仓、测试 SKU
3 token 响应的实际 body 结构与有效期
4 限流:每秒许可数、单日配额
5 能否在 PR 环境走写操作(建单 / 取消 / 销毁),决定探针设计
6 回调:验签算法、时间戳单位、响应体格式、是否按路径区分
7 费用口径:是否有费用类型码(运去哪只有中文名)
8 库存同步:支持按时间增量还是只能全量

骨架已定的部分

warehouse-sdk-edayun/
├── pom.xml
└── src/main/java/common/ecommerce/edayun/
    ├── EdayunConstants.java          端点 / 路径 / 限流(带 TODO 占位)
    ├── adapter/
    │   ├── EdayunAdapter.java        能力位为空,未实现能力不声明
    │   └── EdayunAdapterFactory.java
    ├── dto/package-info.java         一个接口一个文件
    ├── enums/package-info.java       平台枚举约定
    ├── http/package-info.java        信封校验约定
    └── webhook/package-info.java     回调约定

测试:EdayunAdapterTest(5 个)验证类型接对、能力位为空、 未实现能力显式拒绝、注册后可解析、能力查询不触发真实 API。

接下来怎么推进

按 onboarding-checklist.md:

  1. 拿到文档后补 EdayunConstants 的路径常量
  2. 按接口逐个补 dto/ + adapter/XxxMapper + enums/(阶段 2 的 6 步)
  3. 写只读探针 → 真机验证 → 全链路探针
  4. 补回调实现
  5. 更新本文档

已知的坑(从运去哪/信仓带来的经验)

坑 应对
文档参数名可能带 query. 前缀而实际不带 真机验证时必须核对
有些接口没有 code 只有 status 信封校验要兼容两种
文档示例常是自动生成的占位符 不看示例值,看真机返回
单位可能未标注 真机验证量级(kg vs lb 差 2.2 倍)
状态码可能依赖上下文(单据类型) (type, status) 一起带出去