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.
5.9 KiB
5.9 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 能否作为幂等键 |
当前未用作主键 | 重复拉取去重 |
| 14 | 仓租明细的 rentDays / totalStock 语义(累计值还是当日值) |
未使用,只落金额 | 宿主想按天分摊成本时需要 |
| 15 | 仓租 total 是「总行数」还是「总页数」 |
不用它当终止条件,只看本页是否满 200 条 | 无(已规避) |
| 16 | 仓租 3 个月窗口在 20 页(4000 条)内是否够用 | 超出显式失败 | 大仓对账可能需缩窗 |
| 17 | PR 环境没有仓租数据(2025-01~2026-12 全空) | 映射只有单测覆盖 | 需仓方造数据才能真机验证 |
| 18 | 3 个月阈值的确切规则(同天数不同起点结果不同) | 本地只挡 >4 个月,其余交仓方判定 | 无(已规避) |
| 19 | 订单费用明细只给单号、不给时间窗会报「计费时间必填」 | 本地仍允许单号查询(会让仓方报错);是否改成必须给时间窗待定 | 按单号查费用会失败 |
| 20 | 费用预算的 preferentialEstimatedPrice(实测 0.000)语义 |
未使用 | 有优惠时可能少算 |
| 21 | 费用试算首次调用常 Read timed out executing POST http://eda-tms/... |
探针读超时 120 秒 | 宿主需允许重试 |
| 22 | 货物类型 estimatedGoodsType 目前固定 GENERAL_CARGO |
标准模型没有带电信息 | 带电货预估不准 |
| 23 | 虚拟包裹预估在 PR 环境「内部服务器错误」 | 不实现 | 无(暂不需要) |
| 24 | 库存 nonSaleStock(不可售)在统一模型无独立字段 |
整行按可售落,不可售数量丢弃 | 想对账不可售库存时需扩展 InventorySnapshot |
| 25 | 库存响应没有更新时间,asOfUtc 只能取本地时钟 |
用调用方注入的 clock | 快照时间与仓侧实际变动时间有偏差 |
| 26 | 库存 total 是否确为总行数(文档写「响应数据总数」) |
按总行数用,缺失时退回满页判断 | 真机跑一次即可确认 |
| 27 | selectEntrySkuGoodsDetail |
get() / query() 按 entryCode 查 |
只能拿 SKU 级数据,单头 / 时间 / 箱明细仍缺 |
| 28 | 入库状态是否有回调 | 未接 | 目前靠轮询 SKU 明细 |
| 29 | 自发入库单的 shippingProductId(入库物流产品 id) |
不下发 | 发布时仓方可能报缺物流产品 |
| 30 | 快递类必填的 shipCompany / waybill |
不下发,标准模型无字段 | 快递类入库单发布不了 |
| 31 | estimatedDepartureTime 用 predictionShipDate 是否口径正确 |
按「预计发运日 = 预计离港」映射 | 卡车类可能对不上 |
| 32 | 头程拖车 / 报关 / 清关 / 海外拖车四组服务块 | 不下发 | 这些服务范围的入库单发布不了 |
| 33 | intShippingMethod / cabinetType / logisticsType 的码值字典 |
透传 transportType / cabinetType |
传错码仓方会拒绝 |
| 34 | 入库 SKU 状态码表:只确认了 4=已上架 |
其余按 statusName 中文名兜底 |
中文名变化会让状态判错 |
| 35 | 入库明细接口不回仓库 / 创建时间 / 到仓时间 / 箱号 | 仓库用 OMS 配置;时间与箱明细为 null | 拿不到完整单据,需要 entryInfo 单头查询接口 |
| 36 | 是否有入库单列表 / 时间窗查询 | query() 的 cursor 当 entryCode 用 |
无法做增量同步,只能按单号轮询 |
| 37 | forecastWeight / weight 是克、firstWeight 是千克 |
未映射(统一模型没有行级重量) | 想按箱对账重量时需要 |
待业务确认
| # | 问题 | 当前处理 | 影响 |
|---|---|---|---|
| 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,需换算) |