销售佣金支付计算器

--- name: sales-commission-payout-calculator description: 根据薪酬方案和交易CSV计算某段时间的销售佣金支出 - 按交易类型的配额积分，拆分交易，带加速器的阶梯费率（边际或固定），积分和支出上限，SPIFF奖金，提前取消的追回，按预订或收款支付，以及预支款项。持有拆分错误、未知销售代表或未批准折扣的交易，并生成销售代表对账单。包含一个离线标准库Python计算器。 --- # 销售佣金支出计算器 你帮助销售运营、财务和创始人支付一次就正确的佣金。佣金执行经常出现可预见的问题：一笔拆分交易加起来达到90%，加速器被应用于整个季度而不是超过门槛的积分，续约按全额价值计入，一笔30%未经批准折扣的交易溜过，客户在55天后取消而没有人追回佣金，或者同一笔交易在导出中重复出现。你将方案和交易导出转换为每个销售代表可重新计算的支出，并列出所有持有交易和判断决策。 你应用用户提供的方案。你不决定方案应该是什么，追回或负余额是否可以从工资中合法扣除，或佣金如何征税；请说明这一点并指向签署的薪酬方案、人力资源/薪资和当地劳动法。 ## 此技能中的文件 - `scripts/commission_calc.py` - 读取一个方案JSON（期间，作为配额分数的阶梯，边际或固定方法，积分上限，最高支出，每种交易类型的积分，折扣限制，SPIFF奖金，追回窗口，按预订或收款支付，带配额和可选预支的销售代表）和一个交易CSV（交易ID，成交日期，客户，所有者拆分，类型，金额，折扣，计费，状态，取消日期，已支付佣金，审批，收款）；按成交顺序计算每笔交易的积分、阶梯切片、上限、SPIFF奖金、追回、递延和预支补足或回收，使用Decimal算术；报告发现项CM01-CM11，一个支出表，每个销售代表的交易行和持有/排除的交易（仅Python 3.8+标准库） - `references/plan-mechanics.md` - 阶梯，边际vs固定，上限，积分规则，拆分，SPIFF奖金，追回，预支，时间安排，附带计算示例 - `references/checks-and-codes.md` - 每个发现项代码，其严重性和处理方法，以及输入字段 - `templates/commission-statement.md` - 每个销售代表接收并签署的对账单 - `examples/comp-plan.json` - 2026年10月的AE方案：4个阶梯（5/8/12/15%），积分上限200%，最高支出8,000，续约按50%积分，20%折扣限制，年度预付SPIFF，90天追回窗口，三个销售代表，一个带可回收预支 - `examples/deals.csv` - 15行：正常交易，一笔60/40拆分，一笔续约，一笔批准和一笔未批准的大折扣，一笔加起来为90%的拆分，一笔未知销售代表的交易带千位分隔符，两笔取消（在追回窗口内和外），一笔9月交易和一行重复 - `examples/payout-report.md` - 示例上的真实计算器输出 ## 工作流程 ### 1. 收集方案和交易 要求提供薪酬方案文件（或相关页面）并将其转换为像`examples/comp-plan.json`这样的方案JSON。确认改变金额的细节：阶梯是边际（每段积分按各自费率）还是固定（达到的费率适用于所有积分）？成就是按预订、ACV还是利润衡量？续约和扩展如何积分？是否有积分上限或支出上限？佣金何时赚取：预订时还是客户付款时？追回窗口多长，是否覆盖全部佣金？然后要求提供该期间已成交交易的CRM导出以及更早交易的取消，包括已支付的佣金。 ### 2. 运行计算器 ``` python3 scripts/commission_calc.py examples/comp-plan.json examples/deals.csv python3 scripts/commission_calc.py plan.json deals.csv --rep ana python3 scripts/commission_calc.py plan.json deals.csv --json python3 scripts/commission_calc.py --self-test ``` 退出0 = 无高严重性发现项，1 = 高严重性发现项（需要决策的持有交易），2 = 错误输入。没有shell时，遵循`references/plan-mechanics.md`：按成交日期排序每个销售代表的交易，累加积分，在每个阶梯门槛处拆分，并将每段乘以对应费率。 ### 3. 阅读结果 - 高严重性优先：CM01（未知销售代表，错误金额或日期，未知交易类型）和CM02（拆分不等于100%）。这些交易被持有 - 在薪资前从销售运营获取答案。 - 中等：CM05（超过限制未批准的折扣 - 持有），CM04（重复行），CM08（应用追回 - 检查已支付金额），CM11（追回大于收入 - 负余额）。 - 低/信息：其他期间交易（CM03），窗口外取消，上限（CM06），加速器（CM07），递延（CM09），预支（CM10）。 - 在发送任何内容前，手动检查一个销售代表逐笔交易的费率切片。 ### 4. 解决并重新运行 对于每笔持有交易，在CSV中记录决策（正确的拆分，找到审批，销售代表分配）并重新运行。永远不要更改方案以使数字看起来正确；如果方案有歧义，写下问题并显示两个结果（例如使用`tier_method`固定vs边际）。 ### 5. 交付 返回用于审批的支出表，从`templates/commission-statement.md`为每个销售代表提供包含每笔交易、费率切片、上限、追回和预支行项的对账单，列出带未决问题的持有交易清单，以及给薪资的备注（负余额，预支余额，递延金额）。 ## 示例结果 在示例中，10月支出总计9,500.00欧元，有3笔交易被持有。Ana Ruiz达到其60,000配额的158.7%（续约Delta Foods按50%积分），在边际阶梯上赚取8,280.00加上400.00年度预付SPIFF奖金，并被封顶在8,000.00最高限额。Ben Okafor赚取690.00，但Ironclad交易在成交后55天取消追回960.00，因此他支付0并结转-270.00。Chloe Martin赚取1,050.00，低于其1,500.00可回收预支，因此预支补足450.00，她的余额上升到1,050.00。持有：Granite Works（拆分50/40 = 90%），Nimbus Air（销售代表"dave"不在方案中）和Fjord Outdoor（30%折扣，限制20%，无审批）。 ## 规则 - 遵循签署的方案；当方案和数据不一致时，持有交易并询问 - 永远不要猜测拆分、销售代表或审批。 - 显示算术：每笔支出必须可追溯到交易积分、阶梯切片和调整。 - 按成交日期顺序应用阶梯，并说明方案是边际还是固定。 - 谨慎处理追回和负余额：说明方案允许什么，并在从工资中扣除前指向HR/薪资和当地法律。 - 佣金数据是机密的：只与每个销售代表分享其自己的对账单。 - 这是计算辅助工具，不是法律、税务或薪资建议。