OFS troubleshooting
OFS Response Errors: Diagnose Failures by Processing Stage
Treat an OFS response as evidence of how far processing travelled. Find the first stage that failed instead of decoding one error fragment in isolation.
Browse more Integration articles →
Capture the request and response safely
Preserve timestamps, source, operation, application/version, record reference, transport result, response status, and the first error. Redact credentials, customer data, account numbers, tokens, and complete production payloads before sharing.
Use the OFS Response Parser for a browser-only breakdown, and the OFS Message Parserto inspect the request structure.
Failure-stage map
| Stage | Typical evidence | Next check |
|---|---|---|
| Transport | No application receipt, connection failure, timeout, TLS or channel error | Confirm endpoint, route, listener, certificate, connection, and whether the request reached the application boundary. |
| Authentication | User, password, token, source, company, or permission rejection | Confirm the non-sensitive identity context, source configuration, company, authorisation state, and expiry or lock status. |
| OFS syntax | Malformed header, operation, options, credentials section, record ID, or field list | Parse the original request and compare separators, quoting, operation/version names, multivalue syntax, and field positions. |
| Application validation | Mandatory field, format, date, product, record, or business-rule error | Identify the first application-owned validation and reproduce with synthetic or redacted input. |
| Override or authorisation | Override returned, unauthorised record, or approval still required | Separate a valid business override from a technical failure and follow the approved authorisation workflow. |
| Posting | Request accepted but record not committed, locked, rolled back, or failed downstream | Check commit evidence, record state, locks, database errors, dependent services, and transaction outcome certainty. |
| Response delivery | Processing occurred but the caller received no response, invalid content, or a parse failure | Trace the response from T24 through middleware, messaging or HTTP transport, encoding, client timeout, and consumer parsing. |
Diagnostic sequence
- Confirm arrival: prove that the request reached the intended listener and environment.
- Confirm identity context: distinguish authentication and authorisation from application validation.
- Parse the request: verify the operation, options, user context, record ID, separators, and fields.
- Read the first application error: later errors may be consequences of the first rejected field or dependency.
- Classify overrides correctly: an override can be a valid business decision point, not a system failure.
- Prove posting outcome: determine whether the transaction did not start, rejected before commit, committed, rolled back, or is uncertain.
- Trace response delivery: when posting succeeded but the caller failed, inspect middleware, messaging, headers, encoding, timeout, and parsing.
Timeout and retry risk
A missing or unparsable response is not permission to resend. The original request may have committed successfully. Before retry, search by a safe business or message reference, confirm record and accounting state, and establish whether idempotency or duplicate protection applies.
Escalation evidence
- Environment, endpoint or source, application/version, operation, and timestamp window.
- Redacted request structure and complete redacted response.
- The first error at the earliest confirmed processing stage.
- Application-server, TAFJ runtime, service, database, and transport correlation evidence where relevant.
- Posting outcome and whether a retry, override, authorisation, or manual intervention occurred.
Related reading
What Is OFS in T24? Open Financial Services Explained
OFS is how the outside world talks to T24. A plain-English introduction to the message structure, request types, OFS.SOURCE configuration, security, and what breaks when integrations go wrong.
Integration architectureOFS vs API vs Batch Interfaces: When to Use What in T24
A practical guide to T24's three integration paradigms — OFS for real-time, APIs for modernisation, and batch for volume — with decision criteria for each.
Integration & Production supportTrace a Failed OFS Request Through TAFJ and JBoss Logs
A systematic diagnostic sequence for tracing a failed OFS request from entry point to T24 processing — transport, authentication, syntax, validation, posting, and response-delivery failure stages, with log sources and redaction guidance.
