ShowLedger

OAGIS BOD combining the Show 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 ShowLedger BOD is the response to GetLedger. It carries the consolidated accounting entries for an account / period / currency. Often high volume: pagination is common.

Structure (ApplicationArea + DataArea)

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

• LedgerHeader — account, period, currency.
• LedgerLine — entry: date, journal, debit / credit, description, document reference.

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"?>
<ShowLedger
    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-showledger-2026-0014</BODID>
  </ApplicationArea>

  <DataArea>
    <Show/>
    <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>
</ShowLedger>

Use case

A subsidiary ERP responds to GetLedger with a ShowLedger containing 4,800 entries for the previous month on account 411 (customers). The group platform consolidates in seconds.

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.