A period-end foreign-currency revaluation run for one company. It restates open foreign-currency positions (bank, receivable and payable balances) at the closing rate on the revaluation date, holds one Currency Revaluation Line per position, and, once posted, links to the single journal that books the unrealized exchange difference. The calculation that builds a run and the posting that books it exist in the platform, but no seeded app, screen, button or scheduled job runs either of them. A run you create by hand with New is only a record: it calculates nothing and never posts. Posting adjusts each line's GL Account by the line's change in carrying amount, then balances the journal with one line to the unrealized foreign-exchange gain account or the loss account for the net amount. A run can be posted only once. Sync profiles do not import revaluation runs or their lines from another system, because an imported run would have no posting behind it.
Fields
| Field | Label | Type | Required | What it does |
BaseCurrency | Base Currency | Text | | Currency every position is restated into, normally the company's reporting currency. It is stored on the run, so later changes to the company do not reinterpret old runs. It appears in the posted journal's narration. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
FiscalPeriodId | Fiscal Period | Lookup → FiscalPeriod | | Fiscal period the run belongs to. Nothing fills this automatically. The posted journal finds its own period from the Revaluation Date, like any other journal. |
GLId | GL | Lookup → Journal | | The journal that posted the run. It is empty until the run is posted. A run that has a journal here cannot be posted again. |
Id | Id | Guid | Yes | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | Run identifier. A document name setting with the default series CR is seeded for runs. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
PartnerAccountId | Partner Account | Lookup → Account | | Company the run belongs to. Exchange rates are looked up for this company, and the posted journal is booked to it. |
RateType | Rate Type | Text | | Exchange rate type the closing rates are read from. Defaults to Closing. Each line uses the latest active rate of this type on or before the revaluation date. |
RecordTypeId | Record Type | Guid, hidden | | |
RevaluationDate | Revaluation Date | DateAndTime | | Date the positions are restated as at. It is the rate date for every line and the date of the posted journal, so it decides which fiscal period the journal falls in. |
Status | Status | Text | | Draft or Posted. A run is Draft when built and becomes Posted when its journal is posted. Posting is refused when the status is already Posted. |
TotalGainLoss | Total Gain Loss | Currency | | Net unrealized exchange result in the base currency. When the run is built it is the plain sum of the lines' changes in carrying amount. On posting it is replaced by the posted result: positive is a net gain and negative a net loss, taking account of whether each GL account is an asset or a liability. The two figures differ when the run includes payable positions. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Delete | Delete | Delete | Delete |
Edit | Edit | Edit | Edit |
New | New | New | New |