# Prezzi, saldo e consumi (https://docs.getbeel.com/it/api/pricing)

Paghi quanto usi da un saldo prepagato. Il listino, il saldo, le ricariche, i consumi e l'errore 402 insufficient_balance.

Usare Getbeel è gratis: app, sandbox, API, server MCP, webhook, scadenzario, registri ed esportazioni. Si paga solo quello che costa, da **un saldo prepagato in euro per account di fatturazione**. Un gestore con molte aziende clienti ha un solo saldo, e gli scaglioni contano tutte le sue aziende. Prezzi IVA esclusa.

## Listino [#listino]

**Invio allo SDI** (fatture, note di credito, autofatture TD16–TD20: ogni documento inviato allo SDI), a scaglioni per mese solare:

| Invii al mese | Prezzo per invio |
| ------------- | ---------------- |
| 1–1.000       | 0,15 €           |
| 1.001–10.000  | 0,12 €           |
| oltre 10.000  | 0,10 €           |

| Voce                                                                         | Prezzo  |
| ---------------------------------------------------------------------------- | ------- |
| Fattura ricevuta dallo SDI                                                   | 0,15 €  |
| Documento letto dall'IA (scansione email, indirizzo di inoltro, caricamento) | 0,03 €  |
| Conto bancario collegato, al mese                                            | 2,00 €  |
| Movimento bancario importato                                                 | 0,02 €  |
| F24 pagato (qualsiasi F24: IVA, bollo, ritenute, INPS, acconti)              | 1,00 €  |
| LIPE inviata                                                                 | 3,00 €  |
| Dichiarazione OSS inviata                                                    | 3,00 €  |
| Dichiarazione IVA annuale inviata                                            | 12,00 € |
| Dichiarazione IRES/IRAP inviata                                              | 9,00 €  |
| Dichiarazione Redditi PF inviata (autonomi, ogni regime)                     | 9,00 €  |

Una pratica si paga una volta per tipo, periodo e azienda, quando la segni come pagata o inviata (ricevuta registrata): prepararla (a mano o in automatico), rifarla e saltarla sono gratis. Salvare i dati della stima delle imposte è gratis. Un movimento bancario si paga una volta, quando viene importato (collegamento bancario o estratto caricato): importarlo di nuovo (lo stesso estratto, una sincronizzazione che lo riporta, un estratto con un periodo sovrapposto) è gratis, e un estratto caricato non salva di nuovo un movimento già importato per lo stesso conto (riconosciuto da banca e ultime 4 cifre). Il profilo fiscale, il riconoscimento del regime, il calendario e gli avvisi sono gratis. Preventivi, proforma, PDF, solleciti e il reinvio dopo uno scarto sono gratis.

Esempio: 200 aziende che inviano 20 fatture e ne ricevono 30 al mese tramite SDI fanno 4.000 invii (510 €) e 6.000 ricezioni (900 €): 1.410 € al mese.

`GET /billing/prices` restituisce lo stesso listino (centesimi, IVA esclusa).

## Saldo e ricariche [#saldo-e-ricariche]

- **Credito di benvenuto**: 1 € una volta per account (e per carta e partita IVA), valido 90 giorni, quando salvi la prima carta. Una carta che l'ha già ricevuto su un altro team non ne riceve un secondo: Fatturazione e utilizzo mostra "Il credito di benvenuto si applica una sola volta per carta." Il credito di benvenuto è solo per gli account nuovi.
- **Ricariche**: da 10 €, con una fattura per ogni ricarica (IVA al pagamento). Il credito pagato vale 12 mesi.
- **Ricarica automatica**: disattivata di default; quando il saldo scende sotto una soglia aggiunge un importo con la carta salvata. Se la carta viene rifiutata riprova una volta dopo 24 ore, poi si disattiva.
- **Avviso di saldo basso**: l'avviso in Fatturazione e utilizzo, il saldo rosso nella barra laterale e l'email partono quando hai credito pagato: una ricarica (a mano o automatica) non rimborsata per intero; il solo credito di benvenuto non conta. La soglia è 10 € se non la cambi.
- **Saldo a zero**: le nuove azioni a pagamento si fermano. La ricezione delle fatture dallo SDI non si ferma mai: può portare il saldo fino a -10 €, scalati dalla ricarica successiva.

