# Werkzeuge · Finanzen

> MCP-Tools für das Geld der Community: Verkaufsübersicht, Kunden, Kontoauszug, Guthaben, Auszahlungen und die Gebührensimulation, und Auszahlungen anfordern oder stornieren, mit Bestätigung.

Die Kasse der Community: wie viel verkauft wurde, wer zahlt, der Kontoauszug, das verfügbare Guthaben, die Auszahlungen und was von einem Verkauf übrig bleibt. Eine Auszahlung anfordern oder stornieren braucht dein Ja, mit einer Zusammenfassung. Bei Beträgen erscheint nur die Plattformgebühr.

Jedes Tool hat ein Siegel: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`get_sales_summary`](#get-sales-summary) | Umsatz, Monatsreihe, Umsatz pro Produkt und Abonnenten | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_customers`](#list-customers) | Wer zahlt und wie viel schon gezahlt wurde | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_ledger_entries`](#list-ledger-entries) | Buchungen im Kontoauszug | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_balance`](#get-balance) | Gesamtguthaben, verfügbar, einbehalten und ausstehend | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_payouts`](#list-payouts) | Auszahlungen und Status | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`simulate_fee`](#simulate-fee) | Wie viel die Community von einem Verkauf erhält | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`request_payout`](#request-payout) | Fordert eine Auszahlung an, mit Bestätigung | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`cancel_payout`](#cancel-payout) | Storniert eine ausstehende Auszahlung, mit Bestätigung | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |

## `get_sales_summary`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Verkaufsübersicht.** Umsatz und Abonnenten eines Zeitraums. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `period` | `7d`, `30d`, `90d`, `1y`, `custom` | Nein | Der Zeitraum |
| `start_date` | Datum ISO 8601 | Nein | Mit `period: custom` |
| `end_date` | Datum ISO 8601 | Nein | Mit `period: custom` |

**Liefert:** den Umsatz im Zeitraum, die Reihe Monat für Monat, den Umsatz pro Produkt und die aktiven, überfälligen und gekündigten Abonnenten. Bei Beträgen erscheint nur die Plattformgebühr.

**Frag so:** *„Mach ein Diagramm des Umsatzes der letzten 12 Monate."* · *„Welches Produkt hat im Quartal am meisten verkauft?"*

## `list_customers`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Wer zahlt und wie viel schon.** Die zahlenden Kunden und die Gesamtsumme pro Kunde. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `page`, `limit` | Zahl | Nein | Seitenweise Abfrage |

**Liefert:** die Kunden mit Name, E-Mail und gezahlter Gesamtsumme.

**Frag so:** *„Wer sind die 10 Kunden, die am meisten gezahlt haben?"*

## `list_ledger_entries`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Kontoauszug.** Die Buchungen im Kontoauszug, neueste zuerst. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `entry_type` | Text | Nein | Eine Buchungsart: `SALE_GROSS`, `SALE_NET`, `PLATFORM_FEE`, `INSTALLMENT_INTEREST`, `REFUND`, `CHARGEBACK`, `PAYOUT_REQUESTED` … |
| `page`, `limit` | Zahl | Nein | Seitenweise Abfrage |

**Liefert:** die Buchungen mit Datum, Art, Beschreibung und Betrag. Siehe [Guthaben und Kontoauszug](/pagamentos/saldo-e-extrato).

**Frag so:** *„Welche Erstattungen gab es diesen Monat?"*

## `get_balance`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Guthaben.** Das Guthaben der Community. *Mindestrolle: Administrator oder Finanzen.*

Parameter: keine.

**Liefert:** das Gesamtguthaben, das zur Auszahlung verfügbare, das einbehaltene und das noch freizugebende.

**Frag so:** *„Wie viel kann ich heute auszahlen?"*

## `list_payouts`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Auszahlungen.** Die angeforderten Auszahlungen mit Status. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `status` | `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `CANCELED` | Nein | Nur ein Status |
| `page`, `limit` | Zahl | Nein | Seitenweise Abfrage |

**Liefert:** die Auszahlungen mit ID (die `cancel_payout` braucht), Betrag, Gebühr, Status und Datum.

**Frag so:** *„Ist eine Auszahlung fehlgeschlagen?"*

## `simulate_fee`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Wie viel ich von einem Verkauf erhalte.** Simuliert einen Verkauf: Betrag, Plattformgebühr und was die Community erhält. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `amount` | Zahl | Ja | Der Verkaufsbetrag in Reais |
| `payment_method` | `PIX`, `CREDIT_CARD`, `BOLETO` | Nein | Die Zahlungsmethode |
| `installments` | Zahl | Nein | Anzahl der Raten per Karte |

**Liefert:** den Betrag, die Plattformgebühr (die nicht von der Zahlungsmethode abhängt) und den Nettobetrag. Siehe [Plattformgebühr](/pagamentos/taxa-da-plataforma).

**Frag so:** *„Wenn ich einen Kurs für R$ 297 verkaufe, wie viel bleibt der Community?"*

## `request_payout`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Auszahlung anfordern.** Fordert eine Auszahlung vom verfügbaren Guthaben auf das hinterlegte Bankkonto an. *Mindestrolle: Administrator; Finanzen liest nur.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `amount` | Zahl, in Reais | Ja | Bis zum verfügbaren Betrag (siehe `get_balance`) |

**Die Zusammenfassung:** Aktion, Betrag und aktuelles Guthaben.

**Frag so:** *„Wie viel habe ich verfügbar? Zahl R$ 2.000 aus."*

**Hinweise:** Die Gebühr von R$ 3,67 pro Auszahlung und die Regeln sind die des Dashboards. Siehe [Auszahlung](/pagamentos/saque).

## `cancel_payout`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Auszahlung stornieren.** Storniert eine Auszahlung, die noch aussteht. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `payout_id` | ID | Ja | Aus `list_payouts` |

**Die Zusammenfassung:** Aktion, Betrag, Status und Datum der Anforderung.

**Frag so:** *„Storniere die Auszahlung über R$ 2.000, die ich heute angefordert habe."*

## Was es nicht gibt

Es gibt kein Tool für **Erstattungen**: Das läuft weiter über das Dashboard. Siehe [Häufige Probleme](/mcp/problemas-comuns#was-noch-nicht-geht).

## Verwandte Artikel

- [Werkzeuge](/mcp/ferramentas)
- [Rezepte](/mcp/receitas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)