Skip to content

新增海外仓 / 物流商 ​

海外仓和物流商的连接器与电商平台相互独立,授权分别保存在「海外仓账号」和「物流渠道」上。

新增海外仓服务商 ​

海外仓即「映射了服务商仓库代码的系统仓库」:ERP 中海外仓仍是一个普通仓库,库存、成本、出入库单照常;仓库映射决定它属于哪个服务商账号的哪个仓库,SKU 按账号的 SKU 映射转换(没有映射的按物料编码)。

  1. 在 OwhProvider 枚举(及系统字典 ecom_owh_provider)中加入服务商,npm run gen:enums,补英文字典。
  2. 实现 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:按日期区间的费用流水
}
  1. 不支持的操作不声明对应能力,页面会隐藏按钮(例如没有作废退件单接口时显示「标记已作废」)。
  2. 授权字段名称写进 ecom.properties。

服务商接口都在事务之外调用;入库收货完成后由 EcomOwhInboundService 签收 ERP 来源单据(头程货件或在途调拨),出库拿到运单号后按现有流程发货并回传平台,退件收货后调用退货入库——这些业务逻辑与服务商无关,新服务商只需要实现协议。

海外仓账号

测试参考 EcomOverseasWarehouseTests:用本地 HTTP 服务模拟服务商,覆盖签名、库存同步与差异调整、入库推送与部分收货、一件代发与截单、费用入账、退件与调拨。

新增物流商 ​

  1. 在 EcomCarrier 枚举中加入物流商。
  2. 实现 carrier/CarrierConnector:info()(授权字段、正式 / 测试地址)、createOrder(下单取号,返回运单号)、label(面单 PDF)、cancel、track / trackInfo(轨迹与归一状态)。
  3. 轨迹描述归一为 EcomTrackStatus(暂无轨迹、已揽收、运输中、到达待取、已签收、异常、退回),可复用 TrackStatusNormalizer 的多语言关键词判断。

物流渠道上选择对接的物流商并填写授权、环境与自定义地址后,「包裹打单」中即可批量申请运单号、打印面单(面单保存在附件目录 ecom-label/yyyy/MM/)。没有对接的渠道手工填写运单号;轨迹查不到时由 17TRACK 兜底。

物流渠道

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

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com