Mi ez és mire jó?

A GlaSummaryMonthlyController havi bontású főkönyvi riportot ad vissza. Minden sor egy GLA kód, az oszlopok a hónapok nettó forgalmai (T–K), valamint a nyitó és záró egyenleg.

• Adatforrások: BookingLedger, GL_Account
• Kapcsolat: minden lekérdezés a connection(\'compdb\') kapcsolaton fut
• Időkeret: a keretezést a meglévő getdate() biztosítja

Hívás forma

Alap kérés (klasszikus működés)

{
  "year": 2025
}

Alapértelmezetten a teljesen 0 sorok rejtve maradnak (visszafelé kompatibilis működés).

„Nullás” sorok megjelenítése aktivitás alapján

Új flag: show-zero-activity. Ha 1-re állítod, akkor azok a sorok is megjelennek, ahol az időszak során volt könyvelési aktivitás, még ha a végeredmény 0 is lett.

Példa (év alapján)

{
  "year": 2025,
  "show-zero-activity": 1
}

Példa (intervallum alapján)

{
  "show-zero-activity": 1,
  "from_date": "2025-01-01",
  "to_date": "2025-06-30"
}

Időkeretezés – mi történik a háttérben?

• A getdate() határozza meg az év első és utolsó napját.
• Aktivitás-ellenőrzés:
  • Év esetén: whereYear(D_BookL_PostingDate, year)
  • Intervallum esetén: whereBetween(D_BookL_PostingDate, [from_date, to_date]) (csak ha nincs year)
• Prefix-alapú (hierarchikus) vizsgálat: ha egy alábontott GLA kód aktív, a „szülő” is aktívnak számít a megjelenítéshez.

Swagger kivonat

requestBody:
  content:
    application/json:
      schema:
        type: object
        properties:
          show-zero-activity:
            type: integer
            enum: [0, 1]
            default: 0
          year:
            type: integer
          from_date:
            type: string
            format: date
          to_date:
            type: string
            format: date
        description: |
          Alap: a nullás sorok rejtve.
          Ha show-zero-activity=1, a nullás sorok is megjelennek, ha volt aktivitás.
          Ha year van, év alapján vizsgálunk; ennek hiányában és from_date+to_date meglétekor intervallum alapján.

Gyors összefoglaló