`GET /billing/balance` restituisce `pricing` (`pay_as_you_go`, oppure `legacy_plan`: vedi [Account con un piano](#account-con-un-piano)), il saldo in centesimi (`balance_cents`), il credito in scadenza nei prossimi 30 giorni (`expiring_soon_cents`), la ricarica automatica e l'avviso di saldo basso, `welcome_credit` (`granted` e `not_granted_reason`: `card_already_used`, `legacy_plan`, `no_card` o null) e `topup_url`. Il saldo può aggiornarsi con un minuto di ritardo.

`POST /billing/topups` con `amount_cents` crea un link di pagamento Stripe (`checkout_url`) da far pagare a una persona: l'API non addebita mai una carta. Servono una chiave live con lo scope `billing:write` (mai selezionato di default), creata da chi gestisce la fatturazione. Con la chiave di un'azienda cliente le API `/billing` rispondono 403 `billed_to_parent`: saldo e consumi sono sull'account del gestore. La pagina Stripe si apre nella lingua di chi ha creato la chiave (altrimenti del titolare del team, altrimenti in italiano per un'azienda italiana) e propone solo la carta predefinita attuale (Stripe Checkout non può preselezionare una carta salvata, quindi le altre lì sono nascoste; si può comunque inserire un'altra carta).

```bash
curl https://getbeel.com/api/v1/billing/balance \
  -H "Authorization: Bearer $GETBEEL_LIVE_KEY"

curl -X POST https://getbeel.com/api/v1/billing/topups \
  -H "Authorization: Bearer $GETBEEL_LIVE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 2500}'
```

`POST /billing/payment-method` (senza corpo) crea un link Stripe (`checkout_url`, in modalità setup: non addebita nulla) dove una persona inserisce una nuova carta: diventa la carta predefinita e quella delle ricariche automatiche. La stessa carta salvata due volte resta una sola. Stessa chiave e stesso scope delle ricariche; 409 `no_card` se non c'è ancora una carta salvata, come `application/problem+json` con la stessa forma del 402 qui sotto. MCP: `create_billing_card_link`.

## Consumi [#consumi]

`GET /billing/usage?month=2026-12` restituisce per voce (`by_meter`) quantità, importo e prezzo del prossimo invio allo scaglione del mese, e per azienda (`by_company`) per un gestore.

## Saldo insufficiente (402) [#saldo-insufficiente-402]

Un'azione a pagamento che il saldo non copre risponde **402** `application/problem+json` con `code` `insufficient_balance`, `balance_cents`, `required_cents` e `topup_url`, più il solito oggetto `error`. Qui `balance_cents` è il saldo disponibile (il saldo meno gli importi riservati per le azioni in corso), mai sotto 0. Per un'azienda cliente fatturata al suo gestore la risposta non contiene `balance_cents` né `topup_url` (il saldo è del gestore): il messaggio chiede di far aggiungere credito all'account che fattura l'azienda. I tool MCP restituiscono lo stesso testo. Vedi [Errori](/it/api/errors).

## Account con un piano [#account-con-un-piano]

Chi si è registrato prima del 13 novembre 2026 mantiene il suo piano (o l'add-on SDI), con i suoi prezzi e tutto quello che include, senza scadenza: con un piano a pagamento attivo gli adempimenti fiscali e i conti bancari collegati sono inclusi, e senza piano restano chiusi come prima (402 `subscription_required`). Paghi quanto usi vale solo per gli account creati da quel giorno.

Per questi account `GET /billing/balance` risponde con `pricing: "legacy_plan"`, importi a 0, `topup_url` null e `welcome_credit.not_granted_reason: "legacy_plan"`. `GET /billing/usage`, `POST /billing/topups` e `POST /billing/payment-method` rispondono 409 `not_pay_as_you_go`. `GET /usage` restituisce le transazioni SDI del mese (`sdi_transactions`, `free_allowance`, `email_extractions`, `estimated_amount`, `rate_card`, `received_unit_amount`, `email_extraction_unit_amount`).
