Common Settlement Allocator mistakes in Brazil
6 min read
Published April 15, 2026 • By DocketMath Team
The top mistakes
Run this scenario in DocketMath using the Settlement Allocator calculator.
Using DocketMath’s Settlement Allocator for Brazil gets easier once you respect a few jurisdiction-aware realities. The most common errors aren’t “math” mistakes—they’re allocation logic mistakes that quietly shift amounts among categories you later need to justify.
Below are the top pitfalls we see when allocating settlement proceeds in a Brazilian context (BR).
1) Misclassifying the settlement components (principal vs. ancillary)
A frequent issue is treating the entire settlement as one bucket. In Brazil, the breakdown matters because different portions may be handled differently in documentation and downstream accounting.
Typical symptom in DocketMath outputs
- Category totals look internally consistent, but your “principal” line item doesn’t match what your settlement language supports.
- Reports become harder to reconcile with invoices, payroll records, or tax/withholding treatment you prepared for other purposes.
2) Ignoring exclusion rules embedded in allocation logic
Settlement Allocator scenarios often include exclusion toggles (for example: excluding certain components or parties from specific pools). Users sometimes leave default exclusions in place or disable them inadvertently.
Result
- The allocated remainder doesn’t equal the settlement total (or equals it only after an adjustment you didn’t intend).
- One category absorbs costs meant for another category.
3) Using the wrong weighting base (and not documenting it)
DocketMath can allocate by weights—often based on days, percentages, claim strength inputs, or agreed ratios. The error is supplying those weights without matching the settlement agreement’s chosen basis.
Common pattern
- A settlement says “allocated according to the claim value,” but the input uses “number of events” or “time on record” as the weighting base.
- Your output then matches the calculator, not the contract.
4) Double-counting attorneys’ fees or costs
Another classic error is entering fees/costs both as part of the gross settlement and again in a separate allocator field.
What happens
- Allocations sum correctly internally, yet the “net to each claimant” is too low (because deductions are effectively applied twice).
- You later “fix” by manual edits, which breaks auditability.
5) Failing to align currency/rounding rules across inputs
Settlement allocations often require precision. In Brazil, rounding practices can impact totals (especially when the tool allocates to multiple parties).
Symptom
- Each party looks reasonable, but the last party absorbs rounding deltas.
- Your reconciliation step flags “off by R$ X” and triggers unnecessary re-work.
6) Not setting “who is eligible” consistently across the scenario
If the settlement includes multiple claimants, but eligibility differs by category, users often apply one eligibility rule to all categories.
Outcome
- A party is included in distributions they shouldn’t receive—or excluded where the agreement clearly includes them.
- Outputs that are mathematically valid but factually mismatched.
Warning: If your Settlement Allocator configuration doesn’t mirror the settlement agreement’s component definitions and eligibility rules, the calculator can still produce “correct math” while producing “wrong allocations.” Always reconcile the tool’s categories to the language used in the settlement.
How to avoid them
To keep DocketMath’s Settlement Allocator reliable for Brazil, build your configuration around reconciliation checkpoints: totals, categories, eligibility, and documentation alignment.
Use a written checklist for inputs, document each source, and run a quick sensitivity check before finalizing the result. When two runs differ, compare inputs line by line and re-run with one variable changed at a time.
Step 1: Map settlement terms to allocator categories before typing numbers
Create a quick mapping list from the agreement:
- Principal: the core awarded/claimed amount
- Ancillary: interest, monetary correction, penalties, or other add-ons (whatever your agreement labels)
- Fees/costs: attorneys’ fees, expert costs, administrative costs
- Adjustments: any offsets, reimbursements, or special handling
Then enter those mappings into DocketMath so your category totals reflect the agreement structure—not just a convenient grouping.
Step 2: Use a two-pass approach: allocate gross first, then apply deductions once
In practice:
- Pass A (gross allocation): distribute the agreed settlement pool across eligible recipients using the agreed weighting base.
- Pass B (deductions): apply fees/costs only in the dedicated deduction fields—not inside the gross pool.
This prevents double-counting. In DocketMath, confirm that:
- “Fees included in gross” is off if you also entered fees in a separate fee field
- “Deductions applied” is on only once
Step 3: Choose a weighting base you can defend
If the settlement says “by claim value,” use weights that match claim value. If the settlement says “by days,” use days.
A practical checklist for the weighting base:
Step 4: Reconcile totals at three levels
Do not stop at “the grand total matches.” Validate at:
- Gross total vs. settlement amount
- Category totals vs. the agreement’s component breakdown
- Net-to-parties total vs. what each claimant record expects
When you see a mismatch, don’t “eyeball” an adjustment. Instead:
- inspect eligibility settings,
- check exclusion toggles,
- verify rounding settings,
- and confirm there’s no second fee entry.
If you want a quick start, go directly to /tools/settlement-allocator.
Step 5: Standardize rounding so differences land in one place
Before generating the final output:
- set rounding precision consistently for the scenario
- decide whether DocketMath should allocate rounding remainder to a designated party (if supported)
- document the rounding policy in your internal notes
This reduces the “off by a small amount” cycle that often wastes time in Brazilian settlement reconciliations.
Step 6: Create an audit-friendly snapshot of the scenario inputs
After you finalize inputs in DocketMath, capture a snapshot (internally) that includes:
- category definitions used
- eligibility criteria per party
- weighting base and units
- fee/cost application method
That snapshot becomes your reconciliation bridge if questions arise later during internal review.
Practical tip (not legal advice): Avoid “manual edits” after running the allocator. If you must adjust outputs, adjust the inputs or configuration and re-run so your final totals remain traceable.
