# Service Completion Note

<p class="doc-lead">A Service Completion Note records that a service was delivered to a customer — installation, annual maintenance, consulting hours, or any saleable service. It links to a Sale Order or Sale Invoice, confirms work done, and can be used to create a Sale Invoice for billing.</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="#/service/service-completion-note?id=overview">Overview &amp; List View</a>
<a href="#/service/service-completion-note?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="#/service/service-completion-note?id=header-fields">Header Fields</a>
<a href="#/service/service-completion-note?id=shipment-fields">Shipment Details</a>
<a href="#/service/service-completion-note?id=item-lines">Service Lines</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/service/service-completion-note?id=cross-documents">Cross-Document Actions</a>
<a href="#/service/service-completion-note?id=actions-status">Actions &amp; Status</a>
<a href="#/service/service-completion-note?id=faq">FAQ</a>
<a href="#/service/service-completion-note?id=related">Related</a>
</div>
</div>
</div>

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

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

Go to <b>Service → Service Completion Note</b>.

<img src="service/images/srv-completion-note.webp" alt="Service Completion Note list" loading="lazy">

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Internal reference number. |
| Number # | Document number. |
| Customer | Customer who received the service. |
| Sale Order | Linked Sale Order, if any. |
| Employee | Employee who performed or recorded the service. |
| Date | Date of the service completion. |
| Status | Draft, Approved, Cancelled, or Closed. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Default | All notes except Cancelled. |
| Approved | Approved notes only. *(Default tab on open.)* |
| Draft | Notes saved but not yet approved. |
| Cancelled | Cancelled notes. |

<b>Advanced Filters</b>

Employee, Customer, Status (All / Approved / Draft / Cancelled), Date, Created date.

<b>List actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| New | — (creates a blank note) |
| Edit | Draft, For Revisal |
| Delete | Draft, For Revisal |
| View | All statuses |
| Export | — (Excel export when permitted) |

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

<h2 id="quick-start">Quick Start</h2>

<h3>From a Sale Order</h3>
<ol>
<li>Open an approved or partially delivered <a href="#/sales/sale-order">Sale Order</a>.</li>
<li>Click the three-dot menu → <b>Create Service Completion Note</b>.</li>
<li>Customer and service lines are pre-filled from the order.</li>
<li>Adjust quantities if needed, then <b>Save</b> or <b>Save And Approve</b>.</li>
</ol>

<h3>Standalone</h3>
<ol>
<li>Go to <b>Service → Service Completion Note</b> → <b>New</b>.</li>
<li>Set <b>Date</b> and <b>Customer</b>.</li>
<li>Add service lines: <b>Item</b>, <b>Quantity</b>, <b>Unit</b>.</li>
<li><b>Save</b> (Draft) or <b>Save And Approve</b>.</li>
</ol>

<img src="service/images/srv-compl-note-new.webp" alt="New Service Completion Note" loading="lazy">

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

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

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date of service completion. Required. |
| Number | Document number. Hidden when auto-numbering is enabled in Number Settings. |
| Sale Order Id | Linked Sale Order. Read-only when created from an order. |
| Customer * | Customer who received the service. Required. |
| Employee | Employee responsible for the service. |
| Project | Project, if applicable. |
| Project Task | Task within the project. |
| Notes | Additional remarks. |

<b>View page — document details</b>

Note ID, Number #, Date, Project, Project Task, LPO / FPO, Sale Order [Id], Sale Invoice [Id], WorkFlow Request.

<b>View page — party details</b>

Customer, Party Details, Shipping Address, Contact Name, Contact Phone, Phone, Carrier Name / Agent, Bill Of Lading/LR/RR No., Motor Vehicle No.

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

<h2 id="shipment-fields">Shipment Details</h2>

Shown on New/Edit only when <b>Show Shipment Details</b> is enabled in <a href="#/service/service-settings">Service Settings</a>.

| **Field** | **Description** |
|-----------|-----------------|
| Carrier Name/Agent | Name of the carrier or transport agent. |
| Bill Of Lading/LR/RR No. | Transport document reference. |
| Motor Vehicle No. | Vehicle registration number. |

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

<h2 id="item-lines">Service Lines — SERVICES</h2>

| **Column** | **Description** |
|------------|-----------------|
| Sl Num | Line serial number. Auto-numbered. |
| Item | Service item. Only active service items are listed. Click to open Service Enquiry. |
| Description | Optional line description. Shown only when enabled in Service Settings. |
| Quantity | Quantity of service completed (e.g. hours, visits). |
| Unit | Unit of measure. Defaults from the service item. |

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

