# Werkzeuge · Verkauf und Pläne

> MCP-Tools für den Verkauf: Pläne, Produkte und Gutscheine auflisten, Abrechnungsoptionen und Pläne mit Zusatzprodukten als Entwurf anlegen, veröffentlichen und zurückziehen, Preise ändern, Gutscheine und Downsell-Angebote anlegen, bearbeiten und löschen, Produkte und Pläne löschen und die Pläne neu ordnen, mit Bestätigung bei allem, was Geld betrifft.

Was die Community verkauft: Pläne mit Abrechnungsoptionen und Zusatzprodukten, Einzelprodukte, Gutscheine. Alles entsteht als Entwurf und geht erst in den Verkauf, wenn du es sagst; einen Preis ändern, einen Gutschein oder ein Letzte-Chance-Angebot anlegen oder bearbeiten und Löschen brauchen dein Ja, mit einer Zusammenfassung der Beträge. Einen Plan ändern (`update_plan`) läuft beim ersten Aufruf.

## Entwurf vor der Genehmigung

Du kannst alles aufbauen, **bevor** die [Geschäftsinformationen](/pagamentos/informacao-comercial) genehmigt sind: Produkte, Optionen, Pläne, Zusatzprodukte, Gutscheine und Downsell-Angebote entstehen als Entwurf und lassen sich beliebig bearbeiten. Auf die Genehmigung wartet nur das **Veröffentlichen und Verkaufen**:

- `publish_product` wird in einer Community ohne Genehmigung mit der Meldung von Memberfy abgelehnt: *„Um zu veröffentlichen und zu verkaufen, braucht die Community genehmigte Geschäftsinformationen. Bis dahin kannst du alles als Entwurf anlegen und konfigurieren: Fülle sie unter Einstellungen › Geschäftsinformationen aus und reiche sie zur Prüfung ein.“*
- Bei den zusammengesetzten Tools (`create_course`, `create_event` und `create_plan` mit Veröffentlichen) **macht die Ablehnung nichts rückgängig**: Kurs, Event, Ticket, Plan und Optionen bleiben als Entwurf, die Antwort nennt den Grund in `publish_blocked`, und der vorgeschlagene nächste Schritt ist, die Geschäftsinformationen auszufüllen und danach mit `publish_product` zu veröffentlichen.
- Der Preis eines Entwurfs steht in der Währung des Landes aus den Geschäftsinformationen (in jedem Status) oder, ohne sie, in Real. Ist die genehmigte Währung eine andere, wird das Veröffentlichen abgelehnt (*„Dieses Produkt ist in …, die genehmigten Geschäftsinformationen verwenden aber …“*): Passe vorher Währung und Preis an.

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 |
|---|---|---|---|
| [`list_plans`](#list-plans) | Pläne, Optionen und Zusatzprodukte | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_products`](#list-products) | Abrechnungsoptionen und Produkte, mit Preis und Status | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_coupons`](#list-coupons) | Gutscheine mit Status und Nutzung | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_product`](#create-product) | Legt ein Produkt oder eine Abrechnungsoption als Entwurf an | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_plan`](#create-plan) | Optionen, Plan und Zusatzprodukte auf einmal | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`publish_product`](#publish-product) | Stellt ein Produkt in den Verkauf | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`unpublish_product`](#unpublish-product) | Nimmt ein Produkt aus dem Verkauf | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_price`](#update-price) | Ändert einen Preis, mit Bestätigung | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`create_coupon`](#create-coupon) | Legt einen Gutschein an, mit Bestätigung | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`update_plan`](#update-plan) | Ändert Name, Adresse, Optionen und Zusatzprodukte eines Plans | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_product`](#update-product) | Ändert Titel, Bereiche, Bestand, Raten, Testphase und Direktlink | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_coupon_status`](#update-coupon-status) | Pausiert einen Gutschein oder aktiviert ihn wieder | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`update_coupon`](#update-coupon) | Ändert Name, Rabatt, Dauer, Limits, Gültigkeit und Produkte eines Gutscheins | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_coupon`](#delete-coupon) | Löscht einen Gutschein | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`get_coupon_usage`](#get-coupon-usage) | Wer einen Gutschein genutzt hat | Administrator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_downsell_offers`](#list-downsell-offers) | Die Last-Chance-Angebote eines Plans, mit Konversion | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_downsell_offer`](#create-downsell-offer) | Legt ein Last-Chance-Angebot an | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`update_downsell_offer`](#update-downsell-offer) | Ändert oder pausiert ein Last-Chance-Angebot | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_downsell_offer`](#delete-downsell-offer) | Löscht ein Last-Chance-Angebot | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_product`](#delete-product) | Löscht ein Produkt oder eine Abrechnungsoption | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_plan`](#delete-plan) | Löscht einen Plan | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`reorder_plans`](#reorder-plans) | Bringt die Pläne auf der Preisseite in eine neue Reihenfolge | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`get_storefront`](#get-storefront) | Was ein Shop-Bereich zeigt | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_storefront`](#update-storefront) | Wählt die Produkte eines Shops aus | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |

## `list_plans`

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

**Pläne auflisten.** Die Pläne der Community mit ihren Abrechnungsoptionen und Zusatzprodukten. *Mindestrolle: Administrator oder Finanzen.*

Parameter: keine.

**Liefert:** die Pläne (ID, Name, Adresse), die Optionen jedes Plans (ID, Titel, Preis, Intervall, Status) und die Zusatzprodukte.

**Frag so:** *„Welche Pläne haben wir, und was kostet jede Option?"*

## `list_products`

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

**Abrechnungsoptionen und Produkte auflisten.** Alle Produkte: Abo-Optionen, Einzelprodukte, Ratenprodukte und Zusatzprodukte. *Mindestrolle: Administrator oder Finanzen.*

Parameter: keine.

**Liefert:** jedes Produkt mit ID, Titel, Typ, Preis, Intervall, Status (Entwurf oder veröffentlicht) und den Bereichen, die es freischaltet. Die ID brauchen `create_plan` (in `add_on_ids`), `update_price`, `publish_product` und `create_coupon`.

**Frag so:** *„Welche Produkte sind noch Entwürfe?"*

## `list_coupons`

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

**Gutscheine auflisten.** Die Gutscheine mit Status und Nutzung. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `status` | `ACTIVE`, `INACTIVE`, `EXPIRED` | Nein | Nur ein Status |
| `search` | Text | Nein | Teil des Codes oder Namens |
| `page`, `limit` | Zahl | Nein | Seitenweise Abfrage |

**Liefert:** die Gutscheine mit Code, Typ, Wert, Dauer, Gültigkeit, Limit und Nutzungen.

**Frag so:** *„Welche Gutscheine sind aktiv, und wie oft wurde jeder genutzt?"*

## `create_product`

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

**Abrechnungsoption oder Produkt anlegen.** Legt ein Produkt **als Entwurf** an: eine Abo-Option, ein Einzelprodukt (Ticket, Kurs) oder ein Ratenprodukt. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `title` | Text, 3 bis 255 | Ja | |
| `type` | `SUBSCRIPTION`, `ONE_TIME`, `INSTALLMENT` | Ja | Abo-Option, Einzelprodukt oder Ratenprodukt |
| `price` | Zahl, in der Währung der Community | Ja | Beim Abo der Betrag pro Zyklus; bei Jährlich in Raten der Jahresbetrag |
| `interval` | `MONTHLY`, `YEARLY` | Nein | Nur bei `SUBSCRIPTION`: monatlich oder jährlich |
| `max_installments` | 1 bis 12 | Nein | Bis zu wie vielen Raten per Karte (Einzelprodukt oder jährlich) |
| `commitment_months` | 1 bis 36 | Nein | [Vertragslaufzeit](/monetizacao/duracao-do-contrato); nur monatlich |
| `trial_days` | 0 bis 365 | Nein | Kostenloser Testzeitraum |
| `description` | einfacher Text, bis 5.000 | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `space_ids` | Liste von IDs | Nein | Die Bereiche, die der Kauf freischaltet |
| `stock` | Zahl | Nein | Verkaufsmenge (Tickets). Leer: unbegrenzt |
| `direct_link` | ja oder nein | Nein | Ein Einzelprodukt, das per Direktlink verkauft wird, außerhalb des Shops |

**Liefert:** das angelegte Produkt als Entwurf, mit ID.

**Frag so:** *„Lege das Produkt Einzel-Mentoring an, R$ 450, in bis zu 3 Raten, das den Bereich Mentorings freischaltet. Lass es als Entwurf."*

**Hinweise:** Nichts wird verkauft, bevor `publish_product` läuft, und das Anlegen hängt nicht von genehmigten Geschäftsinformationen ab (siehe [Entwurf vor der Genehmigung](#entwurf-vor-der-genehmigung)). Für einen Plan mit mehreren Optionen macht `create_plan` alles auf einmal. Die Regeln jedes Felds sind die des Dashboards: siehe [Produkte](/monetizacao/produtos) und [Abrechnungsoptionen](/monetizacao/opcoes-de-cobranca).

## `create_plan`

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

**Plan mit Optionen und Zusatzprodukten anlegen.** Abrechnungsoptionen → Plan mit den Optionen → verknüpfte Zusatzprodukte. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name` | Text, bis 120 | Ja | Der Name des Plans |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `slug` | Text, bis 60 | Nein | Die Adresse des Plans, für den Link `/pricing/<adresse>` |
| `options` | Liste, 1 bis 6 | Ja | Die Abrechnungsoptionen (siehe unten) |
| `add_on_ids` | Liste von IDs | Nein | Bestehende monatliche Produkte, die keine Planoption sind, aus `list_products` |
| `publish` | ja oder nein | Nein | Veröffentlicht alle Optionen. Standard: Entwurf |
| `idempotency_key` | Text, bis 100 | Nein | |

Jede **Option**:

| Feld | Typ | Beschreibung |
|---|---|---|
| `title` | Text, 3 bis 255 | Pflicht. Z. B. *Mentoring · Monatlich* |
| `price` | Zahl, in der Währung der Community | Pflicht. Bei jährlich der Jahresbetrag |
| `interval` | `MONTHLY`, `YEARLY` | Standard: `MONTHLY` |
| `max_installments` | 1 bis 12 | Bei jährlich: bis zu wie vielen Raten per Karte |
| `commitment_months` | 1 bis 36 | Mindestvertrag, bei monatlich |
| `trial_days` | 0 bis 365 | Kostenloser Testzeitraum |
| `description` | einfacher Text | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `space_ids` | Liste von IDs | Die Bereiche, die die Option freischaltet |

**Liefert:** den Plan (ID, Name, Adresse), die Optionen (ID, Titel, Preis, Intervall, Status) und die verknüpften Zusatzprodukte.

**Frag so:** *„Lege den Plan Mentoring an, mit monatlich R$ 390 und 6 Monaten Vertrag und jährlich R$ 3.900 in bis zu 12 Raten, beide schalten den Bereich Mentoring frei, und verknüpfe die Einzelsitzung als Zusatzprodukt."*

**Hinweise:** Schlägt ein Schritt fehl, wird der Plan zuletzt rückgängig gemacht, weil Memberfy keinen Plan löscht, der noch Optionen hat. Siehe [Pläne](/monetizacao/planos), [Zusatzprodukte](/monetizacao/adicionais) und [Jährlich in Raten](/monetizacao/anual-parcelado).

## `publish_product`

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

**Produkt veröffentlichen (in den Verkauf).** Stellt ein Produkt im Entwurf in den Verkauf. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `product_id` | ID | Ja | Aus `list_products` oder einer Erstellung |

**Liefert:** das Produkt, veröffentlicht.

**Frag so:** *„Du kannst das Produkt Excel von Null veröffentlichen."*

**Hinweise:** Veröffentlichen setzt genehmigte [Geschäftsinformationen](/pagamentos/informacao-comercial) voraus, und das Produkt in der Währung des genehmigten Landes. Fehlt das, lehnt Memberfy ab, und das Produkt bleibt ein bearbeitbarer Entwurf. Siehe [Entwurf vor der Genehmigung](#entwurf-vor-der-genehmigung).

## `unpublish_product`

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

**Produkt aus dem Verkauf nehmen.** Nimmt ein Produkt aus dem Verkauf. Wer schon gekauft hat, behält den Zugriff. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `product_id` | ID | Ja | |

**Liefert:** das Produkt, nicht mehr im Verkauf.

**Frag so:** *„Nimm das Ticket für das Oktober-Treffen aus dem Verkauf."*

## `update_price`

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

**Preis eines Produkts ändern.** Ändert den Preis eines Produkts oder einer Abrechnungsoption. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `product_id` | ID | Ja | Aus `list_products` |
| `new_price` | Zahl, in Reais | Ja | |

**Die Zusammenfassung:** das Produkt, der aktuelle Preis, der neue Preis und der Status (Entwurf oder veröffentlicht).

**Frag so:** *„Erhöhe Growth Monatlich von R$ 129 auf R$ 149."*

**Hinweise:** Bestehende Abonnements folgen den Regeln von Memberfy für Preisänderungen, denselben wie beim Bearbeiten im Dashboard. Siehe [Abrechnungsoptionen](/monetizacao/opcoes-de-cobranca#eine-option-andern-die-schon-abonnenten-hat).

## `create_coupon`

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

**Gutschein anlegen.** Legt einen Rabattgutschein an, prozentual oder als fester Betrag, für alle Produkte oder nur für einige. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `code` | Text, 2 bis 50 | Ja | Z. B. `PRO20`. Wird in Großbuchstaben gespeichert |
| `name` | Text, bis 120 | Ja | Der interne Name |
| `type` | `PERCENTAGE`, `FIXED` | Ja | Prozentual oder fester Betrag |
| `value` | Zahl | Ja | 20 = 20 %, oder der Betrag in Reais |
| `duration` | `ONCE`, `FOREVER`, `REPEATING` | Nein | Bei Abos: nur die 1. Abbuchung (Standard), immer, oder einige Monate |
| `months` | 1 bis 36 | Nein | Mit `REPEATING` |
| `max_uses` | Zahl | Nein | Leer: unbegrenzt |
| `start_date` | Datum ISO 8601 | Nein | Standard: jetzt |
| `end_date` | Datum ISO 8601 | Nein | Leer: ohne Ende |
| `product_ids` | Liste von IDs | Nein | Nur diese Produkte. Leer: alle |

**Die Zusammenfassung:** Aktion, Code, Rabatt (*20%* oder *R$ 50,00*), Dauer, Nutzungslimit, Gültigkeit und Produkte.

**Frag so:** *„Lege den Gutschein BLACK30 an, 30 % nur auf die erste Abbuchung, für die Growth-Pläne, bis zu 100 Nutzungen, gültig bis 30.11."*

Siehe [Gutscheine](/monetizacao/cupons).

## `update_plan`

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

**Plan bearbeiten.** Ändert Name, Beschreibung, Adresse, ob er aktiv ist, die Abrechnungsoptionen und die Zusatzprodukte eines Plans. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link (`/pricing/…`) | Ja | |
| `name`, `description`, `slug` | Text | Nein | |
| `active` | ja oder nein | Nein | |
| `option_ids` | Liste von IDs | Nein | Die **vollständige** Liste der Optionen des Plans |
| `add_on_ids` | Liste von IDs | Nein | Die **vollständige** Liste der Zusatzprodukte |

**Frag so:** *„Nimm die Jahresoption aus dem Plan Growth und lass nur die monatliche.“*

**Hinweise:** Ändert sofort, was verkauft wird, ohne Bestätigung. Den Preis änderst du mit `update_price`, das nach deinem Ja fragt.

## `update_product`

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

**Produkt bearbeiten.** Ändert Titel, Beschreibungen, freigeschaltete Bereiche, Bestand, Raten, Testphase oder Direktlink. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `product` | ID oder Slug | Ja | |
| `title`, `description`, `short_description` | Text | Nein | |
| `space_ids` | Liste von IDs | Nein | Die Bereiche, die der Kauf freischaltet |
| `stock` | Zahl | Nein | |
| `max_installments` | Zahl | Nein | |
| `trial_days` | Zahl | Nein | |
| `direct_link` | ja oder nein | Nein | |

**Frag so:** *„Erhöhe den Ticketbestand auf 120.“*

**Hinweise:** Den Preis änderst du mit `update_price`, das eine Bestätigung braucht.

## `update_coupon_status`

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

**Gutschein pausieren oder reaktivieren.** Pausiert einen Gutschein oder aktiviert ihn wieder. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `coupon` | ID oder Code | Ja | |
| `status` | `ACTIVE`, `INACTIVE` | Ja | Reaktivieren oder pausieren |

**Frag so:** *„Pausiere den Gutschein BLACK30.“*

## `update_coupon`

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

**Gutschein bearbeiten.** Ändert einen bestehenden Gutschein. Nur, was gesendet wird, ändert sich; pausieren geht mit `update_coupon_status`. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `coupon` | ID oder Code | Ja | |
| `name`, `description` | Text | Nein | |
| `value` | Zahl | Nein | Prozentsatz (20 = 20 %) oder Betrag, je nach Typ des Gutscheins |
| `duration` | `ONCE`, `FOREVER`, `REPEATING` | Nein | Einmal, für immer oder für einige Monate |
| `months` | 1 bis 36 | Nein | Mit `REPEATING` |
| `max_uses`, `max_uses_per_person` | Zahl | Nein | Nutzungslimits |
| `start_date`, `end_date` | Datum | Nein | Die Gültigkeit |
| `product_ids` | Liste von IDs | Nein | Die Produkte, für die der Gutschein gilt |

**Liefert:** beim ersten Aufruf den Code und was sich ändert, sowie den Bestätigungscode.

**Frag so:** *„Erhöhe BLACK30 auf 40 % und verlängere ihn bis Sonntag.“*

Siehe [Gutscheine](/monetizacao/cupons).

## `delete_coupon`

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

**Gutschein löschen.** Bereits gewährte Rabatte gelten weiter. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `coupon` | ID oder Code | Ja | |

**Liefert:** beim ersten Aufruf den Code und wie oft er genutzt wurde, sowie den Bestätigungscode.

## `get_coupon_usage`

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

**Nutzung eines Gutscheins ansehen.** Wer ihn genutzt hat, wann und mit wie viel Rabatt. *Mindestrolle: Administrator oder Finanzen.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `coupon` | ID oder Code | Ja | |
| `page` | Zahl | Nein | |

**Frag so:** *„Wer hat den Gutschein BLACK30 genutzt?“*

## `list_downsell_offers`

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

**Downsell-Angebote eines Plans.** Die Rabattangebote auf Zusatzprodukte nach dem Kauf eines Plans, mit wie oft sie gezeigt und angenommen wurden. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link | Ja | |

**Frag so:** *„Wie gut konvertiert das Last-Chance-Angebot für die Coworking-Erweiterung?“*

## `create_downsell_offer`

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

**Downsell-Angebot anlegen.** Legt ein Rabattangebot auf ein Zusatzprodukt an, das nach der Zahlung des Plans angezeigt wird. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link | Ja | |
| `add_on_id` | ID | Ja | Das Zusatzprodukt des Plans |
| `discount_percent` | Zahl | Nein | |
| `timing` | `IMMEDIATE`, `DELAYED` | Nein | Sofort (Standard) oder nach einer Weile |
| `delay_minutes` | Zahl | Nein | Mit `DELAYED` |
| `price_duration` | `FOREVER`, `FIRST_CHARGE`, `CYCLES` | Nein | Rabatt für immer, nur bei der ersten Abbuchung oder für einige Zyklen |
| `cycles` | Zahl | Nein | Mit `CYCLES` |
| `ttl_minutes` | Zahl | Nein | Wie lange das Angebot gilt |

**Frag so:** *„Biete 30 % auf die Coworking-Erweiterung für alle, die Growth ohne sie abonnieren, für die ersten 3 Abbuchungen.“*

Siehe [Downsell](/monetizacao/downsell).

## `update_downsell_offer`

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

**Downsell-Angebot bearbeiten.** Ändert ein Last-Chance-Angebot eines Plans oder pausiert es. Nur, was gesendet wird, ändert sich. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link | Ja | |
| `offer_id` | ID | Ja | Aus `list_downsell_offers` |
| `discount_percent`, `timing`, `delay_minutes`, `price_duration`, `cycles`, `ttl_minutes` | | Nein | Dieselben wie bei `create_downsell_offer` |
| `active` | ja oder nein | Nein | Mit nein wird das Angebot pausiert |

**Frag so:** *„Pausiere das Angebot für die Coworking-Erweiterung bis Monatsende.“*

## `delete_downsell_offer`

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

**Downsell-Angebot löschen.** *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link | Ja | |
| `offer_id` | ID | Ja | Aus `list_downsell_offers` |

## `delete_product`

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

**Produkt löschen.** Löscht ein Produkt oder eine Abrechnungsoption. Wer gekauft hat, behält den Zugriff. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `product` | ID oder Slug | Ja | Aus `list_products` |

**Liefert:** beim ersten Aufruf Titel, Preis und Status sowie den Bestätigungscode.

**Hinweise:** Um nur den Verkauf zu stoppen, nimm lieber `unpublish_product`. Siehe [Produkte](/monetizacao/produtos).

## `delete_plan`

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

**Plan löschen.** Bestehende Abonnements werden nicht gekündigt. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan` | ID oder Link (`/pricing/…`) | Ja | |

**Liefert:** beim ersten Aufruf den Namen des Plans und seine Optionen sowie den Bestätigungscode.

## `reorder_plans`

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

**Pläne neu ordnen.** Bringt die Pläne auf der Preisseite in eine neue Reihenfolge, vom ersten bis zum letzten. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `plan_ids` | Liste von IDs | Ja | Aus `list_plans`, in der neuen Reihenfolge |

**Frag so:** *„Setz auf der Preisseite Growth vor Starter.“*

## `get_storefront`

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

**Shop ansehen.** Was ein Shop-Bereich zeigt: alle Produkte oder nur die ausgewählten. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` | ID oder Link | Ja | Der Shop-Bereich |

## `update_storefront`

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

**Produkte des Shops auswählen.** Legt fest, was ein Shop-Bereich verkauft. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` | ID oder Link | Ja | |
| `mode` | `all`, `selected` | Ja | Alle veröffentlichten Produkte, oder nur die ausgewählten |
| `product_ids` | Liste von IDs | Nein | Mit `selected`, aus `list_products` |

**Frag so:** *„Lass im Shop nur die einzelnen Kurse.“*

Siehe [Shop](/espacos/loja).

## Verwandte Artikel

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