Skip to content

Payment Voucher (Internal) Applet

Work in progress: This applet documentation needs changes and more explaination.

Purpose and Overview

The Payment Voucher (Internal) Applet streamlines the full lifecycle of internal payment vouchers, from creation and expense capture to settlement, adjustments, and final posting. It brings together voucher header details, expense lines, payment lines, and traceability so finance teams can process payments with speed and control across the main menus: Payment Voucher (Internal), File Import, File Export, Intercompany, Settlement Adjustment, and Expenses Adjustment.

Core Concept: The applet links who is paid (entity/supplier) to what is paid (expense lines) and how it is settled (payment lines, contra, and adjustments) while preserving posting and audit traceability.

About the Applet

  • Purpose: Create, track, and finalize internal payment vouchers with settlement, adjustments, and audit controls.
  • Target Users: Accounts Payable clerks, finance executives, treasury/payment operations, and finance controllers.
  • Key Features: Voucher lifecycle management, expense and line-item capture, payment and settlement handling, adjustments and contra, intercompany processing, file import/export, and operational controls like Final/Discard/Void, Send Email, Single/Multiple Print, and Clone.

Key Features Overview

Who Benefits from This Applet?

Accounts Payable and Finance Executives:

  • Fast voucher creation and controlled edits
  • Clear visibility of expenses, payments, and balances
  • Built-in actions to final, discard, or void

Treasury and Payment Operations:

  • Organized payment lines and settlement tracking
  • Export-ready payment files for bank processing
  • Better coordination of payment timing and method

Finance Managers and Controllers:

  • Review-ready documents and settlement consistency
  • Trace document visibility before period close
  • Audit trails for compliance

Auditors and Compliance:

  • Full history of voucher changes and status
  • Traceability from voucher to posting
  • Attachment and document linkage

What Problems Does This Solve?

The Manual Payment Voucher Problem:

Manual payment vouchers often lead to:

  • Missing or inconsistent expense details
  • Slow approvals and late payments
  • Unclear settlement balances
  • Weak audit trails and poor traceability

The Payment Voucher (Internal) Applet Solution:

  • Structured voucher capture with header, expenses, and payments
  • Built-in settlement controls and adjustments
  • Contra handling to offset balances
  • Intercompany processing for cross-entity settlement
  • Export-ready files for downstream payment runs
  • Audit-ready visibility through trace and logs

Key Features Overview

Payment Voucher (Internal) overview infographic
Infographic highlighting challenges, solutions, and beneficiary roles.

internal-payment-voucher-overview

Key Concepts

Understanding the Payment Voucher Framework

AspectComponentPractical Example
Who is paid?Entity or SupplierVendor ABC Trading
What is paid?Expense Line ItemFreight Charge, RM 2,500
How is it settled?Payment Line and SettlementBank transfer, contra offset
Where does it post?AR/AP and Trace DocumentPosting to AP and Cashbook
Example: A payment voucher for freight charges is created, linked to the supplier, assigned cost coding, paid via bank transfer, and traced to the final posting for audit.

Payment Voucher Hierarchy Structure

Organization
│
├── Entities/Suppliers ──> WHO is paid?
│   │
│   └── Voucher Header ──> Core document details
│       │
│       ├── Account & Address Details
│       ├── Expense Lines & Cost Coding
│       └── Payment Lines & Settlement
│
└── Adjustments & Contra ──> Balance corrections
    │
    └── Trace Document ──> Posting visibility

Flow Through the Hierarchy:

  1. Organization: Company policies and controls
  2. Entity: Supplier or payee
  3. Voucher Header: Branch, date, currency, reference
  4. Expenses: Line items and cost allocation
  5. Payments: Method and settlement details
  6. Adjustments/Contra: Corrections and offsets
  7. Trace Document: Posting status and audit

The “Settlement Triangle” of Payments

ComponentRoleExample
Voucher HeaderThe document to be paidIPV-2026-00045
Payment LinesHow the payment is executedBank transfer, cheque
Settlement/ContraHow the balance is clearedOffset against AP invoice

This triangle keeps payment processing consistent and auditable. If one side changes, the other two must be reviewed to keep the voucher balanced.


Quick Start Guide

