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.3 KiB

易达云:待确认事项

接入过程中发现、需要业务或仓方确认的点。先记下来,不阻塞接口对接。

待仓方确认

# 问题 当前处理 影响
1 创建产品是否需要 declarationInfoList 的进口国 默认 US 申报准确性
2 declarationType 码值(0 出口 / 1 进口) 按示例推断 申报方向可能反
3 业务接口能否用 openApiAdminSecret 免签 当前一律用 appSecret 算 MD5 若只有 token 接口免签,现在是正确的
4 创建产品同 SKU 重复调用的行为 按「创建」语义处理,无更新接口 重复建档会报错
5 出库单 getOrderInfo 的 carrierInfoList 是否总与追踪号一一对应 按数组原样映射 多包裹场景
11 交易明细超过 200 条时如何翻页 当前只取第一页 大账户对账会漏
12 billingCode 有没有完整字典(现在按关键字推断) 认不出归 null 费用分类准确度

待业务确认

# 问题 当前处理 影响
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,需换算)