Foreign Currency
ASC 830 multi-currency: exchange rate tables, entity functional currencies, month-end revaluation, realized FX on receivables and translation for consolidation.
Foreign Currency keeps the company’s exchange rates and the functional currency of each entity. It also revalues foreign-currency balances at month end and translates foreign-functional entities for consolidated statements, using the current rate method. Open it from the company app launcher under Accounting > Foreign currency; it appears when your accounting access includes it.
- Who uses it
- Controllers and accountants; approval needs a second user with journal approval rights.
- When
- When rates are published, at month end for revaluation, and at reporting dates for consolidation.
- What it holds
- Effective-dated spot, average and historical rates, entity functional currencies, and revaluation runs with their evidence.
Key workflow
- Set up rates. Enter rates by hand or import a CSV. Rates are effective-dated by type (spot, average, historical). A missing rate is refused rather than assumed to be 1.
- Assign functional currencies. Set an entity’s functional currency before it posts anything. Entities without one use the company base currency.
- Transact. AR invoices and receipts can be raised in a foreign currency. Collecting at a different rate posts the realized gain or loss automatically.
- Revalue at month end. Prepare a revaluation for an entity and period. Cash, receivable, payable and intercompany balances in foreign currencies are restated at the period-end spot rate. A different user approves, and the entry reverses on the first day of the next period.
- Consolidate. Balance sheets and income statements that span entities translate foreign-functional entities: assets and liabilities at the closing rate, income and expense at monthly averages, and equity at historical rates. The cumulative translation adjustment appears in equity. The cash flow statement and the statement of changes in equity, combined or consolidated, translate each foreign entity’s movements at monthly average rates and equity transactions at the rate of their day, with an effect of exchange rates on cash line, so they tie to the translated balance sheets.
Controls
- A rate becomes immutable once any document, posting or revaluation uses it, enforced by the service and by a database trigger. Every rate change and import is audited.
- Revaluation is maker-checker: the preparer cannot approve. Approval re-checks the evidence and refuses if balances or rates moved.
- Re-running a revaluation for the same entity and period posts nothing new. Closed periods are refused.
- Close tie-outs for receivables and payables run per currency, so foreign activity is reconciled, not skipped.
Current boundaries
For period-end sequencing, read the period close workflow guide.
API operations
15 operations · 7 read · 8 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/fx/entitiesList entity functional currencies - PATCH
/fx/entities/{id}Set an entity's functional currency - GET
/fx/ratesList exchange rates - POST
/fx/ratesAdd an exchange rate - GET
/fx/rates/{id}Show an exchange rate - PATCH
/fx/rates/{id}Change an unused exchange rate - DELETE
/fx/rates/{id}Delete an unused exchange rate - POST
/fx/rates/importImport exchange rates from CSV - GET
/fx/revaluationsList revaluation runs - POST
/fx/revaluationsPrepare a revaluation - GET
/fx/revaluations/{id}Show a revaluation run - POST
/fx/revaluations/{id}/decisionApprove or cancel a revaluation - GET
/fx/revaluations/previewPreview a revaluation - POST
/fx/setupCreate the FX accounts - GET
/fx/translationTranslated trial balance
Parameters, request and response fields, errors and a generated example for each operation are in the REST reference for this app. Read scopes, step-up and permissions in the Accounting API guide.
Keep exploring
Related across os.construction
- DocsFinancial reportsReview company financial statements and understand reconciliation coverage.
- DocsFinancial ReportsA 48-report library: statements, consolidated statements with NCI, cash flow, aging, job profitability, WIP, retainage, payroll, flux and control reports, exportable to CSV, XLSX and PDF.
- GlossaryTrial balanceA list of every account's debit or credit balance at a date; total debits equal total credits.
- GlossaryConsolidationCombining the financial statements of several entities into one set for the group, eliminating intercompany balances and transactions.
- BlogHow to close the month in construction accounting: a step list from cutoff to lockA construction month-end close gets every cost and every billing into the right month, proves cash and the subledgers against the ledger, updates the WIP schedule from current cost-to-complete, has someone else review it, and then locks the period. Here is the step list, an example close calendar and a worked example of what one late invoice does to WIP.
- BlogYour first accounting cycle: setup, transactions and closeA practical learning path through the Accounting module's apps, with the people, evidence and review gates needed from opening balances to month-end.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →