omni_tiered_affiliate_commission
Calculate tiered affiliate commission payouts, platform tracking overrides, and net return from sales volume, base/elevated rates, thresholds, and network fees.
Instructions
Tiered Affiliate Marketing Commission & Payout Calculator. Calculate blended affiliate commission payouts, network platform tracking overrides, and net affiliate return across tiered sales performance brackets. Discipline: ECOMMERCE. Governing mathematical model / formula: Total Payout = Tier 1 Payout + Tier 2 Payout + Network Override Fee.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_affiliate_payout (Total Affiliate Partner Commission), platform_tracking_fee_total (Network Platform Override Fees), effective_blended_commission_pct (Effective Blended Partner Rate), total_partner_acquisition_cost (Total Program Acquisition Cost) using affiliate_generated_sales (Affiliate Driven Sales Volume in $), tier_1_base_commission_pct (Tier 1 Base Commission (%) in %), tier_2_volume_threshold (Tier 2 Performance Threshold in $), tier_2_elevated_commission_pct (Tier 2 Elevated Commission (%) in %), network_platform_override_pct (SaaS Platform Network Fee (%) in %). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Tiered Affiliate Marketing Commission & Payout Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "tiered-affiliate-commission"
category (string): "ecommerce"
name (string): "Tiered Affiliate Marketing Commission & Payout Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_affiliate_payout (Total Affiliate Partner Commission): Formatted display string (e.g. '$8,250')
metrics.platform_tracking_fee_total (Network Platform Override Fees): Formatted display string (e.g. '$1,625')
metrics.effective_blended_commission_pct (Effective Blended Partner Rate): Formatted display string (e.g. '12.69%')
metrics.total_partner_acquisition_cost (Total Program Acquisition Cost): Formatted display string (e.g. '$9,875 (15.19% of Sales)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_tiered_affiliate_commission"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier_2_volume_threshold | No | Tier 2 Performance Threshold ($). Sales threshold where higher commission tier unlocks. Default: 30000. Min: 5000. Max: 200000. | |
| affiliate_generated_sales | No | Affiliate Driven Sales Volume ($). Total verified sales generated by affiliate partner. Default: 65000. Min: 1000. Max: 1000000. | |
| tier_1_base_commission_pct | No | Tier 1 Base Commission (%) (%). Base commission rate up to threshold volume. Default: 10. Min: 2. Max: 35. | |
| network_platform_override_pct | No | SaaS Platform Network Fee (%) (%). Impact.com, ShareASale, or CJ Affiliate tracking fee. Default: 2.5. Min: 0. Max: 10. | |
| tier_2_elevated_commission_pct | No | Tier 2 Elevated Commission (%) (%). Higher rate applied to sales above the tier 2 threshold. Default: 15. Min: 5. Max: 50. |