# Strumenti · Vendite e piani

> Strumenti MCP per vendere: elencare piani, prodotti e coupon, creare opzioni di fatturazione e piani con componenti aggiuntivi in bozza, pubblicare e ritirare dalla vendita, cambiare prezzi, creare, modificare ed eliminare coupon e offerte di downsell, eliminare prodotti e piani e riordinare i piani, con conferma per ciò che tocca il denaro.

Ciò che la community vende: piani con le opzioni di fatturazione e i componenti aggiuntivi, prodotti singoli, coupon. Tutto nasce in bozza e va in vendita solo quando lo chiedi; cambiare un prezzo, creare o modificare un coupon, creare o modificare un'offerta di ultima occasione ed eliminare chiedono il tuo sì, con un riepilogo dei valori. Cambiare un piano (`update_plan`) viene eseguito alla prima chiamata.

## Bozza prima dell'approvazione

Puoi preparare tutto **prima** che le [informazioni aziendali](/pagamentos/informacao-comercial) siano approvate: prodotti, opzioni, piani, componenti aggiuntivi, coupon e offerte di downsell nascono in bozza e si possono modificare liberamente. Ciò che aspetta l'approvazione è **pubblicare e vendere**:

- `publish_product` in una community senza approvazione viene rifiutato con il messaggio di Memberfy: *"Per pubblicare e iniziare a vendere, la community deve avere le informazioni aziendali approvate. Nel frattempo puoi creare e configurare tutto come bozza: compilale in Impostazioni › Informazioni Aziendali e inviale per la revisione."*
- Negli strumenti composti (`create_course`, `create_event` e `create_plan` con pubblicazione), il rifiuto **non annulla nulla**: il corso, l'evento, il biglietto, il piano e le opzioni restano in bozza, la risposta riporta il motivo in `publish_blocked`, e il passo successivo suggerito è compilare le informazioni aziendali e poi pubblicare con `publish_product`.
- Il prezzo di una bozza è nella valuta del paese delle informazioni aziendali (in qualsiasi stato) oppure, se non ci sono, in reais. Se la valuta approvata è un'altra, la pubblicazione viene rifiutata (*"Questo prodotto è in …, ma la valuta delle informazioni aziendali approvate è …"*): sistema prima valuta e prezzo.

Ogni strumento ha un'etichetta: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## In sintesi

| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
| [`list_plans`](#list-plans) | Piani, opzioni e componenti aggiuntivi | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_products`](#list-products) | Opzioni di fatturazione e prodotti, con prezzo e stato | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_coupons`](#list-coupons) | Coupon con stato e utilizzi | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_product`](#create-product) | Crea un prodotto o un'opzione di fatturazione, in bozza | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`create_plan`](#create-plan) | Opzioni, piano e componenti aggiuntivi, in una volta | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`publish_product`](#publish-product) | Mette in vendita un prodotto | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`unpublish_product`](#unpublish-product) | Ritira un prodotto dalla vendita | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_price`](#update-price) | Cambia un prezzo, con conferma | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`create_coupon`](#create-coupon) | Crea un coupon, con conferma | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`update_plan`](#update-plan) | Cambia nome, indirizzo, opzioni e componenti aggiuntivi di un piano | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_product`](#update-product) | Cambia titolo, spazi, giacenza, rate, prova e link diretto | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_coupon_status`](#update-coupon-status) | Mette in pausa o riattiva un coupon | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`update_coupon`](#update-coupon) | Cambia nome, sconto, durata, limiti, validità e prodotti di un coupon | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`delete_coupon`](#delete-coupon) | Elimina un coupon | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`get_coupon_usage`](#get-coupon-usage) | Chi ha usato un coupon | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_downsell_offers`](#list-downsell-offers) | Le offerte dell'ultima occasione di un piano, con la conversione | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_downsell_offer`](#create-downsell-offer) | Crea un'offerta dell'ultima occasione | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`update_downsell_offer`](#update-downsell-offer) | Cambia o mette in pausa un'offerta dell'ultima occasione | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`delete_downsell_offer`](#delete-downsell-offer) | Elimina un'offerta dell'ultima occasione | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`delete_product`](#delete-product) | Elimina un prodotto o un'opzione di fatturazione | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`delete_plan`](#delete-plan) | Elimina un piano | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`reorder_plans`](#reorder-plans) | Mette i piani in un nuovo ordine nella pagina dei prezzi | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_storefront`](#get-storefront) | Cosa mostra uno spazio Negozio | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_storefront`](#update-storefront) | Sceglie i prodotti di un Negozio | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |

## `list_plans`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare i piani.** I piani della community, con le opzioni di fatturazione e i componenti aggiuntivi di ciascuno. *Ruolo minimo: Admin o Finanza.*

Parametri: nessuno.

**Restituisce:** i piani (id, nome, indirizzo), le opzioni di ciascuno (id, titolo, prezzo, intervallo, stato) e i componenti aggiuntivi.

**Chiedi così:** *"Quali piani abbiamo, e quanto costa ogni opzione?"*

## `list_products`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare opzioni di fatturazione e prodotti.** Tutti i prodotti: opzioni di abbonamento, prodotti singoli, a rate e componenti aggiuntivi. *Ruolo minimo: Admin o Finanza.*

Parametri: nessuno.

**Restituisce:** ogni prodotto con id, titolo, tipo, prezzo, intervallo, stato (bozza o pubblicato) e gli spazi che sblocca. L'id è quello che chiedono `create_plan` (in `add_on_ids`), `update_price`, `publish_product` e `create_coupon`.

**Chiedi così:** *"Quali prodotti sono in bozza?"*

## `list_coupons`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elencare i coupon.** I coupon, con stato e utilizzi. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `status` | `ACTIVE`, `INACTIVE`, `EXPIRED` | No | Un solo stato |
| `search` | testo | No | Parte del codice o del nome |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** i coupon, con codice, tipo, valore, durata, validità, limite e utilizzi.

**Chiedi così:** *"Quali coupon sono attivi e quante volte è stato usato ciascuno?"*

## `create_product`

<span class="tool-kind tool-kind-write">Modifica</span>

**Creare un'opzione di fatturazione o un prodotto.** Crea un prodotto **in bozza**: un'opzione di abbonamento, un prodotto singolo (biglietto, corso) o a rate. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `title` | testo, da 3 a 255 | Sì | |
| `type` | `SUBSCRIPTION`, `ONE_TIME`, `INSTALLMENT` | Sì | Opzione di abbonamento, prodotto singolo o a rate |
| `price` | numero, nella valuta della community | Sì | Nell'abbonamento, l'importo di ogni ciclo; nell'annuale a rate, l'importo dell'anno |
| `interval` | `MONTHLY`, `YEARLY` | No | Solo in `SUBSCRIPTION`: mensile o annuale |
| `max_installments` | da 1 a 12 | No | In quante rate al massimo con carta (prodotto singolo, o annuale) |
| `commitment_months` | da 1 a 36 | No | [Durata del contratto](/monetizacao/duracao-do-contrato); solo nel mensile |
| `trial_days` | da 0 a 365 | No | Prova gratuita |
| `description` | testo semplice, fino a 5.000 | No | Senza formattazione: i segni di Markdown vengono tolti |
| `space_ids` | elenco di id | No | Gli spazi che l'acquisto sblocca |
| `stock` | numero | No | Quantità in vendita (biglietti). Vuoto: senza limite |
| `direct_link` | sì o no | No | Un prodotto singolo vendibile tramite link diretto, fuori dal Negozio |

**Restituisce:** il prodotto creato, in bozza, con l'id.

**Chiedi così:** *"Crea il prodotto Mentoring singolo, R$ 450, fino a 3 rate, che sblocca lo spazio Mentoring. Lascialo in bozza."*

**Note:** non si vende nulla finché non c'è `publish_product`, e la creazione non dipende dalle informazioni aziendali approvate (vedi [Bozza prima dell'approvazione](#bozza-prima-dell-approvazione)). Per un piano con più opzioni, `create_plan` fa tutto in una volta. Le regole di ogni campo sono quelle del pannello: vedi [Prodotti](/monetizacao/produtos) e [Opzioni di fatturazione](/monetizacao/opcoes-de-cobranca).

## `create_plan`

<span class="tool-kind tool-kind-write">Modifica</span>

**Creare un piano con opzioni e componenti aggiuntivi.** Opzioni di fatturazione → piano con le opzioni → componenti aggiuntivi collegati. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `name` | testo, fino a 120 | Sì | Il nome del piano |
| `description` | testo semplice | No | Senza formattazione: i segni di Markdown vengono tolti |
| `slug` | testo, fino a 60 | No | L'indirizzo del piano, per il link `/pricing/<indirizzo>` |
| `options` | elenco, da 1 a 6 | Sì | Le opzioni di fatturazione (vedi sotto) |
| `add_on_ids` | elenco di id | No | Prodotti mensili esistenti che non sono opzioni di un piano, da `list_products` |
| `publish` | sì o no | No | Pubblica tutte le opzioni. Predefinito: bozza |
| `idempotency_key` | testo, fino a 100 | No | |

Ogni **opzione**:

| Campo | Tipo | Descrizione |
|---|---|---|
| `title` | testo, da 3 a 255 | Obbligatorio. Es.: *Mentoring · Mensile* |
| `price` | numero, nella valuta della community | Obbligatorio. Nell'annuale, l'importo dell'anno |
| `interval` | `MONTHLY`, `YEARLY` | Predefinito: `MONTHLY` |
| `max_installments` | da 1 a 12 | Nell'annuale, in quante rate al massimo con carta |
| `commitment_months` | da 1 a 36 | Contratto minimo, nel mensile |
| `trial_days` | da 0 a 365 | Prova gratuita |
| `description` | testo semplice | Senza formattazione: i segni di Markdown vengono tolti |
| `space_ids` | elenco di id | Gli spazi che l'opzione sblocca |

**Restituisce:** il piano (id, nome, indirizzo), le opzioni (id, titolo, prezzo, intervallo, stato) e i componenti aggiuntivi collegati.

**Chiedi così:** *"Crea il piano Mentoring con mensile da R$ 390 con contratto di 6 mesi e annuale da R$ 3.900 fino a 12 rate, entrambi che sbloccano lo spazio Mentoring, e collega la Sessione individuale come componente aggiuntivo."*

**Note:** se un passaggio fallisce, il piano viene annullato per ultimo, perché Memberfy non elimina un piano che ha ancora opzioni. Vedi [Piani](/monetizacao/planos), [Componenti aggiuntivi](/monetizacao/adicionais) e [Annuale a rate](/monetizacao/anual-parcelado).

## `publish_product`

<span class="tool-kind tool-kind-write">Modifica</span>

**Pubblicare un prodotto (metterlo in vendita).** Mette in vendita un prodotto in bozza. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `product_id` | id | Sì | Da `list_products` o da una creazione |

**Restituisce:** il prodotto, pubblicato.

**Chiedi così:** *"Puoi pubblicare il prodotto Excel da Zero."*

**Note:** la pubblicazione richiede le [informazioni aziendali](/pagamentos/informacao-comercial) approvate, e il prodotto nella valuta del paese approvato. Senza, Memberfy rifiuta e il prodotto resta in bozza, modificabile. Vedi [Bozza prima dell'approvazione](#bozza-prima-dell-approvazione).

## `unpublish_product`

<span class="tool-kind tool-kind-write">Modifica</span>

**Ritirare un prodotto dalla vendita.** Ritira un prodotto dalla vendita. Chi ha già comprato mantiene l'accesso. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `product_id` | id | Sì | |

**Restituisce:** il prodotto, fuori vendita.

**Chiedi così:** *"Ritira dalla vendita il biglietto dell'incontro di ottobre."*

## `update_price`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Cambiare il prezzo di un prodotto.** Cambia il prezzo di un prodotto o di un'opzione di fatturazione. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `product_id` | id | Sì | Da `list_products` |
| `new_price` | numero, in reais | Sì | |

**Il riepilogo:** il prodotto, il prezzo attuale, il prezzo nuovo e lo stato (bozza o pubblicato).

**Chiedi così:** *"Aumenta il Growth Mensile da R$ 129 a R$ 149."*

**Note:** gli abbonamenti già esistenti seguono le regole di Memberfy per il cambio di prezzo, le stesse della modifica dal pannello. Vedi [Opzioni di fatturazione](/monetizacao/opcoes-de-cobranca#modificare-un-opzione-che-ha-gia-abbonati).

## `create_coupon`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Creare un coupon.** Crea un coupon di sconto, in percentuale o a importo fisso, per tutti i prodotti o solo per alcuni. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `code` | testo, da 2 a 50 | Sì | Es.: `PRO20`. Viene salvato in maiuscolo |
| `name` | testo, fino a 120 | Sì | Il nome interno |
| `type` | `PERCENTAGE`, `FIXED` | Sì | Percentuale o importo fisso |
| `value` | numero | Sì | 20 = 20%, oppure l'importo in reais |
| `duration` | `ONCE`, `FOREVER`, `REPEATING` | No | Negli abbonamenti: solo il 1° addebito (predefinito), sempre, o per alcuni mesi |
| `months` | da 1 a 36 | No | Con `REPEATING` |
| `max_uses` | numero | No | Vuoto: senza limite |
| `start_date` | data ISO 8601 | No | Predefinito: adesso |
| `end_date` | data ISO 8601 | No | Vuoto: senza fine |
| `product_ids` | elenco di id | No | Solo questi prodotti. Vuoto: tutti |

**Il riepilogo:** l'azione, il codice, lo sconto (*20%* o *R$ 50,00*), la durata, il limite di utilizzi, la validità e i prodotti.

**Chiedi così:** *"Crea il coupon BLACK30, 30% solo sul primo addebito, per i piani Growth, fino a 100 utilizzi, valido fino al 30/11."*

Vedi [Coupon](/monetizacao/cupons).

## `update_plan`

<span class="tool-kind tool-kind-write">Modifica</span>

**Modificare un piano.** Cambia nome, descrizione, indirizzo, se è attivo, le opzioni di fatturazione e i componenti aggiuntivi di un piano. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link (`/pricing/…`) | Sì | |
| `name`, `description`, `slug` | testo | No | |
| `active` | sì o no | No | |
| `option_ids` | elenco di id | No | L'elenco **intero** delle opzioni del piano |
| `add_on_ids` | elenco di id | No | L'elenco **intero** dei componenti aggiuntivi |

**Chiedi così:** *"Togli l'annuale dal piano Growth e lascia solo il mensile."*

**Note:** cambia subito ciò che si vende, senza conferma. Il prezzo si cambia con `update_price`, che chiede il tuo sì.

## `update_product`

<span class="tool-kind tool-kind-write">Modifica</span>

**Modificare un prodotto.** Cambia titolo, descrizioni, spazi che sblocca, giacenza, rate, prova gratuita o link diretto. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `product` | id o slug | Sì | |
| `title`, `description`, `short_description` | testo | No | |
| `space_ids` | elenco di id | No | Gli spazi che l'acquisto sblocca |
| `stock` | numero | No | |
| `max_installments` | numero | No | |
| `trial_days` | numero | No | |
| `direct_link` | sì o no | No | |

**Chiedi così:** *"Porta la giacenza del biglietto a 120."*

**Note:** il prezzo si cambia con `update_price`, che chiede conferma.

## `update_coupon_status`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Mettere in pausa o riattivare un coupon.** Mette in pausa o riattiva un coupon. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `coupon` | id o codice | Sì | |
| `status` | `ACTIVE`, `INACTIVE` | Sì | Riattivare o mettere in pausa |

**Chiedi così:** *"Metti in pausa il coupon BLACK30."*

## `update_coupon`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Modifica coupon.** Cambia un coupon esistente. Cambia solo ciò che viene inviato; per metterlo in pausa c'è `update_coupon_status`. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `coupon` | id o codice | Sì | |
| `name`, `description` | testo | No | |
| `value` | numero | No | Percentuale (20 = 20%) o importo, secondo il tipo di coupon |
| `duration` | `ONCE`, `FOREVER`, `REPEATING` | No | Una volta, per sempre o per alcuni mesi |
| `months` | da 1 a 36 | No | Con `REPEATING` |
| `max_uses`, `max_uses_per_person` | numero | No | Limiti di utilizzo |
| `start_date`, `end_date` | data | No | La validità |
| `product_ids` | elenco di id | No | I prodotti su cui vale il coupon |

**Restituisce:** alla prima chiamata, il codice del coupon e ciò che cambia, più il codice di conferma.

**Chiedi così:** *"Porta BLACK30 al 40% ed estendilo fino a domenica."*

Vedi [Coupon](/monetizacao/cupons).

## `delete_coupon`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina coupon.** Gli sconti già concessi restano validi. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `coupon` | id o codice | Sì | |

**Restituisce:** alla prima chiamata, il codice del coupon e quante volte è stato usato, più il codice di conferma.

## `get_coupon_usage`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Vedere l'uso di un coupon.** Chi l'ha usato, quando e quanto sconto. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `coupon` | id o codice | Sì | |
| `page` | numero | No | |

**Chiedi così:** *"Chi ha usato il coupon BLACK30?"*

## `list_downsell_offers`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Offerte di downsell di un piano.** Le offerte di sconto sui componenti aggiuntivi dopo l'acquisto di un piano, con quante volte sono state mostrate e convertite. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link | Sì | |

**Chiedi così:** *"Quanto converte l'offerta dell'ultima occasione dell'Estensione Coworking?"*

## `create_downsell_offer`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Creare un'offerta di downsell.** Crea un'offerta di sconto su un componente aggiuntivo, mostrata dopo il pagamento del piano. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link | Sì | |
| `add_on_id` | id | Sì | Il componente aggiuntivo del piano |
| `discount_percent` | numero | No | |
| `timing` | `IMMEDIATE`, `DELAYED` | No | Subito (predefinito) o dopo un certo tempo |
| `delay_minutes` | numero | No | Con `DELAYED` |
| `price_duration` | `FOREVER`, `FIRST_CHARGE`, `CYCLES` | No | Sconto per sempre, solo sul primo addebito o per alcuni cicli |
| `cycles` | numero | No | Con `CYCLES` |
| `ttl_minutes` | numero | No | Per quanto tempo vale l'offerta |

**Chiedi così:** *"Offri il 30% sull'Estensione Coworking a chi si abbona a Growth senza, per i primi 3 addebiti."*

Vedi [Downsell](/monetizacao/downsell).

## `update_downsell_offer`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Modifica offerta di downsell.** Cambia un'offerta dell'ultima occasione di un piano, o la mette in pausa. Cambia solo ciò che viene inviato. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link | Sì | |
| `offer_id` | id | Sì | Da `list_downsell_offers` |
| `discount_percent`, `timing`, `delay_minutes`, `price_duration`, `cycles`, `ttl_minutes` | | No | Gli stessi di `create_downsell_offer` |
| `active` | sì o no | No | Con no, mette in pausa l'offerta |

**Chiedi così:** *"Metti in pausa l'offerta dell'Estensione Coworking fino a fine mese."*

## `delete_downsell_offer`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina offerta di downsell.** *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link | Sì | |
| `offer_id` | id | Sì | Da `list_downsell_offers` |

## `delete_product`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina prodotto.** Elimina un prodotto o un'opzione di fatturazione. Chi l'ha acquistato mantiene l'accesso. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `product` | id o slug | Sì | Da `list_products` |

**Restituisce:** alla prima chiamata, il titolo, il prezzo e lo stato, più il codice di conferma.

**Note:** per smettere soltanto di vendere, meglio `unpublish_product`. Vedi [Prodotti](/monetizacao/produtos).

## `delete_plan`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina piano.** Chi è già abbonato non viene annullato. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan` | id o link (`/pricing/…`) | Sì | |

**Restituisce:** alla prima chiamata, il nome del piano e le sue opzioni, più il codice di conferma.

## `reorder_plans`

<span class="tool-kind tool-kind-write">Modifica</span>

**Riordina piani.** Mette i piani in un nuovo ordine nella pagina dei prezzi, dal primo all'ultimo. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `plan_ids` | elenco di id | Sì | Da `list_plans`, nel nuovo ordine |

**Chiedi così:** *"Nella pagina dei prezzi, metti Growth prima di Starter."*

## `get_storefront`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Vedere il negozio.** Cosa mostra uno spazio Negozio: tutti i prodotti o solo quelli scelti. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio Negozio |

## `update_storefront`

<span class="tool-kind tool-kind-write">Modifica</span>

**Scegliere i prodotti del negozio.** Definisce cosa vende uno spazio Negozio. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | |
| `mode` | `all`, `selected` | Sì | Tutti i prodotti pubblicati, o solo quelli scelti |
| `product_ids` | elenco di id | No | Con `selected`, da `list_products` |

**Chiedi così:** *"Lascia nel negozio solo i corsi singoli."*

Vedi [Negozio](/espacos/loja).

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Ricette](/mcp/receitas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)