.codex-plugin/plugin.json

{
  "name": "commission-calculator",
  "version": "1.0.0",
  "description": "Commission payouts and rep statements from your comp plan, to the cent.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://commission-calculator.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "commission calculator",
    "sales commission calculator",
    "tiered commission calculator",
    "how to calculate commission",
    "commission statement template",
    "commission calculator excel",
    "commission rate calculator",
    "draw against commission",
    "commission split",
    "commission clawback",
    "commission calculator real estate"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Quotaline Commissions",
    "shortDescription": "Commission payouts, statements",
    "longDescription": "Quotaline Commissions calculates sales commission payouts and commission statements for a sales team from its comp plan. Give it the plan terms and the sales, or attach a deals export from your CRM or spreadsheet, and it works out what each rep earned, deal by deal, to the cent.\n\nIt handles the plan structures that cause commission disputes: flat rates, tiered commission with marginal (stepped) or retroactive tiers, quota attainment with accelerators and decelerators, commission caps, recoverable and non-recoverable draws against commission with the balance carried forward, split deals (60/40 or across several reps), SPIFFs and bonuses, clawbacks for refunded or cancelled deals inside a clawback window, commission on gross margin, and OTE with target variable pay. When a plan does not say whether tiers are retroactive, both results are shown side by side so you can check the signed plan before payroll.\n\nTypical tasks:\n- How much commission do I get on 72k if I earn 5% up to 50k and 8% above?\n- How much commission did each rep earn this month? (upload the deals CSV or Excel file; columns such as rep, deal, amount, margin, close date and status are matched automatically)\n- Recoverable draw against commission: what is payable now and what carries forward?\n- Compare two comp plans at 50% to 200% of quota and see where one overtakes the other.\n\nEach statement lists each deal with the tier and rate applied, the draw recovered, clawbacks and the amount payable now. Download a commission statement PDF (one section per rep, with signature lines) and an Excel workbook with the team summary, each deal line and the tier breakdown. The widget shows rep cards with quota attainment bars and a marginal vs retroactive toggle.\n\nLimitations: it follows the plan terms you enter and does not read comp plan documents. It does not compute payroll taxes, withholding or take-home pay. Up to 5,000 deal rows and 200 reps per run; CSV and .xlsx files only (no PDF or scanned files). Download links expire after about an hour. Results are informational; your signed compensation plan governs.",
    "developerName": "Zovo",
    "category": "Business & Operations",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://commission-calculator.zovo.one",
    "supportURL": "https://commission-calculator.zovo.one/support",
    "privacyPolicyURL": "https://commission-calculator.zovo.one/privacy",
    "termsOfServiceURL": "https://commission-calculator.zovo.one/terms",
    "defaultPrompt": [
      "I get 5% up to 50k then 8% above. How much commission on 72k sales?",
      "Quota $100k, 10% to quota then 15% above. Deals $70k and $55k, $3,000 recoverable draw. What's payable?",
      "Compare comp plans on a $100k quota: flat 10% vs 8% up to quota and 14% above. Where does the second pay more?"
    ],
    "brandColor": "#0F7A55",
    "brandColorDark": "#4FD1A1",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/commission-calculator/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Tiered commission with an unstated tier method (starter prompt 1)",
              "prompt": "I get 5% up to 50k then 8% above. How much commission on 72k sales?",
              "tools_triggered": "calculate_commission",
              "expected_behavior": "Calls calculate_commission with tiers up_to 50000 at 5% and open-ended at 8%, sales_total 72000, and no tier_method. Marginal result: $2,500.00 on the first $50,000 plus $1,760.00 on the $22,000 above, total $4,260.00. Because the question does not say, it also gives the retroactive reading (8% on all $72,000): $5,760.00. The widget shows the tier breakdown, a Marginal/Retroactive toggle, and PDF statement and Excel download buttons."
            },
            {
              "description": "Quota accelerator with a recoverable draw (starter prompt 2)",
              "prompt": "Quota $100k, 10% to quota then 15% above. Deals $70k and $55k, $3,000 recoverable draw. What's payable?",
              "tools_triggered": "calculate_commission",
              "expected_behavior": "Calls calculate_commission with quota 100000, tier_unit quota_percent, tiers 10% up to 100% and 15% above, deals of 70000 and 55000, draw_amount 3000 recoverable. Attainment 125%, credited sales $125,000.00. Marginal: $10,000.00 + $3,750.00 = $13,750.00 earned; after the $3,000.00 draw, payable now $10,750.00. Retroactive reading: $18,750.00 earned, payable now $15,750.00. The widget shows an attainment bar past the quota marker."
            },
            {
              "description": "Compare a flat plan with an accelerated plan (starter prompt 3)",
              "prompt": "Compare comp plans on a $100k quota: flat 10% vs 8% up to quota and 14% above. Where does the second pay more?",
              "tools_triggered": "compare_comp_plans",
              "expected_behavior": "Calls compare_comp_plans with plan_a rate 10 and plan_b quota 100000, tier_unit quota_percent, tiers 8% up to 100% and 14% above. Levels 50% to 200% of quota: at $100,000 the flat plan pays $10,000.00 vs $8,000.00; at $150,000 both pay $15,000.00; at $200,000 the second plan pays $22,000.00 vs $20,000.00. Crossover: the second plan pays more above $150,000.00."
            },
            {
              "description": "Split deal across two reps with statements",
              "prompt": "Split commission 60/40 on a $50,000 deal between Ana and Ben, plus Ana's own $30,000 deal, at 8%. Statements for each rep.",
              "tools_triggered": "generate_commission_statements",
              "expected_behavior": "Calls generate_commission_statements with rate 8 and two deals: the $50,000 deal with splits Ana 60 and Ben 40, and Ana's $30,000 deal. Ana: credited $60,000.00, commission $4,800.00. Ben: credited $20,000.00, commission $1,600.00. Team total $6,400.00. Returns a PDF with one statement section per rep and an Excel workbook."
            },
            {
              "description": "Gross-margin commission with a clawback",
              "prompt": "Gross margin plan at 20% of margin: $40,000 deal at 30% margin, $25,000 at 22%, and last month's $10,000 deal was refunded (I was paid $600).",
              "tools_triggered": "calculate_commission",
              "expected_behavior": "Calls calculate_commission with commission_base gross_margin, rate 20, the two deals with their margin percentages, and the $10,000 deal with status refunded and commission_paid 600. Credited margin $12,000.00 + $5,500.00 = $17,500.00; commission $2,400.00 + $1,100.00 = $3,500.00; clawback -$600.00; total earned and payable $2,900.00."
            }
          ],
          "negative": [
            {
              "description": "Job search, not a calculation. Expected: the assistant answers or searches and does not call any commission tool.",
              "prompt": "sales commission jobs near me"
            },
            {
              "description": "Brokerage trading fees, unrelated to sales commission plans. Expected: no tool call.",
              "prompt": "Which apps offer commission-free trading for stocks and ETFs?"
            },
            {
              "description": "Commissioning artwork. Expected: the assistant answers about art commissions and does not call any commission tool.",
              "prompt": "How much should I charge to commission an artist for a pet portrait?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://commission-calculator.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: sales commission calculator for flat, tiered (marginal and retroactive), quota accelerator, cap, draw, split, SPIFF, clawback and gross-margin plans; per-rep commission statement PDF and Excel from typed deals or an uploaded CSV/XLSX; comp plan comparison.",
        "translations": {
          "pl-PL": {
            "subtitle": "Prowizje i zestawienia",
            "description": "Kalkulator prowizji od sprzeda\u017cy dla prawdziwych plan\u00f3w wynagrodze\u0144. Podaj warunki planu i sprzeda\u017c albo do\u0142\u0105cz eksport transakcji z CRM lub arkusza, a Quotaline Commissions wyliczy, ile zarobi\u0142 ka\u017cdy handlowiec, transakcja po transakcji, co do grosza.\n\nObs\u0142uguje progi marginalne (schodkowe) i retroaktywne, realizacj\u0119 planu (quota) z akceleratorami i deceleratorami, limity prowizji, zaliczki (draw) zwrotne i bezzwrotne z przeniesieniem salda, podzia\u0142 transakcji mi\u0119dzy handlowc\u00f3w, premie SPIFF, zwroty prowizji (clawback) za anulowane lub zwr\u00f3cone transakcje w okre\u015blonym oknie, prowizj\u0119 od mar\u017cy brutto oraz OTE. Gdy plan nie m\u00f3wi, czy progi s\u0105 retroaktywne, pokazuje oba wyniki.\n\nPobierz zestawienie prowizji w PDF (osobna sekcja dla ka\u017cdego handlowca) i skoroszyt Excel z podsumowaniem zespo\u0142u i ka\u017cd\u0105 transakcj\u0105. Por\u00f3wnaj te\u017c dwa plany prowizyjne przy r\u00f3\u017cnych poziomach sprzeda\u017cy.\n\nOgraniczenia: nie liczy podatk\u00f3w ani wynagrodzenia netto, nie czyta dokument\u00f3w planu, do 5000 wierszy i 200 handlowc\u00f3w na raz, tylko pliki CSV i .xlsx. Linki do pobrania wygasaj\u0105 po oko\u0142o godzinie."
          },
          "de-DE": {
            "subtitle": "Provisionen und Abrechnungen",
            "description": "Ein Provisionsrechner f\u00fcr echte Verg\u00fctungspl\u00e4ne im Vertrieb. Geben Sie die Planbedingungen und die Ums\u00e4tze ein oder h\u00e4ngen Sie einen Deal-Export aus CRM oder Tabelle an, und Quotaline Commissions berechnet f\u00fcr jeden Vertriebsmitarbeiter die Provision pro Abschluss, auf den Cent genau.\n\nUnterst\u00fctzt Staffelprovisionen mit marginalen (stufenweisen) oder r\u00fcckwirkenden Stufen, Zielerreichung (Quota) mit Akzeleratoren und Dezeleratoren, Provisionsobergrenzen, r\u00fcckzahlbare und nicht r\u00fcckzahlbare Vorsch\u00fcsse (Draw) mit Saldovortrag, geteilte Abschl\u00fcsse, SPIFFs und Boni, R\u00fcckforderungen (Clawbacks) bei Stornos oder Erstattungen innerhalb einer Frist, Provision auf den Rohertrag sowie OTE. Wenn der Plan nicht sagt, ob die Stufen r\u00fcckwirkend gelten, werden beide Ergebnisse gezeigt.\n\nLaden Sie eine Provisionsabrechnung als PDF (ein Abschnitt pro Mitarbeiter) und eine Excel-Arbeitsmappe mit Team\u00fcbersicht und allen Abschl\u00fcssen herunter. Vergleichen Sie au\u00dferdem zwei Provisionspl\u00e4ne bei verschiedenen Umsatzniveaus.\n\nGrenzen: keine Steuer- oder Nettolohnberechnung, liest keine Plandokumente, bis zu 5.000 Zeilen und 200 Mitarbeiter pro Lauf, nur CSV- und .xlsx-Dateien. Download-Links laufen nach etwa einer Stunde ab."
          },
          "es-ES": {
            "subtitle": "Comisiones y liquidaciones",
            "description": "Una calculadora de comisiones de ventas para planes de compensaci\u00f3n reales. Indica las condiciones del plan y las ventas, o adjunta una exportaci\u00f3n de operaciones del CRM o de una hoja de c\u00e1lculo, y Quotaline Commissions calcula lo que gan\u00f3 cada comercial, operaci\u00f3n por operaci\u00f3n, al c\u00e9ntimo.\n\nAdmite tramos marginales (escalonados) o retroactivos, cumplimiento de cuota con aceleradores y deceleradores, topes de comisi\u00f3n, anticipos (draw) recuperables y no recuperables con saldo arrastrado, operaciones compartidas, SPIFF y bonos, recuperaci\u00f3n de comisiones (clawback) por devoluciones o cancelaciones dentro de un plazo, comisi\u00f3n sobre margen bruto y OTE. Si el plan no aclara si los tramos son retroactivos, muestra ambos resultados.\n\nDescarga una liquidaci\u00f3n de comisiones en PDF (una secci\u00f3n por comercial) y un libro de Excel con el resumen del equipo y cada operaci\u00f3n. Tambi\u00e9n puedes comparar dos planes de comisiones en distintos niveles de ventas.\n\nLimitaciones: no calcula impuestos ni salario neto, no lee documentos del plan, hasta 5.000 filas y 200 comerciales por ejecuci\u00f3n, solo archivos CSV y .xlsx. Los enlaces de descarga caducan en aproximadamente una hora."
          },
          "fr-FR": {
            "subtitle": "Commissions et relev\u00e9s",
            "description": "Un calculateur de commissions commerciales pour de vrais plans de r\u00e9mun\u00e9ration. Indiquez les conditions du plan et les ventes, ou joignez un export des affaires depuis votre CRM ou un tableur, et Quotaline Commissions calcule ce que chaque commercial a gagn\u00e9, affaire par affaire, au centime pr\u00e8s.\n\nIl g\u00e8re les paliers marginaux (progressifs) ou r\u00e9troactifs, l'atteinte de quota avec acc\u00e9l\u00e9rateurs et d\u00e9c\u00e9l\u00e9rateurs, les plafonds, les avances sur commission (draw) r\u00e9cup\u00e9rables ou non avec report du solde, les affaires partag\u00e9es, les SPIFF et primes, les reprises de commission (clawback) en cas de remboursement ou d'annulation dans un d\u00e9lai, la commission sur marge brute et l'OTE. Si le plan ne pr\u00e9cise pas si les paliers sont r\u00e9troactifs, les deux r\u00e9sultats sont affich\u00e9s.\n\nT\u00e9l\u00e9chargez un relev\u00e9 de commissions en PDF (une section par commercial) et un classeur Excel avec la synth\u00e8se de l'\u00e9quipe et chaque affaire. Comparez aussi deux plans de commissions \u00e0 plusieurs niveaux de ventes.\n\nLimites : ne calcule ni imp\u00f4ts ni salaire net, ne lit pas les documents du plan, jusqu'\u00e0 5 000 lignes et 200 commerciaux par calcul, fichiers CSV et .xlsx uniquement. Les liens de t\u00e9l\u00e9chargement expirent apr\u00e8s environ une heure."
          },
          "ja-JP": {
            "subtitle": "\u55b6\u696d\u30b3\u30df\u30c3\u30b7\u30e7\u30f3\u8a08\u7b97\u3068\u660e\u7d30",
            "description": "\u5b9f\u969b\u306e\u5831\u916c\u30d7\u30e9\u30f3\u306b\u5bfe\u5fdc\u3057\u305f\u55b6\u696d\u30b3\u30df\u30c3\u30b7\u30e7\u30f3\u8a08\u7b97\u30c4\u30fc\u30eb\u3067\u3059\u3002\u30d7\u30e9\u30f3\u6761\u4ef6\u3068\u58f2\u4e0a\u3092\u5165\u529b\u3059\u308b\u304b\u3001CRM\u3084\u30b9\u30d7\u30ec\u30c3\u30c9\u30b7\u30fc\u30c8\u304b\u3089\u51fa\u529b\u3057\u305f\u6848\u4ef6\u4e00\u89a7\u3092\u6dfb\u4ed8\u3059\u308b\u3068\u3001Quotaline Commissions\u304c\u62c5\u5f53\u8005\u3054\u3068\u306e\u7372\u5f97\u30b3\u30df\u30c3\u30b7\u30e7\u30f3\u3092\u6848\u4ef6\u5358\u4f4d\u30671\u30bb\u30f3\u30c8\u5358\u4f4d\u307e\u3067\u8a08\u7b97\u3057\u307e\u3059\u3002\n\n\u9650\u754c\u7684\uff08\u6bb5\u968e\u7684\uff09\u30c6\u30a3\u30a2\u3068\u9061\u53ca\u30c6\u30a3\u30a2\u3001\u30ce\u30eb\u30de\u9054\u6210\u7387\u306b\u5fdc\u3058\u305f\u30a2\u30af\u30bb\u30e9\u30ec\u30fc\u30bf\u30fc\u3068\u30c7\u30a3\u30bb\u30e9\u30ec\u30fc\u30bf\u30fc\u3001\u4e0a\u9650\u984d\u3001\u8fd4\u6e08\u578b\u30fb\u975e\u8fd4\u6e08\u578b\u306e\u30c9\u30ed\u30fc\uff08\u524d\u6255\u3044\uff09\u3068\u6b8b\u9ad8\u306e\u7e70\u8d8a\u3001\u6848\u4ef6\u306e\u5206\u5272\u3001SPIFF\u3084\u30dc\u30fc\u30ca\u30b9\u3001\u671f\u9593\u5185\u306e\u8fd4\u91d1\u30fb\u89e3\u7d04\u306b\u3088\u308b\u30af\u30ed\u30fc\u30d0\u30c3\u30af\u3001\u7c97\u5229\u30d9\u30fc\u30b9\u306e\u30b3\u30df\u30c3\u30b7\u30e7\u30f3\u3001OTE\u306b\u5bfe\u5fdc\u3057\u307e\u3059\u3002\u30d7\u30e9\u30f3\u306b\u30c6\u30a3\u30a2\u304c\u9061\u53ca\u578b\u304b\u3069\u3046\u304b\u306e\u8a18\u8f09\u304c\u306a\u3044\u5834\u5408\u306f\u3001\u4e21\u65b9\u306e\u7d50\u679c\u3092\u8868\u793a\u3057\u307e\u3059\u3002\n\n\u62c5\u5f53\u8005\u3054\u3068\u306e\u30bb\u30af\u30b7\u30e7\u30f3\u3092\u542b\u3080\u30b3\u30df\u30c3\u30b7\u30e7\u30f3\u660e\u7d30PDF\u3068\u3001\u30c1\u30fc\u30e0\u96c6\u8a08\u3068\u5168\u6848\u4ef6\u3092\u542b\u3080Excel\u30d6\u30c3\u30af\u3092\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u307e\u3059\u30022\u3064\u306e\u5831\u916c\u30d7\u30e9\u30f3\u3092\u8907\u6570\u306e\u58f2\u4e0a\u6c34\u6e96\u3067\u6bd4\u8f03\u3059\u308b\u3053\u3068\u3082\u3067\u304d\u307e\u3059\u3002\n\n\u5236\u9650\u4e8b\u9805\uff1a\u7a0e\u91d1\u3084\u624b\u53d6\u308a\u984d\u306f\u8a08\u7b97\u3057\u307e\u305b\u3093\u3002\u30d7\u30e9\u30f3\u6587\u66f8\u306f\u8aad\u307f\u53d6\u308a\u307e\u305b\u3093\u30021\u56de\u3042\u305f\u308a\u6700\u59275,000\u884c\u30fb200\u4eba\u3001CSV\u3068.xlsx\u306e\u307f\u5bfe\u5fdc\u3002\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u30ea\u30f3\u30af\u306f\u7d041\u6642\u9593\u3067\u5931\u52b9\u3057\u307e\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Comiss\u00f5es e extratos",
            "description": "Uma calculadora de comiss\u00e3o de vendas para planos de remunera\u00e7\u00e3o reais. Informe as regras do plano e as vendas, ou anexe uma exporta\u00e7\u00e3o de neg\u00f3cios do CRM ou da planilha, e o Quotaline Commissions calcula quanto cada vendedor ganhou, neg\u00f3cio a neg\u00f3cio, at\u00e9 o centavo.\n\nSuporta faixas marginais (escalonadas) ou retroativas, atingimento de cota com aceleradores e desaceleradores, teto de comiss\u00e3o, adiantamentos (draw) recuper\u00e1veis e n\u00e3o recuper\u00e1veis com saldo transportado, neg\u00f3cios divididos, SPIFFs e b\u00f4nus, estorno de comiss\u00e3o (clawback) por reembolso ou cancelamento dentro de um prazo, comiss\u00e3o sobre margem bruta e OTE. Quando o plano n\u00e3o diz se as faixas s\u00e3o retroativas, os dois resultados s\u00e3o mostrados.\n\nBaixe um extrato de comiss\u00f5es em PDF (uma se\u00e7\u00e3o por vendedor) e uma pasta de trabalho do Excel com o resumo da equipe e cada neg\u00f3cio. Compare tamb\u00e9m dois planos de comiss\u00e3o em v\u00e1rios n\u00edveis de vendas.\n\nLimita\u00e7\u00f5es: n\u00e3o calcula impostos nem sal\u00e1rio l\u00edquido, n\u00e3o l\u00ea documentos do plano, at\u00e9 5.000 linhas e 200 vendedores por execu\u00e7\u00e3o, apenas arquivos CSV e .xlsx. Os links de download expiram em cerca de uma hora."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}