Welcome to Zuora Product Documentation

Explore our rich library of product information

The FX Gain/Loss Journal Entry behavior

Learn about the FX Gain/Loss Journal Entry behavior

A Journal Run can fail when Unrealized FX Gain/Loss is calculated and the required foreign exchange (FX) rate is not available.

When the FX Gain/Loss Journal Entry accounting rule is enabled, the system calculates unrealized FX based on the accounting period end date, not the Journal Run (JR) target dates.

Unrealized FX Gain/Loss calculation

Unrealized FX Gain/Loss reflects the change in value of open Accounts Receivable (AR) balances due to currency fluctuations.

The calculation is based on a period-end snapshot of all open AR balances. To determine the unrealized amount, the system compares:

  • The FX rate on the original transaction date

  • The FX rate on the accounting period end date (adjusted by the configured Rate Offset, if applicable)

Because of this design, the system requires FX rates covering the period from the first transaction date through the end of the accounting period.

Role of Journal Run target dates

The Journal Run target dates only determine which journal entry transactions are included in the run. They do not affect how Unrealized FX Gain/Loss is calculated.

Even if the Journal Run targets a subset of dates, the unrealized FX calculation still requires the FX rate corresponding to the accounting period end date (plus any configured rate offset).

Rate offset behavior

If a Rate Offset is configured, the system looks for the FX rate on:

Accounting Period End Date - Rate Offset

For example, if the rate offset is -1 day, the system retrieves the FX rate for the day prior to the accounting period end date.

Resolution

Ensure that the required FX rate exists for the date determined by:

Accounting Period End Date - Rate Offset

If the FX rate for this date is missing, the Unrealized FX Gain/Loss calculation may fail during the Journal Run.