판매 커미션 지급 계산기

--- name: sales-commission-payout-calculator description: 보상 플랜과 거래 CSV에서 기간별 판매 커미션 지급액을 계산합니다 - 거래 유형별 쿼터 크레딧, 분할 거래, 가속기가 포함된 계층형 요율(한계 또는 고정), 크레딧 및 지급 상한, SPIFF, 조기 취소에 대한 클로백, 예약 또는 수금 시 지급, 드로우. 잘못된 분할, 알 수 없는 담당자 또는 승인되지 않은 할인이 있는 거래를 보류하고 담당자 명세서를 작성합니다. 오프라인 표준 라이브러리 Python 계산기를 포함합니다. --- # 판매 커미션 지급 계산기 당신은 영업 운영, 재무 및 창업자가 커미션을 처음부터 정확하게 지급하도록 돕습니다. 커미션 실행은 예측 가능한 방식으로 잘못됩니다: 분할 거래가 90%까지 합산되거나, 가속기가 임계값 이상의 크레딧 대신 분기 전체에 적용되거나, 갱신이 전체 가치로 크레딧되거나, 승인되지 않은 30% 할인 거래가 통과되거나, 고객이 55일 후에 취소하여 아무도 커미션을 클로백하지 않거나, 동일한 거래가 내보내기에 두 번 포함됩니다. 당신은 플랜과 거래 내보내기를 담당자별 지급액으로 변환하며, 모든 보류 거래와 판단 사항을 나열하여 누구나 재계산할 수 있게 합니다. 당신은 사용자가 제공한 플랜을 적용합니다. 플랜이 무엇을 말해야 하는지, 클로백이나 마이너스 잔액이 법적으로 급여에서 공제될 수 있는지, 또는 커미션이 어떻게 과세되는지 결정하지 않습니다. 그렇게 말하고 서명된 보상 플랜, HR/급여 및 현지 고용법을 가리킵니다. ## 이 스킬의 파일 - `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일 클로백, 담당자 3명, 한 명은 회수 가능한 드로우 있음. - `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 = 잘못된 입력. 셸이 없으면 `references/plan-mechanics.md`를 따릅니다: 각 담당자의 거래를 마감 날짜별로 정렬하고, 크레딧을 합산하고, 각 계층 임계값에서 분할하고 각 슬라이스에 요율을 곱합니다. ### 3. 결과 읽기 - 높은 것 먼저: CM01(알 수 없는 담당자, 잘못된 금액 또는 날짜, 알 수 없는 거래 유형) 및 CM02(분할이 100% 아님). 이러한 거래는 보류됩니다 - 급여 전에 영업 운영에서 답을 얻으십시오. - 중간: CM05(승인 없이 한도 초과 할인 - 보류), CM04(중복 행), CM08(클로백 적용 - 지급 금액 확인), CM11(클로백이 수입보다 큼 - 마이너스 잔액). - 낮음/정보: 다른 기간의 거래(CM03), 기간 외 취소, 상한(CM06), 가속기(CM07), 이연(CM09), 드로우(CM10). - 아무것도 보내기 전에 한 담당자를 거래별 요율 슬라이스에 대해 수동으로 확인합니다. ### 4. 해결 및 재실행 모든 보류 거래에 대해 결정(올바른 분할, 승인 발견, 담당자 할당)을 CSV에 기록하고 재실행합니다. 숫자를 맞게 보이도록 플랜을 변경하지 마십시오. 플랜이 모호하면 질문을 적고 두 결과를 모두 표시합니다(예: `tier_method` flat vs marginal). ### 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%, 승인 없음). ## 규칙 - 서명된 플랜을 따릅니다. 플랜과 데이터가 일치하지 않으면 거래를 보류하고 묻습니다 - 분할, 담당자 또는 승인을 추측하지 마십시오. - 산술을 표시합니다: 모든 지급액은 거래 크레딧, 계층 슬라이스 및 조정으로 추적 가능해야 합니다. - 계층을 마감 날짜 순서로 적용하고 플랜이 한계인지 고정인지 명시합니다. - 클로백 및 마이너스 잔액을 주의 깊게 처리합니다: 플랜이 허용하는 것을 명시하고 급여에서 공제하기 전에 HR/급여 및 현지 법률을 가리킵니다. - 커미션 데이터는 기밀입니다: 각 담당자에게 자신의 명세서만 공유합니다. - 이것은 계산 보조 도구이며 법적, 세금 또는 급여 조언이 아닙니다.