ANTE User Manual

Exchange Rate (Developer)

The Exchange Rate screen is where you set up, once for the whole system, how ANTE gets its foreign-exchange (FX) rates. You choose which rate providers to use, which currencies to fetch, and how often. The rates you set up here become the system-wide rates that every company sees on their own Treasury → FX Rates page.

This page does two jobs:

  1. Provider Configuration — turn the daily rate fetch on or off, choose which currencies to fetch, and store the credentials for each rate provider.
  2. Global rates — see all the rates the system currently holds for a chosen month, fetch today's rate on demand, or backfill an entire past month.

⚠️ Developer Access Only

This screen is part of the Developer portal and is only available to accounts with developer privileges.

Getting Here

  1. Open the Developer portal.
  2. In the sidebar, open the System group.
  3. Click Exchange Rate.

How It Works

At the top of the page, three quick facts summarize how the system handles rates:

  • Many providers, one primary — You can store keys for several providers. The system keeps a copy of the rates from each one. The provider you mark as primary is the one that postings and reports prefer.
  • Auto-fetch at 02:00 PHT — Once a day, the system automatically fetches rates from every enabled provider. You don't have to run it by hand.
  • Tenants override per-company — Individual companies can set their own manual rate on their Treasury → FX Rates page (Daily tab). That manual rate wins for that company only.

📌 The per-company manual overrides do not appear on this screen. They are managed on each company's own settings page.

Provider Configuration

This is the top card on the page. It holds the system-wide settings and the list of providers.

System Settings

FieldDescription
Enable daily FX rate fetchingWhen on, the daily automatic fetch runs. When off, the automatic fetch is paused and the system falls back to manual overrides only.
Pivot currencyRead-only. This is automatically taken from the primary company's Main Currency (Settings → Company Info). All rates are stored against this currency.

Target Currencies

Below the providers list is a grid of currency chips, one per supported currency.

  • Click a currency chip to select or unselect it. Selected currencies show a check mark.
  • The pivot currency is shown with a "base" tag and cannot be selected — the system excludes it automatically.
  • Selected currencies move to the front of the list, and a counter shows how many are selected.
  • For each currency you select, the daily fetch pulls one rate (that currency to the pivot currency) from every enabled provider.

After changing the Enable daily FX rate fetching toggle or the Target currencies, click Save settings to apply your changes.

Providers List

Each provider you can use is shown as its own row. A counter above the list shows how many providers are currently enabled.

Every provider row shows:

ElementDescription
Provider nameThe name of the rate provider.
free badgeShown on providers that don't need an API key (Frankfurter, a free European Central Bank source, is always available).
key configured ✓ / key requiredFor providers that need an API key — whether a key has been saved.
primary badgeMarks the provider that postings and reports prefer.
last statusThe result of this provider's most recent fetch.
Include in daily fetchTurn this provider on or off for the daily automatic fetch.
Primary (read default)Mark this provider as the primary one. Only one provider can be primary at a time.
API KeyFor providers that need one — paste the key here, then click Save. If a key is already saved, leave it blank to keep the existing one.
Base URL (optional override)Leave blank to use the provider's default endpoint. Only needed in special setups.

📌 Saved API keys are stored securely and are never shown back to you. The screen only tells you whether a key is configured.

Global Rates

This is the second card on the page. It shows the system-wide rates that have already been stored, and lets you fetch new ones.

Viewing Rates for a Month

  • Use the View month picker to choose which month to look at. You cannot pick a future month.
  • A This month shortcut appears when you're viewing a past month — click it to jump back to the current month.
  • A counter shows how many rate rows are stored for the chosen month.

When rates exist for the month, they appear in a table:

ColumnDescription
DateThe date the rate applies to.
PairThe currency pair, shown as "from → to".
RateThe exchange rate value.
ProviderWhich provider the rate came from (or "—" if none).
SourceWhere the number came from.

If no rates are stored for the chosen month, the screen shows an empty message inviting you to use Sync now or Sync month.

Last Sync Banner

Above the actions is a banner that reports the most recent automatic-fetch result:

  • A status word — SUCCESS, PARTIAL, FAILED, or NEVER.
  • The date and time of the last sync.
  • If the last sync failed, the error message is shown for troubleshooting.

Freshness Indicator

A badge shows how current the stored data is, based on the date of the newest rate row and the primary provider.

Common Tasks

Turning On Automatic Rate Fetching

  1. Go to Developer → System → Exchange Rate.
  2. In Provider Configuration, check Enable daily FX rate fetching.
  3. In the Target currencies grid, click the currencies you want the system to fetch.
  4. Click Save settings.

From then on, the system fetches the chosen currencies once a day automatically.

Adding a Provider's API Key

  1. In Provider Configuration, find the provider's row in the Providers list.
  2. Paste the key into the API Key field.
  3. Click Save on that row.

The row updates to show key configured ✓.

Choosing the Primary Provider

  1. Find the provider's row.
  2. Check Primary (read default).

The provider gets the primary badge. To change the primary later, mark a different provider as primary.

📌 Changing the primary provider never breaks an existing rate — the system can still read from any other provider's stored copy.

Fetching Today's Rate On Demand (Sync Now)

  1. In the Global rates card, choose a provider in the picker next to the buttons (or leave it on All enabled providers).
  2. Click Sync now.
  3. A message confirms how many rates were fetched, or reports which currencies failed.

📌 Sync now is rate-limited. If you click it too often, the button shows a countdown and you'll need to wait before trying again.

Backfilling a Whole Month (Sync Month)

Use this to fill in history — for example when first turning the feature on, or to fill a gap after an outage.

  1. In the Global rates card, click Sync month.
  2. In the dialog:
    • Provider — choose a provider. Only providers that support historical ranges can be selected (Frankfurter today); others appear disabled with a "no range support" note.
    • Month to backfill — pick the month. It defaults to the previous month and cannot be a future month.
  3. Click Backfill month.
  4. A message confirms how many rates were stored across how many days, or reports any failures.

📌 Backfilling a month you've already filled is safe — existing rates are refreshed, not duplicated. Weekends and holidays are skipped because the source only publishes weekday rates. Sync month is rate-limited to one backfill every 5 minutes.

← Previous
AI Usage Statistics
Next →
Storage