聚合配送

Gogs Webhooks/Webhook.md → server/Gogs Webhooks/Webhook.md

@@ -20,7 +20,7 @@ cd $PROJECT_DIR
 unset GIT_DIR
 /usr/local/git/bin/git reset --hard
 /usr/local/git/bin/git pull origin $GIT_BRANCH
-
+cd 
 # ... 其他构建或重启命令 ...
 # 例如：
 # echo "正在重启服务..."

server/有用的信息.md

@@ -15,4 +15,9 @@
 - 微信开放平台
 	hzghdcom@126.com  
 	xhb.2020
-	[https://open.weixin.qq.com](https://open.weixin.qq.com/)微信开放平台
+	[https://open.weixin.qq.com](https://open.weixin.qq.com/)微信开放平台
+
+
+git.huaml.com
+zhh 
+xhb*2025

任务小笔记/25-1021：聚合配送/SQL.md

@@ -51,6 +51,7 @@ CREATE TABLE `xhHdDeliveryOrder` (
     `distance` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '距离,单位：米',
     `fee` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '配送费用，单位：分',
     `tip` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '小费，单位：分',
+    `cancelCost` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '取消扣费，单位：分',
     `orderStatus` tinyint(2) NOT NULL DEFAULT '0' COMMENT '配送状态: 0订单生成 1系统已接单 2派单中 3待取货 4配送中 5已送达， -1已取消 -2异常， 10改派中 20已分配骑手 30骑手已到店 40申请取消中 50客服介入处理中',
     PRIMARY KEY (`id`),
     KEY `unix_mh` (`mainId`, `hdOrderId`),
@@ -75,4 +76,25 @@ xhGhsOrder 下的相关字段：
 `sendTimeWant` date NOT NULL DEFAULT '0000-00-00' COMMENT '客户要求的发货时间',
 `sendTip` decimal(9,2) NOT NULL DEFAULT '0.00' COMMENT '运费里增加的小费',
 
+```
+
+
+### 需求强相关的表字段
+```
+#表 xhShopExt
+`hcFreeKm` smallint(6) NOT NULL DEFAULT '0' COMMENT '花材多少公里内免费配送',
+`hcMap` varchar(500) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '花材免费配送的阶梯',
+
+#表 xhShopExt
+`thirdSend` tinyint(4) NOT NULL DEFAULT '0' COMMENT '商城端下单选跑腿 0支持 1不支持',  
+`thirdSendFee` tinyint(4) NOT NULL DEFAULT '0' COMMENT '商城端下单选跑腿，跑腿费用 0到付 1自动计算',
+
+
+```
+
+### 查询好用的 sql
+```
+select id, orderSn, status, sendStatus, deliveryId from xhGhsOrder where id=5085;
+
+
 ```

任务小笔记/25-1021：聚合配送/上线SQL.md

@@ -17,7 +17,7 @@ CREATE TABLE `xhDeliveryAuthToken` (
   `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
   `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
   PRIMARY KEY (`id`),
-  KEY `idx_mp` (`mainId`,`platform`)
+  UNIQUE KEY `idx_mp` (`mainId`,`platform`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='商家授权与平台绑定表';
 
 // 创建一个批发各跑腿的表，记录各跑腿平台返回的订单
@@ -45,4 +45,8 @@ CREATE TABLE `xhGhsDeliveryOrder` (
 ALTER TABLE `xhGhsOrder` MODIFY COLUMN `sendStatus` tinyint(4) NOT NULL DEFAULT '-4' COMMENT '配送状态: 0订单生成 1系统已接单 2派单中 3待取货 4配送中 5已送达， -1已取消 -2异常 -4没有叫跑腿， 10改派中 20已分配骑手 30骑手已到店 40申请取消中 50客服介入处理中';
 
 UPDATE xhGhsOrder SET sendStatus = -4;
+
+
+ALTER TABLE `xhOrder` MODIFY COLUMN `sendStatus` tinyint(4) NOT NULL DEFAULT '-4' COMMENT '配送状态: 0订单生成 1系统已接单 2派单中 3待取货 4配送中 5已送达， -1已取消 -2异常 -4没有叫跑腿， 10改派中 20已分配骑手 30骑手已到店 40申请取消中 50客服介入处理中';
+UPDATE xhOrder SET sendStatus = -4;
 ```

任务小笔记/25-1021：聚合配送/弃用或删除.md

@@ -4,4 +4,10 @@
 3. 跑腿设置 要做修改 -- 展示出所有授权的平台 + 新增平台授权 + 点击平台可对帐户充值（平台列表中可看到剩余金额）
    - 有个查询的页面：当前未配送、配送中、已完成
    - admin/shop/expressSet 页面去除（新建一个 admin/deliveryManage/deliveryManage）
-   - 
+
+
+#### hdApp 端
+1. pagesStore/me/expressSet 弃用（要删除掉）
+2. js接口文件 @/api/shop-express 弃用（）
+3. 订单--》呼叫跑腿（admin/express/create）（要删除掉）
+4. 

任务小笔记/25-1021：聚合配送/蜂鸟/模拟数据.md

@@ -10,8 +10,8 @@
   "callback_business_type": "orderStatusNotify",
   "param": {
     "app_id": "6587209115185920913",
-    "order_id": 150000005238787740,
-    "partner_order_code": "XSD_CS26323511",
+    "order_id": 150000005870797461,
+    "partner_order_code": "KD_CS61236169",
     "order_status": 0,
     "push_time": 1610629131295,
     "carrier_driver_id": null,

任务小笔记/25-1021：聚合配送/蜂鸟/蜂鸟上线注意点.md

@@ -0,0 +1,9 @@
+### 1.修改授权回调地址
+由于为了在测试环境调试授权回调，所以把授权回调地址临时设置为：https://api.shop.hzghd.com/delivery/fengniao-auth-callback，请在上线时，切换到：https://api.shop.wixhb.com/delivery/fengniao-auth-callback （测试环境，用不上这个授权回调地址，所以修改为线上地址后不影响）
+
+需要事先在【开发者中心】->【应用管理】->【查看应用详情】->【编辑】维护可以访问的授权回调地址
+
+线上授权回调请求示例：
+https://open.ele.me/app-auth?appId=6587209115185920913&devId=133146508&authCallbackUrl=https://api.shop.hzghd.com/delivery/fengniao-auth-callback?main_id=661
+
+### 2.

任务小笔记/25-1021：聚合配送/要完成的需求整理.md

@@ -14,11 +14,10 @@
 		4. 顺丰只授权，没有刷新 access ??? 
 	3. ~~跑腿总览能一眼知道是否 token 过期（显示过期时间点）
 
-3. 顺风有==预取消订单==接口，要接入哦 ---- （闪送 也有==订单预取消==）
+3. 顺风有==预取消订单==接口，要接入哦 ---- （闪送 也有 ==订单预取消==）
 	1. 并非真正取消订单，用来验证是否可以取消订单并返回计价等信息。
 	2. 货拉拉并没==预取消接口==，只能从“查询订单详情”接口的can_order_cancel字段判断
 	3. 这个不是必接的，放到下一步执行
-
 4. 下单后，要做的功能：
 	1. 查询订单在路上的情况（展示配送到哪了）
 		1. 查询闪送员位置信息  -- 闪送
@@ -26,14 +25,17 @@
 		3. 获取配送员实时坐标接口 -- 顺丰
 	2.  各平台也有：查询订单详情接口，可作为接口类的必备的方法名）
 	3. 加小费接口
-
 5. ~~货拉拉==获取可选取消原因==接口 -- (对接完毕，前端已接入)
 	1. 所有平台的取消都没记录取消 code 与原因 -- 考究有没有必要
-
 6. 余额与充值
-
 7. 闪送的备注是在 订单计费 接口提交的，这个比较特别（没实现）
 ### 后期要实现的
 1. 查询订单详情页
 2. 查询骑手信息页面
 3. 加小费功能
+### 新功能需求
+1、花卉宝端，买花材选跑腿下单  
+2、滴滴和达达接口对接  
+3、~~花掌柜端跑腿授权  ~~
+4、花卉宝端，买花束计算运费问题（需要再讨论）
+5、~~花掌柜端订单发送 跑腿~~  及处理跑腿订单状态回调

任务小笔记/25-1021：聚合配送/货拉拉/货拉拉上线注意点.md

@@ -0,0 +1,4 @@
+![[Pasted image 20251127001500.png]]
+https://api.shop.wixhb.com/delivery/huolala-callback
+
+授权回调地地临时修改为测试环境 --- https://api.shop.hzghd.com/delivery/huolala-callback

任务小笔记/25-1021：聚合配送/达达/接口对接知识点.md

@@ -0,0 +1,5 @@
+###### 1.**怎么加小费?**
+  小费是商户用来调节运力的手段，适当增加小费会让订单更有竞争力。
+
+  订单发出时可以通过“新增订单”接口直接加；发单成功，在订单处于待接单状态时，可以通过“增加小费”接口增加。
+

任务小笔记/25-1021：聚合配送/闪送/闪送上线注意点.md

@@ -0,0 +1,18 @@
+线上回调URL--  https://api.shop.wixhb.com/delivery/callback
+线上跳转URL--  https://api.shop.wixhb.com/delivery/shansong-auth-callback
+
+```
+// ------------------ 授权(账号绑定) ---------------------  
+//授权  
+public function actionShansongAuth()  
+{  
+    //闪送授权（商户授权：授权后能为商户下所有门店发单）  
+    $auth = new \common\components\delivery\platform\shansong\Auth();  
+    if(getenv('YII_ENV') == 'production') {  
+	    //$apiHost = Yii::$app->params['ghsHost'];
+        // TODO 暂时修改为测试环境  
+		$apiHost = 'https://api.shop.hzghd.com';
+} else {  
+        $apiHost = Yii::$app->params['ghsHost'];  
+    }
+```

任务小笔记/25-1021：聚合配送/需求与实现.md

@@ -0,0 +1,10 @@
+
+### 1. 免跑腿费
+跑腿费是否加入到 price(总价)需要添加判断条件：
+
+1. 比较 this.showDistance与this.ghsInfo.hcFreeKm的大小，如果 this.showDistance 小于 this.ghsInfo.hcFreeKm，则免运费，即不计到总价。（注意：this.showDistance的单位是米， this.ghsInfo.hcFreeKm的单位是千米）
+
+2. 如果条件1的结果是 this.showDistance 大于 this.ghsInfo.hcFreeKm，则接着判断this.ghsInfo.hcMap 是否为空，不为空， 则取出来与 花材数量（allCountFun.bigLength）、花材总价（allPriceFun）、this.showDistance 分别进行比较，如果花材数量大于 num，花材总价大于price，this.showDistance 小于 distance*1000，那么也是免运费。如果不满足，则要收运费。[{num: "5", price: "100", distance: "5"}] 是this.ghsInfo.hcMap示例数据。
+
+如果是免运费则把 @hdApp/src/admin/billing/affirmGhs.vue:234 中价格加上中横线，并在价格后面加上蓝色的 “【免跑腿费】”，否则不变。
+