Currency Master
Currency Master is where you register the currencies your organization transacts in. Each record defines a currency’s ISO code, symbol, name, decimal precision, and display format — the configuration that everything else in the system relies on for multi-currency processing. Exchange rates for each registered currency are configured through the Exchange Rates sub-module, which sits inside Currency Master.
Access is permission-controlled. If you can’t see this screen, your administrator can grant you access.
The list view
Go to Currency Master in the sidebar. Three summary counters at the top show Total, Active, and Inactive records.
Searching and filtering
Search by currency name, ISO code, or symbol, case-insensitive. Where nothing matches, an empty state appears.
Two filters narrow the list independently: Status (All, Active, Inactive) and a currency-specific filter listing all registered currencies.
Choosing columns and refreshing
Click ⚙ Display Fields to toggle the Currency, ISO Code, and Symbol columns. Status and Actions are always shown.
Click ↻ Refresh to reload the list — a confirmation toast appears once it’s done.
Creating a currency record
Click + New.
Fields
Currency — selected from a searchable dropdown, searchable by name, ISO code, or symbol. Each option shows the ISO code, symbol, and full name together. Choosing a currency auto-fills the Symbol and Name fields below and enables the Format dropdown.
Each currency can only be registered once. Selecting one already in Currency Master blocks the save with “Currency already exists.”
Currency Symbol — auto-filled from your selection, but you can override it in the text field if needed.
Currency Name — auto-filled from your selection, and also overridable.
Decimal Places — 0, 2, or 3. Changing this resets whatever Format you’d already chosen, since the format options depend on the decimal precision.
Format — a searchable dropdown, scoped to match your Decimal Places selection. It stays disabled until you’ve chosen a currency. As soon as you pick a format, a live preview renders showing the symbol and pattern together — for example, $1,234,567.89 — so you can confirm it looks right before saving.
Saving
Click Save. The system checks all mandatory fields and confirms the currency isn’t already registered. New records are always created with a status of Active — there’s no option to create one as Inactive.
Where a check fails, the message appears inline beside the field and the record isn’t saved. Once saved, you’re returned to the list with a success message.
Viewing a currency record
Click the View icon to see every field in read-only form, along with a Has Transactions indicator.
If the currency has been used in transactions, a warning banner appears here as well as on the edit form.
Editing a currency record
Click the Edit icon. All existing values are pre-filled.
If the currency has already been used in transactions, a warning banner explains that the Currency selection itself can’t be changed. The field stays visible and technically clickable, but attempting to save a different currency produces “Currency cannot be changed — already used in transactions.” Everything else — symbol, name, decimal places, format — remains fully editable regardless of transaction history.
Deleting a currency record
Click the Delete icon. If the currency has no transaction history, a confirmation asks you to confirm before removing it.
If it has been used in transactions, deletion is blocked outright with an inline message, and no confirmation modal appears at all — there’s nothing to confirm since the action isn’t available.
Working with multiple records
Bulk status changes
Select records using the checkboxes, then choose Mark Active or Mark Inactive from the Actions menu. A confirmation modal appears before the change is applied.
Records already at the target status, and any record flagged as a functional currency, are excluded automatically from the bulk update. If your entire selection turns out to be ineligible, an error explains that no eligible records were found.
Exporting
Click Export and choose PDF or MS Excel. Both open a preview modal showing Currency, ISO, Symbol, and Status for your currently filtered records before you confirm the download. MS Excel downloads as a CSV file. An error appears if there’s nothing to export.
Importing
Click Import and upload a CSV, XLS, or XLSX file. Other file types are rejected immediately with a red inline error, and the Import button stays disabled until a valid file is provided.
Once you confirm the import, new currencies are added with a status of Active. Any row whose ISO code already exists in Currency Master is skipped rather than overwriting the existing record. The success message tells you how many were added and how many were skipped.
Exchange Rates
About this sub-module
Exchange Rates lives inside Currency Master and holds the dated conversion rates for a currency against every other currency it might be exchanged with. Each rate is tied to a specific “as of” date, so you can maintain a history of rates over time rather than a single static figure, and one rate per currency pair can be marked as the current rate in effect.
Opening the exchange rate list
From the Currency Master list, select a record and choose Actions › Add Exchange Rate. The page opens scoped to that currency, with its name and ISO code shown in the header. Click ← Back at any point to return to the Currency Master list.
Filtering and searching
The Exchange Currency filter narrows the list to rates against one specific currency. The dropdown lists every currency except the base currency itself, since a currency can’t hold an exchange rate against itself.
Search by date, rate value, or ISO code, case-insensitive. Where nothing matches, a “No exchange rates found for this currency” message appears.
Choosing columns
Click ⚙ Display Fields to toggle the As of Date and Exchange Rate columns. ISO and Actions are always shown.
Sort order
Rates are always listed most recent first, by date.
Adding an exchange rate
Click + New to open the Add Exchange Rate modal.
Fields
Date (As of Date) — defaults to today, but can be changed. This is the effective date the rate applies from.
Exchange Currency — a searchable dropdown by ISO code, symbol, or name. The base currency is excluded, since you’re always setting a rate against something else.
Exchange Rate — a positive numeric value. It must be greater than zero, and its decimal precision can’t exceed what’s configured for the base currency in Currency Master.
Saving
Click Save. The system checks all three fields are complete and confirms there isn’t already a rate for the same exchange currency on the same date — only one rate per currency pair per date is allowed. Attempting a duplicate produces “Exchange Rate already exists for the selected currency and effective date.”
Once saved, a success message confirms and the new rate appears in the list.
Viewing an exchange rate
Click the View icon to see the base currency, as of date, exchange currency, rate, and whether it’s been used in transactions, all read-only.
If it’s been used in transactions, a warning note appears here too.
Editing an exchange rate
Click the Edit icon, or Edit from the view modal. Date, exchange currency, and rate values are all pre-filled.
If the rate has already been used in a transaction, editing is blocked entirely — the modal shows a message explaining why, and no field can be changed. This is stricter than Currency Master’s own edit behaviour, where unrelated fields stay editable even after transaction use; here, any transaction history locks the whole record.
Deleting an exchange rate
Click the Delete icon. If the rate has no transaction history, a confirmation asks you to confirm. If it has been used in a transaction, deletion is blocked with an inline message and no confirmation is shown.
Setting the current rate
Select exactly one exchange rate using its checkbox, then choose Actions › Set as Current Rate. A confirmation shows you which rate you’re about to set before applying it.
This only works with a single selection. Selecting none produces “Select a row first to set as current rate,” and selecting more than one produces “Select only one exchange rate to set as current.” Once confirmed, that rate becomes the one reflected back in the Currency Master list for this currency.
Exporting and importing
Export offers PDF or MS Excel, both applying your current filter and search, and both showing As of Date, ISO, and Exchange Rate. An error appears if there’s nothing to export.
Import accepts CSV, XLS, or XLSX files. Rows are skipped where the date, ISO code, or rate is missing, where the exchange currency matches the base currency, or where the currency-and-date combination is a duplicate of an existing rate. The success message reports how many rows were added and how many were skipped.