Nexto
Administration

Currency Management

Currency Management

This page is the exchange's currency catalog, and only the admin sees it: here you decide which currencies the app works with and what properties each one has — enabling/disabling, multilingual name, flag, category, rate mode, decimal count, creating a derived currency (like "Tehran Dollar" from the Dollar), and enabling remittance for each currency. Any change here applies to all users, and only active currencies appear in trade/transfer forms.

How This Differs From "My Currencies"

Currency Management My Currencies
Who Admin only Each user, for themselves
Scope The whole system Only that user's own display
Purpose Defining/enabling a currency and its settings Bringing frequently-used currencies to the front of selection lists

In short: currencies get "defined and enabled" here; in "My Currencies," each user picks their own frequently-used ones from among these active currencies so they come first in the pickers.

Fields

Field Description
Name The currency's display name in your interface language; each language is edited separately and changing it does not affect the other languages.
Flag The icon next to the name; derived currencies inherit their parent's flag.
Category Fiat, crypto, gold, remittance, or goods & services (see below).
Rate mode The rate's display direction: multiply or divide relative to the reference currency — determines how the board rate is read. Each menu option shows its own live example from the board; with USD as reference, × reads 1 EUR = 1.08 USD and ÷ reads 1 USD = 3.67 AED.
Decimals Display precision for this currency's amounts.

Working With the List

  • The filter row under the column headers works on the Exchange currencies table; this page has no filter form above the table.
  • The search box further down the page belongs to the "Add from the world currency list" card and has nothing to do with filtering this table.
  • The "Decimals" column has a numeric filter, and the "Order" column is sortable (its own cell holds the move buttons, so a numeric filter on it would make no sense).

Toman/Rial base unit

The exchange's rial-side unit (Toman or Rial) is chosen during initial setup — alongside the reference currency — and every balance, document, and report uses that unit. It can only be changed before the first document is recorded; after that it is locked, since changing it would invalidate all recorded figures. This is different from the "Rial unit of receipts" setting (in Settings, used for reading WhatsApp receipts): that one only controls how bank-receipt amounts are interpreted.

Gold, coins and bars

  • For gold, only 18K gold (gram) (GL18K), coins (Emami, Bahar, half, quarter, gram coin) and bars are currencies.
  • Melted and worked gold of other karats is not a currency: each piece is converted to 18K grams with “weight × fineness ÷ 750” and recorded with “Receive gold pieces” (e.g. 32.86 g at 747 = 32.729 g of 18K).
  • Serial-numbered bar (BARSN) is a count-based catalog currency. Brand bars are derived from it and inherit “serial-numbered”; every such bar is kept one by one in the cash box by serial number.
  • 1 kg gold bar (BAR1KG) is also in the catalog: count-based and serial-numbered, priced as 1,000 grams of 24K gold. You can derive an “Iranian bar” or a “foreign bar” from it.
  • A currency derived from a coin or a bar also inherits its parent’s weight multiplier (a bar derived from the 100 g bar is priced as 100 grams from the start); adjust a premium or a different purity with the multiplier in Board rates → Settings.
  • Gold-category currencies in “Add from the world currency list” are shown only when “Gold trading” is on in Settings.

Notes

  • The reference currency (the basis for all reports) is a single one, set during setup; changing it later is not a simple task.
  • Derived currencies (like "Tehran Dollar" or remittances) are linked to a parent currency: they inherit flag, category, and price source from the parent, and if they have no direct price of their own, their rate is read from the parent.
  • Rate settings (buy/sell spread, rounding, API) are under Board Rate → Settings.

Table Filtering and Sorting

  • There is a filter row right under the column headers: in a text column type part of the value, in a numeric column give a "Min" or a range ("100-500" means between the two, "-500" means at most 500), in an option column pick from the list. The filter applies to every record on the server, not just the page you are looking at.
  • Column headers carrying the ⇅ mark sort when you click them, and the default arrangement comes from the "Order" column; the ▲/▼ move buttons work on the whole list of active currencies, not on the filtered list.
  • Changing a column filter or the sorting happens without reloading the page: only the table body is swapped, so your filters and scroll position stay put. The page address only changes with the filters in the form at the top of the page (date range and grouping).
  • Active filters are kept, and the Excel/PDF export sees exactly the same ones. To clear one, empty the field or leave the "All" option.
  • On phones each row is a card: the counterparty and amount in large type, a few key details and the action buttons at the bottom; "Show more" opens the rest. Less-used filters are behind "More filters", column filters behind "Column filters", and the round + button at the bottom of the screen creates a new item.

Display slug and custom flag: a currency’s internal code never changes after creation , but in the row editor you can set a custom display slug (e.g. US$ instead of USD) shown everywhere — statements, forms, exports and WhatsApp messages; search recognises both. The flag can be an emoji or an uploaded image (svg/png/jpg/webp, max 300KB); the uploaded image takes priority over the default icon. SVG files are accepted only as plain graphics: scripts, external links and embedded content are stripped on upload, and a malformed SVG is rejected.

  • Renaming a currency code: the code field (behind each row's flag button) is both the display form and the internal code — saving renames the internal code . Ledger and balances are untouched . If the currency has derivatives you are asked whether to rename their prefix too, and reminded that desk/inbox messages must use the new code and old documents will display it as well.

Desk words (currency dictionary)

Every exchange has its own words for its currencies: “dollar herat”, “harat”, “ringgit”… Click the button next to the currency name to open the Desk words field; separate words with commas. The WhatsApp inbox recognises these words when reading messages. A word can map to only one currency. The full list, including “variant suffixes” (like har, applied to every base currency), is in the inbox settings.

Goods and services

Not everything you buy and sell is money: visas, hotel nights, tickets, transfers, or goods such as oil, steel beams or any other commodity. These are counted in units, not amounts. Create a row in the “Goods & services” category for each one with the “Add goods or service” card; from then on it appears like a currency in the trade form, statements and balances.

Field Description
Name e.g. “Dubai visa”, “Steel I-beam 14” or “Crude oil”.
Code (English) English letters, digits and _ only — like VISA or STEEL_14.
Unit The word shown next to the quantity: pcs, person, night, trip, t, kg, barrel, L, m, bar… or any word you like; empty = “pcs”.
Decimal Places Zero for visas and tickets; as many as needed for goods sold in fractions (tons, barrels).
Profit method Pass-through or stocked (see below).
Reference price per unit Optional; an approximate price per unit in the reference currency (see below).

Two profit methods

Pass-through (back-to-back buy and sell) is for a service that is never stocked. Example: you get a Dubai visa from an agency for 90 dollars and sell it to the traveler for 110 dollars at the same moment. A pass-through item is traded only in “Double trade” — buying from the supplier and selling to the customer together — and its profit is the 20-dollar gap between the two legs; it creates no position and no average. The regular buy/sell form refuses it.

Stocked (average cost) is for goods you buy, hold and sell bit by bit. Example: you buy 1,000 barrels of oil at 70 dollars and later another 1,000 barrels at 74 dollars; the average cost is 72 dollars. Selling 500 barrels at 78 dollars makes a profit of 3,000 dollars (500 × (78 − 72)), and 1,500 barrels stay in stock at the same 72 average. These goods are traded with the regular buy/sell form and their stock shows up in Currency Position.

In both methods one side of the trade must be a currency; trading one item for another (e.g. oil against steel) is refused.

Reference price, board and revaluation

  • Goods and services have no market rate: they do not appear on the Board Rate, in the customer panel's price list or in the dashboard rate widget, and they are never revalued — no unrealized FX profit or loss.
  • Balances are valued at cost, not at today's price. The reference price is used only while no cost has been recorded yet, for example in opening balances.
  • In Currency Position, the reference price only shows the stock's “current value” and creates no document.
  • In Opening Balances, an item's first balance is recorded at the reference price, or at a rate you enter manually there.
  • In the exchange currencies table, an item row shows profit method, unit and reference price for editing instead of “Rate mode”.

Adding a new currency

The “Add from the world currency list” card shows only the ones common in the region. For anything else, search by name or code, or press Show all to open the full list with chips for national currencies, remittances, crypto and gold. On each chip, the main click adds the currency, and the ⋯ menu holds “Remittance” and “Derive”. A remittance appears under its own name (for example “Dirham remittance”). Each currency code is unique, and a hyphen or a space in it becomes _. A currency that was created earlier and then removed from the selected list is not created again; search for it in this same card and add it back. A code must not end with : when deriving, write a suffix after “PARENT”.

Removing a currency that still has balances

If a currency still has balances or an open position, removing it first shows a warning and goes ahead with “Remove despite the balance”. It leaves the forms and the board, but its automatic rate keeps being read so reference values, credit limits and revaluation aren't worked out on a stale rate. A currency on a manual rate keeps its last rate.

This guide comes straight from the in-app help and refreshes with every update. Video tutorials · Free demo
Chat on WhatsApp