Compass Caging
Guide

How data entry works

  1. + New Batch — pick the client, batch kind, and BatchID. A batch is one bundle of mail worked together.
  2. Scan or key each gift into the batch. You can leave and come back — open batches stay editable.
  3. Submit Batch when the bundle is done. Submitting locks it and queues it for the weekly export. If you have more mail, start the next batch.

Select a working batch above or click + New Batch to begin. New here? Print the staffer guide — the app on page 1, the floor SOP on page 2.

New Batch

Validation Issues

Import Batch File

Change Password

Two-Factor Authentication

Add User

Already Backed Up to Google Drive

Add Client

Accounts
One row per account the client banks with. Batches and reconciliations are recorded under an account; the last 4 digits route statement uploads to the right one. The default account must be a bank account; its label appears on the weekly report. A Treasury / investment account is the custodian account donated stock and some wires land in: it is reconciled on its own from the custodian's transaction file, and every week it must be reconciled through before that week's export and report can be filed. Accounts with history can be deactivated, never deleted, and keep their type.
Transfer workbook settings
Fee rate card — dated rows; the row in effect on each week's transfer date (period end + lag, or period end for an ICS sweep) drives the analytical caging and TY letter fee columns. TY letters are an add-on: leave the TY rate blank for clients that don't get them and no TY fee is billed.

Journal Entry Mapping

Each finished week files its accounting import with the close: one balanced journal entry per cashflow — a keyed batch, a processor payout, a ticked bank record — built from these rules. A blank match value is the catch-all; rows matching an exclude rule are skipped and tallied; negative amounts (refunds, chargebacks, sweeps in) flip sides; the deposit line is derived so every entry balances. Templates accept {prefix} {symbol} {date} {dateCompact} {reference} {reference6} {seq} {clientCode}; memo and document also accept {entryNumber}.

Which cash GL account an entry's bank line posts to follows the money: a gift, payout or bank record whose cash landed in an account below posts there, whatever source it came from. Leave the main account blank to keep each source's deposit rule. Every other account the client's money lands in — a second checking or savings account — needs its own cash account, or its entries are held back unfiled rather than posted to the main account's cash. A treasury account may instead use the Treasury source's deposit rule.

AccountCash account #Account nameLocationDeptEntity

Journal Entries

Journal Import — Date Range

One import file with the filed journal entries of every finished week whose period ends in the range, for this account.

Match Bank Item

Selected $0.00 of $0.00

Which Deposit Paid It?

Donor

Is This the Same Donor?

✓ an address, email or phone on both records — the evidence they may be one donor.

Edit Donor

A type set here is never changed by the matcher, and every gift on this donor takes it as its Gift Type (files already delivered do not change). A name typed here stays until it is cleared.

Move Gift to Another Donor

Its chargebacks and disputes move with it. The matcher never moves it back.

Behind This Bank Item

Issue Billing Statement

An issued statement is numbered and its file is kept exactly as issued. It cannot be changed after issuing: corrections and late weeks go on the next statement.

Void Billing Statement

Link a Transfer to Its Week

Not listed? A debit filed as something else is re-filed as Transfer / Sweep (internal) on the Reconciliation tab first.

Import Transfer History

Read a client's manual Compass Weekly Caging Transfers workbook in, for the weeks before the system. Only weeks that end before the client's first closed reconciliation are taken — the sheet's rows for weeks the system has closed are skipped, so no week is counted twice — and a week already on file is never replaced. You see what it would add before anything is kept.

Hold a Week's Transfer

Correct Report Inputs

Only the figures typed at finish time can be corrected. Fees, disputes, stock gain/(loss), and deposit dates were drawn from the reconciliation and are locked with it — undo the reconciliation to change them. The batch data, export CSV, and xlsx never change; the correction is recorded in the audit trail.

Finish Reconciliation & Deliver the Week

Batches this week delivers

