# Esempi di richieste (https://docs.getbeel.com/it/guide/example-prompts)

Cosa chiedere al tuo assistente collegato a Getbeel.

Scrivi all'assistente come scriveresti a un collaboratore. Accanto a ogni richiesta trovi lo strumento MCP che l'assistente usa.

## Prima di iniziare [#prima-di-iniziare]

- **Un assistente collegato** a Getbeel: vedi [Collega Claude, ChatGPT o Cursor](/it/guide/connect-ai).
- **Con più strumenti collegati**, inizia con "Con Getbeel…": l'assistente sceglie quello giusto.
- **Modalità Test** per provare. Gli strumenti che cambiano dati fiscali (cespiti, ritenute, adempimenti) e i dati aziendali funzionano solo in **Live**.
- **Costo**: le richieste non si pagano a parte. Gli invii live allo SDI seguono il listino ([Prezzi](/it/api/pricing)).

## Controllare la situazione [#controllare-la-situazione]

| Richiesta                                                                                                | Strumento                      |
| -------------------------------------------------------------------------------------------------------- | ------------------------------ |
| "Con Getbeel, quali fatture emesse a ottobre sono state scartate dallo SDI? Spiegami perché."            | `list_invoices`, `get_invoice` |
| "Elenca le fatture emesse ma finite nel cassetto fiscale negli ultimi 30 giorni, con cliente e importo." | `list_invoices`                |
| "Quanto ho fatturato in totale a Rossi S.r.l. quest'anno?"                                               | `list_invoices`                |
| "Quali fatture sono scadute e non ancora pagate?"                                                        | `list_overdue_invoices`        |
| "Elenca le note di credito della fattura 12."                                                            | `list_credit_notes`            |

## Fatture dei fornitori [#fatture-dei-fornitori]

| Richiesta                                                                            | Strumento                        |
| ------------------------------------------------------------------------------------ | -------------------------------- |
| "Quali fatture ricevute a settembre arrivano dall'email? Raggruppale per fornitore." | `list_received_invoices`         |
| "Quanto ho speso in software negli ultimi tre mesi?"                                 | `list_received_invoices`         |
| "Ricevi una fattura di prova nella sandbox e mostramela." (solo in Test)             | `create_sandbox_inbound_invoice` |

## Prima di inviare [#prima-di-inviare]

| Richiesta                                                                            | Strumento          |
| ------------------------------------------------------------------------------------ | ------------------ |
| "Controlla questo XML FatturaPA e dimmi cosa correggere." (allega o incolla il file) | `validate_invoice` |
| "Questa fattura è a IVA zero per un cliente tedesco: quale natura devo usare?"       | nessuno            |

Per l'ultima domanda l'assistente può leggere questa documentazione. Per i casi dubbi chiedi al commercialista.

## Preparare e inviare [#preparare-e-inviare]

| Richiesta                                                                                                                                               | Strumento                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| "Prepara una bozza per Bianchi S.p.A., P.IVA 01234567890, codice destinatario M5UXCR1: consulenza di ottobre, 1.000 euro più IVA al 22%. Non inviarla." | `create_invoice_draft`        |
| "Mostrami la bozza e, se è tutto corretto, inviala."                                                                                                    | `get_invoice`, `send_invoice` |
| "Fai una nota di credito che annulla la fattura 12."                                                                                                    | `create_credit_note`          |

Prima di `send_invoice` l'assistente deve mostrarti la fattura e chiederti conferma.

<Callout type="warn">
  In **Live** l'invio emette una fattura vera e non si annulla. Controlla
  cliente, importi e IVA nella bozza prima di confermare.
</Callout>

## Banca [#banca]

| Richiesta                                                                            | Strumento                                    |
| ------------------------------------------------------------------------------------ | -------------------------------------------- |
| "Mostrami l'ultimo estratto conto: periodo, saldi e quanti movimenti sono abbinati." | `list_bank_statements`, `get_bank_statement` |
| "Quali movimenti non sono ancora abbinati a una fattura?"                            | `list_unmatched`                             |

## Tasse [#tasse]

