# Strumenti · Finanze

> Strumenti MCP per il denaro della community: riepilogo delle vendite, clienti, estratto conto, saldo, prelievi e la simulazione della commissione, e richiedere o annullare prelievi, con conferma.

La cassa della community: quanto ha venduto, chi paga, l'estratto conto, il saldo disponibile, i prelievi, e quanto resta di una vendita. Richiedere o annullare un prelievo chiede il tuo sì, con un riepilogo. Negli importi compare solo la commissione della piattaforma.

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 |
|---|---|---|---|
| [`get_sales_summary`](#get-sales-summary) | Ricavi, serie mensile, ricavi per prodotto e abbonati | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_customers`](#list-customers) | Chi paga e quanto ha già pagato | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_ledger_entries`](#list-ledger-entries) | Movimenti dell'estratto conto | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_balance`](#get-balance) | Saldo totale, disponibile, trattenuto e da liberare | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_payouts`](#list-payouts) | Prelievi e stato | Admin o Finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`simulate_fee`](#simulate-fee) | Quanto riceve la community da una vendita | Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`request_payout`](#request-payout) | Richiede un prelievo, con conferma | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`cancel_payout`](#cancel-payout) | Annulla un prelievo in sospeso, con conferma | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |

## `get_sales_summary`

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

**Riepilogo vendite.** I ricavi e gli abbonati di un periodo. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `period` | `7d`, `30d`, `90d`, `1y`, `custom` | No | Il periodo |
| `start_date` | data ISO 8601 | No | Con `period: custom` |
| `end_date` | data ISO 8601 | No | Con `period: custom` |

**Restituisce:** i ricavi del periodo, la serie mese per mese, i ricavi per prodotto e gli abbonati attivi, in ritardo e annullati. Negli importi compare solo la commissione della piattaforma.

**Chiedi così:** *"Fai un grafico dei ricavi degli ultimi 12 mesi."* · *"Quale prodotto ha venduto di più nel trimestre?"*

## `list_customers`

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

**Chi paga e quanto ha già pagato.** I clienti paganti e il totale pagato da ciascuno. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** i clienti, con nome, e-mail e totale pagato.

**Chiedi così:** *"Chi sono i 10 clienti che hanno pagato di più?"*

## `list_ledger_entries`

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

**Estratto conto.** I movimenti dell'estratto conto, dai più recenti. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `entry_type` | testo | No | Un tipo di movimento: `SALE_GROSS`, `SALE_NET`, `PLATFORM_FEE`, `INSTALLMENT_INTEREST`, `REFUND`, `CHARGEBACK`, `PAYOUT_REQUESTED`… |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** i movimenti, con data, tipo, descrizione e importo. Vedi [Saldo ed estratto conto](/pagamentos/saldo-e-extrato).

**Chiedi così:** *"Quali sono stati i rimborsi di questo mese?"*

## `get_balance`

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

**Saldo.** Il saldo della community. *Ruolo minimo: Admin o Finanza.*

Parametri: nessuno.

**Restituisce:** il saldo totale, il disponibile per il prelievo, il trattenuto e ciò che deve ancora essere liberato.

**Chiedi così:** *"Quanto posso prelevare oggi?"*

## `list_payouts`

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

**Prelievi.** I prelievi richiesti, con lo stato. *Ruolo minimo: Admin o Finanza.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `status` | `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `CANCELED` | No | Un solo stato |
| `page`, `limit` | numero | No | Paginazione |

**Restituisce:** i prelievi, con id (che chiede `cancel_payout`), importo, commissione, stato e date.

**Chiedi così:** *"Qualche prelievo è fallito?"*

## `simulate_fee`

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

**Quanto ricevo da una vendita.** Simula una vendita: l'importo, la commissione della piattaforma e ciò che riceve la community. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `amount` | numero | Sì | L'importo della vendita, in reais |
| `payment_method` | `PIX`, `CREDIT_CARD`, `BOLETO` | No | Il metodo di pagamento |
| `installments` | numero | No | Numero di rate con carta |

**Restituisce:** l'importo, la commissione della piattaforma (che non dipende dal metodo di pagamento) e il netto. Vedi [Commissione della piattaforma](/pagamentos/taxa-da-plataforma).

**Chiedi così:** *"Se vendo un corso da R$ 297, quanto resta alla community?"*

## `request_payout`

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

**Richiedere un prelievo.** Richiede un prelievo dal saldo disponibile verso il conto bancario registrato. *Ruolo minimo: Admin; il ruolo Finanza può solo leggere.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `amount` | numero, in reais | Sì | Fino al disponibile (vedilo con `get_balance`) |

**Il riepilogo:** l'azione, l'importo e il saldo attuale.

**Chiedi così:** *"Quanto ho disponibile? Preleva R$ 2.000."*

**Note:** la commissione di R$ 3,67 per prelievo e le regole sono quelle del pannello. Vedi [Prelievo](/pagamentos/saque).

## `cancel_payout`

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

**Annullare un prelievo.** Annulla un prelievo ancora in sospeso. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `payout_id` | id | Sì | Da `list_payouts` |

**Il riepilogo:** l'azione, l'importo, lo stato e la data della richiesta.

**Chiedi così:** *"Annulla il prelievo da R$ 2.000 che ho chiesto oggi."*

## Cosa non esiste

Non c'è uno strumento di **rimborso**: si continua dal pannello. Vedi [Problemi comuni](/mcp/problemas-comuns#cosa-non-si-puo-ancora-fare).

## Correlati

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