Quick start infographic for Payment Voucher (Internal)
Role-based quick start flow for creating, reviewing, and exporting vouchers.

For Finance Executives: Create Your First Payment Voucher

  1. Go to Payment Voucher (Internal) from the sidebar.
    Payment Voucher (Internal) listing
    Listing view with filters, actions, and email template selection.
  2. Click + and fill main details (branch, company, date, currency, reference).
    Add Payment Voucher (Internal) button
    Plus button on the listing used to create a new voucher.
  3. Open Account and select the entity, billing, and shipping details.
    Account tab with Entity Details
    Entity Details fields for the payee in the Account tab.
Select Entity dialog
Entity selection list used to populate Account details.
  1. Open Expenses and add line items with amounts and cost coding.
Expenses tab with item list and Select Item
Expenses tab with line list and item selection panel.
Add Item form - Item Details
Add Item form showing Item Details fields.
Add Item form - Batch Number
Batch Number tab for lot-controlled items.
Add Item form - Serial Number
Serial Number tab for serialized items with scan/import.
Add Item form - Item Details (Main Details)
Item Details main fields for the selected item.
Add Item form - Costing Details
Costing Details tab for cost allocation and pivot view.
Add Item form - Issue Link
Issue Link tab for linking related issues or tickets.
  1. Open Payment and add payment lines to match the payable amount.
Payment tab in voucher edit
Payment tab ready for settlement lines.
Add Settlement drawer
Add Settlement form with Settlement Group and Method.

Settlement Type Reference (examples; depends on your configured payment methods):

Settlement TypeWhen to UseNotes
CashCash payment at point of processingPosts to cashbook when finalized
Bank TransferBank-to-bank paymentCapture bank reference if required
ChequeCheque-based paymentRecord cheque number and date
Contra/OffsetOffset against related documentsReduces open balance without cash movement
Other (FPX/e-Wallet)Digital payment channelsUse if configured in your settlement methods
Payment lines with totals
Payment line list showing total payment and balances.
  1. Review AR/AP or Settlement Adjustment if the balance is not zero.
AR/AP tab summary
AR/AP summary for settlement, contra, and outstanding balances.
  1. Add Doc Link or Attachments if approvals or invoices must be stored.
Doc Link tab
Doc Link tab for linking related documents.
Attachments tab
Attachments tab for uploading supporting files.
  1. Click Save for draft or Final to lock the voucher.
Save action in voucher edit
Save button on the voucher form.

What happens next? Managers or controllers can review and finalize, and the trace document will reflect posting status when available.

Pro Tip: Use Send Email and Single/Multiple Print from the listing to speed up communication and approvals.

For Managers/Controllers: Review and Finalize

  1. Open Payment Voucher (Internal) and filter by status or date.
    Advanced search filters
    Status and date range filters for the listing.
  2. Review Main Details, Expenses, and Payment tabs for completeness.
    Edit Payment Voucher (Internal) - Main Details
    Edit view showing Main Details fields and actions.
Expenses tab in edit view
Expenses tab with line items and totals.
Payment tab in edit view
Payment tab showing settlement lines and totals.
Edit Payment form
Edit Payment form with Settlement Type, Method, Date, and Amount.
  1. Check Settlement Adjustment or Contra if balances do not align.
Contra tab in voucher edit
Contra tab listing offsets and balances.
Add Contra button
Plus button used to add a contra document.
Select document to contra
Selection list for choosing documents to offset.
  1. Review Trace Document (if available) to confirm posting readiness.
Trace Document tabs
Trace Document tabs for Journal, Cashbook, Points, Tax, and Inventory.

Trace Document Differences

Trace TypeWhat It RepresentsWhen It AppearsWhy It Matters
Journal TxnGeneral ledger postingsAfter voucher is Final and GL posting is createdConfirms debit/credit accounts and amounts
Cashbook TxnCash or bank movementsAfter voucher is Final and settlement method posts to cash/bankValidates cash/bank impact and references
Points TxnPoints ledger movementOnly when points-based settlement is usedConfirms points redemption or accrual entries
Tax TxnTax-related postingsWhen tax is applied on expense linesValidates tax amount and tax account mapping
Inv TxnInventory movement postingsWhen expenses affect inventory itemsConfirms stock impact and valuation entries
  1. Click Final to approve, or Query offline if corrections are needed.
