Looking up a reference
A reference names one request, such as Ref 3B81C04E. A clerk finds it on an error message, or copies it from an entry on a record’s history. This screen shows what that request did.
Look a reference up
- Go to System, then select Look up reference.
- Paste the reference into the box, such as Ref 3B81C04E or Ref 3B81C04E @ ACC-4417.
- Select Look up.
You need at least the first eight characters. A full reference works too.
If the reference carries an account, such as @ ACC-4417, the screen shows that account’s changes only. The summary still counts every record the request touched.
What you see
| Section | What it tells you |
|---|---|
| Summary | How many records the request touched, how many settled, and how many failed |
| Rejected, refused and failed requests | The message the clerk saw, who sent it and when |
| Failed in the background | Work that failed after the screen said it had succeeded |
| Troubleshooting queue | Batch work under this reference that is waiting for a retry |
| One section per record | What changed on that record, in plain words |
Time to settle is how long the request’s work took, from its first change to its last. A clerk can see “done” before the balance moves, because some work finishes in the background. A large time to settle explains that gap.
Worked example
Alex at Woodgrove Bank charges a fee and sees “Fee charged”. The balance does not move. Alex copies Ref 3B81C04E @ ACC-4417 from the history entry and sends it to support.
Support pastes it here. The summary reads: touched 2 records, 2 settled, 0 in the troubleshooting queue, 1 failed in the background. The Failed in the background section names the posting that failed and why. Support now knows the fee was recorded but never posted.
Records you may not see
A request can touch records you have no permission to view. They are counted, never dropped. The summary says how many are hidden and which kind, for example “1 record is hidden: you don’t have permission to view counterparties.”
Rejected and failed requests, background failures and the troubleshooting queue show to anyone who may use this screen. None of them holds what was sent.
When nothing is found
The screen says nothing is recorded under the reference. Check the reference was copied whole. A reference only finds requests made in your own organisation.
A rejected or refused request is found only while your organisation keeps failed-request records.
The reference
The reference is the request’s trace id, in the form the W3C Trace Context standard sets. The platform complies with that standard, as its standards register records.
What your organisation configures
- Who may use this screen, through the permission to look up references.
- Who may see each kind of record, through the usual view permissions.
- Whether rejected and refused requests are kept, and for how long, on the failed requests settings screen.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.