# Security Cheques

<p class="doc-lead">Security Cheques is a register of undated or blank-dated cheques given to a supplier as a guarantee. You enter the cheque yourself. It does not come from a Payment Voucher, it does not post a journal, and it does not change the supplier balance or the cash account balance. When the deal ends, mark the cheque collected back.</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/security-cheques?id=overview">Overview &amp; List View</a>
<a href="#/accounts/security-cheques?id=quick-start">Quick Start</a>
<a href="#/accounts/security-cheques?id=header-fields">Fields</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">View and actions</span>
<div class="doc-toc-links">
<a href="#/accounts/security-cheques?id=view">View</a>
<a href="#/accounts/security-cheques?id=actions-status">Actions &amp; Status</a>
<a href="#/accounts/security-cheques?id=permissions">Permissions</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/accounts/security-cheques?id=what-it-does-not-do">What it does not do</a>
<a href="#/accounts/security-cheques?id=best-practices">Best Practices</a>
<a href="#/accounts/security-cheques?id=faq">FAQ</a>
<a href="#/accounts/security-cheques?id=related">Related</a>
</div>
</div>
</div>

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

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

Go to <b>Accounts → Security Cheques</b> from the left menu. Use <b>New Security Cheque</b> on the list, or the quick-add on the menu, to record a cheque you are handing to a supplier.

The list opens on the <b>Draft</b> tab. Select one or more rows to show footer actions. The selection total adds the <b>Amount</b> of the selected rows.

<b>List columns</b>

`Id`, `Supplier`, `Cheque No`, `Cash Account`, `Amount`, `Cheque Date`, `Status`

<b>Quick filters</b>

| **Filter** | **Shows** |
|------------|-----------|
| Draft | Cheques not yet approved. This tab is selected when you open the list. |
| Approved | Approved cheques that have not been issued yet. |
| Issued | Cheques given to the supplier and still held by them. |
| Collected Back | Cheques returned when the deal ended. |
| Cancelled | Cheques voided before they were collected back. |

Type a cheque number in the <b>Cheque No</b> box on the list header. A partial number is enough.

<b>Advanced filters</b>

`Supplier`, `Cheque Number`, `Cash Account`, `Cheque Date`, `Status`, `Created Date`

Status options are All, Draft, Approved, Issued, Collected Back, and Cancelled.

<b>Row colour</b>

| **Status** | **List colour** |
|------------|-----------------|
| Draft | Grey |
| Approved | Black, bold |
| Issued | Black, bold |
| Collected Back | Normal black, not bold and not red |
| Cancelled | Red |

Global search finds this screen when you type <b>security cheque</b>, and opens the create screen when you type <b>new security cheque</b>. There is no cheque-number search prefix for this register.

Screenshot pending.

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

<h2 id="quick-start">Quick Start — Create a Security Cheque</h2>

<ol>
<li>Go to <b>Accounts → Security Cheques</b>.</li>
<li>Select <b>New Security Cheque</b>.</li>
<li>Select the <b>Supplier</b>. Cheque number, cash account, amount, and cheque date are optional. Leave <b>Cheque Date</b> blank when the cheque is undated.</li>
<li>Select <b>Save</b>. The cheque is saved as <b>Draft</b>.</li>
<li>Open the draft and select <b>Approve</b>.</li>
<li>When you hand the cheque to the supplier, select <b>Issue</b>.</li>
<li>When the supplier returns the cheque, select <b>Mark as Collected Back</b>.</li>
</ol>

Each status button asks you to confirm before it runs. You can select the same actions on one row or on several selected rows.

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

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

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Supplier | Yes | Supplier who holds the cheque. You can add a supplier from the field if your role can create suppliers. |
| Cash Account | No | Bank or cash account the cheque is drawn on. Choosing an account does not move money. |
| Cheque Number | No | Number printed on the cheque. |
| Amount | No | Face amount. Must be 0 or greater, and not more than 990,000,000. |
| Cheque Date | No | Date written on the cheque. Leave it empty for a security cheque given without a date. |

Saving always creates a <b>Draft</b>. The form does not ask for a status.

You can change these fields only while the cheque is <b>Draft</b>. After approval, the details stay as they were. There is no action to send an approved cheque back to draft. Use <b>Cancel</b> if it should not be issued.

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

<h2 id="view">View</h2>

Open a row with <b>View</b>, or click the row. The title is the supplier name. Under it, <b>Status</b> shows Draft, Approved, Issued, Collected Back, or Cancelled. The stamp on the header uses the same words. A cancelled cheque stamp is red.

| **Field** | **Description** |
|-----------|-----------------|
| ID | Security cheque number in this register. |
| Supplier | Supplier name. Select it to open the supplier. |
| Cash Account | Account chosen on the cheque, if any. |
| Cheque Number | Cheque number, if entered. |
| Amount | Face amount. |
| Cheque Date | Date on the cheque. Blank when none was entered. |
| Collected Back Date | Filled when you mark the cheque collected back. |
| Cancelled Date | Filled when you cancel the cheque. |

<b>Edit</b> and <b>Delete</b> appear only on a draft. After approval, those buttons are hidden.

Screenshot pending.

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

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

A security cheque moves in one direction: <b>Draft → Approved → Issued → Collected Back</b>. <b>Cancel</b> is available from Draft, Approved, or Issued. Collected Back and Cancelled are final. Nothing is posted to the ledger at any step.

| **Status** | **Meaning** | **What you can do** |
|------------|-------------|---------------------|
| Draft | Recorded, not yet approved. Details can still change. | Edit, Delete, Approve, Cancel |
| Approved | Accepted, not yet given to the supplier. Details are locked. | Issue, Cancel |
| Issued | Given to the supplier and still with them. | Mark as Collected Back, Cancel |
| Collected Back | Supplier returned the cheque. Collected Back Date is set to today if you do not send another date. | View only |
| Cancelled | Voided before it was collected back. Cancelled Date is set to today if you do not send another date. | View only |

| **Action** | **Where** | **From status** | **Result** |
|------------|-----------|-----------------|------------|
| New Security Cheque | List | — | Opens a blank draft. |
| Approve | List footer and view more menu | Draft | Status becomes Approved. |
| Issue | List footer and view more menu | Approved | Status becomes Issued. |
| Mark as Collected Back | List footer and view more menu | Issued | Status becomes Collected Back. |
| Cancel | List footer and view more menu | Draft, Approved, or Issued | Status becomes Cancelled. |
| Edit | List footer and view | Draft | Changes supplier, cash account, cheque number, amount, or cheque date. |
| Delete | View | Draft | Removes the draft. |
| View | List footer | Any | Opens the cheque. |

Approve on a cheque that is already approved, issued, collected back, or cancelled is rejected. Issue works only from Approved. Mark as Collected Back works only from Issued. Cancel does not work after the cheque is collected back or already cancelled.

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

<h2 id="permissions">Permissions</h2>

A role needs the Security Cheque permissions before the menu and buttons appear. Each status change is a separate permission.

| **Permission** | **Allows** |
|----------------|------------|
| list | Open the Security Cheques list. |
| view | Open a cheque. |
| create | New Security Cheque, including from global search. |
| update | Edit a draft. |
| delete | Delete a draft. |
| approve | Approve. |
| issue | Issue. |
| collected back | Mark as Collected Back. |
| cancel | Cancel. |

Without the matching permission, the button is hidden. Calling the action without it is refused.

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

<h2 id="what-it-does-not-do">What it does not do</h2>

<ul>
<li>It does not create or update a <a href="#/accounts/payment-voucher">Payment Voucher</a>.</li>
<li>It does not post a journal, and it does not change the supplier balance or the cash account balance.</li>
<li>It does not appear on <a href="#/accounts/issued-cheques">Issued Cheques</a> or <a href="#/accounts/received-cheques">Received Cheques</a>.</li>
<li>It is not a PDC cheque. PDC is a payment mode on a voucher. A security cheque is only a status record.</li>
<li>It cannot be printed from <a href="#/accounts/cheque-print-templates">Cheque Print Templates</a>.</li>
<li>It has no secondary status, no cheque report, and no bank-reconciliation line.</li>
<li>It cannot be sent back to Draft after approval. Cancel it instead.</li>
<li>Global search does not look up a security cheque by cheque number.</li>
</ul>

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

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

<ul>
<li>Leave <b>Cheque Date</b> empty when the cheque you give the supplier has no date.</li>
<li>Approve only after the supplier, amount, and cheque number are correct. Those fields cannot be edited later.</li>
<li>Select <b>Issue</b> when the cheque actually leaves your office, not when you first type it.</li>
<li>Select <b>Mark as Collected Back</b> as soon as the supplier returns it, so the Issued tab shows only cheques still outside.</li>
<li>Use <b>Cancel</b> for a draft or approved cheque you will not hand over. Do not delete an approved cheque — delete is only for drafts.</li>
</ul>

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

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

<b>Why is a new security cheque Draft, not Issued?</b><br>
Save stores a draft so you can correct the supplier and cheque details. Approve it, then Issue it when you give it to the supplier.

<b>Can I leave the cheque date blank?</b><br>
Yes. Cheque Date is optional. That is the usual case for a security cheque.

<b>Why can I not edit an approved cheque?</b><br>
Edit is only for Draft. After approval the details are locked. Cancel the cheque if it should not go out. There is no revert to draft.

<b>Does Issue or Collected Back hit the bank or the supplier ledger?</b><br>
No. Every status is a label on this register only. Supplier balance and cash account balance stay unchanged.

<b>Why is Collected Back not red?</b><br>
Red on this list means Cancelled. Collected Back is a normal completed row. Approved and Issued are bold. Draft is grey.

<b>Why does the header say Suspended?</b><br>
It should say Draft, Approved, Issued, Collected Back, or Cancelled. Suspended is the label for inactive customers and suppliers, not for this cheque. Refresh the screen if an older page is still open.

