## 一、前言

在之前的系列文章中，我写了 LikeShop 多商户版的架构、社区团购的部署和商家入驻的二开。这一篇聚焦连锁点餐系统，重点讲**门店自提**和**第三方配送对接**这两个二开时最常被要求定制的功能。

先说一个连锁点餐场景的典型二开需求。某茶饮品牌用 LikeShop 连锁点餐系统做线上点单，总部有 30 家门店。运营方提出两个需求：第一，用户在小程序下单时选择“到店自提”，系统需要根据用户 LBS 位置推荐最近的门店，并且自提订单的核销要和门店的 POS 系统打通；第二，部分门店没有自配送能力，需要接入达达或美团配送，订单发货后自动推送配送单，配送状态回调实时更新订单状态。

这两个需求看起来是两个独立功能，但它们有一个共同点：**都涉及“履约能力”的扩展**。门店自提需要扩展核销流程，第三方配送需要扩展物流对接。LikeShop 连锁点餐系统的架构设计，恰好为这两类扩展预留了空间。

这篇文章就从连锁点餐的架构特点出发，把门店自提和第三方配送对接的技术实现路径拆开讲清楚。

## 二、连锁点餐系统的架构特点

### 2.1 总部 + 多门店模式

LikeShop 连锁点餐系统基于**总部 + 多门店的连锁模式**，拥有门店独立管理后台，支持总部定价和门店定价。系统采用 LBS 定位点餐，可堂食可外卖。

这个架构和普通商城有一个关键区别：**门店不是“商家”，而是同一品牌下的经营单元**。所有门店共享总部的商品库、营销规则和会员体系，但每个门店有自己的库存、营业时间和配送范围。这个区别决定了门店自提和配送对接的实现方式和多商户版完全不同——多商户版需要处理商户数据隔离，连锁点餐系统只需要处理门店维度的数据过滤。

### 2.2 履约方式的设计

连锁点餐系统支持三种履约方式：**堂食（店内就餐或打包带走）、外卖（同城配送）、自提（到店取货）** 。

这三种方式在订单中的区分通常通过订单类型字段实现。堂食和自提的订单不需要物流配送，外卖订单需要选择配送方式（商家自配送或第三方配送）。二开时新增履约方式，需要在订单类型枚举中增加新的值，并在状态机中定义对应的流转路径。

### 2.3 门店自提的业务逻辑

门店自提的核心流程是：**用户下单时选择“门店自提”→从门店列表中选择具体门店→支付后生成提货码→用户到店出示提货码→核销员核销→订单状态由待发货变更为已完成**。

门店列表按地理位置由近到远显示，提货码有两种状态：待核销和已核销。自提订单不能多次核销。

## 三、门店自提的二开实战

### 3.1 二开场景：自提订单核销与门店 POS 系统打通

**需求**：用户到店核销提货码时，除了在 LikeShop 中标记订单完成，还需要把核销信息同步到门店的 POS 系统，用于门店的库存扣减和日结对账。

**改造思路**：遵循 LikeShop 二开的“扩展优先”原则，不修改核心的核销逻辑，而是新建扩展 Logic，在核销成功后调用。

**改造步骤**：

**第一步**：定位核销的业务逻辑入口。在 `shopapi` 或 `adminapi` 的 `SelfFetchLogic`（或对应的核销模块 Logic）中，找到核销订单的方法。

**第二步**：新建扩展 Logic：

