GetLedger — Get Ledger

BOD OAGIS combinant le verbe Get et le noun Ledger. Équivalent canonique direct des messages EDI EDIFACT FINSTA et X12 821 dans l'écosystème Finance d'OAGIS 10.x.

Objet du BOD

Le BOD GetLedger interroge un grand livre comptable pour un compte donné, une période donnée. Réponse : ShowLedger avec les écritures consolidées. Outil essentiel pour la consolidation multi-ERP.

Structure (ApplicationArea + DataArea)

Comme tout BOD OAGIS, GetLedger empile une ApplicationArea d'enveloppe technique (Sender, BODID, CreationDateTime) et une DataArea métier qui contient le verbe et le noun.

• Get verbe avec Expression sur compte, période, devise.
• Ledger noun partiel.

Exemple XML

Payload OAGIS 10.x minimal, à titre didactique. Les éléments structurants (en-tête + au moins une ligne) sont obligatoires dans toute implémentation conforme.

<?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>

Cas d'usage

Une plateforme de consolidation interroge les 12 ERP du groupe en fin de mois : GetLedger par compte / période / devise. Les 12 ShowLedger sont consolidés en un seul jeu de balances groupe.

Équivalences EDI

En passerelle EDI, ce BOD se mappe typiquement vers :

• EDIFACT FINSTA — équivalent EDIFACT.
• X12 821 — équivalent X12.

Pour aller plus loin

• OAGi — OAGIS 10.x — page officielle de la spec et téléchargement libre.
• OAGi (OAGIS) — hub sur ediverse — architecture BOD, verbes, modèle canonique.
• EDIFACT sur ediverse — équivalent fonctionnel EDIFACT FINSTA.
• X12 sur ediverse — équivalent fonctionnel X12 821.