<b>Can I find cheque 123551 from global search?</b><br>
No. Type <b>security cheque</b> to open the list, then search the cheque number in the Cheque No box. There is no <b>schq:</b> record search.

<b>What if I cancel an issued cheque?</b><br>
Status becomes Cancelled and Cancelled Date is filled. The supplier balance does not change. You cannot collect it back after that.

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

<h2 id="related">Related</h2>

<ul>
<li><a href="#/status/cheque-status">Cheque Status</a> — how Security Cheque statuses differ from Issued Cheques and Received Cheques.</li>
<li><a href="#/accounts/issued-cheques">Issued Cheques</a> — outgoing cheques created from a Payment Voucher, with bank clearance and ledger posting.</li>
<li><a href="#/accounts/received-cheques">Received Cheques</a> — incoming cheques created from a Receipt Voucher.</li>
<li><a href="#/accounts/payment-voucher">Payment Voucher</a> — actual supplier payments. A security cheque is not a payment.</li>
<li><a href="#/purchase/suppliers">Suppliers</a> — the party the cheque is given to.</li>
<li><a href="#/accounts/cash-bank-accounts">Cash/Bank Accounts</a> — optional account on the cheque. Selecting it does not move funds.</li>
</ul>

<section class="ai-index-only">

## Errors and warnings

Exact messages for Security Cheques from the ERP screen and `fs_api`. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors.

### Supplier missing

- **Type:** Error
- **Action:** Save, Update
- **When:** Supplier is empty on New Security Cheque or Edit.
- **Example message:** *Please fill supplierId*
- **Outcome:** The cheque is not saved.
- **Solution:** Select a Supplier, then save again.

### Edit after draft

- **Type:** Error
- **Action:** Update
- **When:** Update is sent for a cheque whose status is Approved, Issued, Collected Back, or Cancelled. The Edit button is hidden in those statuses; this is the result if update is still sent.
- **Example message:** *Only a draft security cheque can be edited*
- **Outcome:** Supplier, cash account, cheque number, amount, and cheque date stay unchanged.
- **Solution:** Leave the approved cheque as it is, or Cancel it from Draft, Approved, or Issued. There is no revert to draft.

### Security cheque not found

- **Type:** Error
- **Action:** Update, Approve, Issue, Mark as Collected Back, Cancel
- **When:** The id does not match a security cheque.
- **Example message:** *Security cheque not found*
- **Outcome:** Nothing is saved and the status does not change.
- **Solution:** Refresh the list and open the cheque again.

### Status change not allowed

- **Type:** Error
- **Action:** Approve, Issue, Mark as Collected Back, Cancel
- **When:** Approve is used when the cheque is not Draft. Issue is used when it is not Approved. Mark as Collected Back is used when it is not Issued. Cancel is used when the cheque is Collected Back or already Cancelled. The same message is returned for any other status jump, including a second Approve, Issue, or Mark as Collected Back.
- **Example message:** *Cannot change status from the current status*
- **Outcome:** The status, Collected Back Date, and Cancelled Date stay unchanged. If several rows were selected, none of them change.
- **Solution:** Use the action that matches the current status. Draft: Approve or Cancel. Approved: Issue or Cancel. Issued: Mark as Collected Back or Cancel. Collected Back and Cancelled: no further action.

### Amount below zero

- **Type:** Error
- **Action:** Save, Update
- **When:** Amount is less than 0.
- **Example message:** *Validation min on amount failed*
- **Outcome:** The cheque is not saved.
- **Solution:** Enter an amount of 0 or greater.

### Amount above the limit

- **Type:** Error
- **Action:** Save, Update
- **When:** Amount is greater than 990000000.
- **Example message:** *Validation max on amount failed*
- **Outcome:** The cheque is not saved.
- **Solution:** Enter an amount of 990,000,000 or less.

### Not allowed to use the action

- **Type:** Error
- **Action:** list, view, New Security Cheque, Update, Delete, Approve, Issue, Mark as Collected Back, Cancel
- **When:** The role does not include that Security Cheque permission. The button is normally hidden; this is the result if the action is still requested.
- **Example message:** *You are not authorized to do this action*
- **Outcome:** The screen does not open, or the status does not change.
- **Solution:** Grant the matching Security Cheque permission on the role: list, view, create, update, delete, approve, issue, collected back, or cancel.

### Supplier or cash account still used by a security cheque

- **Type:** Error
- **Action:** Delete on Supplier, or delete on Cash Account
- **When:** A security cheque still points at that supplier or cash account.
- **Example message:** *Cannot delete this suppliers due to reference found in securityCheques* for a supplier. *Cannot delete this cashAccounts due to reference found in securityCheques* for a cash account.
- **Outcome:** The supplier or cash account is not deleted.
- **Solution:** Cancel or delete the security cheques that use that supplier or cash account, then delete the master record. Draft cheques can be deleted. Approved, issued, collected back, and cancelled cheques stay in the register and keep the reference.

</section>
