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.

41 lines
2.5 KiB

# 易达云:待确认事项
接入过程中发现、需要业务或仓方确认的点。**先记下来,不阻塞接口对接。**
## 待仓方确认
| # | 问题 | 当前处理 | 影响 |
|---|---|---|---|
| 1 | **创建产品是否需要 `declarationInfoList` 的进口国** | 默认 `US` | 申报准确性 |
| 2 | `declarationType` 码值(0 出口 / 1 进口) | 按示例推断 | 申报方向可能反 |
| 3 | 业务接口能否用 `openApiAdminSecret` 免签 | 当前一律用 `appSecret` 算 MD5 | 若只有 token 接口免签,现在是正确的 |
| 4 | 创建产品同 SKU 重复调用的行为 | 按「创建」语义处理,无更新接口 | 重复建档会报错 |
| 5 | 出库单 `getOrderInfo` 的 `carrierInfoList` 是否总与追踪号一一对应 | 按数组原样映射 | 多包裹场景 |
| 11 | 交易明细超过 200 条时如何翻页 | 当前只取第一页 | 大账户对账会漏 |
| 12 | `billingCode` 有没有完整字典(现在按关键字推断) | 认不出归 null | 费用分类准确度 |
| 13 | 订单费用明细的 `billingId` 能否作为幂等键 | 当前未用作主键 | 重复拉取去重 |
## 待业务确认
| # | 问题 | 当前处理 | 影响 |
|---|---|---|---|
| 6 | **派送地址的州要全称(California)还是二字码(CA)** | 原样透传 | 所有出库单地址 |
| 7 | 统一模型缺的字段:带电 / 包材 / 物流包装 | 创建产品里硬编码为「不带」 | 带电商品无法正确申报 |
| 8 | 保价服务(`is_insurance`) | 未下发,标准模型无字段 | 保价订单 |
| 9 | `OutboundCommand` 没有 `carrierProductId`(易达云物流产品 id) | 未下发,走仓方默认分物流规则 | 指定物流产品 |
| 10 | `channelName` 从 `Platform` 枚举推(AMAZON_SC → Amazon) | 首段大写 | 非标准平台名可能对不上 |
## 已确认(不需要再问)
| 项 | 结论 |
|---|---|
| 测试基址 | `https://test.omniselling.com.cn/saas-service/openapi/microService` |
| 测试账号 | `openapi-test` / `123456` |
| token 接口响应 | 扁平结构,无 `code`,无有效期,`token_type=bearer` |
| token 请求头 | `POST /oauth/token` **不带** `token` 头 |
| 业务请求头 | `Authorization: Bearer <token>` + `appKey` + `timestamp` + `sign` |
| 签名算法 | `MD5(body + "." + appSecret)`,小写十六进制 |
| 时间戳单位 | 毫秒,5 分钟内有效 |
| 布尔标志 | **0 是 / 1 否**(与直觉相反) |
| 重量单位 | kg(我们的是 g,需换算) |