# 易达云:待确认事项 接入过程中发现、需要业务或仓方确认的点。**先记下来,不阻塞接口对接。** ## 待仓方确认 | # | 问题 | 当前处理 | 影响 | |---|---|---|---| | 1 | **创建产品是否需要 `declarationInfoList` 的进口国** | 默认 `US` | 申报准确性 | | 2 | `declarationType` 码值(0 出口 / 1 进口) | 按示例推断 | 申报方向可能反 | | 3 | 业务接口能否用 `openApiAdminSecret` 免签 | 当前一律用 `appSecret` 算 MD5 | 若只有 token 接口免签,现在是正确的 | | 4 | 创建产品同 SKU 重复调用的行为 | 按「创建」语义处理,无更新接口 | 重复建档会报错 | | 5 | 出库单 `getOrderInfo` 的 `carrierInfoList` 是否总与追踪号一一对应 | 按数组原样映射 | 多包裹场景 | ## 待业务确认 | # | 问题 | 当前处理 | 影响 | |---|---|---|---| | 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 ` + `appKey` + `timestamp` + `sign` | | 签名算法 | `MD5(body + "." + appSecret)`,小写十六进制 | | 时间戳单位 | 毫秒,5 分钟内有效 | | 布尔标志 | **0 是 / 1 否**(与直觉相反) | | 重量单位 | kg(我们的是 g,需换算) |