chenchuchuan
|
5124ff85d1
|
docs(edayun): 补退货 / BOL / 物流产品 / 轨迹 / 条码的实测结论
README 新增五节,每节都包含「真机验证」小节与实际返回:
- 退货四接口:状态码表(来自列表文档)、时间窗是字符串、checkList 优先、
data=false 是仓方拒绝、详情三处文档类型不符
- BOL:与入库 BOL 的区别、11=已妥投、PR 无数据
- 物流产品:-998 是哨兵值、applicableBusiness 只能固定 1、各口径条数
- 物流轨迹:请求体是纯数组、「未匹配到轨迹」不是错误、上网/妥投时间口径
- 条码打印:与入库贴标的区别、本地提前挡的两条、四种纸张
库存一节补了真机结论:pageSize 静默截断到 500、页码越界重复返回最后一页、
safeStock 大量为 null、数字字段全是字符串。
TODO 从 37 条增到 67 条,主要新增:退货状态码表 / 行 id 缺失、BOL 状态码表、
物流产品码表与哨兵值、轨迹 eventStatus、条码 OSS 链接有效期。
Co-Authored-By: Claude <noreply@anthropic.com>
|
4 days ago |
chenchuchuan
|
d3633f58ef
|
feat(edayun): 对接仓租明细 / 费用试算 / 库存查询 / 入库单
- 仓租费用明细 POST /webApi/order/cost/v1/selectUserRentDetailList
新增 FeeCapable.storageRents(),按 SKU + 计费日返回仓储费
- 费用试算 POST /webApi/estimate/v1/trial
- 库存查询 POST /webApi/userSkuStock/v1/queryInventory
- 创建 / 编辑自发入库单 POST /webApi/entryInfo/v1/saveEntrySpontaneousOrder
- 查询入库单 SKU 明细 POST /webApi/entryInfo/v1/selectEntrySkuGoodsDetail
- 抽出 EdayunQueryWindows 统一时间窗构造与校验
- 文档补充各接口实测结论与遗留问题(TODO #14-#37)
Co-Authored-By: Claude <noreply@anthropic.com>
|
5 days ago |
chenchuchuan
|
fbf2363c06
|
feat(edayun): 对接查询订单费用明细
POST /webApi/order/cost/v1/selectOrderCostInfoList → List<BillingDocument>
与交易明细(accountFlow/list)是两回事:
- 交易明细 = 账户流水,带余额,金额为负表示扣费
- 订单费用 = 按订单拆的报价,带应收/折扣/实付与计费重、分区
三处关键口径:
1. **金额取实付**(realPayPrice = 应收 - 折扣)。应收只是报价,
对账要以实际发生为准。三个金额都保留在 DTO 里。
2. **一个订单展开成多条**。响应是 rows → chargeDetails → feeDetails,
按计费项展开,多条记录 documentNo 相同、靠 feeName 区分。
只有汇总没有 feeDetails 时按汇总记一条。
3. **单号类型要配合**(type: 0 订单号 / 1 平台单号 / 2 追踪号)。
统一模型新增 FeeQueryNoType 枚举与 FeeQuery.noType(),
不支持的类型显式拒绝——静默按别的口径查会让对账金额对不上。
时间窗 ≤3 个月(文档约束),无单号且无时间窗时本地拒绝。
能力接口新增 WarehouseFeeCapable.orderCosts(默认抛不支持),
门面 fees().orderCosts(query)。
顺带补 BillingDocument 里遗漏的 serialNumber() / accountBalance() getter
(上一提交只加了字段没加 getter,测试编译不过)。
测试 12 个。只跑 edayun 模块:93 个全绿;yqn / xincang 未受影响。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
ad41104cc6
|
feat(edayun): 对接查询交易明细(POST /webApi/accountFlow/list)
三条与其它仓不同的口径,都做了针对性处理:
1. **同一单号的同一计费项有多条流水,不能去重**。
文档原文说明这一点,所以每条流水映射成一条 BillingDocument,
靠新增的 serialNumber()(账户流水号)区分。按单号去重会丢账。
2. **金额是 string 且可为负**。billingAmount="-0.500" 是扣费,
正数是充值 / 退费。用 BigDecimal 解析保留符号,不取绝对值。
3. **币种有两个**:accountCurrency(账户币种,优先)与 originalCurrency
(原币)。跨币种账户时两者不同,靠 exchangeRate 换算。
统一模型扩展:
- FeeQuery 新增 settledAfter / settledBefore(计费时间窗,毫秒)。
与已有的 snapshotStartDate(运去哪按仓储费快照查)语义不同,
Javadoc 写明不要互相替代。
- BillingDocument 新增 serialNumber(流水号)与 accountBalance(变动后余额)。
查询约束在本地校验:
- 没给业务单号时时间段必填,且不能超过 180 天
- pageNum / pageSize 必填,当前固定第 1 页 / 每页 200(上限)
- 超过 200 条的翻页待确认(已记 TODO)
计费项分类按 billingCode 关键字推断,认不出归 null 不猜。
测试 10 个。只跑 edayun 模块:81 个全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
03f4773cb8
|
feat(edayun): 对接查询出库单与查询面单
两个接口:
- POST /webApi/order/v1/getOrderInfo → OutboundOrder
- POST /webApi/order/v1/getOrderLabel → List<PackageResult>(含 labelRef)
enums/EdayunOrderStatus:文档给了 24 个状态,按「宿主是否需要区分」折叠:
- ReadyToShip → SUBMITTED,Shipment → PICKING
- Shipped / Online / Delivered / Returns → SHIPPED(文档定义的「已发货」)
- Cancelled / InterceptSuccess → CANCELLED(文档定义的「已取消」)
- 其余 19 个异常类 → EXCEPTION,具体原因在 errorMsg / rawStatus
精确匹配不做子串:Shipment(发货中)不能因为含 Ship 就判成已发货。
adapter/EdayunOrderQueryMapper:
- 订单详情映射:poNumber→来源单号、orderNo→仓侧单号;毫秒时间戳;
SN 按 SKU 汇总;包裹 fileUrl 转附件;0/1 旗标 null 保持 null
- 面单映射:trackingNo 与 labels 按逗号位置一一对应到 PackageResult
- 地址优先取二字码(destProvince),全称兜底
适配器 get / packages 已实现;query / cancel / checkCancel 仍显式不支持。
测试 15 个(状态映射、地址口径、SN、旗标 null、多包裹对应、空面单)。
只跑 edayun 模块:56 个测试全绿。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |