Skip to content

Tax Configuration Applet

Purpose and Overview

The Tax Configuration Applet is the centralized master configuration tool for managing all tax codes and their corresponding rates across the entire system. It allows users to define tax parameters that are automatically applied across all other applets wherever tax selection is required.

This applet serves as the single source of truth for taxation — any tax code created, updated, activated, or deactivated here will immediately reflect in Tax Selection dropdowns and Tax Tabs across all relevant modules.

Core Concept: The Tax Configuration Applet is a master data module — it does not process transactions itself, but provides the tax codes and rates that all other applets reference. Proper configuration here ensures accurate tax calculations system-wide.

Key Features Overview

Who Benefits from This Applet?

Finance & Tax Teams:

  • Centralized Control: Manage all tax codes from a single applet instead of configuring taxes per module
  • Rate Management: Update tax rates in one place and have changes reflected across the entire system
  • Compliance: Maintain accurate tax configurations aligned with regulatory requirements (GST, SST, Withholding Tax)

Accountants & Auditors:

  • Audit Trail: Track all tax code changes with full history
  • Lifecycle Management: Deactivate obsolete tax codes without losing historical data
  • Accuracy: Ensure consistent tax application across all financial documents

System Administrators:

  • Cross-Applet Integration: Tax codes automatically appear in all relevant modules
  • Multi-Country Support: Configure tax codes for different countries and jurisdictions
  • Standardization: Enforce consistent tax naming conventions across departments

What Problems Does This Solve?

The Decentralized Tax Configuration Problem:

Without a centralized tax configuration tool, organizations face:

  • Tax codes configured differently across modules leading to inconsistencies
  • Difficulty tracking which tax rates are active and which are obsolete
  • Manual rate updates required in multiple places when regulations change
  • No standardized naming conventions causing confusion during tax selection

The Tax Configuration Applet Solution:

  • Single Source of Truth — All tax codes managed in one place, reflected everywhere
  • Multi-Type Support — GST, SST, Sales Tax, Service Charge, and Withholding Tax all in one applet
  • Active/Inactive Lifecycle — Safely retire tax codes without deleting historical data
  • Auto-Integration — New tax codes instantly available across all system modules
  • Country-Based Configuration — Tax codes linked to specific countries for multi-jurisdiction compliance

Key Features Inventory

Tax Code Creation
Create, edit, and manage tax codes with unique identifiers and descriptive names
Understanding Tax Types
Configure GST, SST, Sales Tax, Service Charge, and Withholding Tax types
Rate Configuration
Set and update tax rates with system-wide propagation
Lifecycle Management
Manage Active/Inactive status to retire codes without data loss
Tax Configuration Applet Overview Infographic
At a Glance: The Challenges, Solutions, Supported Tax Types, and System-Wide Integration of the Tax Configuration Applet.

Key Concepts

Understanding Tax Types

The applet supports multiple tax categories, each serving a specific purpose:

Tax TypePurposeDirection
GST InputGoods and Services Tax paid on purchasesInbound (Purchase)
GST OutputGoods and Services Tax collected on salesOutbound (Sales)
SSTSales and Service TaxBoth
SLS (Sales)Sales-specific taxOutbound (Sales)
SVC (Service Charge)Service Charge applied to transactionsOutbound (Sales)
Withholding Tax InputTax deductions at source on payments receivedInbound (Purchase)
Withholding Tax OutputTax deductions at source on payments madeOutbound (Sales)
Selecting the incorrect tax type may affect financial reporting and calculations. Always verify the tax type matches the transaction direction (Input for purchases, Output for sales).

Tax Code Structure

Each tax code consists of:

ComponentDescriptionExample
CountryThe jurisdiction the tax applies toMalaysia, Singapore
Tax CodeUnique identifier for the taxSR-6, SR-8, ZRL
NameFull descriptive nameService Tax 6%, Sales Tax 8%
Tax TypeCategory of tax (GST, SST, etc.)SST, GST Output
RateThe percentage rate applied6%, 8%, 10%
StatusActive or InactiveActive

Cross-Applet Integration

This applet functions as the master tax configuration module. Once a tax code is created and saved:

  • It automatically appears in the Tax Selection dropdowns across the system
  • It becomes available in the Tax Tab of all relevant applets
  • Any updates to the tax code or rate are immediately reflected system-wide
Tax codes are shared across all modules — Sales, Purchasing, Invoicing, Credit Notes, and more. A single change here propagates everywhere.

Quick Start Guide

Step 1: Open the Tax Configuration Applet

Navigate to the Tax Configuration Applet from the Finance module. The listing screen displays all existing tax codes.

Tax Configuration Listing Screen
The Tax Configuration Listing screen showing all tax codes with their country, tax code, name, tax type, rate, status, and dates.

Step 2: Create a New Tax Code

  1. Click the Create (+) button
  2. Select the relevant Country from the selection menu
  3. Enter a unique Tax Code identifier
  4. Enter a descriptive Name (use full descriptive names for clarity)

Step 3: Configure Tax Type and Rate

  1. Select the appropriate Tax Type (GST Input/Output, SST, SLS, SVC, Withholding Tax)
  2. The rate field will auto-populate or become available based on the selected type
  3. Manually input the specific Tax Rate percentage
  4. Verify the rate before saving

Step 4: Save

Click Create to finalize the new tax entry. The tax code will immediately be available across all system modules.

Feature Deep Dive

Tax Code Creation

When creating a new tax code, the following fields must be configured:

FieldRequiredDescription
CountryYesThe jurisdiction/country the tax applies to
Tax CodeYesUnique identifier (e.g. SR-6, ZRL)
NameYesFull descriptive name (e.g. Service Tax 6%)
Tax TypeYesCategory: GST, SST, SLS, SVC, or Withholding Tax
RateYesTax percentage rate
Best Practice: Use clear and descriptive names rather than abbreviations. For example, use “Service Tax 6%” instead of “ST6”. This improves usability and reduces selection errors in other applets.
Create Tax Code - Tax Type Dropdown
The Create Tax Configuration form showing the Tax Type dropdown with available options: GST-INPUT, GST-OUTPUT, SST-SLS-INPUT, SST-SLS-OUTPUT.

Editing and Updating Tax Codes

To modify an existing tax entry:

  1. Click into the specific tax code from the listing screen
  2. Update the required fields — Tax Type, Tax Rate, Name, or other details
  3. Click Save to apply changes

Changes are immediately reflected across all modules that reference this tax code.

Edit Tax Code
The Tax Configuration Edit form showing tax code details — Country, Tax Code, Tax Name, Tax Type, Rate, and Status fields.
Edit Tax Code - Tax Type Dropdown
The Tax Type dropdown during editing, showing additional options: SST-SLS-OUTPUT, SST-SVC-INPUT, SST-SVC-OUTPUT, WITH-INPUT.

Rate Configuration

After selecting a Tax Type:

  • Certain fields may auto-populate or dynamically appear based on the selected type
  • You must manually enter the correct numerical rate
  • Always verify the rate before saving
Failure to input the correct rate will impact financial calculations system-wide. Double-check all rate entries before saving.

Lifecycle Management

Tax codes follow an Active/Inactive lifecycle rather than deletion:

StatusBehavior
ActiveAvailable for selection in all modules, applied to new transactions
InactiveHidden from selection dropdowns, preserves historical data

Why use Inactive instead of deleting?

  • Preserves historical transaction data — Past documents retain their tax references
  • Prevents selection in new transactions — Users cannot accidentally apply obsolete rates
  • Maintains audit integrity — Complete history of all tax codes is preserved for compliance

To deactivate a tax code:

  1. Open the tax code record
  2. Change the status from Active to Inactive
  3. Save the changes
Listing Search and Filter Panel
The search and filter panel with options to filter by Country, Tax Type, date range, and Status.

Configuration & Settings

Application Settings (Settings > Application Settings)

SettingDescription
Field VisibilityConfigure which fields are visible and mandatory during tax code creation and editing
Default CountrySet a default country pre-filled when creating new tax codes
Tax Code FormatDefine naming conventions or format rules for tax code identifiers

Personalization (Personalization > Default Selection)

SettingDescription
Default ViewConfigure the default listing view and sort order
Default CountrySet your personal default country selection

FAQ

Q: Can I delete a tax code that is no longer needed? A: No. Instead of deleting, change the tax code status to Inactive. This preserves historical transaction data while preventing the code from being selected in new transactions. Deleting tax codes could break references in existing documents.

Q: If I update a tax rate, does it affect existing transactions? A: No. Existing transactions retain the rate that was applied at the time of creation. The updated rate will only apply to new transactions going forward.

Q: Can I have multiple tax codes for the same tax type? A: Yes. You can create multiple tax codes under the same type with different rates. For example, you might have “Service Tax 6%” and “Service Tax 8%” both under the SST type for different effective periods.

Q: How do I know which tax type to select? A: Select Input types (GST Input, Withholding Tax Input) for purchase/inbound transactions and Output types (GST Output, Withholding Tax Output) for sales/outbound transactions. Use SST, SLS, or SVC based on your country’s tax regulations.

Q: Will a new tax code automatically appear in all modules? A: Yes. Once created and saved with Active status, the tax code immediately appears in Tax Selection dropdowns and Tax Tabs across all relevant applets system-wide.

Applet Reference

Menu Items

ActionDescription
Create (+)Create a new tax code entry
SearchSearch for existing tax codes
FilterFilter by tax type, status, or country

Settings

SettingLocationDescription
Application SettingsSettings > Application SettingsConfigure field visibility and mandatory fields on creation/edit forms
Default CountrySettings > Application SettingsSet the default country selection

Personalization

SettingLocationDescription
Default ViewPersonalization > Default SelectionConfigure listing view and sort preferences
Default CountryPersonalization > Default SelectionPersonal default country selection

Summary

The Tax Configuration Applet is the master configuration module for all tax-related settings across the system. Key takeaways:

  • Single Source of Truth — All tax codes managed centrally and reflected everywhere
  • Multi-Type Support — GST (Input/Output), SST, Sales Tax, Service Charge, and Withholding Tax
  • Active/Inactive Lifecycle — Never delete tax codes; deactivate them to preserve history
  • Instant Integration — New and updated tax codes immediately available across all modules
  • Rate Accuracy — Always verify tax rates before saving, as they impact calculations system-wide
Best Practice: Use descriptive naming conventions, verify rates before saving, and deactivate rather than delete obsolete tax codes to maintain audit integrity.