# Journals

<p class="doc-lead">Most journal entries in Freespace ERP are created automatically when you approve transactions such as sale invoices, payment vouchers, or expenses. Use manual journals for adjustment entries, reclassifications, or corrections that the system does not generate on its own.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/accounts/journal-entries?id=overview">Overview &amp; List View</a>
<a href="#/accounts/journal-entries?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/accounts/journal-entries?id=header-fields">Header Fields</a>
<a href="#/accounts/journal-entries?id=journal-lines">Journal Lines</a>
<a href="#/accounts/journal-entries?id=variants">Manual vs System Journals</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/accounts/journal-entries?id=actions-status">Actions &amp; Status</a>
<a href="#/accounts/journal-entries?id=master-update">Master Update</a>
<a href="#/accounts/journal-entries?id=view-tabs">View Tabs &amp; Widgets</a>
<a href="#/accounts/journal-entries?id=best-practices">Best Practices</a>
<a href="#/accounts/journal-entries?id=faq">FAQ</a>
<a href="#/accounts/journal-entries?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

The Journals list shows all journal entries — both automatic and manual — with transaction type, reference, party, notes, date, and status. Use the list to open, review, filter, or bulk-action manual journals.

<b>List columns</b>

`Id`, `Date`, `Transaction`, `Ref Id.`, `Ref Bill No`, `Invoice Ref No`, `Party`, **Notes**, `Status`

<p><b>Invoice Ref No</b> shows the <b>Supplier Invoice Number</b> from the source document when one was entered (for example on a purchase invoice, debit note, expense, purchase expense, or prepaid expense).</p>

<b>Quick filters</b>

| **Filter** | **Shows** |
|------------|-----------|
| Default | All journals except Cancelled |
| Approved | Approved journals |
| Draft | Draft journals |
| Cancelled | Cancelled journals |

<b>Header actions</b>

| **Action** | **Description** |
|------------|-----------------|
| New | Opens the new manual journal form |

Click a row to open the journal in view mode. Select one or more rows to show footer actions: **edit**, **delete**, and **view**.

<b>List View</b>

<img src="accounts/images/journal-list.webp" alt="Journal list" loading="lazy">

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start — Create a Manual Journal</h2>

<h3>1. Navigate</h3>
Go to <b>Accounts → Journals</b> from the left menu.

<h3>2. Create new journal</h3>
Click <b>New</b> to open the manual journal form.

<img src="accounts/images/jour-crea.webp" alt="New journal form" loading="lazy">

<h3>3. Fill in details</h3>
<ul>
<li>Enter the <b>Date</b> and optional <b>Notes</b>.</li>
<li>Add journal lines with <b>New line</b> — select an <b>Account</b> and enter a <b>Debit</b> or <b>Credit</b> amount on each line.</li>
<li>Ensure total debits equal total credits before saving.</li>
</ul>

<h3>4. Save</h3>
<ul>
<li><b>Save</b> — saves the journal as a draft.</li>
<li><b>Save And Approve</b> — saves and approves immediately; posts the accounting entry.</li>
<li><b>Reset</b> — clears the form.</li>
<li><b>Cancel</b> — closes the form without saving.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Date | Date and time of the journal entry. Mandatory. |
| Notes | Optional header notes for the entire journal. |
| Currency | Shown only when multi-currency is enabled for the company. |
| Currency Exchange Rate | Auto-filled from the selected currency when multi-currency is enabled. |

<b>View-only fields (system journals)</b>

When a journal is linked to a source transaction, the view also shows:

| **Field** | **Description** |
|-----------|-----------------|
| Journal No. | Journal ID. |
| Transaction | Source transaction type (e.g. Sale Invoice, Payment Voucher). |
| Transaction Ref [Id] | Reference of the source transaction with its ID. When the source has a <b>Supplier Invoice Number</b> (purchase invoice, debit note, expense, purchase expense, or prepaid expense), that number is shown instead of the system bill number. |
| Is Foreign Currency Revaluation | Shown when the journal is a foreign currency revaluation entry. |