Final action in Trace Document view
Final button highlighted with Trace Document tab open.

For Admins: Initial System Setup

  1. Configure Settings > Application Settings to show or hide key tabs.
Application Settings
Application Settings for field visibility and tab configuration.
  1. Set defaults in Settings > Default Selection for faster entry.
Default Selection settings
Default Selection settings for branch and location defaults.
  1. Define Printable Format Settings for voucher output.
Printable Format Settings listing
Printable Format Settings listing for voucher templates.
Add Printable Format
Add Printable Format form with upload area.
  1. Configure Email Template for voucher notifications.
Email Template listing
Email Template list for voucher notifications.
Create Email Template form
Create Email Template form with printable format and template body.
  1. Review Permissions and field visibility for role-based access.
Permission Set settings
Permission Set listing for role-based access.
  1. Test a full voucher flow (create → payment → final → trace).

For Treasury/Payment Ops: Generate a Payment Export (CSV)

  1. Open File Export from the sidebar.
Payment Voucher File Export listing
File Export listing with Generate CSV and export history.
  1. Select the transaction date range.
File Export date range filters
Choose transaction date range before generating CSV.
  1. Click Generate CSV to download the payment file.
Generate CSV action
Generate CSV button in File Export.
  1. Confirm the export appears in the listing.
Generated export entry
Export listing showing a generated CSV with download action.

For Finance Operations: Bulk Import Payment Vouchers

  1. Open File Import from the sidebar.

    File Import listing
    File Import listing with uploaded files and statuses.

  2. Download and fill the import template (Excel/CSV). The Excel/CSV template file can be download from File Export menu

  3. Upload the file and review the Checking tab.

    File Import Checking tab
    Checking tab showing validation results.

  4. Fix errors and re-upload if needed.

  5. Confirm the import and review the created vouchers.

New rollout checklist: Validate a full workflow from draft to final, including payment lines, adjustments, and trace document visibility.

Payment Allocation and Settlement Tracking

Payment vouchers are only complete when the settlement position is clear. This section explains how to confirm what is paid, what is offset, and what remains outstanding.

How to Check Your Settlement Position

  1. Open the voucher and go to the Payment tab to review payment lines.
  2. Check Settlement Adjustment for corrections or balance fixes.
  3. Use AR/AP (edit view) to verify outstanding and settled amounts.
  4. Recheck totals after any Expenses or Payment edits.

Key Features

  • Real-time recalculation when payments or expenses change
  • Settlement adjustment workflows for corrections
  • Contra support for offsetting related documents

Common Scenarios

Scenario 1: Partial Payment

Voucher amount: RM 10,000
Payment recorded: RM 6,000
Status: Partially settled, RM 4,000 outstanding

Scenario 2: Full Settlement with Contra

Voucher amount: RM 5,000
Payment: RM 2,000
Contra offset: RM 3,000
Status: Fully settled

Tips for Finance Teams

  • Recheck settlement after editing expense lines
  • Use adjustments for late corrections instead of reissuing vouchers
  • Confirm AR/AP tab balance before finalizing

Voucher Management

The main workflow centers on the Payment Voucher (Internal) menu:

  • List and filter vouchers with advanced search and column toggles
  • Create, edit, and clone vouchers from the listing
  • Final, discard, or void vouchers based on status and control policies
  • Send email and print vouchers from the listing (email requires a selected template)
  • Template selection for Send Email is available directly on the listing toolbar
Payment Voucher (Internal) listing (alternate view)
Listing view for Payment Voucher (Internal).
Payment Voucher (Internal) create/edit form
Create/Edit form with tabs for details, expenses, and payment.

Common Statuses:

StatusMeaningTypical Action
DraftIn progressContinue editing and save
FinalApproved and lockedProceed to posting/trace
DiscardedCancelled before finalNo posting impact
VoidedCancelled after finalAudit trail retained

Create/Edit Tabs (Core):

  • Main Details: Document header fields (branch, date, currency, reference).
  • Account: Entity, billing, and shipping details.
  • Expenses: Line items and cost coding.
  • Payment: Payment lines and settlement alignment.
  • Department Hdr: Department header coding.
  • Doc Link: Link to related documents.

