Transaction Sets
Overview
Transaction Sets are balanced journal entries that post to general ledger accounts. Each transaction set maintains double-entry bookkeeping principles by ensuring debits equal credits.
What are Transaction Sets?
A Transaction Set is a journal entry with one or more debit and credit transactions that affect GL accounts. Transaction Sets ensure your ledger stays balanced according to standard accounting principles.
Requirements
Minimum Transactions
Every Transaction Set must include:
- At least two transactions (one debit and one credit minimum)
- At least one debit entry
- At least one credit entry
Balanced Entries
Transaction Sets must balance according to these rules:
- Total debits must equal total credits
- If using multiple effective dates, debits and credits must balance per date
- Balance is validated before posting
Effective Dating
Current Day Posting (Default)
By default, transactions post to the current business day:
- No
effectiveDateparameter required - Simplest method for real-time transactions
- Updates today’s balances immediately
Prior Date Posting
Post to a prior business day by setting effectiveDate:
- Use for corrections or adjustments
- Subject to system-configured limits
- Useful for period-end adjustments
Date Constraints
- Prior-date posting limits are configurable
- Cannot post beyond the configured date range
- Transactions with the same effective date must balance together
Reversals
Reverse a Transaction Set to negate a previously posted entry.
How Reversals Work
When you reverse a Transaction Set:
- A new Transaction Set is created with opposite entries
- Debits become credits and credits become debits
- Original entry remains in history
- New reversal is linked to the original
Reversal Dates
Choose how to date the reversal:
- Use Original Date: Omit
effectiveDate- reversal uses the same date as the original entry - Use New Date: Provide an
effectiveDateto post the reversal on a different date
Common Uses
- Error Corrections: Reverse incorrect entries
- Period Adjustments: Reverse and repost with corrections
- Provisional Entries: Undo temporary entries when final amounts are available
Best Practices
Planning Entries
- Group Related Transactions: Keep related debits and credits in one set
- Use Clear References: Include meaningful descriptions and reference numbers
- Balance by Date: When using multiple dates, ensure each date balances independently
- Consider Reversals: Design entries with potential reversals in mind
Effective Date Strategy
- Current Day for Operations: Use current-day posting for normal transactions
- Prior Dates for Corrections: Use prior-date posting for adjustments only
- Check Date Limits: Verify allowed date ranges before backdating
- Document Adjustments: Maintain clear audit trails for backdated entries
Error Prevention
- Validate Balance: Verify your transaction set balances before submitting
- Check Date Ranges: Ensure effective dates are within allowed ranges
- Verify Accounts: Confirm all referenced accounts exist and are active
- Review Responses: Check API responses for the new Transaction Set ID
Institution Level Configuration
Your administrator can configure:
- Prior-date posting limits: How far back transactions can be posted
- Date constraints: Business rules for effective dates
- Validation rules: Additional requirements for entries
Contact your institution administrator for specific configuration details.