Liquidity structures

A liquidity structure shows which accounts concentrate into which parent accounts. The header account sits at the top. Each structure uses one currency and one liquidity-management enrolment.

Read the tree

In the client app, open Accounts → Liquidity. In the bank app, open the counterparty’s Liquidity panel. Select a structure and an As at date. The initial date is tomorrow on your organisation’s trading calendar.

The approved tree shows the structure on that date. A pending change appears beneath it, with its proposer, side and effective date. Added pairs appear green, removed pairs appear struck through, and moved pairs show their previous and proposed parents.

A broken pair shows the affected account, reason and starting date. Other branches continue to appear normally. These screens describe the structure. The sweep history below shows the money each run actually moved.

Propose and review a change

  1. Under Propose changes, choose an effective date after the current trading date.
  2. Find the account by its account number.
  3. Choose an edit and its accounts, then select Add edit.
  4. Add further edits to the same change when needed.
  5. Select Submit change.

For a header replacement, choose whether the old header leaves or becomes a child of the new header. The system checks the complete proposed tree together. Only one change can await the other side at a time.

If the other side proposed the change, review its diff before selecting Approve or Reject. A rejection requires a reason. If your side proposed it, you can Withdraw it. Your organisation may require further signatures before your action takes effect.

flowchart LR
  P["Pending change"] -->|"Other side approves"| S["Scheduled"]
  P -->|"Other side rejects"| R["Rejected"]
  P -->|"Proposing side withdraws"| W["Withdrawn"]
  P -->|"Effective date arrives first"| L["Lapsed"]
  style P fill:#1e40af,color:#ffffff
  style S fill:#059669,color:#ffffff
  style R fill:#b45309,color:#ffffff
  style W fill:#374151,color:#ffffff
  style L fill:#7c3aed,color:#ffffff

Follow a dated move

Using the tree’s effective-date convention, account 4001-21 currently concentrates into 4001-11. A pending change moves it beneath 4001-01 from 1 December 2026. Until the other side approves, the approved tree retains 4001-11 as its parent. After approval, the move appears on reads from 1 December onward. Earlier dates retain the earlier parent.

Cancel a scheduled change

Before a scheduled change takes effect, select Propose cancellation in the change timeline. The other side must approve the cancellation. Until then, the scheduled change remains in the approved tree. If a later change depends on it, the system refuses a cancellation that would break that later change.

Understand broken pairs

If an account closes, pairs directly touching that account become broken from the closure date. Reopening the account does not restore the mandate. An approved remove-and-add supplies a fresh mandate.

If an account leaves the enrolment’s scope, its pairs show Out of enrolment scope. If it returns, that scope break clears from its return date. Both reasons remain visible when you read earlier dates.

Choose how a pair concentrates

Each pair carries its own terms. The terms say how much money moves between the child and its parent. To change them, propose a Change pair terms edit, then pick the child account. The form opens with that pair’s current terms.

  1. Select a Concentration method.
  2. Enter the amounts the method asks for.
  3. Select a Direction. One-way only collects. Two-way also funds a child that falls short.
  4. Enter a Priority. Priority 1 is funded first.
  5. Select Allow a partial sweep if a child may receive less than it needs.

The tree shows each pair’s terms on one line, for example “Target balance target 5,000.00 · one-way · priority 1”.

What each method does

Method Above the band Below the band (two-way only)
Zero balance Sweeps the whole balance up Funds the child back to zero
Target balance Sweeps down to the target Funds the child up to the target
Threshold Above the trigger, sweeps the whole balance up Funds the child back to zero
Collar Above the trigger, sweeps down to the collar level Below the collar level, funds up to it
Range Above the maximum, sweeps down to the target Below the minimum, funds up to the target
Custom band Above the upper trigger, sweeps down to the upper target Below the lower trigger, funds up to the lower target

Inside the band, nothing moves. A trigger is exclusive. If the threshold is 10,000.00, a balance of 10,000.00 stays put and 10,000.01 sweeps.