```php
// server/app/common/logic/SelfFetchExtendLogic.php
class SelfFetchExtendLogic
{
    /**
     * 核销成功后的扩展处理
     * @param int $orderId  订单id
     * @param int $shopId   门店id
     * @param string $code  核销码
     */
    public static function afterVerify(int $orderId, int $shopId, string $code): void
    {
        try {
            // 查询订单商品明细
            $goodsList = OrderGoodsModel::where('order_id', $orderId)
                ->field('goods_id, item_id, goods_num')
                ->select();

            // 调用门店 POS 系统的核销接口
            $posData = [
                'shop_id'    => $shopId,
                'order_sn'   => OrderModel::where('id', $orderId)->value('order_sn'),
                'verify_code'=> $code,
                'goods_list' => $goodsList->toArray(),
                'verify_time'=> time(),
            ];
            PosServer::syncVerifyRecord($posData);

        } catch (Exception $e) {
            // POS 同步失败不影响主流程，只记录日志
            Log::error("POS核销同步失败：订单{$orderId}，{$e->getMessage()}");
        }
    }
}
```

**第三步**：在核销逻辑的末尾调用扩展方法：

```php
// 原有的核销逻辑
// 校验核销码、更新订单状态、记录核销日志...

// 新增：调用扩展逻辑（不修改原有逻辑）
SelfFetchExtendLogic::afterVerify($orderId, $shopId, $code);
```

**关键原则**：POS 系统同步失败时只记录日志，不回滚核销操作。核销是门店的核心业务，不能因为一个外部系统的调用失败而导致核销失败。

### 3.2 二开场景：自提门店增加“预计取餐时间”

**需求**：用户选择自提门店后，需要展示该门店当前的预计取餐时间（比如“预计15分钟后可取”），帮助用户判断到店时间。

**改造步骤**：

**第一步**：在 `ls_self_fetch_shop` 表中增加字段：

```sql
ALTER TABLE `ls_self_fetch_shop` 
ADD COLUMN `estimated_minutes` int(11) DEFAULT '0' COMMENT '预计取餐时间（分钟）';
```

**第二步**：在门店列表的查询结果中返回该字段：

```php
// server/app/shopapi/logic/SelfFetchShopLogic.php
public static function getNearbyShops(array $params): array
{
    $longitude = $params['longitude'] ?? 0;
    $latitude = $params['latitude'] ?? 0;

    $shops = SelfFetchShopModel::where('status', 1)
        ->where('delete_time', 0)
        ->field('id,name,image,address,longitude,latitude,estimated_minutes')
        ->select()
        ->toArray();

    // 按距离排序
    if ($longitude && $latitude) {
        foreach ($shops as &$shop) {
            $shop['distance'] = self::calcDistance(
                $longitude, $latitude, $shop['longitude'], $shop['latitude']
            );
        }
        usort($shops, function ($a, $b) {
            return $a['distance'] <=> $b['distance'];
        });
    }

    return ['lists' => $shops];
}

private static function calcDistance($lng1, $lat1, $lng2, $lat2): float
{
    $radLat1 = deg2rad($lat1);
    $radLat2 = deg2rad($lat2);
    $a = $radLat1 - $radLat2;
    $b = deg2rad($lng1) - deg2rad($lng2);
    $s = 2 * asin(sqrt(pow(sin($a / 2), 2) + cos($radLat1) * cos($radLat2) * pow(sin($b / 2), 2)));
    return round($s * 6378.137, 2); // 公里
}
```

**第三步**：在管理后台的门店编辑页面增加“预计取餐时间”的输入项。

## 四、第三方配送对接

### 4.1 连锁点餐的配送需求

连锁点餐系统的外卖订单需要同城配送。对于没有自配送能力的门店，接入第三方配送是最经济的方案。目前主流的第三方配送平台有**达达秒送**和**美团配送**，两者都提供了完整的开放平台 API。

LikeShop 的第三方生态中已经包含了部分物流能力（快递鸟、快递100查询），但同城即时配送需要二开对接。第三方配送的核心流程是：**订单支付成功 → 推送配送单到第三方平台 → 骑手接单配送 → 配送状态回调 → 更新订单状态**。

### 4.2 达达配送对接的实现

达达秒送提供了 PHP SDK，可以通过 Composer 安装。

```bash
composer require ledc/dada
```

**第一步**：封装达达配送的 Service：

