同城配送设置
1. 功能概述
同城配送是 MISEB 多商户电商系统集成的微信小程序官方物流服务，基于微信即时配送接口实现。通过该功能，平台和商户可以：
- 快速接入多家运力公司（如顺丰同城、美团配送、达达快送、闪送等）。
- 实现统一的配送下单、取消和轨迹查询。
- 支持门店与运力账户的独立绑定与管理。
- 实时同步配送状态，确保订单状态流转准确。
2. 业务流程
- 用户下单：用户在小程序端选择“同城配送”方式并支付订单。
- 商户发货：
- 商户在后台订单管理中点击发货。
- 系统自动校验门店与运力账户的归属关系。
- 调用微信接口创建配送单。
- 配送执行：
- 骑手接单、取货、配送。
- 系统通过定时任务和回调接口实时更新订单状态。
- 订单完成：商品送达后，订单自动流转为已收货/已完成状态。
3. 配置指南
3.1 微信小程序配置
在使用同城配送前，请确保 application.yml 中已正确配置微信小程序的 AppID 和 Secret：
yaml
wx:
miniapp:
appid: ${WX_MINIAPP_APPID}
secret: ${WX_MINIAPP_SECRET}3.2 腾讯地图配置
门店地址选择功能依赖腾讯地图服务，请前往 腾讯位置服务 申请 Key，并在系统后台配置：
- 路径：系统设置 -> 第三方接口 -> 腾讯地图 Key
3.3 定时任务配置
为了确保配送状态的实时性，需要在“定时任务管理”中启用状态同步任务：
| 配置项 | 说明 |
|---|---|
| Bean名称 | CityDeliveryStatusSyncTask |
| 方法名称 | syncDeliveryStatus |
| Cron表达式 | 0 0/5 * * * ? (建议每5分钟执行一次) |
| 功能描述 | 定时从微信侧拉取最新的配送单状态并更新本地订单。 |
3.4 回调地址配置
为了接收微信推送的配送状态变更（如骑手已接单、已送达），需要在微信公众平台（小程序后台）配置回调 URL：
- URL格式：
https://您的域名/api/publicly/city/delivery/callback/status - 说明：该接口用于接收微信配送状态的实时推送。
4. 运力与门店管理
4.1 运力账户绑定
平台或商户需要绑定各运力公司的账户（AppKey/AppSecret）才能使用对应的配送服务。
- 支持运力：顺丰同城 (SFTC)、美团配送 (MTPS)、达达快送 (DADA)、闪送 (SS)、UU跑腿 (UU)、蜂鸟配送 (FENG) 等。
- 操作：在“同城配送”页面，点击“账户管理”，添加并绑定运力账号。
4.2 门店管理
每个发货门店需要在系统中创建，并与微信侧的门店 ID 关联。
- 操作：在“同城配送”页面，点击“门店管理”，录入门店名称、地址、经纬度等信息，并同步至微信。
5. 注意事项
- 商户隔离：系统已实现严格的商户隔离机制，商户只能使用自己绑定的运力账户和门店进行发货。
- 余额管理：请确保各运力账户中有充足的余额，否则可能导致发货失败。
- 状态同步：建议同时开启定时任务和回调配置，以保障状态同步的可靠性。