Docs Library

Guide

Recoup each advance against the contract that paid it

When a payee has more than one contract, an advance on one contract should be recouped from that contract's income. Contract accounts keep a separate balance for each contract, payee and currency.

Best For Royalty teams who pay advances or recoup costs contract by contract.

Give a payee an account on a contract, see what is still to recoup after each locked calculation and pool contracts that share one advance.

To try sample data, create a free workspace and choose the SaaS Affiliate sample during setup.

On This Page

Before You Begin

  • Have Owner, Admin or Finance access to set accounts, pools and balance moves. Viewers can read balances.
  • Link the royalty rules for the contract to it in the rule editor. Income from rules without a contract stays on the Default agreement.

Expected Result

Each contract shows what the payee still has to recoup on it, and each calculation shows how much every contract contributed.

Steps

Follow this path

  1. 01

    Open the contract, or amend an active one, and add an account in the Accounts block: the payee, the currency, and the opening balance, advance, expenses and clawback to recoup.

  2. 02

    To recoup several contracts together, create a pool for the payee and currency and choose it on each account.

  3. 03

    If the payee's advance is still recorded on the payee, open the contract and choose Move balance from Default agreement. Enter the amount, the reason and the date it takes effect.

  4. 04

    Run and lock the calculation for the period.

  5. 05

    Check the contract page, the payee's Contracts tab and the payee row of the calculation (By contract) for what was recouped and what is left.

  6. 06

    Generate statements. The payee's statement and its Payee Portal page show a Contract Balances table with each account's opening, earned, recouped and closing amounts.

Details

What to know

Which income recoups which account

Allocora assigns each calculated amount to one account of the payee.

  • Income from a rule linked to a contract goes to that contract's account for the payee and currency, using the contract version in force on the income date. A pooled account recoups with its pool.
  • Tier bonuses follow the rule of their tier program.
  • Income from rules without a contract, fallback percentages and contracts where the payee has no account in that currency count toward the Default agreement. The calculation warns about the contract in the last case.

How each account recoups

Every account recoups in a fixed order: refund carry, then the opening balance, the advance, expenses and clawback.

  • A refund on one contract creates carry on that account only; it does not reduce income on another contract.
  • A pool recoups as one account across its contracts. Each recouped amount counts first toward the account whose income paid it, then toward the oldest accounts, so the contract page can show the pool balance and the part that belongs to this account.
  • An account brings its advance and costs once. When an amendment moves it into or out of a pool, its balance goes with it; when the account is removed from the contract, its balance returns to the Default agreement.
  • Reserve and the payout threshold apply to the payee's total after all accounts have recouped.
  • A payee whose income and balances all sit on the Default agreement is calculated exactly as before.

The Default agreement

Balances set on the payee record (opening balance, advance, expenses, clawback) belong to the payee's Default agreement. Income outside contract accounts recoups them.

  • Allocora does not split these balances automatically. To move part of them to a contract, use Move balance from Default agreement on that contract.
  • A move can take no more than the balance left after the last locked calculation and earlier moves, and its date must fall after the end of that calculation.
  • A move goes into a draft or active contract where the payee already has an account in that currency. It is recorded with its reason and cannot be edited afterwards.

Reference Tables

Fields and checks

Example: two contracts, one advance

Contract A carries an advance of 100; contract B has none. In the period, A earns 50 and B earns 80.

Setup Contract A Contract B Payable
Separate accounts Recoups 50, still to recoup 50 Net 80 80
A and B in one pool Pool recoups the advance of 100 from 130 Net 30 for the pool 30

Troubleshooting

If this does not work

The calculation says income under a contract counted toward the Default agreement.

The payee has no account in that currency on the contract. Amend the contract to add the account; the next calculation recoups it there.

Move balance from Default agreement rejects the amount.

The message shows the balance left on the Default agreement. Enter that amount or less, with a date after the end of the last locked calculation.

A pool cannot be archived.

Remove the pool from the current terms of its contracts by amending them, then archive the pool.

Apply this in a workspace

Create a free workspace, explore sample data, and import your own revenue when you are ready.