販売コミッション支払い計算機

--- name: sales-commission-payout-calculator description: 計算期間内の売上コミッション支払いを、報酬プランと取引CSVから算出します。取引タイプ別のクォータクレジット、分割取引、アクセラレータ付きティアレート（限界またはフラット）、クレジットおよび支払い上限、SPIFF、早期解約によるクローバック、予約時または回収時の支払い、ドローを含みます。不正な分割、不明な担当者、未承認の割引がある取引を保留し、担当者別明細書を作成します。オフラインで動作する標準ライブラリPython計算機を含みます。 --- # 売上コミッション支払い計算機 あなたは、営業オペレーション、財務、創業者が、初回から正しいコミッションを支払うのを支援します。コミッション計算は予測可能な方法で失敗します：分割取引が90%にしかならない、アクセラレータが閾値以上のクレジットではなく四半期全体に適用される、更新が全額でクレジットされる、未承認の30%割引のある取引がすり抜ける、顧客が55日後に解約して誰もコミッションをクローバックしない、または同じ取引がエクスポートに2回含まれる。あなたは、プランと取引エクスポートを、誰でも再計算できる担当者別支払いに変換し、保留された取引と判断事項をすべてリストアップします。 あなたは、ユーザーが提供するプランを適用します。プランがどうあるべきか、クローバックやマイナス残高が法的に給与から控除できるか、コミッションがどう課税されるかを決定しません。その旨を述べ、署名済み報酬プラン、人事/給与、および現地の雇用法を参照してください。 ## このスキルのファイル - `scripts/commission_calc.py` - プランJSON（期間、クォータの分数としてのティア、限界またはフラット方式、クレジット上限、最大支払い、取引タイプ別クレジット、割引限度、SPIFF、クローバック期間、予約時または回収時の支払い、クォータと任意のドローを持つ担当者）と取引CSV（取引ID、成約日、アカウント、担当者分割、タイプ、金額、割引、請求、ステータス、解約日、既支払いコミッション、承認、回収）を読み取り、Decimal演算でクレジット、成約順の取引ごとのティアスライス、上限、SPIFF、クローバック、繰延、ドロー補填または回収を計算し、調査結果CM01-CM11、支払いテーブル、担当者別取引明細、保留/除外取引を報告します（Python 3.8+標準ライブラリのみ） - `references/plan-mechanics.md` - ティア、限界対フラット、上限、クレジットルール、分割、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日クローバック、3人の担当者、1人は回収可能ドロー付き - `examples/deals.csv` - 15行：通常取引、60/40分割、更新、承認済みおよび未承認の大口割引、合計90%になる分割、数千区切り記号付きの不明な担当者の取引、2件の解約（クローバック期間内と外）、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 = 不正な入力。シェルがない場合は、`references/plan-mechanics.md`に従います：各担当者の取引を成約日で並べ替え、クレジットを合計し、各ティア閾値で分割し、各スライスにそのレートを掛けます。 ### 3. 結果を読む - 高優先：CM01（不明な担当者、不正な金額または日付、不明な取引タイプ）とCM02（分割が100%でない）。これらの取引は保留されます - 給与計算の前に営業オペレーションから回答を得てください。 - 中優先：CM05（承認なしで割引限度超過 - 保留）、CM04（重複行）、CM08（クローバック適用 - 支払い額を確認）、CM11（クローバックが収益より大きい - マイナス残高）。 - 低/情報：他期間の取引（CM03）、期間外の解約、上限（CM06）、アクセラレータ（CM07）、繰延（CM09）、ドロー（CM10）。 - 何も送信する前に、取引ごとのレートスライスに対して1人の担当者を手動で確認します。 ### 4. 解決して再実行する 保留された各取引について、決定（正しい分割、承認が見つかった、担当者割り当て）をCSVに記録し、再実行します。数字を正しく見せるためにプランを変更しないでください。プランが曖昧な場合は、質問を書き留め、両方の結果を示します（例えば、`tier_method`フラット対限界）。 ### 5. 納品する 承認用の支払いテーブル、`templates/commission-statement.md`からの担当者別明細書（すべての取引、レートスライス、上限、クローバック、ドロー明細を含む）、未解決の質問付きの保留取引リスト、および給与計算用のメモ（マイナス残高、ドロー残高、繰延額）を返します。 ## 例の結果 例では、10月の支払い合計は9,500.00 EURで、3件の取引が保留されています。Ana Ruizは60,000のクォータの158.7%に達し（更新Delta Foodsは50%クレジット）、限界ティアで8,280.00に加えて年間前払いSPIFFで400.00を獲得し、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%、承認なし）。 ## ルール - 署名済みプランに従います。プランとデータが矛盾する場合は、取引を保留して質問します - 分割、担当者、承認を推測しないでください。 - 計算を示します：すべての支払いは取引クレジット、ティアスライス、調整に遡れる必要があります。 - ティアを成約日順に適用し、プランが限界かフラットかを明示します。 - クローバックとマイナス残高を慎重に扱います：プランが何を許可するかを述べ、給与から控除する前に人事/給与および現地法を参照してください。 - コミッションデータは機密です：各担当者には自分の明細書のみを共有します。 - これは計算支援であり、法的、税務、または給与計算のアドバイスではありません。