新增海外仓 / 物流商
海外仓和物流商的连接器与电商平台相互独立,授权分别保存在「海外仓账号」和「物流渠道」上。
新增海外仓服务商
海外仓即「映射了服务商仓库代码的系统仓库」:ERP 中海外仓仍是一个普通仓库,库存、成本、出入库单照常;仓库映射决定它属于哪个服务商账号的哪个仓库,SKU 按账号的 SKU 映射转换(没有映射的按物料编码)。
- 在
OwhProvider枚举(及系统字典ecom_owh_provider)中加入服务商,npm run gen:enums,补英文字典。 - 实现
owh/connector/OwhConnector并注册为 Bean:
java
@Component
public class FooOwhConnector implements OwhConnector {
public OwhProvider provider() { return OwhProvider.FOO; }
public OwhInfo info() { ... } // 授权字段(CarrierField)、正式 / 测试地址、能力 OwhCapability
// warehouses / products / inventory:仓库、物流产品、库存(可用 / 在途 / 锁定,内部分页取完)
// createInbound / queryInbound:入库单(ASN 按箱 × SKU)与收货数量
// createOutbound / queryOutbound / cancelOutbound:一件代发出库、运单号与承运商、取消或截单
// createReturn / queryReturn:退件与质检结果(良品 / 不良品)
// createTransferOut / queryTransferOut:调拨出库(B2B)
// fees:按日期区间的费用流水
}- 不支持的操作不声明对应能力,页面会隐藏按钮(例如没有作废退件单接口时显示「标记已作废」)。
- 授权字段名称写进
ecom.properties。
服务商接口都在事务之外调用;入库收货完成后由 EcomOwhInboundService 签收 ERP 来源单据(头程货件或在途调拨),出库拿到运单号后按现有流程发货并回传平台,退件收货后调用退货入库——这些业务逻辑与服务商无关,新服务商只需要实现协议。

测试参考 EcomOverseasWarehouseTests:用本地 HTTP 服务模拟服务商,覆盖签名、库存同步与差异调整、入库推送与部分收货、一件代发与截单、费用入账、退件与调拨。
新增物流商
- 在
EcomCarrier枚举中加入物流商。 - 实现
carrier/CarrierConnector:info()(授权字段、正式 / 测试地址)、createOrder(下单取号,返回运单号)、label(面单 PDF)、cancel、track/trackInfo(轨迹与归一状态)。 - 轨迹描述归一为
EcomTrackStatus(暂无轨迹、已揽收、运输中、到达待取、已签收、异常、退回),可复用TrackStatusNormalizer的多语言关键词判断。
物流渠道上选择对接的物流商并填写授权、环境与自定义地址后,「包裹打单」中即可批量申请运单号、打印面单(面单保存在附件目录 ecom-label/yyyy/MM/)。没有对接的渠道手工填写运单号;轨迹查不到时由 17TRACK 兜底。

测试参考 CarrierConnectorTests(本地 HttpServer 模拟物流商)。