业绩明细:得物负差额新增「订单实付未减联合营销费」备注;抖音备注改名「订单实付含已退款部分」

得物:负差额 = 联合营销费未让利尾数(该单营销费支出 + 差额恰为整数)时标注;规则排在通用「未减冲减/优惠」之前,避免被笼统备注抢先;证据子查询仅在得物负差额行计算。抖音:备注名统一加「订单」前缀。导航说明同步更新。
This commit is contained in:
yueyang 2026-10-13 11:07:46 +08:00
parent 53b0821384
commit d1ffaf773c
2 changed files with 53 additions and 9 deletions

View File

@ -154,7 +154,7 @@ class Pages extends Controller
}
/**
* 「实付含已退款部分」的聚水潭证据 SQL(仅抖音负差额行计算,CASE 守卫保证其它行不触发子查询)。
* 「订单实付含已退款部分」的聚水潭证据 SQL(仅抖音负差额行计算,CASE 守卫保证其它行不触发子查询)。
*
* 退款单:经订单 o_id 关联(so_id 列没有索引,订单侧走 so_id 索引、退款单侧走 o_id 索引),
* 只统计 SUCCESS 且非 Split 父单的叶子退款;分别取合计与单笔最大值。
@ -182,6 +182,28 @@ class Pages extends Controller
];
}
/**
* 得物「联合营销费未让利」证据 SQL(仅得物负差额行计算,CASE 守卫保证其它行不触发子查询)。
*
* 得物联合营销费 = 让利买家部分(整数)+ 商家自担尾数;订单实付只扣了让利部分,
* 未让利尾数 = 营销费支出 − 让利,即「营销费支出 + 差额」恰为整数;
* 对不上(差值非整)时不标注,避免误标。
*
* @return array{guard:string, marketing_expense:string}
*/
private static function receiptDewuMarketingEvidenceSql(): array
{
$guard = "platform = '得物' AND COALESCE(difference, COALESCE(income_amount, 0) + COALESCE(discount_amount, 0) + COALESCE(offset_amount, 0)) < -0.005";
return [
'guard' => $guard,
'marketing_expense' => "(SELECT COALESCE(SUM(b.expense_amount), 0)
FROM dewu_settlement_bill_rows b
WHERE b.online_order_no = store_receipt_order_match_rows.online_order_no
AND b.bill_item = '联合营销费')",
];
}
/**
* 「差额异常备注」原因(不落库):说明差额为什么产生,一行最多一个,按顺序取第一条命中。
* 未匹配行 → 订单实付未匹配(细分原因见「未匹配原因」列);已匹配但基准金额=0 → 订单实付取数为0;
@ -196,19 +218,26 @@ class Pages extends Controller
$label = $basis['label'];
$rules = [];
$effective = 'COALESCE(difference, COALESCE(income_amount, 0) + COALESCE(discount_amount, 0) + COALESCE(offset_amount, 0))';
$rules[$label . '未匹配'] = "match_status = '未匹配'";
$rules[$label . '取数为0(种菜)'] = "match_status = '已匹配' AND planting_amount IS NOT NULL AND ABS(COALESCE($column, 0)) < 0.005";
$rules[$label . '取数为0'] = "match_status = '已匹配' AND planting_amount IS NULL AND ABS(COALESCE($column, 0)) < 0.005";
// 得物「订单实付未减联合营销费」:负差额 = 联合营销费未让利尾数(营销费支出 + 差额恰为整数)才标注。
// 放在通用「未减冲减/优惠」等式之前:得物这类行的差额常恰好等于冲减(营销费)金额,需优先给出具体项备注。
$dewuEvidence = self::receiptDewuMarketingEvidenceSql();
$dewuNeat = '(' . $dewuEvidence['marketing_expense'] . ' + ' . $effective . ')';
$rules['订单实付未减联合营销费'] = 'CASE WHEN (' . $dewuEvidence['guard']
. ' AND (' . $dewuEvidence['marketing_expense'] . ') > 0.005'
. ' AND ABS(' . $dewuNeat . ' - ROUND(' . $dewuNeat . ', 0)) < 0.005) THEN 1 ELSE 0 END = 1';
$rules[$label . '未减冲减'] = "match_status = '已匹配' AND ABS(COALESCE($column, 0) - (COALESCE(income_amount, 0) + COALESCE(discount_amount, 0))) < 0.005";
$rules[$label . '未减优惠'] = "match_status = '已匹配' AND ABS(COALESCE($column, 0) - (COALESCE(income_amount, 0) + COALESCE(offset_amount, 0))) < 0.005";
$rules[$label . '未减优惠和冲减'] = "match_status = '已匹配' AND ABS(COALESCE($column, 0) - COALESCE(income_amount, 0)) < 0.005";
$effective = 'COALESCE(difference, COALESCE(income_amount, 0) + COALESCE(discount_amount, 0) + COALESCE(offset_amount, 0))';
// 抖音「实付含已退款部分」:负差额能在聚水潭退款单/取消子单金额里对上(≈差额)才标注。
// 抖音「订单实付含已退款部分」:负差额能在聚水潭退款单/取消子单金额里对上(≈差额)才标注。
$refundEvidence = self::receiptRefundEvidenceSql();
$differenceAbs = 'ABS(' . $effective . ')';
$refundHit = static fn (string $amount): string => 'CASE WHEN ' . $amount . ' > 0.005 THEN ABS(' . $amount . ' - ' . $differenceAbs . ') < 0.02 ELSE 0 END';
$rules['实付含已退款部分'] = 'CASE WHEN (' . $refundEvidence['guard'] . ') THEN ('
$rules['订单实付含已退款部分'] = 'CASE WHEN (' . $refundEvidence['guard'] . ') THEN ('
. $refundHit($refundEvidence['refund_sum'])
. ' OR ' . $refundHit($refundEvidence['refund_max'])
. ' OR ' . $refundHit($refundEvidence['cancelled_sum'])
@ -252,6 +281,17 @@ class Pages extends Controller
if (abs($product) < 0.005) {
return ($row->planting_amount ?? null) !== null ? $label . '取数为0(种菜)' : $label . '取数为0';
}
// 得物负差额:差额与联合营销费未让利尾数吻合(营销费支出 + 差额恰为整数)→「订单实付未减联合营销费」。
// 放在通用「未减冲减/优惠」等式之前:得物这类行的差额常恰好等于冲减(营销费)金额,需优先给出具体项备注。
if (($row->platform ?? '') === '得物' && $difference < -0.005) {
$marketingExpense = (float) ($row->order_dewu_marketing_expense ?? 0);
if ($marketingExpense > 0.005) {
$neat = $marketingExpense + $difference;
if (abs($neat - round($neat)) < 0.005) {
return '订单实付未减联合营销费';
}
}
}
if (abs($product - ($income + $discount)) < 0.005) {
return $label . '未减冲减';
}
@ -262,12 +302,12 @@ class Pages extends Controller
return $label . '未减优惠和冲减';
}
// 抖音负差额:实付多出来的部分能在聚水潭退款单/取消子单金额里对上(≈差额)→「实付含已退款部分」。
// 抖音负差额:实付多出来的部分能在聚水潭退款单/取消子单金额里对上(≈差额)→「订单实付含已退款部分」。
if (($row->platform ?? '') === '抖音' && $difference < 0) {
$refunds = [$row->order_refund_sum ?? null, $row->order_refund_max ?? null, $row->order_cancelled_sum ?? null];
foreach ($refunds as $refund) {
if ($refund !== null && (float) $refund > 0.005 && abs((float) $refund - abs($difference)) < 0.02) {
return '实付含已退款部分';
return '订单实付含已退款部分';
}
}
}
@ -927,11 +967,13 @@ class Pages extends Controller
$itemsQuery = $base();
$applyFilters($itemsQuery);
$refundEvidence = self::receiptRefundEvidenceSql();
$dewuEvidence = self::receiptDewuMarketingEvidenceSql();
$items = $itemsQuery
->selectRaw('*')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['refund_sum'] . ' END AS order_refund_sum')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['refund_max'] . ' END AS order_refund_max')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['cancelled_sum'] . ' END AS order_cancelled_sum')
->selectRaw('CASE WHEN (' . $dewuEvidence['guard'] . ') THEN ' . $dewuEvidence['marketing_expense'] . ' END AS order_dewu_marketing_expense')
->orderBy('occurred_date')
->orderBy('store_name')
->orderBy('online_order_no')
@ -1303,13 +1345,15 @@ class Pages extends Controller
$this->applyReceiptRemarkFilter($query, $remarkValues);
}
// 「实付含已退款部分」判定所需证据列(与页面同一口径;仅抖音负差额行会真正计算子查询)。
// 「订单实付含已退款部分」「订单实付未减联合营销费」判定所需证据列(与页面同一口径;仅对应平台负差额行会真正计算子查询)。
$refundEvidence = self::receiptRefundEvidenceSql();
$dewuEvidence = self::receiptDewuMarketingEvidenceSql();
$query
->selectRaw('*')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['refund_sum'] . ' END AS order_refund_sum')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['refund_max'] . ' END AS order_refund_max')
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['cancelled_sum'] . ' END AS order_cancelled_sum');
->selectRaw('CASE WHEN (' . $refundEvidence['guard'] . ') THEN ' . $refundEvidence['cancelled_sum'] . ' END AS order_cancelled_sum')
->selectRaw('CASE WHEN (' . $dewuEvidence['guard'] . ') THEN ' . $dewuEvidence['marketing_expense'] . ' END AS order_dewu_marketing_expense');
$selected = array_values(array_intersect(
array_filter(explode(',', (string) $request->query('columns', ''))),

View File

@ -806,7 +806,7 @@ $navigation = [
'directory' => [
'icon' => 'receipt_long',
'status' => '共享镜像',
'description' => '覆盖店铺收款账户账单各平台页签(总账备注=订单收入),按「店铺 + 订单号」匹配订单侧商品金额与订单实付金额;一行 = 一个店铺的一个订单,商品金额只挂一次。「商品金额」只取主单(拆单子单不参与,整单没有主单时退化为取全部行),并排除虚拟条码(X0000x:信誉订单 / 虚拟订单)明细行;「订单实付金额」取订单级实付(拆单取主单)再减去虚拟条码行实付。「优惠金额」「冲减金额」另取总账备注=优惠收入 / 冲减收入的账单金额,不计入收入金额;「退款金额」另取总账备注=退款的账单金额,只单独列示,不计入收入金额、也不参与差额;「种菜金额」是订单号在种菜明细表或聚水潭订单标签明细(是否种菜订单=是)任意一边出现过时,该订单的收入金额(两个条件是或的关系),只是收入金额里的一部分,不参与差额;差额=(收入金额+优惠金额+冲减金额)−订单实付金额,匹配状态与差额异常备注同样按订单实付金额判定,未匹配到订单实付金额的行按订单实付金额=0 计入差额,只反映真正对不上的部分。挂不到订单行的优惠/冲减会补成一行(收入/商品留空)。「差额异常备注」只说明差额为什么产生,按顺序自动判定:订单实付未匹配(未匹配到订单实付金额,具体原因看「未匹配原因」列);订单实付取数为0(种菜)(订单实付=0 且是种菜单)、订单实付取数为0(订单实付=0 但不是种菜单)、订单实付未减冲减(订单实付=收入+优惠 → 差额=冲减金额)、订单实付未减优惠(订单实付=收入+冲减 → 差额=优惠金额)、订单实付未减优惠和冲减(订单实付=收入 → 差额=优惠+冲减)、实付含已退款部分(仅抖音负差额:聚水潭退款单/取消子单金额≈差额对上才标注);都不满足则留空。「未匹配原因」单独一列,取值:账单无单号 / 单号格式异常 / 订单表无此单 / 订单无实付金额 / 无收款账单。',
'description' => '覆盖店铺收款账户账单各平台页签(总账备注=订单收入),按「店铺 + 订单号」匹配订单侧商品金额与订单实付金额;一行 = 一个店铺的一个订单,商品金额只挂一次。「商品金额」只取主单(拆单子单不参与,整单没有主单时退化为取全部行),并排除虚拟条码(X0000x:信誉订单 / 虚拟订单)明细行;「订单实付金额」取订单级实付(拆单取主单)再减去虚拟条码行实付。「优惠金额」「冲减金额」另取总账备注=优惠收入 / 冲减收入的账单金额,不计入收入金额;「退款金额」另取总账备注=退款的账单金额,只单独列示,不计入收入金额、也不参与差额;「种菜金额」是订单号在种菜明细表或聚水潭订单标签明细(是否种菜订单=是)任意一边出现过时,该订单的收入金额(两个条件是或的关系),只是收入金额里的一部分,不参与差额;差额=(收入金额+优惠金额+冲减金额)−订单实付金额,匹配状态与差额异常备注同样按订单实付金额判定,未匹配到订单实付金额的行按订单实付金额=0 计入差额,只反映真正对不上的部分。挂不到订单行的优惠/冲减会补成一行(收入/商品留空)。「差额异常备注」只说明差额为什么产生,按顺序自动判定:订单实付未匹配(未匹配到订单实付金额,具体原因看「未匹配原因」列);订单实付取数为0(种菜)(订单实付=0 且是种菜单)、订单实付取数为0(订单实付=0 但不是种菜单)、订单实付未减冲减(订单实付=收入+优惠 → 差额=冲减金额)、订单实付未减优惠(订单实付=收入+冲减 → 差额=优惠金额)、订单实付未减优惠和冲减(订单实付=收入 → 差额=优惠+冲减)、订单实付含已退款部分(仅抖音负差额:聚水潭退款单/取消子单金额≈差额对上才标注)、订单实付未减联合营销费(仅得物负差额:联合营销费未让利尾数对上才标注);都不满足则留空。「未匹配原因」单独一列,取值:账单无单号 / 单号格式异常 / 订单表无此单 / 订单无实付金额 / 无收款账单。',
'empty' => '店铺收款匹配订单明细尚未同步,请先执行 store-receipt:order-match:sync。',
'fields' => [
['name' => 'platform', 'label' => '平台'],