```php
// server/app/common/server/DadaDeliveryServer.php
class DadaDeliveryServer
{
    private static function getConfig(): array
    {
        return [
            'appKey'    => ConfigService::get('dada_app_key'),
            'appSecret' => ConfigService::get('dada_app_secret'),
            'sourceId'  => ConfigService::get('dada_source_id'),
            'debug'     => false,
            'enabled'   => true,
        ];
    }

    /**
     * 推送配送单
     * @param int $orderId 订单id
     * @return array
     */
    public static function createDeliveryOrder(int $orderId): array
    {
        $order = OrderModel::find($orderId);
        if (!$order) {
            throw new Exception('订单不存在');
        }

        $shop = ShopModel::find($order['shop_id']);
        $address = OrderAddressModel::where('order_id', $orderId)->find();

        $config = new \Ledc\Dada\Config(self::getConfig());
        $dada = new \Ledc\Dada\Dada($config);

        // 构建配送单参数
        $params = [
            'shop_no'            => $shop['dada_shop_no'],
            'origin_id'          => $order['order_sn'],
            'city_code'          => $shop['city_code'],
            'receiver_name'      => $address['contact'],
            'receiver_address'   => $address['province'] . $address['city'] . $address['district'] . $address['address'],
            'receiver_lat'       => $address['latitude'],
            'receiver_lng'       => $address['longitude'],
            'receiver_phone'     => $address['telephone'],
            'callback'           => request()->domain() . '/api/delivery/dadaNotify',
            'cargo_price'        => $order['total_amount'],
            'is_prepay'          => 0,
            'receiver_name'      => $address['contact'],
            'tips'               => 0,
        ];

        $result = $dada->order()->addOrder($params);

        // 记录配送单号
        if (isset($result['distance'])) {
            OrderModel::where('id', $orderId)->update([
                'delivery_no'   => $result['deliveryNo'] ?? '',
                'delivery_type' => 'dada',
                'update_time'   => time(),
            ]);
        }

        return $result;
    }
}
```

**第二步**：配置达达配送的回调地址。达达配送的状态回调会实时推送订单状态变化，需要在订单创建时传入 `callback` URL。

```php
// server/app/api/controller/DeliveryController.php
class DeliveryController extends BaseController
{
    /**
     * 达达配送状态回调
     */
    public function dadaNotify()
    {
        $payload = request()->post(false);

        // 记录原始回调日志
        Log::write('达达回调：' . json_encode($payload), 'info');

        $status = $payload['order_status'] ?? 0;
        $orderSn = $payload['order_id'] ?? '';

        $order = OrderModel::where('order_sn', $orderSn)->find();
        if (!$order) {
            return json(['status' => 'fail', 'msg' => '订单不存在']);
        }

        // 根据达达状态更新订单状态
        switch ($status) {
            case 1: // 待接单
                OrderModel::where('id', $order['id'])->update([
                    'delivery_status' => 1,
                    'update_time'     => time(),
                ]);
                break;
            case 2: // 待取货
                OrderModel::where('id', $order['id'])->update([
                    'delivery_status' => 2,
                    'update_time'     => time(),
                ]);
                break;
            case 3: // 配送中
                OrderModel::where('id', $order['id'])->update([
                    'delivery_status' => 3,
                    'update_time'     => time(),
                ]);
                break;
            case 4: // 已完成
                OrderStatusLogic::transit($order['id'], 3, '配送完成，订单自动完成');
                OrderModel::where('id', $order['id'])->update([
                    'delivery_status' => 4,
                    'finish_time'     => time(),
                    'update_time'     => time(),
                ]);
                break;
            case 5: // 已取消
                OrderModel::where('id', $order['id'])->update([
                    'delivery_status' => 5,
                    'update_time'     => time(),
                ]);
                break;
        }

        return json(['status' => 'ok']);
    }
}
```

