【交易】门店自提

友情提示：

uni-app Vue3 版本，门店自提暂未迁移完成，预计 2024 年 Q2 完成。目前缺两部分：

* 订单结算页，增加自提门店的选择
* 订单详情页，增加自提门店的展示

如果你着急的话，可以参考 [uni-app Vue2 版本 **(opens new window)**](https://gitee.com/yudaocode/yudao-mall-uniapp/tree/master-vue2/)迁移过来，相关的后端接口都已经完成。

门店自提，是指用户在下单时，选择自提，然后到指定的门店进行自提（核销）。

## [#](https://doc.iocoder.cn/mall/trade-delivery-pickup/#_1-%E9%97%A8%E5%BA%97%E4%BF%A1%E6%81%AF)1. 门店信息

门店自提时，需要使用门店信息，由 `yudao-module-trade-biz` 后端模块的 `delivery` 包的 DeliveryPickUpStoreService 实现。

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

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

```sql
CREATE TABLE `trade_delivery_pick_up_store` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '门店名称',
  `introduction` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '门店简介',
  `phone` varchar(16) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '门店手机',
  `area_id` int NOT NULL COMMENT '区域编号',
  `detail_address` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '门店详细地址',
  `logo` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '门店 logo',
  `opening_time` time NOT NULL COMMENT '营业开始时间',
  `closing_time` time NOT NULL COMMENT '营业结束时间',
  `latitude` double NOT NULL COMMENT '纬度',
  `longitude` double NOT NULL COMMENT '经度',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '门店状态',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='自提门店';
```

比较简单，就是存储下门店的基本信息。

### [#](https://doc.iocoder.cn/mall/trade-delivery-pickup/#_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_1624570.8581973411732958.png)

## [#](https://doc.iocoder.cn/mall/trade-delivery-pickup/#_2-%E8%87%AA%E6%8F%90%E6%B5%81%E7%A8%8B)2. 自提流程

### [#](https://doc.iocoder.cn/mall/trade-delivery-pickup/#_2-1-%E4%B8%8B%E5%8D%95%E3%80%90%E4%B9%B0%E5%AE%B6%E3%80%91)2.1 下单【买家】

① 买家在 uni-app 订单结算页时，选择自提，然后选择自提门店。如下图所示：

TODO 未开发，后续补图

注意：商品的配送方式需要支持自提，才会显示自提的选项！！！如果没设置，去“商品管理”里，编辑下相关的商品。

② 下单并支付完成后，买家在 uni-app 订单详情页时，可以看到自提门店的信息，也包括核销码、核销二维码。如下图所示：

TODO 未开发，后续补图

### [#](https://doc.iocoder.cn/mall/trade-delivery-pickup/#_2-2-%E6%A0%B8%E9%94%80%E3%80%90%E5%8D%96%E5%AE%B6%E3%80%91)2.2 核销【卖家】

① 核销订单列表，对应 [商城系统 -> 订单中心 -> 配送管理 -> 门店自提 -> 核销订单] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `views/mall/trade/delivery/pickUpOrder` 目录。如下图所示：

![核销订单列表](/media/202404/2024-04-26_1624570.335480703679356.png)

② 点击「核销」按钮，输入核销码，查询核销订单的信息。如下图所示：

![核销订单 - 查询](/media/202404/2024-04-26_1624570.11693206386940702.png)

后端对应 AppTradeOrderController 的 `#getByPickUpVerifyCode(...)` 提供的“查询核销码对应的订单”接口，基于 `trade_order` 表的 `pick_up_verify_code` 字段查询。

③ 点击「确认核销」按钮后，即可核销成功。如下图所示：

![核销订单 - 确认](/media/202404/2024-04-26_1624570.7968893259238634.png)

后端对应 AppTradeOrderController 的 `#pickUpOrderByVerifyCode(...)` 提供的“订单核销”接口。

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

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

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