<hr class="doc-section-divider">

<h2 id="journal-lines">Journal Lines</h2>

Add lines with <b>New line</b>. Each line must have an account and either a debit or credit amount — not both on the same line.

<b>Create / edit line columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Account | Ledger account. Only active leaf (postable) accounts are shown. An info button opens Account Enquiry when an account is selected. |
| Debit | Debit amount. Disabled when a credit amount is entered on the same line. |
| Credit | Credit amount. Disabled when a debit amount is entered on the same line. |
| Debit- | Foreign-currency debit amount. Shown when a currency is selected on the header. |
| Credit- | Foreign-currency credit amount. Shown when a currency is selected on the header. |
| Notes | Optional per-line notes. |

<b>View line columns</b>

**Account**, **Dr**, **Cr**, **Notes**

<b>Validation</b>

Total debits must equal total credits. If they do not match, the system shows: <b>Invalid Journal. Debit and Credit Total Mismatch.</b>

<hr class="doc-section-divider">

<h2 id="variants">Manual vs System Journals</h2>

| **Type** | **How identified** | **Behavior** |
|----------|-------------------|--------------|
| Manual journal | No linked transaction reference | Full create, edit, approve, cancel, and Master Update (subject to status) |
| System-generated journal | Shows <b>Transaction</b> and <b>Transaction Ref [Id]</b> on view | Created automatically when a source transaction is approved. Approve, Cancel, and Master Update are not available from the journal view when linked. |
| Foreign currency journal | Currency and exchange rate on header | Line amounts may use foreign-currency debit/credit columns; converted to base currency for posting |
| Closing entry journal | Transaction type shows Closing Entry | Created by closing entry process |

<b>Common use cases for manual journals</b>

<ul>
<li>Correction entries when errors are identified in automated postings.</li>
<li>Reclassification of accounts (e.g. moving an amount from one expense account to another).</li>
<li>Period-end adjustments not captured by standard transactions.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved but not yet approved. Can be edited or deleted. |
| Approved | Finalized and posted to accounts. |
| For Revisal | Sent back for correction. Can be edited or deleted. |
| Cancelled | Voided. Journal entry reversed. |

<h3>List actions (footer bar when rows selected)</h3>

| **Action** | **When available** | **Notes** |
|------------|-------------------|-----------|
| edit | Draft, For Revisal | Single row only |
| delete | Draft, For Revisal | Supports multi-select |
| view | All statuses | Single row; row click also opens view |

<h3>View toolbar actions</h3>

| **Action** | **When available** | **Notes** |
|------------|-------------------|-----------|
| Approve | Draft | Not available for linked (system) journals |
| Edit | Draft, For Revisal | |
| Delete | Draft, For Revisal | |
| clone | All statuses | Hidden when clone is disabled in user settings |

<h3>More menu (⋮)</h3>

| **Action** | **When available** | **Notes** |
|------------|-------------------|-----------|
| Cancel | Approved | Not available for linked (system) journals |
| Master Update | Approved, Closed | Manual journals only — hidden when linked to a source transaction |
| Add/Update Note | All statuses | Updates <b>Notes</b> only |

<hr class="doc-section-divider">

<h2 id="master-update">Master Update</h2>

<b>Master Update</b> lets you change selected fields on an approved manual journal without reopening the full edit form. Open a journal, click the more menu (⋮), and select <b>Master Update</b>.

<b>When available</b>: Approved or Closed status only, and only for <b>manual journals</b> (not linked to a source transaction).

<b>Dialog actions</b>: <b>Confirm</b>, <b>Cancel</b>

<h3>Fields that can be master-updated</h3>

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Date | Yes | Journal date and time. Updating the date also updates the linked journal posting date. |
| Is Foreign Currency Revaluation | Optional | Marks the journal as a foreign currency revaluation entry. |

