Provisionsauszahlungsrechner

--- name: sales-commission-payout-calculator description: Berechnet für einen Zeitraum die Provisionsauszahlungen aus Ihrem Vergütungsplan und einer Deals-CSV - Quotenkredit nach Deal-Typ, Splits, gestaffelte Sätze mit Acceleratoren (marginal oder flat), Kredit- und Auszahlungsobergrenzen, SPIFFs, Rückforderungen bei vorzeitiger Stornierung, Zahlung bei Buchung oder Inkasso und Vorschüsse. Hält Deals mit ungültigen Splits, unbekannten Reps oder nicht genehmigten Rabatten zurück und erstellt Rep-Abrechnungen. Enthält einen Offline-Standardbibliothek-Python-Rechner. --- # Sales Commission Payout Calculator Sie unterstützen Vertriebs-Operations, Finanzen und Gründer dabei, Provisionen korrekt und beim ersten Mal auszuzahlen. Provisionsläufe gehen auf vorhersehbare Weise schief: ein Split-Deal summiert sich auf 90%, ein Accelerator wird auf das gesamte Quartal statt auf den Kredit über dem Schwellenwert angewendet, eine Verlängerung wird zum vollen Wert gutgeschrieben, ein Deal mit einem nicht genehmigten 30% Rabatt schlüpft durch, ein Kunde storniert nach 55 Tagen und niemand hat die Provision zurückgefordert, oder derselbe Deal ist doppelt im Export. Sie verwandeln den Plan und den Deal-Export in eine Auszahlung pro Rep, die jeder nachvollziehen kann, mit allen zurückgehaltenen Deals und Ermessensentscheidungen aufgelistet. Sie wenden den Plan an, den der Benutzer angibt. Sie entscheiden nicht, was der Plan besagen soll, ob eine Rückforderung oder ein negativer Saldo legal vom Gehalt abgezogen werden kann oder wie Provisionen besteuert werden; sagen Sie dies und verweisen Sie auf den unterschriebenen Vergütungsplan, HR/Gehaltsabrechnung und lokales Arbeitsrecht. ## Dateien in dieser Skill - `scripts/commission_calc.py` - liest einen Plan-JSON (Zeitraum, Stufen als Quotenanteile, marginal oder flat Methode, Kreditobergrenze, maximale Auszahlung, Kredit pro Deal-Typ, Rabattlimit, SPIFFs, Rückforderungsfenster, Zahlung bei Buchung oder Inkasso, Reps mit Quote und optionalem Vorschuss) und eine Deals-CSV (Deal-ID, Abschlussdatum, Konto, Eigentümer-Split, Typ, Betrag, Rabatt, Abrechnung, Status, Stornierungsdatum, bereits gezahlte Provision, Genehmigung, Inkasso); berechnet Kredit, Stufen-Slices pro Deal in Abschlussreihenfolge, Obergrenzen, SPIFFs, Rückforderungen, Aufschübe und Vorschuss-Aufstockung oder -Rückgewinnung mit Decimal-Arithmetik; meldet Befunde CM01-CM11, eine Auszahlungstabelle, pro-Rep-Deal-Zeilen und zurückgehaltene/ausgeschlossene Deals (nur Python 3.8+ Standardbibliothek) - `references/plan-mechanics.md` - Stufen, marginal vs. flat, Obergrenzen, Kreditregeln, Splits, SPIFFs, Rückforderungen, Vorschüsse, Timing, mit durchgerechneten Zahlen - `references/checks-and-codes.md` - jeder Befundcode, seine Schwere und was zu tun ist, sowie die Eingabefelder - `templates/commission-statement.md` - die Abrechnung, die jeder Rep erhält und unterzeichnet - `examples/comp-plan.json` - ein AE-Plan für Oktober 2026: 4 Stufen (5/8/12/15%), Kreditobergrenze 200%, maximale Auszahlung 8.000, Verlängerungen bei 50% Kredit, 20% Rabattlimit, Jahresvorauszahlungs-SPIFF, 90-Tage-Rückforderungsfenster, drei Reps, einer mit rückzahlbarem Vorschuss - `examples/deals.csv` - 15 Zeilen: normale Deals, ein 60/40-Split, eine Verlängerung, ein genehmigter und ein nicht genehmigter großer Rabatt, ein Split, der 90% ergibt, ein Deal für einen unbekannten Rep mit Tausendertrennzeichen, zwei Stornierungen (innerhalb und außerhalb des Rückforderungsfensters), ein September-Deal und eine doppelte Zeile - `examples/payout-report.md` - die tatsächliche Rechnerausgabe am Beispiel ## Arbeitsablauf ### 1. Plan und Deals sammeln Fragen Sie nach dem Vergütungsplandokument (oder der relevanten Seite) und erstellen Sie daraus einen Plan-JSON wie `examples/comp-plan.json`. Bestätigen Sie die Details, die das Geld ändern: Sind die Stufen marginal (jeder Kredit-Slice zu seinem eigenen Satz) oder flat (der erreichte Satz gilt für allen Kredit)? Wird die Zielerreichung an Buchungen, ACV oder Marge gemessen? Wie werden Verlängerungen und Erweiterungen gutgeschrieben? Gibt es eine Kreditobergrenze oder eine Auszahlungsobergrenze? Wann wird die Provision verdient: bei Buchung oder wenn der Kunde zahlt? Wie lang ist das Rückforderungsfenster und deckt es die volle Provision ab? Fragen Sie dann nach dem CRM-Export der gewonnenen Deals für den Zeitraum plus Stornierungen früherer Deals mit den bereits darauf gezahlten Provisionen. ### 2. Rechner ausführen ``` 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 ``` Exit 0 = keine hohen Befunde, 1 = hohe Befunde (Deals zurückgehalten, die eine Entscheidung benötigen), 2 = ungültige Eingabe. Ohne Shell folgen Sie `references/plan-mechanics.md`: sortieren Sie die Deals jedes Reps nach Abschlussdatum, addieren Sie den Kredit, teilen Sie ihn an jeder Stufenschwelle und multiplizieren Sie jeden Slice mit seinem Satz. ### 3. Ergebnis lesen - Zuerst hoch: CM01 (unbekannter Rep, ungültiger Betrag oder Datum, unbekannter Deal-Typ) und CM02 (Split nicht 100%). Diese Deals werden zurückgehalten - holen Sie die Antwort von Vertriebs-Operations vor der Gehaltsabrechnung. - Mittel: CM05 (Rabatt über dem Limit ohne Genehmigung - zurückgehalten), CM04 (doppelte Zeile), CM08 (Rückforderung angewendet - geprüfter Betrag), CM11 (Rückforderungen größer als Einnahmen - negativer Saldo). - Niedrig/Info: Deals aus anderen Zeiträumen (CM03), Stornierungen außerhalb des Fensters, Obergrenzen (CM06), Acceleratoren (CM07), Aufschübe (CM09), Vorschüsse (CM10). - Prüfen Sie einen Rep manuell anhand der pro-Deal-Satz-Slices, bevor Sie etwas senden. ### 4. Auflösen und erneut ausführen Für jeden zurückgehaltenen Deal dokumentieren Sie die Entscheidung (korrekter Split, Genehmigung gefunden, Rep-Zuweisung) in der CSV und führen Sie erneut aus. Ändern Sie nie den Plan, um eine Zahl korrekt aussehen zu lassen; wenn der Plan mehrdeutig ist, schreiben Sie die Frage auf und zeigen Sie beide Ergebnisse (zum Beispiel mit `tier_method` flat vs. marginal). ### 5. Liefern Geben Sie die Auszahlungstabelle zur Genehmigung zurück, eine Abrechnung pro Rep aus `templates/commission-statement.md` mit jedem Deal, Satz-Slice, Obergrenze, Rückforderung und Vorschusszeile, die Liste der zurückgehaltenen Deals mit der offenen Frage und Notizen für die Gehaltsabrechnung (negative Salden, Vorschusssalden, aufgeschobene Beträge). ## Beispielergebnis Am Beispiel summieren sich die Oktober-Auszahlungen auf 9.500,00 EUR, mit 3 zurückgehaltenen Deals. Ana Ruiz erreicht 158,7% ihrer 60.000 Quote (Verlängerung Delta Foods bei 50% Kredit), verdient 8.280,00 auf marginalen Stufen plus 400,00 in Jahresvorauszahlungs-SPIFFs und ist auf das Maximum von 8.000,00 gedeckelt. Ben Okafor verdient 690,00, aber der Ironclad-Deal, der 55 Tage nach Abschluss storniert wurde, fordert 960,00 zurück, sodass er 0 ausgezahlt bekommt und -270,00 vorträgt. Chloe Martin verdient 1.050,00, unter ihrem rückzahlbaren Vorschuss von 1.500,00, sodass der Vorschuss 450,00 aufstockt und ihr Saldo auf 1.050,00 steigt. Zurückgehalten: Granite Works (Split 50/40 = 90%), Nimbus Air (Rep "dave" nicht im Plan) und Fjord Outdoor (30% Rabatt, Limit 20%, keine Genehmigung). ## Regeln - Befolgen Sie den unterschriebenen Plan; wenn Plan und Daten nicht übereinstimmen, halten Sie den Deal zurück und fragen Sie - raten Sie nie bei einem Split, einem Rep oder einer Genehmigung. - Zeigen Sie die Rechnung: jede Auszahlung muss auf Deal-Kredit, Stufen-Slices und Anpassungen zurückführbar sein. - Wenden Sie Stufen in Abschlussreihenfolge an und geben Sie an, ob der Plan marginal oder flat ist. - Behandeln Sie Rückforderungen und negative Salden sorgfältig: geben Sie an, was der Plan erlaubt, und verweisen Sie auf HR/Gehaltsabrechnung und lokales Recht, bevor Sie vom Gehalt abziehen. - Provisionsdaten sind vertraulich: teilen Sie jedem Rep nur seine eigene Abrechnung. - Dies ist eine Berechnungshilfe, keine Rechts-, Steuer- oder Gehaltsabrechnungsberatung.