xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Currency Revaluation Line — entity reference
REFERENCE · Last reviewed

Currency Revaluation Line — entity reference

One foreign-currency position on a Currency Revaluation run, such as a bank balance, a receivable or a payable, identified by its ledger account and, for receivables and payables, the counterparty. The line records the foreign amount, the base amount already carried in the ledger, the closing rate, the restated base amount, and the change between the last two. Lines are written by the platform's revaluation calculation when it builds a run. They are not shown in any seeded app, and no button on any screen builds a run, adds lines or posts one. If you create or edit a line by hand, nothing calculates its amounts: Revalued Base Amount and Gain Loss keep whatever you type, and the line reaches the ledger only when its run is posted. Posting skips lines that have no GL Account or a zero Gain Loss.

Fields

FieldLabelTypeRequiredWhat it does
BookedBaseAmountBooked Base AmountCurrencyWhat the position is currently carried at in the base currency, which is the figure already in the ledger. It is the baseline the change is measured against and is never recalculated. Rounded to two decimals.
ClosingRateClosing RateCurrencyRate from the line's currency to the run's base currency on the revaluation date, taken from the run's Rate Type. The latest active exchange rate on or before that date is used; if only the reverse pair exists, its inverse is used. Stored to eight decimals. Building a run fails with a 'No exchange rate found' error when neither pair has a rate.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyCurrencyTextCurrency code of the position, such as USD. When it equals the run's base currency the rate is 1 and the line has no change.
CurrencyRevaluationIdCurrency RevaluationLookup → CurrencyRevaluationThe revaluation run this line belongs to.
ForeignAmountForeign AmountCurrencyThe open balance of the position in its own currency, before restatement. Rounded to two decimals.
GainLossGain LossCurrencyRevalued Base Amount minus Booked Base Amount: the change in the position's carrying amount, not a gain or loss sign. A positive value is a gain on a debit-natured account such as a bank or receivable, but a loss on a credit-natured account such as a payable, because the liability grew. Posting reads the GL Account's type to decide the direction. Lines with zero are skipped when the run is posted.
GLAccountIdGL AccountLookup → GLAccountLedger account that holds the position, usually a foreign-currency bank, receivable or payable account. Posting adjusts this account by the line's Gain Loss: it is debited when the carrying amount of an asset rises and credited when a liability rises. A line without a GL Account is skipped when the run is posted.
IdIdGuidYes
LineNumberLine NumberNumberOrder of the line within its run. Lines are numbered 1, 2, 3 when the run is built and are posted in this order.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesLine identifier. A document name setting with the default series CRL is seeded for lines.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountCompany the line belongs to. It is copied from the run.
PartyAccountIdParty AccountLookup → AccountCustomer or vendor whose open balance is restated. It is set on receivable and payable positions and left empty for bank positions. When the run is posted it is carried onto the journal line, so the adjustment appears on that party's ledger.
RecordTypeIdRecord TypeGuid, hidden
RevaluedBaseAmountRevalued Base AmountCurrencyForeign Amount multiplied by Closing Rate and rounded to two decimals, which is what the position is worth in the base currency on the revaluation date. It is calculated only when a run is built and is not recalculated if you edit the line.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
NewNewNewNew
NewInlineNewNewInlineNew