Two methods are not bands, and both are one-way:

For these two, the form holds Direction at one-way.

A worked example

Cape Town uses target balance 5,000.00, one-way.

Cape Town’s balance Swept up Left in Cape Town
12,000.00 7,000.00 5,000.00
5,000.00 nothing 5,000.00
3,000.00 nothing 3,000.00

At 3,000.00 nothing moves, because a one-way pair never funds the child.

When the parent is short

If several two-way children need funding, the parent funds them in priority order. If the parent runs out, the next child gets less, or nothing.

Treasury holds 4,000.00 and has no overdraft facility. Cape Town (priority 1) and Durban (priority 2) each sit at −3,000.00 on zero balance, two-way.

Durban allows a partial sweep Cape Town receives Durban receives Treasury ends
Yes 3,000.00 1,000.00 0.00
No 3,000.00 nothing 1,000.00

A partial sweep is off by default, so a short parent never moves part of a leg silently.

Value dates on a zero-balance sweep

If a zero-balance sweep collects money, each part keeps the value date it arrived with. The parent then earns interest from the day the money was really there. Money sent down to fund a child is always valued on the trading date.

If the terms are refused

The proposal is refused with the rule it broke:

Message What to change
Amounts, targets and triggers cannot be negative. Enter zero or a positive amount.
The collar level must not be above the trigger. Lower the collar level, or raise the trigger.
Enter a percentage above 0 and at most 100. Correct the percentage.
This method sweeps one way only. Choose one-way. Set the direction to one-way.
Set the minimum at or below the target, and the target at or below the maximum. Reorder the range.
Keep both targets between the lower and upper triggers, with the lower trigger at or below the upper. Reorder the custom band.

Choose when a pair sweeps

Each pair also says on which days it sweeps, and at what times. The terms form shows the pair’s current schedule. Any terms change keeps it unless you edit it.

  1. Select Sweep days: every business day, weekly or monthly.
  2. Enter Every to skip periods. For example, 2 with weekly sweeps every second week.
  3. Enter a Starting date. A weekly or monthly schedule repeats on that date’s weekday or day of the month.
  4. Enter a time in Sweep at, then select Add slot. Repeat for each time of day.
  5. Select Sweep at day-end to sweep once more when the trading day closes.

A new pair sweeps every business day at day-end. Times are in the structure’s time zone. To change it, propose a Change structure terms edit and enter a Sweep time zone. Sweeps follow your organisation’s trading calendar.

A slot must reach its payment venue before the venue’s cut-off. If a slot is too late, the proposal is refused and names the latest slot allowed.

Message What to change
Choose at least one sweep slot, or sweep at day-end. Add a time, or select Sweep at day-end.
Each sweep slot can appear only once. Remove the repeated time.
Enter a time zone such as Africa/Johannesburg. Correct the sweep time zone.

Sweep schedule

Under the tree, each structure shows its sweep schedule for the current trading date. It shows the schedule’s status, each slot, and what happened at that slot.

Status What it means
Sweeping Today’s slots run as their times arrive
Day-end only The trading date is ahead of the clock, so only the day-end slot can run
Paused Today’s sweeps have closed and the next day is not yet planned
No sweeps today No pair sweeps on this date

Sweeps pause while day-end runs. Day-end closes the trading date’s sweeps, then plans the next date. A paused schedule shows its slots greyed, the reason, and the date sweeps resume.

For example, while day-end for 10 November 2026 runs, the schedule says “Day-end for 10 Nov is running. Sweeps resume on 11 Nov.” A structure that sweeps only on Mondays, closed on Tuesday 10 November, resumes on Monday 16 November. If day-end has not finished, the schedule says sweeps resume once it completes.

Each slot shows its outcome in words:

Outcome What it means
Planned The slot has not run yet
Released, waiting to settle The slot’s sweep was sent and has not yet settled
Settled The slot’s sweep finished
Skipped: the trading day closed first Day-end closed the date before the slot ran
Skipped: too late for the venue’s cut-off The slot would have missed the payment venue’s cut-off
Skipped: the venue was closed that day The payment venue was not open on that date
Skipped: a later slot covered it A later slot swept the position instead

On 10 November, the 10:00 slot shows Settled and the 15:00 slot shows Skipped: too late for the venue’s cut-off. The client and the bank see the same schedule.

A paused sweep schedule does not stop you capturing work. Payments captured during day-end are dated to the next trading date.

Sweep history

Each structure shows its sweep history at the foot of the page, below its timeline of changes. In the client app, open Accounts → Liquidity and select a structure. In the bank app, open the counterparty’s Liquidity panel.

The newest run is first. Each row is one leg of a run: its trading date, slot, accounts, amount and state.

State What it means
Completed The money moved
Broken The leg could not finish; the bank is resolving it
Cancelled The bank closed the leg with no money moved; the next run sweeps the true position
Settled by movement The money moved by another route, which the bank recorded
Superseded The pair’s next run took the leg over

A broken leg also shows why, in plain words. A run that did not execute shows why it did not run, for example “Not run: the structure was not live”. Select Older runs to page back.

You see a structure’s history only if you can view every account in it. In the bank app, Open leg opens the leg, where operations resolve a break. See sweep breaks.

Invest the header’s surplus

The header can place surplus money into one investment destination at day-end. The destination sits beside the tree and cannot also be its header or a child. You configure it through Change structure terms, rather than a pair’s concentration method.

  1. Select Change structure terms under Propose changes.
  2. Select Invest the header’s surplus at day-end.
  3. Find and choose the Receiving account.
  4. Choose Settlement: book transfer to a call deposit, or external payment to an instrument provider.
  5. Enter the Retained balance to keep on the header.
  6. Enter the Minimum placement. Zero allows any positive surplus.
  7. Select Add edit, then Submit change with a future effective date.

The other side reviews the destination, settlement, retained balance and minimum before approving. Changing the time zone keeps the destination unless you edit it. Clear the investment checkbox to propose removing the destination.

A book-transfer destination must be an active call deposit that accepts and returns money on demand. An external destination must be a notional account with a nominated provider. See notional investment accounts for settlement and redemption. A fixed or notice deposit cannot return money automatically and cannot be a sweep destination.

How the day-end amount is chosen

The sweep collects from the tree and funds children before placing the remaining surplus. A placement below the minimum stays on the header. A placement equal to the minimum proceeds.

Under the retained-balance convention, a header holding 7,450,000.00 with a retained balance of 5,000,000.00 places 2,450,000.00. At the retained balance, nothing moves.

If funding would leave the header below its retained balance, the call deposit returns available money first. This draw-back can be smaller than the minimum placement. Call-deposit money is used before overdraft headroom. An external instrument has no automatic draw-back.

An external placement shows Instructed while its payment awaits settlement. Its cash hold reduces the header’s available balance. That investment pair cannot place again while the payment remains in flight. On settlement, the notional position increases and the leg becomes Completed. A rejection leaves the notional position unchanged and appears as a broken leg.

Place a term or notice deposit by hand

Open the deposit separately and choose the header as its funding account. A fixed deposit follows its chosen maturity instruction. A notice deposit follows its notice period. These manual placements leave the investment destination unchanged.

What your organisation configures

Your organisation selects the enrolled accounts, channel entitlements and required signatures. Your access may cover only some structures or accounts. Your organisation also controls the trading date and whether liquidity management is available. Your treasurers choose each pair’s concentration method, direction, priority and partial sweep. They also choose each pair’s sweep days and times, and each structure’s time zone. Your organisation sets the default sweep time zone and the safety margin before a venue’s cut-off.

Your organisation also controls eligible call deposits, notional accounts, providers, fees and settlement dates.

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.