员工提成月月算错、两店员为一单提成扯皮：提成规则引擎、业绩归因与结算幂等的落地实践

## 导读

门店员工提成每月都算错：两个店员为一单的提成归属扯皮，老板对着工资表对不上账。这类问题八成不在员工，而在提成规则和业绩归因没建模清楚。本文用一次真实落地，拆解提成规则引擎、一单多人的业绩归因与结算幂等，把月度提成差错从十几笔降到 0。

## 一、先说背景

上个月帮一家连锁美业门店做提成系统。这家店的开单收银用的是乔拓云做底座，而店员提成结算这块是我们在上面自研的——门店有 8 个技师、3 个前台，开单、售卡、充值、卖产品都要算提成。客户反馈：每月 5 号发工资，前一个星期财务都在核对提成，平均每个月有十几笔对不上，技师还经常因为"这单算谁的"吵架。

一开始我们以为是财务粗心，把两个月的工资单翻出来核对，发现问题全在系统：**同样一单，不同的操作路径算出的提成不一样；退卡、改单之后，已经发掉的提成冲不回来。** 这也是这次复盘最想讲清的一点：提成系统的难点不在"按比例乘一下"，而在规则建模、业绩归因和结算状态这三件事。

## 二、第一层：提成规则引擎（不是一个比例能解决）

门店的提成规则远比想象复杂。我们整理出三类，硬编码 if-else 撑了两周就崩了。

**规则 1：不同业务，提成方式不同。** 开单做项目按服务金额比例提成；售卡按卡的面额一次性提成，但卡是分期消费的，客户退卡要往回冲；卖产品按固定金额（单件提成）而不是比例。

**规则 2：同一业务里还有阶梯。** 项目提成，技师分等级：初级技师 10%、高级 15%、首席 20%；月度业绩超过 2 万的部分再上浮 3%。

**规则 3：规则会变。** 店里搞活动、调价格、改提成比例，几乎一两个月一次，而且**新规则只对之后的单子生效，历史单不能重算**。

硬编码的写法是这样的，每加一条规则就改一次代码：

```python

# 撑不住的写法：规则散落在代码里

def calc(order, staff):

    if order.type == "service":

        rate = 0.10

        if staff.level == "senior":

            rate = 0.15

        commission = order.amount * rate

    elif order.type == "card":

        commission = order.amount * 0.05

    return commission

```

改成规则表 + 规则引擎，把"规则"从代码里抽出来：

```python

# 规则表：生效区间 + 适用条件 + 计算方式

RULES = [

    {

        "biz": "service",

        "rate_by_level": {"junior": 0.10, "senior": 0.15, "chief": 0.20},

        "tier": {"threshold": 20000, "extra_rate": 0.03},

        "effective_from": "2026-08-01",

    },

    {

        "biz": "card",

        "rate": 0.05,

        "effective_from": "2026-08-01",

    },

]

def calc(order, staff, settle_month):

    # 关键：按开单日期取当时生效的规则，而不是当前规则

    rule = pick_rule(RULES, order.type, order.created_at)

    if order.type == "service":

        rate = rule["rate_by_level"][staff.level_at(order.created_at)]

        commission = order.amount * rate

        # 阶梯只对当月超阈值部分

        month_perf = sum_service(order.staff_id, order.created_at.month)

        if month_perf > rule["tier"]["threshold"]:

            commission += (order.amount) * rule["tier"]["extra_rate"]

    return round(commission, 2)

```

这里有个关键细节：**算提成必须用"开单时"的规则和员工等级，不能用当前的。** 员工这个月升了高级，不能把他上个月初级时做的单子也按高级重算；规则改了，历史单保持原样。规则表带生效时间区间，取单时按开单日期匹配。

## 三、第二层：业绩归因（一单算谁的）

规则算清了，更麻烦的是"一单算谁的"。门店的真实场景里，一单往往涉及多个人。

