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.
2.1 KiB
2.1 KiB
易达云:待确认事项
接入过程中发现、需要业务或仓方确认的点。先记下来,不阻塞接口对接。
待仓方确认
| # | 问题 | 当前处理 | 影响 |
|---|---|---|---|
| 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 <token> + appKey + timestamp + sign |
| 签名算法 | MD5(body + "." + appSecret),小写十六进制 |
| 时间戳单位 | 毫秒,5 分钟内有效 |
| 布尔标志 | 0 是 / 1 否(与直觉相反) |
| 重量单位 | kg(我们的是 g,需换算) |