Create/Edit Tabs (Edit-Only or Conditional):

  • Expenses Adjustment: Correct expense allocation after creation.
  • AR/AP: Review outstanding and settled balances.
  • Settlement Adjustment: Correct settlement mismatches.
  • Contra: Offset balances against related documents.
  • Trace Document: Posting trace and downstream status.
  • Attachments: Supporting documents and approvals.
  • Export: Export voucher data when enabled.
  • Sales Commission: Link commission records when configured.

Voiding Payment Vouchers

Use Void to cancel a voucher after it has been finalized, while keeping an audit trail. For drafts, use Discard instead.

When to Use Void (Common Scenarios)

  • The voucher was finalized with the wrong entity or amount.
  • The payment was cancelled or should not proceed.
  • The expense lines were materially incorrect and must be reversed before re‑issuing.
  • The voucher was duplicated and needs to be cancelled cleanly.

When to Use Discard Instead

  • The voucher is still in Draft and was created in error.
  • You want to abandon edits without creating a posting trail.

How to Void a Payment Voucher (User Guide)

  1. Open Payment Voucher (Internal) from the sidebar.
  2. Filter and select the Final voucher you want to void.
    Search Filter for Posting Status FINAL
    Filter using Posting Status into FINAL to make it faster to search for Payment Voucher which have been FINAL
Search result for FINAL
All the payment voucher in the listing is with Posting Status FINAL
  1. Click Void from the listing action bar.
    Void button
    Click in the VOID button to void the Payment Voucher
Confirmation on void document
Pop out confirmation to make sure user really want to VOID the Payment Voucher
  1. Confirm the action in the Pop out.
Successfuly VOID the payment voucher
Pop out success message on voiding the document
  1. Verify the status becomes Voided by using the Search Filter.
    Search recent VOID Payment Voucher
    Use the Search Filter to search for the VOID document using the Posting Status
Show all the voided payment voucher
All the voided Payment Voucher will show in the Payment Voucher Listing
  1. Open the voucher, then go to Trace Document in the edit view to review the posting trace; review Applet Log for audit confirmation.
Payment Voucher before void
Payment Voucher before void
Payment Voucher after void
Payment Voucher after void

Handling “Ready” or Posted Vouchers

If a voucher is already Final, exported, or has settlement/trace entries:

  • Check Trace Document to see what has posted (Journal/Cashbook/Tax/Inv/Points). Note that Trace Document may still show the original postings even after a void, depending on your configuration.
  • Confirm settlement status in Payment, AR/AP, or Settlement Adjustment.
  • If your policy requires, coordinate with finance control before voiding.
  • If Void is not allowed, use adjustments/contra to correct balances and keep the audit trail intact.

Line Item and Expenses

Use the Expenses tab to capture detailed costs:

  • Line items with quantities and amounts
  • Pricing details and taxes
  • Department or cost coding for segment, project, profit center, and dimension
  • Item references such as serial, bin, or batch when applicable
  • Optional issue links and delivery details

Payments and Settlement

The Payment tab manages how the voucher is paid:

  • Multiple payment lines per voucher
  • Multi-currency and forex handling when enabled
  • Settlement alignment with expenses and adjustments
  • Reviewable AR/AP position for outstanding balances

Tip: If the forex button is enabled, review the exchange rate before finalizing to avoid posting variance.


Adjustments and Contra

For corrections and balancing:

  • Expenses Adjustment: Fix or reallocate expense line issues
  • Settlement Adjustment: Correct settlement mismatches
  • Contra: Offset balances against related documents

Use the Settlement Adjustment and Expenses Adjustment menus for a full listing view and audit.

Settlement Adjustment listing
Settlement Adjustment listing for payment vouchers.
Expenses Adjustment listing
Expenses Adjustment listing for payment vouchers.

Intercompany Processing

The Intercompany menu separates work into two queues:

  • Unprocessed: Pending intercompany transactions to be linked or resolved
  • Processed: Completed intercompany links for audit

This supports cross-entity payment flows without losing traceability.

Intercompany transaction listing
Intercompany listing with unprocessed and processed tabs.

Where Intercompany Data Comes From

Intercompany records are generated from Internal Payment Vouchers that are flagged for intercompany processing. Once a voucher is saved and finalized, the system creates intercompany entries that appear in the Unprocessed queue for linking or resolution. Availability depends on your intercompany configuration and permissions.

How to Create an Intercompany Transaction

  1. Create or open an Payment Voucher (Internal).
  2. Go to Account and open the Intercompany sub‑tab (if enabled).
  3. Select the intercompany entity/branch or required intercompany fields.
  4. Save and Final the voucher.
  5. Open Intercompany from the sidebar to view the new record under Unprocessed.
  6. Link or resolve it, then confirm it moves to Processed.

Tip: If the Intercompany sub‑tab is hidden, enable it in Settings > Application Settings or check your role permissions.


File Import

Bulk creation is available through File Import:

  1. Upload the source file (Excel/CSV as provided by your template).
  2. Validate data in the checking view.
  3. Resolve errors and confirm the import.
  4. Open a sample voucher to verify header, expenses, and payment lines.
File Import listing
File Import listing with uploaded files and statuses.

File Export CSV

Generate payment voucher exports for downstream payment runs:

  1. Open File Export.
  2. Select the transaction date range.
  3. Click Generate CSV to download the file.
  4. If the file is empty, confirm the vouchers are Final and within the date range.
Payment Voucher file export listing
File Export screen for generating voucher CSV output.

Trace and Audit

  • Where to trace a payment voucher: Open Payment Voucher (Internal) from the sidebar, select a voucher, and go to Trace Document in the edit view. Trace tabs appear after the voucher is Final.
  • Trace Document: View posting trace and downstream status (available after finalization).
  • Applet Log: Review who changed what, and when (Settings > Applet Log).

Use these tools to support audits and period close review.


Document Links and Attachments

  • Doc Link: Connect vouchers to related documents for traceability.
  • Attachments: Store invoices, approvals, and supporting files.
  • Sales Commission: Link commission records when enabled.

Configuration and Settings

Configure the applet under Settings:

  • Application Settings: Field visibility, tab enablement, and validation behavior.
  • Default Selection: Set defaults for branch, currency, and common fields.
  • Printable Format Settings: Control voucher print layout and branding.
  • Email Template: Configure email content used by Send Email.
  • Feature Visibility: Show or hide menu items and features by role.
  • Permissions: Client-side permission sets and user/team/role assignments.
  • Webhook: Configure outbound notifications for downstream systems.
  • Applet Log: System audit trail for voucher actions.
  • Release Notes: Track changes delivered to the applet.
Payment Voucher (Internal) settings
Settings page for field visibility, defaults, and templates.

Related Applets


Summary

The Payment Voucher (Internal) Applet provides a controlled, auditable workflow for managing internal payments. It combines voucher entry, expense and payment management, settlement adjustments, intercompany handling, and file import/export in one place, with clear traceability for finance and compliance.


FAQ

Q: Why is the Final button disabled? A: Required fields may be missing, or your role does not have final permission. Check Main Details, Expenses, and Payment tabs.

Q: Why is the Payment or Expenses tab hidden? A: It can be disabled in Application Settings or by role-based field configuration.

Q: Why does my voucher show an outstanding balance? A: Payment lines and settlement adjustments do not fully match the expense total. Review payments, contra, and adjustments.

Q: How do I export payment files for the bank? A: Go to File Export, pick the transaction date range, and click Generate CSV.

Q: Where can I trace a payment voucher? A: Open the voucher from Payment Voucher (Internal) and go to Trace Document in the edit view. Trace tabs appear after the voucher is Final.

Q: Can I link a voucher to related documents? A: Yes. Use Doc Link to connect related documents and keep traceability intact.

Q: Why is the export file empty? A: Check that vouchers are Final and the transaction date range matches the voucher dates.

Q: Why can’t I select a supplier/entity? A: The supplier may be inactive or missing in master data, or your role lacks permission.

Q: Why is Send Email missing or disabled? A: Email can be hidden in Application Settings or your role does not have permission; also confirm an Email Template is selected.

Q: Why don’t I see Intercompany records? A: You may not have access to intercompany data, or there are no transactions within your branch or date scope.