| Richiesta                                                        | Strumento                 |
| ---------------------------------------------------------------- | ------------------------- |
| "Quali scadenze fiscali ho nei prossimi 30 giorni?"              | `get_tax_calendar`        |
| "Quanta IVA devo versare per ottobre?"                           | `get_vat_settlement`      |
| "Posso compensare il credito IVA?"                               | `ask_accountant_question` |
| "Quanto devo mettere da parte per le imposte di quest'anno?"     | `get_tax_estimate`        |
| "Prepara i dati della CU 2026 dei professionisti che ho pagato." | `get_withholdings_cu`     |

## Correggere dati [#correggere-dati]

| Richiesta                                                            | Strumento                                 |
| -------------------------------------------------------------------- | ----------------------------------------- |
| "Elimina il cespite registrato per errore."                          | `list_fixed_assets`, `delete_fixed_asset` |
| "Elimina la ritenuta registrata due volte per la parcella di Verdi." | `list_withholdings`, `delete_withholding` |
| "Aggiorna l'indirizzo della sede: Via Roma 10, 20121 Milano."        | `list_companies`, `update_company`        |

L'assistente deve chiederti conferma prima di eliminare o cambiare dati. Una ritenuta già versata con un F24 non si elimina. I dati aziendali finiscono in ogni fattura che emetti.

## Cosa significano gli stati delle fatture [#cosa-significano-gli-stati-delle-fatture]

L'assistente usa gli stessi stati che vedi in **Fatture emesse**. Quello che conta è se la fattura è emessa:

| In Getbeel                        | Cosa significa                                                                                                             | Cosa fare                                                                                                 |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Inviata al SDI**                | Lo SDI sta facendo i controlli (da pochi minuti fino a 5 giorni)                                                           | Aspetta l'esito, non inviarla di nuovo                                                                    |
| **Consegnata**                    | Recapitata al cliente: è emessa                                                                                            | Niente                                                                                                    |
| **Emessa · nel cassetto fiscale** | Lo SDI non ha potuto recapitarla, ma è **emessa**: il cliente la trova nella sua area riservata di Fatture e Corrispettivi | Avvisa il cliente. **Non inviarla di nuovo**: sarebbe un duplicato                                        |
| **Scartata**                      | Lo SDI l'ha rifiutata: si considera **mai emessa**. Il dettaglio mostra il codice e il motivo                              | Scegli **Correggi e reinvia**: torna in bozza con lo stesso numero e la stessa data; correggila e inviala |
| **Già emessa · duplicato**        | Lo SDI ha scartato un secondo invio con il codice 00404 perché ha già accettato la stessa fattura: è **emessa**            | Niente: non va reinviata. L'assistenza collega l'invio accettato                                          |

Per i dettagli e le fonti ufficiali: [ciclo di vita SDI](/it/api/sdi-lifecycle) e [codici di scarto](/it/api/reference-data/sdi-errors).

## Se qualcosa non va [#se-qualcosa-non-va]

| Messaggio dell'assistente | Causa                                                      | Cosa fare                                                              |
| ------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------- |
| `livemode_required`       | Lo strumento cambia dati reali e il collegamento è in Test | Ricollega l'assistente in **Live**                                     |
| `test_mode_required`      | La sandbox funziona solo in Test                           | Usa un collegamento in **Test**                                        |
| `subscription_required`   | Lo strumento richiede un piano attivo                      | Scegli un piano in **Impostazioni → Utilizzo e fatturazione**          |
| `withholding_remitted`    | La ritenuta è già in un F24 pagato                         | Lasciala com'è e senti il commercialista                               |
| `insufficient_scope`      | Il collegamento non ha quel permesso                       | Revoca l'app in **App collegate** e ricollegala con il permesso giusto |

Puoi anche chiedere direttamente:

- "La fattura 118 è stata scartata con il codice 00305. Cosa significa e come la correggo?"
- "La fattura per Verdi risulta Emessa · nel cassetto fiscale. Cosa devo fare?"
- "Perché la fattura 121 dice Già emessa · duplicato?"

## Prossimi passi [#prossimi-passi]

<Cards>
  <Card title="Server MCP" href="/it/api/mcp">
    L'elenco completo degli strumenti, con scope e argomenti.
  </Card>
  <Card title="Sandbox" href="/it/api/sandbox">
    Prova ogni esito SDI e le fatture ricevute senza inviare nulla.
  </Card>
  <Card title="Tasse" href="/it/guide/tasse">
    Cosa calcola Getbeel da solo e cosa prepari tu.
  </Card>
</Cards>
