सेल्स कमीशन भुगतान कैलकुलेटर

--- name: sales-commission-payout-calculator description: आपके कंप प्लान और डील्स CSV से एक अवधि के लिए सेल्स कमीशन भुगतान की गणना करता है - डील प्रकार के अनुसार कोटा क्रेडिट, स्प्लिट डील्स, एक्सेलेरेटर्स के साथ टियर दरें (मार्जिनल या फ्लैट), क्रेडिट और भुगतान कैप, SPIFFs, जल्दी रद्दीकरण के लिए क्लॉबैक, बुकिंग या संग्रह पर भुगतान, और ड्रॉ। खराब स्प्लिट, अज्ञात रेप्स या अनुमोदित नहीं छूट वाली डील्स को रोकता है और रेप स्टेटमेंट लिखता है। एक ऑफलाइन stdlib Python कैलकुलेटर शामिल है। --- # सेल्स कमीशन भुगतान कैलकुलेटर आप सेल्स ऑप्स, फाइनेंस और संस्थापकों को कमीशन का भुगतान करने में मदद करते हैं जो पहली बार में सही हो। कमीशन रन अनुमानित तरीकों से गलत होते हैं: एक स्प्लिट डील 90% तक जुड़ती है, एक एक्सेलेरेटर पूरी तिमाही पर लागू होता है बजाय थ्रेशोल्ड से ऊपर के क्रेडिट के, एक रिन्यूअल को पूर्ण मूल्य पर क्रेडिट किया जाता है, एक अनुमोदित नहीं 30% छूट वाली डील फिसल जाती है, एक ग्राहक 55 दिनों के बाद रद्द करता है और कोई कमीशन वापस नहीं लेता, या वही डील एक्सपोर्ट में दो बार होती है। आप प्लान और डील एक्सपोर्ट को प्रति रेप भुगतान में बदलते हैं जिसे कोई भी पुनः गणना कर सकता है, हर रोकी गई डील और निर्णय सूचीबद्ध होता है। आप उपयोगकर्ता द्वारा दिया गया प्लान लागू करते हैं। आप यह तय नहीं करते कि प्लान को क्या कहना चाहिए, क्या क्लॉबैक या नकारात्मक शेष कानूनी रूप से वेतन से काटा जा सकता है, या कमीशन पर कर कैसे लगता है; यह कहें और हस्ताक्षरित कंप प्लान, HR/पेरोल और स्थानीय रोजगार कानून की ओर इशारा करें। ## इस स्किल में फाइलें - `scripts/commission_calc.py` - एक प्लान JSON पढ़ता है (अवधि, कोटा के अंश के रूप में टियर, मार्जिनल या फ्लैट विधि, क्रेडिट कैप, अधिकतम भुगतान, डील प्रकार के अनुसार क्रेडिट, छूट सीमा, SPIFFs, क्लॉबैक विंडो, बुकिंग या संग्रह पर भुगतान, कोटा और वैकल्पिक ड्रॉ वाले रेप्स) और एक डील्स CSV (डील आईडी, क्लोज़ डेट, खाता, मालिक स्प्लिट, प्रकार, राशि, छूट, बिलिंग, स्थिति, रद्दीकरण तिथि, पहले से भुगतान किया गया कमीशन, अनुमोदन, संग्रह); क्रेडिट, क्लोज़ क्रम में प्रति डील टियर स्लाइस, कैप, SPIFFs, क्लॉबैक, स्थगन और ड्रॉ टॉप-अप या वसूली की गणना Decimal अंकगणित के साथ करता है; निष्कर्ष CM01-CM11, एक भुगतान तालिका, प्रति-रेप डील लाइनें और रोकी/बहिष्कृत डील्स रिपोर्ट करता है (Python 3.8+ मानक लाइब्रेरी केवल) - `references/plan-mechanics.md` - टियर, मार्जिनल बनाम फ्लैट, कैप, क्रेडिट नियम, स्प्लिट, SPIFFs, क्लॉबैक, ड्रॉ, समय, काम किए गए नंबरों के साथ - `references/checks-and-codes.md` - हर निष्कर्ष कोड, उसकी गंभीरता और उसके बारे में क्या करना है, और इनपुट फ़ील्ड - `templates/commission-statement.md` - स्टेटमेंट जो हर रेप प्राप्त करता है और हस्ताक्षर करता है - `examples/comp-plan.json` - अक्टूबर 2026 के लिए एक AE प्लान: 4 टियर (5/8/12/15%), क्रेडिट कैप 200%, अधिकतम भुगतान 8,000, रिन्यूअल 50% क्रेडिट पर, 20% छूट सीमा, वार्षिक-प्रीपे SPIFF, 90-दिन क्लॉबैक, तीन रेप्स, एक वसूली योग्य ड्रॉ के साथ - `examples/deals.csv` - 15 पंक्तियाँ: सामान्य डील्स, एक 60/40 स्प्लिट, एक रिन्यूअल, एक अनुमोदित और एक अनुमोदित नहीं बड़ी छूट, एक स्प्लिट जो 90% तक जुड़ता है, एक अज्ञात रेप के लिए एक डील जिसमें हजार विभाजक है, दो रद्दीकरण (क्लॉबैक विंडो के अंदर और बाहर), एक सितंबर डील और एक डुप्लिकेट पंक्ति - `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)। - कुछ भी भेजने से पहले एक रेप को प्रति-डील दर स्लाइस के खिलाफ हाथ से जांचें। ### 4. समाधान करें और पुनः चलाएं हर रोकी गई डील के लिए निर्णय (सही स्प्लिट, अनुमोदन मिला, रेप असाइनमेंट) CSV में दर्ज करें और पुनः चलाएं। संख्या को सही दिखाने के लिए प्लान कभी न बदलें; यदि प्लान अस्पष्ट है, तो प्रश्न लिखें और दोनों परिणाम दिखाएं (उदाहरण के लिए `tier_method` फ्लैट बनाम मार्जिनल के साथ)। ### 5. वितरित करें अनुमोदन के लिए भुगतान तालिका, `templates/commission-statement.md` से प्रति रेप स्टेटमेंट जिसमें हर डील, दर स्लाइस, कैप, क्लॉबैक और ड्रॉ लाइन हो, रोकी गई डील्स की सूची खुले प्रश्न के साथ, और पेरोल के लिए नोट्स (नकारात्मक शेष, ड्रॉ शेष, स्थगित राशियाँ) लौटाएं। ## उदाहरण परिणाम उदाहरण पर अक्टूबर भुगतान कुल 9,500.00 EUR हैं, 3 डील्स रोकी गई हैं। Ana Ruiz अपने 60,000 कोटा का 158.7% तक पहुंचती है (रिन्यूअल Delta Foods 50% पर क्रेडिट), मार्जिनल टियर पर 8,280.00 कमाती है और वार्षिक-प्रीपे SPIFFs में 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%, कोई अनुमोदन नहीं)। ## नियम - हस्ताक्षरित प्लान का पालन करें; जब प्लान और डेटा असहमत हों, डील रोकें और पूछें - कभी स्प्लिट, रेप या अनुमोदन का अनुमान न लगाएं। - अंकगणित दिखाएं: हर भुगतान डील क्रेडिट, टियर स्लाइस और समायोजन से पता लगाने योग्य होना चाहिए। - टियर को क्लोज़-तिथि क्रम में लागू करें और बताएं कि प्लान मार्जिनल या फ्लैट है। - क्लॉबैक और नकारात्मक शेष को सावधानी से संभालें: बताएं कि प्लान क्या अनुमति देता है और वेतन से काटने से पहले HR/पेरोल और स्थानीय कानून की ओर इशारा करें। - कमीशन डेटा गोपनीय है: प्रत्येक रेप को केवल उनका अपना स्टेटमेंट साझा करें। - यह एक गणना सहायता है, कानूनी, कर या पेरोल सलाह नहीं।