<h2 id="cross-documents">Cross-Document Actions</h2>

<b>Created from</b>

| **Source** | **Action** | **When available** |
|------------|------------|---------------------|
| <a href="#/sales/sale-order">Sale Order</a> | Create Service Completion Note | Approved, Partial Delivered, Delivered |
| <a href="#/sales/sale-invoice">Sale Invoice</a> | Create Service Completion Note | Approved, Closed |

<b>Creates</b>

| **Target** | **Action** | **When available** |
|------------|------------|---------------------|
| <a href="#/sales/sale-invoice">Sale Invoice</a> | Create Invoice | Approved |

<p>When created from a Sale Invoice (without a Sale Order), the note is automatically <b>Closed</b> on approval.</p>

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

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

<h3>New / Edit form actions</h3>

| **Action** | **Description** |
|------------|-----------------|
| Save | Saves as Draft. |
| Save And Approve | Saves and approves in one step. |
| Update | Saves changes on an existing Draft or For Revisal note. |
| Reset | Clears the form. |
| Cancel | Closes without saving. |

<h3>View toolbar actions</h3>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Approve | Draft |
| Edit | Draft, For Revisal |
| Delete | Draft, For Revisal |
| Clone | All (if permitted) |

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

| **Action** | **Available when status is** |
|------------|------------------------------|
| Create Invoice | Approved |
| Cancel | Approved, Open, Closed |
| Add/Update Note | All |
| Print | All |

<h3>Status lifecycle</h3>

| **Status** | **Meaning** |
|------------|-------------|
| Draft | Saved but not approved. Can be edited or deleted. |
| Approved | Service delivery confirmed. Can create Sale Invoice or Cancel. |
| Closed | Automatically set when created from a Sale Invoice and approved. |
| Cancelled | Voided. Cancel any linked Sale Invoice first if one exists. |

<p><b>On approve:</b> If linked to a Sale Order, delivery quantities are validated and the order delivery status may update. No stock or ledger posting occurs on this document.</p>

<p><b>Signature on print:</b> Received By (customer).</p>

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

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

<p><b>Can I create a Service Completion Note without a Sale Order?</b><br>Yes. Use <b>New</b> on the list and select the customer and service items directly.</p>

<p><b>Why is my note Closed immediately after approval?</b><br>When the note was created from a Sale Invoice (not a Sale Order), it closes automatically on approval because the invoice already exists.</p>

<p><b>Why can't I cancel this note?</b><br>Cancel the linked Sale Invoice first, then cancel the Service Completion Note.</p>

<p><b>Does approving a Service Completion Note post to accounts?</b><br>No. It confirms service delivery only. Create a Sale Invoice from the note to bill the customer.</p>

<p><b>Where do I enable shipment fields?</b><br>Service → Service Settings → <b>Show Shipment Details</b>.</p>

<p><b>What is the difference between a Service Completion Note and a Sale Invoice?</b><br>The Service Completion Note confirms that a service was delivered to the customer. The <a href="#/sales/sale-invoice">Sale Invoice</a> bills the customer and posts revenue. Approve the completion note first, then use <b>Create Invoice</b> when billing is due.</p>

<p><b>Why can't I approve this note?</b><br>Approval is blocked when the linked Sale Order is Cancelled or Closed. Correct the order status or create a standalone note without an order link.</p>

<p><b>Why did approve fail on quantity?</b><br>When linked to a Sale Order, delivered quantities cannot exceed what remains to be delivered on the order. Reduce line quantities to match the order balance.</p>

<p><b>Can I create a Service Completion Note from a Sale Invoice?</b><br>Yes. Use <b>Create Service Completion Note</b> from an approved Sale Invoice when you need a delivery document after invoicing. The note closes automatically on approval because the invoice already exists.</p>

<p><b>Does approving a Service Completion Note affect stock?</b><br>No. Services are not inventory items — approval updates delivery quantities on the linked Sale Order only.</p>

<p><b>Can I link a Project and Project Task?</b><br>Yes. Set <b>Project</b> and <b>Project Task</b> on service jobs so completion notes roll into <a href="#/project/reports/project-summary">Project Summary</a> and profit reports with the rest of the job costing.</p>

<p><b>Can I edit an approved Service Completion Note?</b><br>Not directly. <b>Cancel</b> the note (after cancelling any linked Sale Invoice) and create a new one, or use workflow revise actions if enabled in your company.</p>

<p><b>What invoice statuses block cancellation?</b><br>When linked to a Sale Order, cancel is blocked while a related Sale Invoice for that order is Approved or Closed. Cancel the invoice first, then cancel the completion note.</p>

<p><b>Why is there no New button when I open from a Sale Order?</b><br>Notes created from orders inherit customer and lines from the order. Use the order's <b>Create Service Completion Note</b> action, or use <b>New</b> on the list for standalone delivery without an order.</p>

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

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

<ul>
<li><a href="#/service/service-items">Service Items</a> — define services before creating notes.</li>
<li><a href="#/service/service-receipt-note">Service Receipt Note</a> — record services received from suppliers.</li>
<li><a href="#/sales/sale-order">Sale Order</a> — source document for linked completion notes.</li>
<li><a href="#/sales/sale-invoice">Sale Invoice</a> — billing document created from an approved note.</li>
<li><a href="#/service/service-settings">Service Settings</a> — shipment details and footer notes.</li>
<li><a href="#/service/reports/service-enquiry">Service Enquiry</a> — item purchase and sales history.</li>
</ul>

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

## Errors and warnings

Exact messages for Service Completion Note 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.


### Future or back-dated date

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Date is in the future and future-date transactions are off, or the user cannot enter previous dates, or the date is before the allowed cutoff.
- **Example message:** *Future date transactions are not allowed.* or *Previous date transaction entries are not allowed.* or *Transaction date cannot be before YYYY-MM-DD.*
- **Outcome:** The document is not saved.
- **Solution:** Set Date to an allowed date, then save.

### Accounts closed for the date

- **Type:** Error
- **Action:** Approve, Save And Approve, Master Update
- **When:** The document date is in a closed accounting period.
- **Example message:** *Accounts closed for the date*
- **Outcome:** Not posted, or the date is not changed.
- **Solution:** Use a date after the accounts closing date.

### Multi-level approval required

- **Type:** Error / workflow
- **Action:** Approve, Save And Approve
- **When:** An active multi-level approval template matches this document.
- **Example message:** *Multi level approval is required*
- **Outcome:** Direct approve is blocked.
- **Solution:** Use Send Request on the first stage. For Send Request, stage Approve, Reject, Send For Revise, and Cancel Request messages, see <a href="#/features/multiapproval?id=action-errors">Multi Approval — Action error messages</a>.

### Edit or delete not allowed

- **Type:** Error
- **Action:** Edit, Delete
- **When:** Status is not Draft or For Revisal, or auto bill-number is on for delete.
- **Example message:** *Edit not allowed in the current status* or *Invalid status* or *Delete prevented..*
- **Outcome:** Posted documents stay in the ledger.
- **Solution:** Cancel a posted document after unlinking related records. Delete only drafts.

### Cancel date restriction

- **Type:** Error
- **Action:** Cancel
- **When:** User cannot cancel previous-date transactions, or the date is before the cancel cutoff.
- **Example message:** *Cancelling previous date transactions are not allowed* or *Cancelling transactions before YYYY-MM-DD is not allowed.*
- **Outcome:** Not cancelled.
- **Solution:** Cancel only dates the user is allowed to cancel.

### Items missing or invalid

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Item lines are empty, a required field is missing, or line totals do not match.
- **Example message:** *items not found* or *Invalid Data in lines {N}* (`fs_api`). ERP: *Items contains invalid data* or *Items required*.
- **Outcome:** Not saved.
- **Solution:** Add valid item lines, then save.

### Quality inspection pending

- **Type:** Error (blocks approve)
- **Action:** Approve
- **When:** QC is required and still pending (`qcStatus` pending).
- **Example message:** *Quality Inspection is Pending*
- **Outcome:** Approve fails.
- **Solution:** Complete Quality Inspection first, then Approve.

### Sale order must be open

- **Type:** Error
- **Action:** Approve
- **When:** The linked sale order is missing, cancelled, or closed, or completed qty exceeds the order.
- **Example message:** *Order not found*; *Cannot approve on a cancelled order*; *Cannot approve on a closed order*; *Service completed quantity exceeds sale order*
- **Outcome:** Not approved.
- **Solution:** Use an approved open sale order and do not exceed remaining service quantity.
### Cancel blocked by sale invoice

- **Type:** Error
- **Action:** Cancel
- **When:** A sale invoice already consumed this note.
- **Example message:** *Cancel sale invoice 1042,1043 before cancelling service completion note*
- **Outcome:** Not cancelled.
- **Solution:** Cancel the sale invoice first.

</section>
