【交易】快递发货

## 1. 快递公司

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_1-1-%E8%A1%A8%E7%BB%93%E6%9E%84)1.1 表结构

快递公司，由 `yudao-module-trade-biz` 后端模块的 `delivery` 包的 DeliveryExpressService 实现，只有一个表：

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

```sql
CREATE TABLE `trade_delivery_express` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司编码',
  `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司名称',
  `logo` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递公司 logo',
  `sort` int NOT NULL DEFAULT '0' COMMENT '排序',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递公司';
```

比较简单，就是存储下快递公司的基本信息。

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_1-2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)1.2 管理后台

对应 [商城系统 -> 订单中心 -> 配送管理 -> 快递发货 -> 快递公司] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/mall/trade/delivery/express` 目录。如下图所示：

![快递公司](/media/202404/2024-04-26_1624340.5438066997414412.png)

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_1-3-%E7%89%A9%E6%B5%81%E4%BF%A1%E6%81%AF)1.3 物流信息

由 `yudao-module-trade-biz` 后端模块的 ExpressClient 实现，已对接快递鸟、快递 100 等快递查询接口。

## [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-%E5%BF%AB%E9%80%92%E8%BF%90%E8%B4%B9%E6%A8%A1%E6%9D%BF)2. 快递运费模板

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-1-%E8%A1%A8%E7%BB%93%E6%9E%84)2.1 表结构

运费模版，由 `yudao-module-trade-biz` 后端模块的 `delivery` 包的 DeliveryExpressTemplateService 实现，包括一个主表 + 两个子表：

![表关系](/media/202404/2024-04-26_1624340.4619298906849124.png)

#### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-1-1-%E8%BF%90%E8%B4%B9%E6%A8%A1%E7%89%88%E8%A1%A8)2.1.1 运费模版表

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

```sql
CREATE TABLE `trade_delivery_express_template` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '模板名称',
  `charge_mode` tinyint NOT NULL COMMENT '配送计费方式',
  `sort` int NOT NULL DEFAULT '0' COMMENT '排序',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递运费模板';
```

比较简单，关键信息都在两个子表中。

唯一需要注意的是，`charge_mode` 字段，表示配送计费方式，由 DeliveryExpressChargeModeEnum 枚举，有三种：按件、按重量、按体积。

#### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-1-2-%E8%BF%90%E8%B4%B9%E6%A8%A1%E6%9D%BF%E3%80%90%E8%AE%A1%E8%B4%B9%E3%80%91%E9%85%8D%E7%BD%AE%E8%A1%A8)2.1.2 运费模板【计费】配置表

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

```sql
CREATE TABLE `trade_delivery_express_template_charge` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号，自增',
  
  `template_id` bigint NOT NULL COMMENT '快递运费模板编号',
  `charge_mode` tinyint NOT NULL COMMENT '配送计费方式',
  
  `area_ids` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '配送区域 id',
  
  `start_count` double NOT NULL COMMENT '首件数量',
  `start_price` int NOT NULL COMMENT '起步价，单位：分',
  `extra_count` double NOT NULL COMMENT '续件数量',
  `extra_price` int NOT NULL COMMENT '额外价，单位：分',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递运费模板计费配置';
```

① `template_id` 字段：关联 `trade_delivery_express_template` 表的 `id` 字段，表示该计费配置属于哪个运费模版。而 `charge_mode` 字段，只是进行冗余存储，减少查询次数。

② `area_ids` 字段：配送区域 id 数组，存储的区级别。如下图所示：

![配送区域](/media/202404/2024-04-26_1624340.8390635385159159.png)

③ `start_count`、`start_price`、`extra_count`、`extra_price` 字段：配送计费的具体配置。

#### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-1-3-%E8%BF%90%E8%B4%B9%E6%A8%A1%E6%9D%BF%E3%80%90%E5%8C%85%E9%82%AE%E3%80%91%E9%85%8D%E7%BD%AE)2.1.3 运费模板【包邮】配置

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

```sql
CREATE TABLE `trade_delivery_express_template_free` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  
  `template_id` bigint NOT NULL COMMENT '快递运费模板编号',
  
  `area_ids` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '包邮区域 id',
  
  `free_price` int NOT NULL COMMENT '包邮金额，单位：分',
  `free_count` int NOT NULL DEFAULT '0' COMMENT '包邮件数,',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=21 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递运费模板包邮配置';
```

整体类似 `trade_delivery_express_template_charge` 表，就不重复赘述。

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)2.2 管理后台

对应 [商城系统 -> 交易系统 -> 快递发货 -> 快递发货 -> 运费模版] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/mall/trade/delivery/expressTemplate` 目录。如下图所示：

![运费模版](/media/202404/2024-04-26_1624340.5519834353646369.png)

### [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_2-3-%E8%BF%90%E8%B4%B9%E8%AE%A1%E7%AE%97)2.3 运费计算

由 `yudao-module-trade-biz` 后端模块的 TradeDeliveryPriceCalculator 实现订单的运费计算。

## [#](https://doc.iocoder.cn/mall/trade-delivery-express/#_3-%E9%85%8D%E9%80%81%E9%85%8D%E7%BD%AE)3. 配送配置

![配送配置](/media/202404/2024-04-26_1624340.2556563785756316.png)

* SQL 对应 `trade_config` 表的 `delivery_` 开头的字段。
* 前端对应 `yudao-ui-admin-vue3` 项目的 `views/mall/trade/config/index.vue` 目录
* 后端对应 `yudao-module-trade-biz` 项目的 TradeConfigController 类