# Example prompts (https://docs.getbeel.com/en/guide/example-prompts)

What to ask your assistant once it is connected to Getbeel.

Write to the assistant as you would write to a colleague. Next to each request you find the MCP tool the assistant uses.

## Before you start [#before-you-start]

- **An assistant connected** to Getbeel: see [Connect Claude, ChatGPT or Cursor](/en/guide/connect-ai).
- **With several tools connected**, start with "With Getbeel…": the assistant picks the right one.
- **Test mode** to try things out. Tools that change fiscal data (fixed assets, withholdings, filings) and company data work only in **Live**.
- **Cost**: requests have no separate charge. Live sends to SDI follow the price list ([Pricing](/en/api/pricing)).

## Check where things stand [#check-where-things-stand]

| Request                                                                                                         | Tool                           |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| "With Getbeel, which invoices issued in October did SDI reject? Tell me why."                                   | `list_invoices`, `get_invoice` |
| "List the invoices issued in the last 30 days that ended up in the cassetto fiscale, with customer and amount." | `list_invoices`                |
| "How much have I invoiced Rossi S.r.l. in total this year?"                                                     | `list_invoices`                |
| "Which invoices are overdue and still unpaid?"                                                                  | `list_overdue_invoices`        |
| "List the credit notes for invoice 12."                                                                         | `list_credit_notes`            |

## Supplier invoices [#supplier-invoices]

| Request                                                                       | Tool                             |
| ----------------------------------------------------------------------------- | -------------------------------- |
| "Which invoices received in September came by email? Group them by supplier." | `list_received_invoices`         |
| "How much have I spent on software in the last three months?"                 | `list_received_invoices`         |
| "Receive a test invoice in the sandbox and show it to me." (Test only)        | `create_sandbox_inbound_invoice` |

## Before sending [#before-sending]

| Request                                                                        | Tool               |
| ------------------------------------------------------------------------------ | ------------------ |
| "Check this FatturaPA XML and tell me what to fix." (attach or paste the file) | `validate_invoice` |
| "This invoice has zero VAT for a German customer: which natura should I use?"  | none               |

For the last question the assistant can read these docs. For unclear cases, ask your accountant (commercialista).

## Prepare and send [#prepare-and-send]

| Request                                                                                                                                             | Tool                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| "Prepare a draft for Bianchi S.p.A., P.IVA 01234567890, codice destinatario M5UXCR1: October consulting, 1,000 euros plus 22% VAT. Do not send it." | `create_invoice_draft`        |
| "Show me the draft and, if everything is right, send it."                                                                                           | `get_invoice`, `send_invoice` |
| "Make a credit note that cancels invoice 12."                                                                                                       | `create_credit_note`          |

Before `send_invoice` the assistant must show you the invoice and ask you to confirm.

<Callout type="warn">
  In **Live**, sending issues a real invoice and cannot be undone. Check
  customer, amounts and VAT in the draft before you confirm.
</Callout>

## Bank [#bank]

| Request                                                                                      | Tool                                         |
| -------------------------------------------------------------------------------------------- | -------------------------------------------- |
| "Show me the latest bank statement: period, balances and how many transactions are matched." | `list_bank_statements`, `get_bank_statement` |
| "Which transactions are not matched to an invoice yet?"                                      | `list_unmatched`                             |

## Taxes [#taxes]

| Request                                                  | Tool                      |
| -------------------------------------------------------- | ------------------------- |
| "Which tax deadlines do I have in the next 30 days?"     | `get_tax_calendar`        |
| "How much VAT do I have to pay for October?"             | `get_vat_settlement`      |
| "Can I offset my VAT credit?"                            | `ask_accountant_question` |
| "How much should I set aside for this year's taxes?"     | `get_tax_estimate`        |
| "Prepare the 2026 CU data for the professionals I paid." | `get_withholdings_cu`     |

## Correct data [#correct-data]

| Request                                                            | Tool                                      |
| ------------------------------------------------------------------ | ----------------------------------------- |
| "Delete the fixed asset I registered by mistake."                  | `list_fixed_assets`, `delete_fixed_asset` |
| "Delete the withholding recorded twice for Verdi's fee note."      | `list_withholdings`, `delete_withholding` |
| "Update the registered office address: Via Roma 10, 20121 Milano." | `list_companies`, `update_company`        |

The assistant must ask you to confirm before it deletes or changes data. A withholding already paid with an F24 cannot be deleted. Company data goes on every invoice you issue.

## What invoice statuses mean [#what-invoice-statuses-mean]

The assistant uses the same statuses you see in **Issued invoices**. What matters is whether the invoice is issued:

| In Getbeel                       | What it means                                                                                                           | What to do                                                                                             |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Sent to SDI**                  | SDI is running its checks (from a few minutes up to 5 days)                                                             | Wait for the outcome, do not send it again                                                             |
| **Delivered**                    | Delivered to the customer: it is issued                                                                                 | Nothing                                                                                                |
| **Issued · in cassetto fiscale** | SDI could not deliver it, but it is **issued**: the customer finds it in their reserved area of Fatture e Corrispettivi | Tell the customer. **Do not send it again**: it would be a duplicate                                   |
| **Rejected**                     | SDI refused it: it counts as **never issued**. The details show the code and the reason                                 | Choose **Correct and resend**: it goes back to draft with the same number and date; fix it and send it |
| **Already issued · duplicate**   | SDI rejected a second send with code 00404 because it already accepted the same invoice: it is **issued**               | Nothing: do not resend it. Support links the accepted send                                             |

For details and official sources: [SDI lifecycle](/en/api/sdi-lifecycle) and [rejection codes](/en/api/reference-data/sdi-errors).

## If it fails [#if-it-fails]

| Assistant message       | Cause                                                    | Fix                                                                          |
| ----------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `livemode_required`     | The tool changes real data and the connection is in Test | Reconnect the assistant in **Live**                                          |
| `test_mode_required`    | The sandbox works only in Test                           | Use a **Test** connection                                                    |
| `subscription_required` | The tool needs an active plan                            | Choose a plan in **Settings → Usage & billing**                              |
| `withholding_remitted`  | The withholding is already in a paid F24                 | Leave it as it is and talk to your accountant                                |
| `insufficient_scope`    | The connection lacks that permission                     | Revoke the app in **Connected apps** and reconnect with the right permission |

You can also ask directly:

- "Invoice 118 was rejected with code 00305. What does it mean and how do I fix it?"
- "The invoice for Verdi shows Issued · in cassetto fiscale. What should I do?"
- "Why does invoice 121 say Already issued · duplicate?"

## Next steps [#next-steps]

<Cards>
  <Card title="MCP server" href="/en/api/mcp">
    The full list of tools, with scopes and arguments.
  </Card>
  <Card title="Sandbox" href="/en/api/sandbox">
    Try every SDI outcome and received invoices without sending anything.
  </Card>
  <Card title="Taxes" href="/en/guide/tasse">
    What Getbeel computes on its own and what you prepare.
  </Card>
</Cards>