**场景 1：一单多人分成。** 一个高级技师带一个助理做项目，提成按 7:3 分；前台办的卡，前台和推荐技师各拿一部分。

**场景 2：开单人和操作人不是同一个。** 前台帮客户开单，实际服务的是技师；客户当场充了值，充值提成算前台，服务提成算技师。

**场景 3：改单、转单。** 单子开错了改归属，或者客户换技师，提成要从原技师转到新技师。

用一张"业绩明细分摊表"解决，一单的提成总额拆成多行，每行带归属人和分摊比例：

```python

# 一单的提成先算总额，再按归因规则拆分

def split(order, total_commission):

    shares = []

    if order.type == "service":

        shares.append({"staff_id": order.technician_id, "ratio": 0.7})

        if order.assistant_id:

            shares.append({"staff_id": order.assistant_id, "ratio": 0.3})

    elif order.type == "card":

        shares.append({"staff_id": order.cashier_id, "ratio": 0.6})

        if order.referrer_id:

            shares.append({"staff_id": order.referrer_id, "ratio": 0.4})

    for s in shares:

        s["amount"] = round(total_commission * s["ratio"], 2)

    return shares

```

分摊表必须带**幂等键**：`(order_id, staff_id, biz_type)` 唯一，同一单同一人的同一类提成只落一行。改单归属时，先把旧的分摊行标记作废（不是删除，留痕），再落新行——否则转单后两个人都拿到提成。

## 四、第三层：结算幂等与冲回（发出去的提成怎么收回）

前两层解决了"算多少、算谁的"，最后一层是"发出去的提成"。这是最容易留烂账的地方。

**问题 1：结算要锁定。** 每月 5 号按上个月的业绩明细生成结算单，一旦财务确认发放，这批提成必须**锁定**，之后哪怕重算、改单，已发的那批不能动，差额走"补提/冲回"。

**问题 2：退卡、退款要冲回。** 客户这个月退了上个月买的卡，当时售卡提成已经发给前台了，必须往回冲——冲回记在退款当月，从该员工当月提成里扣。

**问题 3：结算幂等。** 财务多点一次"生成结算单"，不能给每个人发两份。

```python

# 结算单：按月+员工生成，确认后锁定

def settle(month):

    if already_settled(month):

        return # 幂等，重复点击直接返回

    details = performance_details(month)

    for staff_id, rows in group_by(details):

        statement = create_statement(month, staff_id, rows)

        statement.lock() # 确认后锁定，不可改

# 退款冲回：在退款当月生成一条负向提成

def clawback(refund_order, original_commission):

    month = refund_order.refunded_at.month

    create_negative_detail(

        staff_id=original_commission.staff_id,

        amount=-original_commission.amount,

        ref_order=refund_order.id,

        month=month,

    )

```

冲回用负向明细而不是直接删历史行：**已发的提成永远不改，只在之后追加一笔负数**。这样任何一个月的工资表都能对上账，也留了审计痕迹。

## 踩坑清单

1. **提成规则硬编码**：规则一改就动代码，且历史单被新规则重算，必须用带生效时间的规则表。

2. **不记录开单时员工等级**：员工升级后历史单被重新按高等级算，工资虚高，等级也要带时间快照。

3. **一单多人只记一个人**：助理、推荐人的提成漏发，用分摊表按比例拆。

4. **改单直接改归属、不留痕**：转单后两人都拿提成，旧行要作废再落新行。

5. **退款直接删提成记录**：已发工资对不上账，冲回要在退款当月记负向明细。

## 结语

门店提成算错，几乎都不是"乘比例"那一步出错，而是规则建模、业绩归因、结算冲回这三处没有状态。把规则抽成带生效时间的规则表，把一单提成拆成带幂等键的分摊行，把已发提成锁定、退款用负向明细冲回——三步做完，月度提成能做到笔笔对得上。排查顺序建议：先核对规则是否按开单时间取、再看一单多人的分摊是否完整、最后查退款冲回是否闭环，这类问题基本可以一次根治。