# Werkzeuge · Credits

> MCP-Tools für Buchungs-Credits: Stand, Kontoauszug, Credits vergeben, korrigieren und abziehen, und die Regeln der Community (Ansparen, Stornofrist, späte Stornierung und Nichterscheinen). Mindestrolle und Rezepte.

Die [Credits](/monetizacao/creditos) über den Assistenten: den Stand und den Kontoauszug sehen (das eigene oder, für das Team, das jedes Mitglieds), Credits vergeben und korrigieren, sie abziehen und die Regeln der Community lesen oder ändern. Die Credits der Pläne und Produkte legst du mit [`create_plan` und `update_plan`](/mcp/ferramentas-vendas) (`monthly_credits`) und [`create_product` und `update_product`](/mcp/ferramentas-vendas) (`granted_credits` und `granted_credits_validity_days`) fest; in einer Community ohne Bereich für Buchungen oder Terminbuchung erklärt der Assistent, dass zuerst einer angelegt werden muss.

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_credit_balance`](#get-credit-balance) | Der Stand, was in 7 Tagen verfällt, und die Posten | Alle (eigenes); Team (anderer) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_credit_entries`](#list-credit-entries) | Der Kontoauszug, vom neuesten zum ältesten | Alle (eigener); Team (anderer) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`grant_credits`](#grant-credits) | Legt einen neuen Posten mit Credits an, mit Grund | Finanzen | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`adjust_credits`](#adjust-credits) | Fügt Credits als Korrektur hinzu, mit Grund | Finanzen | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`revoke_credits`](#revoke-credits) | Zieht Credits ab (negative Korrektur) | Finanzen | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`get_credit_settings`](#get-credit-settings) | Die Credit-Regeln der Community | Moderator (oder Finanzen) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_credit_settings`](#update-credit-settings) | Ändert die Regeln | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |

„Finanzen“ bedeutet hier **Eigentümer, Administrator oder Finanzen**; der **Moderator liest nur**. „Team“ sind Eigentümer, Administrator, Moderator und Finanzen. Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person in der Oberfläche tun würde. Die Plattformvariable, die entscheidet, ob ein pausiertes oder säumiges Abonnement die Credits weiter nutzt, gehört dem SuperAdmin und hat kein Tool.

## `get_credit_balance`

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

**Der Stand.** Der nutzbare Stand (die Summe der nicht verfallenen Posten; er kann negativ sein, was das Buchen blockiert), was in den nächsten 7 Tagen verfällt, und die Posten, jeder mit der Herkunft (**Tarif**, **Produkt** oder **Team**), dem Rest und dem Verfallsdatum. *Mindestrolle: alle (eigenes); das Team liest das jedes Mitglieds.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `profile_id` | ID | Nein | Nur das Team: von wem. Ohne ihn ist es deins (ein Mitglied, das nach dem einer anderen Person fragt, wird abgewiesen) |

**Frag so:** *„Wie viele Credits habe ich?“* · *„Wie ist der Stand von Maria Souza?“*

## `list_credit_entries`

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

**Der Kontoauszug.** Jeder Eintrag mit der Art (Vergabe, Nutzung für eine Buchung, Erstattung, Korrektur, Verfall, Widerruf), dem Betrag mit Vorzeichen, der Herkunft, der dahinterstehenden Buchung, dem Produkt oder dem Abonnement und dem Grund. Das Buch wächst nur: Nichts wird bearbeitet oder gelöscht. Seitenweise.

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `profile_id` | ID | Nein | Nur das Team: von wem. Ohne ihn ist es deiner |
| `kind` | `GRANT`, `DEBIT`, `REFUND`, `ADJUSTMENT`, `EXPIRATION` oder `REVOCATION` | Nein | Filtert nach Art |
| `page`, `limit` | Zahl | Nein | Seiten (`limit` bis 200) |

**Frag so:** *„Zeig mir den Credit-Kontoauszug von Maria für diesen Monat.“*

## `grant_credits`

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

**Credits vergeben.** Legt einen **neuen Posten** mit **Pflichtgrund** und optionaler Gültigkeit an (ohne sie verfallen sie nicht). Vor dem Handeln zeigt es eine Zusammenfassung und wiederholt den Aufruf erst nach deinem Ja. Liefert den neuen Stand und den Eintrag. *Mindestrolle: Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `profile_id` | ID | Ja | Das Mitglied (`list_members`) |
| `amount` | ganze Zahl, von 1 bis 100.000 | Ja | Wie viele Credits |
| `reason` | Text (bis 255) | Ja | Der Grund: bleibt im Kontoauszug |
| `expires_at` | Datum und Uhrzeit in der Zukunft | Nein | Wann sie verfallen; ohne oder mit `null` nie |

**Frag so:** *„Gib João 10 Kulanz-Credits, gültig bis Monatsende, weil er ein neues Mitglied empfohlen hat.“*

## `adjust_credits`

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

**Nach oben korrigieren.** Fügt Credits als **Korrektur** hinzu (ein Korrektureintrag: So behebst du einen Fehler, da das Buch nie bearbeitet wird). Dieselben Parameter wie `grant_credits` (bis 100.000 auf einmal), und es verlangt ebenfalls eine Bestätigung. Um Credits abzuziehen, nutze [`revoke_credits`](#revoke-credits), das eine Bestätigung verlangt. *Mindestrolle: Finanzen.*

## `revoke_credits`

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

**Credits abziehen.** Eine negative Korrektur, mit Pflichtgrund. Verbraucht **zuerst die Posten, die früher verfallen**, und **geht nicht über den nutzbaren Stand hinaus** (sonst `409`: lies vorher den Stand). Vor dem Handeln zeigt es eine Zusammenfassung (wie viel, der Stand jetzt, der Stand danach und der Grund) und wiederholt den Aufruf mit dem `confirmation_token` erst nach einem ausdrücklichen Ja. *Mindestrolle: Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `profile_id` | ID | Ja | Das Mitglied |
| `amount` | ganze Zahl, 1 oder mehr | Ja | Wie viele Credits abgezogen werden |
| `reason` | Text | Ja | Der Grund |

## `get_credit_settings`

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

**Die Regeln.** Ansparen (ein, Obergrenze, Monate), Anteil im ersten Monat, Stornofrist in Stunden, ob späte Stornierung und Nichterscheinen die Credits kosten, und die Tage der Verfallswarnung. *Mindestrolle: Moderator (oder Finanzen).*

## `update_credit_settings`

<span class="tool-kind tool-kind-write">Ändert</span>

**Die Regeln ändern.** Ändert nur, was du schickst. Gilt ab dem nächsten Monatswechsel und ändert nie einen bestehenden Posten. *Mindestrolle: Administrator.*

| Parameter | Typ | Beschreibung |
|---|---|---|
| `rollover_enabled` | wahr oder falsch | Credits des Plans in den nächsten Monat übertragen (Voreinstellung: nein) |
| `rollover_cap` | ganze Zahl oder `null` | Die Obergrenze der Übertragung; `null`: keine Obergrenze |
| `rollover_max_cycles` | 1 bis 12 | Wie viele Monate das Angesparte gilt |
| `prorate_first_month` | wahr oder falsch | Anteil für die verbleibenden Tage im ersten Monat |
| `change_window_hours` | 0 bis 720 | Frist zum Stornieren oder Ändern ohne Verlust (Voreinstellung: 24) |
| `late_cancel_loses_credits` | wahr oder falsch | Späte Stornierung kostet die Credits (Voreinstellung: ja) |
| `no_show_loses_credits` | wahr oder falsch | Nichterscheinen kostet die Credits (Voreinstellung: ja) |
| `expiry_notice_days` | 0 bis 30 | Tage der Warnung vor dem Verfall (0 = keine Warnung) |

**Frag so:** *„Schalte das Ansparen von Credits ein, mit einer Obergrenze von 20, für 2 Monate, und setze die Stornofrist auf 12 Stunden.“*

## Verwandte Artikel

- [Credits](/monetizacao/creditos)
- [Werkzeuge · Buchungen und Terminbuchung](/mcp/ferramentas-reservas)
- [Werkzeuge](/mcp/ferramentas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)
- [Rezepte](/mcp/receitas)