<b>Not master-updatable</b>: journal lines, accounts, debit/credit amounts, and notes (use <b>Add/Update Note</b> for notes).

<hr class="doc-section-divider">

<h2 id="view-tabs">View Tabs &amp; Side Panels</h2>

When you open a manual journal entry in full view (not in a small modal), the right side shows tabbed panels. Click the expand icon on a tab to open the same data in a larger modal.

Manual journals do not show Summary or Journal Info side tabs — the journal lines on the main form are the entry itself.

<h3>Bottom panel (all transactions)</h3>

| **Tab** | **What it shows** |
|---------|-------------------|
| History | Activity log — who created, approved, edited, or cancelled the journal and when. |
| Attachments | Files uploaded to this journal entry. |

<hr class="doc-section-divider">

<h2 id="best-practices">Best Practices</h2>

<ul>
<li><b>Always balance debits and credits:</b> Verify totals before saving or approving.</li>
<li><b>Add notes:</b> Document the reason for manual entries — especially corrections and reclassifications.</li>
<li><b>Prefer source transactions:</b> Record business activity through the appropriate module (Expense, Payment Voucher, etc.) so the system generates the journal automatically.</li>
<li><b>Review system journals:</b> Use the <b>Transaction</b>, <b>Ref Id.</b>, and <b>Invoice Ref No</b> columns to trace journals back to their source documents and supplier bills.</li>
<li><b>Use Master Update for date corrections:</b> Adjust the journal date on approved manual entries without editing lines.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Why can't I approve or cancel this journal?</b><br>
If the journal shows a <b>Transaction</b> reference, it was created automatically by another module. Manage it through the source transaction, not the journal screen.

<b>Why is Master Update not available?</b><br>
Master Update is only available for manual journals (no linked transaction) in Approved or Closed status.

<b>Which fields can I change with Master Update?</b><br>
<b>Date</b> and <b>Is Foreign Currency Revaluation</b> only. Journal lines cannot be changed through Master Update.

<b>Can I edit an approved manual journal?</b><br>
Approved journals cannot be edited from the standard edit form. Use <b>Master Update</b> for allowed fields, or <b>Cancel</b> and create a new journal if a full correction is needed.

<b>What happens when I cancel an approved journal?</b><br>
The journal status changes to Cancelled and the accounting entry is reversed.

<b>How do I find journals for a specific transaction type?</b><br>
Use the advanced filter <b>Transaction Type</b> on the list, or run the <b>Journal Report</b>.

<b>Where is the supplier’s invoice number on a journal?</b><br>
On the list, check <b>Invoice Ref No</b>. On the journal view, <b>Transaction Ref [Id]</b> shows the <b>Supplier Invoice Number</b> when one was entered on the source document; otherwise it shows the system bill number. The same preference is used on <a href="#/accounts/reports/account-transactions">Account Transactions</a>.

<b>Why DR must equal CR?</b><br>
Double-entry rule enforced on save and approve — totals must match within rounding precision.

<b>Why future date blocked?</b><br>
User or company setting may block future-dated journals unless enabled in preferences.

<hr class="doc-section-divider">

<h2 id="related">Related Topics &amp; Videos</h2>

<b>Related documentation</b>
<ul>
<li><a href="#/accounts/reports/journal-report">Journal Report</a> — browse journal lines by date, account, and transaction type.</li>
<li><a href="#/accounts/reports/account-wise-direct-journal">Account Wise Direct Journals</a> — summary of approved manual journals by account.</li>
<li><a href="#/accounts/reports/daybook">Day Book</a> — daily ledger view including journal entries.</li>
<li><a href="#/accounts/reports/account-transactions">Account Transactions</a> — detailed account-wise transaction report.</li>
</ul>

<b>Video — Journal overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/z1NUpcfsGtU?si=nyjDb_0E1lOMpxjN" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
