GetLedger

OAGIS BOD combining the Get verb with the Ledger noun. Direct canonical equivalent of EDI EDIFACT FINSTA and X12 821 messages in OAGIS 10.x's Finance domain.

BOD purpose

The GetLedger BOD queries a general ledger for a given account, given period. Response: ShowLedger with consolidated entries. Essential tool for multi-ERP consolidation.

Structure (ApplicationArea + DataArea)

Like every OAGIS BOD, GetLedger stacks an ApplicationArea technical envelope (Sender, BODID, CreationDateTime) and a business DataArea that contains the verb and the noun.

• Get verb with Expression on account, period, currency.
• Ledger noun partial.

XML example

Minimal OAGIS 10.x payload for didactic purposes. Structural elements (header + at least one line) are required in any conformant implementation.

<?xml version="1.0" encoding="UTF-8"?>
<GetLedger
    xmlns="http://www.openapplications.org/oagis/10"
    releaseID="10.11" versionID="10.11">

  <ApplicationArea>
    <Sender>
      <LogicalID>ERP-CENTRAL-EU</LogicalID>
      <ComponentID>FinanceModule</ComponentID>
      <ConfirmationCode>OnError</ConfirmationCode>
    </Sender>
    <CreationDateTime>2026-05-15T10:15:00Z</CreationDateTime>
    <BODID>5a8f7d2e-2b15-4c1a-9e6f-getledger-2026-0014</BODID>
  </ApplicationArea>

  <DataArea>
    <Get>
      <Expression expressionLanguage="XPath">//Ledger[Status='New']</Expression>
    </Get>
    <Ledger>
      <LedgerHeader>
        <Account><ID>411000</ID></Account>
        <Period><StartDate>2026-04-01</StartDate><EndDate>2026-04-30</EndDate></Period>
        <Currency>EUR</Currency>
      </LedgerHeader>
      <LedgerLine>
        <PostingDate>2026-04-12</PostingDate>
        <Journal>VEN</Journal>
        <DebitAmount currencyID="EUR">1999.20</DebitAmount>
        <Description>Facture INV-2026-552190</Description>
      </LedgerLine>
    </Ledger>
  </DataArea>
</GetLedger>

Use case

A consolidation platform queries the group's 12 ERPs at month-end: GetLedger per account / period / currency. The 12 ShowLedger responses are consolidated into a single group balance set.

EDI equivalences

On an EDI gateway, this BOD typically maps to:

• EDIFACT FINSTA — EDIFACT equivalent.
• X12 821 — X12 equivalent.

Further reading

• OAGi — OAGIS 10.x — official spec page and free download.
• OAGi (OAGIS) — hub on ediverse — BOD architecture, verbs, canonical model.
• EDIFACT on ediverse — functional equivalent EDIFACT FINSTA.
• X12 on ediverse — functional equivalent X12 821.