# ledger

Verfolgen Sie Ausgaben, Transaktionen und finanzielle Kontexte, ohne Finanzdaten mit dem generischen Speicher zu vermischen.

- Canonical: https://docs.xmemo.dev/de/docs/tools/ledger
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 3bc28bb66da214c9eceb8c96db997d55d16493cd954fb2e787f46cdc124e477e
- Edition-Digest: 88ff972c1b894cb94b9217d261686329d5e336d538d4a2b930a6f1ffbdb55577
- Source-Revision: sha256:5ae3da12a28b7c528cd1988ad36022f9c72af84d4498e1c17052666c465b4673

## Tool Reference: `ledger`

### Purpose

Verwalten Sie regulierte Finanztransaktionen und Erinnerungen an die Verlängerung externer Dienste über den Ledger-Dispatcher mit strukturierten Zusammenfassungen und Auditgrenzen.

### Parameters

- `action` (add_expense | list | summary | overview | update_transaction, required): Vom Aufrufer ausgewählte Ledger-Operation. Es werden nur diese fünf Literalwerte akzeptiert.
- `item / amount / transaction_type / currency` (string / number, optional): Kernfelder der Transaktion; Betrag und Währung sind für finanzielle Schreibvorgänge erforderlich.
- `transaction_date / category / merchant / payment_method / note` (string, optional): Optionale Transaktionsklassifizierungs-, Datums- und Notizfelder.
- `query / date_from / date_to / min_amount / max_amount` (string / number, optional): Listen- und Zusammenfassungsfilter.
- `transaction_id / expected_version / patch` (string / integer / object, optional): Exaktes Aktualisierungsziel, optimistische Nebenläufigkeitsversion und zulässige Aktualisierungsfelder.
- `owner_timezone / project_id` (string, optional): Datumsinterpretation und autorisierte Projekt- oder Teamgrenze.
- `limit / offset / months` (integer / boolean, optional, default: 20 / 0 / 6 / false): Paginierung, Zusammenfassungshorizont und Steuerung strukturierter Ausgaben.

### Returns

Die strukturierte Ausgabe enthält die angeforderte Transaktion, Zusammenfassungsgruppen oder Übersicht sowie eine benutzerseitige Textzusammenfassung. Widget-Aufrufer können Aktualisierungsmetadaten erhalten; vertrauliche Daten sind niemals Teil des Antwortvertrags.

### Errors

- Autorisierungsfehler: Dem Token fehlt memory:read für Lesevorgänge oder memory:write für Mutationen.
- Validierungsfehler: Erforderliche Transaktionsfelder, Datumsformate, Währung oder Aktionswerte sind ungültig.
- Nebenläufigkeitsfehler: Eine Aktualisierung weist eine veraltete expected_version auf oder die genaue Transaktion wurde nicht gefunden.
- Aggregationsgrenze: Datensätze in unterschiedlichen Währungen werden separat gemeldet, anstatt eine fehlerhafte Gesamtsumme zu erzeugen.

### Examples

#### Eine Ausgabe erfassen



```typescript
ledger({
  action: "add_expense",
  item: "Domain renewal",
  amount: 18.00,
  currency: "USD",
  transaction_date: "2026-08-21",
  category: "software"
})
```

#### Eine monatliche Zusammenfassung prüfen



```typescript
ledger({ action: "summary", months: 1 })
```

### Related Tools

- [remember](/docs/tools/remember): Nur für nicht-finanziellen dauerhaften Kontext um den Datensatz herum verwenden.
- [todos](/docs/tools/todos): TODO für allgemeine Folgeaufgaben verwenden; ledger kann Prüferinnerungen aktivieren.
- [forget](/docs/tools/forget): Einen überprüften Ledger-Datensatz über seinen geregelten Lebenszyklus entfernen.

## Vor dem Erfassen überprüfen

Prüfen Sie zunächst die aktuelle Zusammenfassung; Ledger-Einträge sind Finanzdaten, und ein doppelter Eintrag ist schwieriger nachzuvollziehen als ein fehlender.

```ts
ledger({ action: "summary", months: 1 })
```