**达达回调的关键约束**：订单状态回传顺序中，配送员自身原因取消运单后重抛场景下会出现状态重复回传。需要在回调处理中做**幂等校验**——检查当前 `delivery_status` 是否已经大于回调状态，如果已经处理过则直接返回成功。

### 4.3 美团配送对接的实现

美团配送的对接流程和达达类似，但签名机制和接口规范不同。美团配送要求按 key 字典序拼接参数，`timestamp` 为秒级且与美团时间差不超过5分钟，签名原文末尾拼 `app_secret` 后 MD5 再转大写。

```php
// server/app/common/server/MeituanDeliveryServer.php
class MeituanDeliveryServer
{
    /**
     * 美团配送签名生成
     */
    private static function generateSign(array $params, string $appSecret): string
    {
        // 按 key 字典序排序
        ksort($params);

        // 拼接参数
        $signStr = '';
        foreach ($params as $key => $value) {
            $signStr .= $key . '=' . $value . '&';
        }
        $signStr = rtrim($signStr, '&');
        $signStr .= $appSecret;

        // MD5 后转大写
        return strtoupper(md5($signStr));
    }

    /**
     * 创建美团配送订单
     */
    public static function createDeliveryOrder(int $orderId): array
    {
        $order = OrderModel::find($orderId);
        $address = OrderAddressModel::where('order_id', $orderId)->find();
        $shop = ShopModel::find($order['shop_id']);

        $params = [
            'app_key'        => ConfigService::get('meituan_app_key'),
            'timestamp'      => time(),
            'order_id'       => $order['order_sn'],
            'delivery_id'    => 'MT' . $order['order_sn'],
            'sender_name'    => $shop['name'],
            'sender_phone'   => $shop['mobile'],
            'sender_address' => $shop['address'],
            'receiver_name'  => $address['contact'],
            'receiver_phone' => $address['telephone'],
            'receiver_address' => $address['address'],
            'goods_price'    => $order['total_amount'],
        ];

        // 生成签名
        $params['sign'] = self::generateSign($params, ConfigService::get('meituan_app_secret'));

        // 调用美团配送下单接口
        $result = HttpServer::post('https://peisongopen.meituan.com/api/order/create', $params);

        if (($result['code'] ?? -1) != 0) {
            throw new Exception('美团配送下单失败：' . ($result['msg'] ?? '未知错误'));
        }

        // 记录配送单号
        OrderModel::where('id', $orderId)->update([
            'delivery_no'   => $result['data']['delivery_id'] ?? '',
            'delivery_type' => 'meituan',
            'update_time'   => time(),
        ]);

        return $result;
    }
}
```

**美团配送的关键约束**：美团外卖订单同步接口全部要求 POST 方法，且请求体为 JSON。签名验证需对 POST 参数双重 URL 解码并按键名 ASCII 升序排序后拼接计算。

### 4.4 配送方式的可配置化

连锁点餐系统中，不同门店可能使用不同的配送方式。建议在门店表中增加配送配置字段：

```sql
ALTER TABLE `ls_shop` 
ADD COLUMN `delivery_type` varchar(50) DEFAULT 'self' COMMENT '配送方式：self-自配送,dada-达达,meituan-美团';
```

在订单创建时，根据门店的 `delivery_type` 选择对应的配送服务：

```php
// server/app/common/logic/OrderDeliveryLogic.php
class OrderDeliveryLogic
{
    public static function dispatch(int $orderId): void
    {
        $order = OrderModel::find($orderId);
        $shop = ShopModel::find($order['shop_id']);

        switch ($shop['delivery_type']) {
            case 'dada':
                DadaDeliveryServer::createDeliveryOrder($orderId);
                break;
            case 'meituan':
                MeituanDeliveryServer::createDeliveryOrder($orderId);
                break;
            case 'self':
            default:
                // 商家自配送，不做处理
                break;
        }
    }
}
```

## 五、第三方配送与订单状态机的联动

第三方配送的接入需要和 LikeShop 的订单状态机联动。配送状态的变化会驱动订单状态的变化。

| 配送状态 | 订单状态变化 |
|----------|-------------|
| 骑手接单 | 订单保持“待收货” |
| 配送中 | 订单保持“待收货” |
| 配送完成 | 订单迁移到“已完成” |
| 配送取消 | 订单保持“待收货”，需人工处理 |

**关键约束**：订单状态迁移必须通过 `OrderStatusLogic::transit()` 方法，不能直接 `update` 状态字段。配送回调中更新订单状态时，需要先检查当前订单状态是否允许迁移，避免重复回调导致状态错乱。

## 六、二开避坑清单

**坑一：扩展逻辑异常影响主流程。** 核销和配送推送的扩展逻辑，必须用 try-catch 包裹，异常只记录日志不回滚主流程。POS 同步失败不能导致核销失败，配送推送失败不能导致订单创建失败。

**坑二：配送回调没有做幂等校验。** 达达配送会出现状态重复回传，美团配送的订单状态也可能多次推送。回调处理中必须检查当前 `delivery_status`，已处理过的状态直接返回成功。

**坑三：门店的配送配置没有按门店维度隔离。** 连锁点餐系统中不同门店的配送能力不同，配送方式必须存储在门店表中，不能做成平台级配置。

**坑四：自提订单和配送订单的状态机混用。** 自提订单不需要配送环节，状态迁移路径是“待发货 → 已完成”。配送订单需要经过“待收货 → 已完成”。二开时不要在状态机中混用两条路径。

**坑五：核销员只能在移动端核销。** PC 商城个人中心不支持门店核销入口，核销员只能在移动端商城进行核销。如果二开时需要在 PC 端增加核销功能，需要额外开发。

**坑六：配送回调地址使用了 HTTP 而非 HTTPS。** 达达和美团的回调地址建议使用 HTTPS，如果回调地址不可访问或证书不被认可，回调会失败。

## 七、总结

LikeShop 连锁点餐系统的门店自提和第三方配送二开，核心可以概括为两条线：

**门店自提**：业务逻辑为“用户选择自提门店 → 支付后生成提货码 → 到店核销 → 订单完成”。二开时通过新建扩展 Logic 的方式注入自定义逻辑（如 POS 同步），不修改核心核销流程。门店维度增加“预计取餐时间”等字段需要在门店表中扩展。

**第三方配送**：支持达达和美团两种主流配送平台。核心流程为“订单支付成功 → 推送配送单 → 骑手配送 → 状态回调 → 更新订单状态”。达达使用官方 PHP SDK 对接，美团需要自行实现签名逻辑。配送状态回调必须做幂等校验，订单状态更新必须走状态机入口。

二开时守住三条底线：**扩展逻辑不影响主流程、配送回调做幂等校验、配送配置按门店维度隔离**。把这三点处理好，连锁点餐系统的履约能力就能灵活扩展。

在之前的系列文章中，我写了 LikeShop 多商户版的架构、社区团购的部署和商家入驻的二开。这一篇聚焦连锁点餐系统，重点讲门店自提和第三方配送对接这两个二开时最常被要求定制的功能。

LikeShop 连锁点餐系统二开：门店自提与第三方配送对接

人工智能

本文深入解析LikeShop连锁点餐系统二开实践，聚焦门店自提核销与第三方配送对接两大核心功能。通过门店自提POS系统打通、预计取餐时间扩展、达达及美团配送API接入等实战案例，详解订单状态机联动、幂等校验机制及配送配置门店维度隔离方案，为连锁餐饮系统履约能力扩展提供完整技术路径。

代码解释

JSON

对象存储COS新用户低至1元！


2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

LikeShop 连锁点餐系统二开：门店自提与第三方配送对接-腾讯云开发者社区-腾讯云

LikeShop 连锁点餐系统二开：门店自提与第三方配送对接

LikeShop 连锁点餐系统二开：门店自提与第三方配送对接

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