Submitted work dated in the period goes out; batches matched to bank items in this period are reconciled here and always go out, as do gifts from a treasury account the treasury reconciliation has closed over (non-caging Stock and ACH/Wire). Untick a batch to hold it for a later week. Batches dated after the statement ending date (next week's mail keyed early) stay back unless you tick them.

Report Figures

Mail and deposit dates, fees, disputes, and stock gain/(loss) are what this reconciliation’s items are typed as — they go out exactly as shown. To move one, re-type the item on the register; it cannot be typed over here.

Not in the data

TY letters and BRE charges have nothing behind them in the reconciliation — enter them here. They are also the only figures a filed report can be corrected on afterwards. Stock comes from the Stock batches keyed at reconciliation, and pledges from the transactions they came with.

Add to System

The donor transaction behind this cashflow — stored with full detail as a single-entry submitted batch, dated to the bank transaction.

Remove Holding

Account for a Sale of Donated Stock

Shares given before the system

If the lot this sale sold was donated before the system existed (so it has no Stock batch), enter its basis — the FMV it was recorded at when given — and say where the figure comes from. The gain or loss is the proceeds less this.

Create Chargeback

A single-entry batch is created and submitted automatically — it will be included in the next weekly export.

Mark Check Rejected

For a check the bank never accepted — rejected at remote deposit, so it was not in the deposit. The donor's record stays in its batch at $0.00 and still goes out on the export, with this comment. If the bank credited the check and later took it back, use Chargeback instead.

Find the Gift This Dispute Reverses

Mark Dispute Won

The processor decided the dispute in the client's favor and returned the money (a "Dispute Won" reversal inside a payout). The dispute record itself stays as-is; the won amount prefills the weekly report's Dispute Won figure for the week the reversal landed.

If the bank paid the win back on a line of its own instead, don't mark it here: type that line Won Dispute on the Reconciliation register and tick it. The report takes the win from there, and marking it here as well would report it twice.

If that week is already filed, date the win in the open week instead — a filed week does not change, so a win dated inside it would reach no report. Once a filed week has reported a win, it cannot be cleared or re-dated.

Declare a Settlement In Transit

Use this for money you know is coming — a processor payout for charges made this week — before its bank row or payout report exists. It is reported on this reconciliation : the settlement disposes of the item, and the gap between the gross keyed and the net you name is reported as this week's processor fee, checked against the payout file when it arrives. For a caged card batch with Stripe's charge ledger on file, the net and the fee are filled in from it — what Stripe actually charged — so the fee reported is Stripe's own, never a slip that was keyed but never charged.

The date it lands decides only which bank statement counts the cash. On or before this statement's end, this week's cleared balance counts it — use that when the statement's ending balance already includes money that has not posted. After it, this week's cleared balance leaves it out and the week it lands counts it instead. Either way, the reconciliation that counts the cash will not finish until the bank row behind it arrives.

Link Stripe Charges to This Batch

A card batch is settled by the Stripe payout that carries its charges, and the description each card was run under is what says which charges are its own (2026.09.06.VPE.01_Campbell). When a description cannot say it — run under another convention such as VP.CC.01_Campbell, or under the wrong day of a BatchID that repeats — tick the charges that are this batch's slips. They settle the batch once their payout is matched to the bank; that bank match stays exactly as it is. Charges whose donor and amount match a slip here are ticked for you; nothing is linked until you save.

Ticked $0.00 of $0.00 keyed

Carry to a Later Week

The row keeps the date the bank gave it. What changes is which reconciliation has to account for it — use this when the statement lists a row its own ending balance has not taken yet. When the posting arrives on a later statement it updates this row instead of joining it, so the money is never on the register twice.

Remove a Bank Row

For a row that is not on the bank's statement — a second copy left by downloading the statement again, or a row a newer download of the same period no longer lists. The audit trail keeps the whole row, and uploading a file that lists it brings it back.

No Balance on Statements

Correct a Payout

For a payout file uploaded under the wrong client, or filed under a mistyped reference or date. Only a payout nothing is built on yet can be corrected: not matched, declared, confirmed in transit, journaled or counted by a closed week. The audit trail keeps every row removed.

Remove a Stripe Charge Report

For a transaction report uploaded under the wrong client or the wrong Stripe account. A report can be removed until a reconciliation closes after it, or until a payout its charges went out in is matched. The audit trail keeps every charge removed.

Thank-You Run

Print Letters Print Envelopes Mail-Merge .xlsx Word Template CSV

Mail the letters, then confirm. Tick Not mailed for any that did not go out: they go back to the queue for the next run.

Skip Thank-You Letters

Letters & Alerts

Thank-you letters

Fields: ·

Printing from Word instead? Download this letter as a Word mail-merge template (save first: it is built from the settings as saved), then merge it with a print run's Mail-Merge .xlsx.

Dev-officer alerts

Preview

Confirm