GetbeelDocs

Prezzi, saldo e consumi

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

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

Invii al mesePrezzo per invio
1–1.0000,15 €
1.001–10.0000,12 €
oltre 10.0000,10 €
VocePrezzo
Fattura ricevuta dallo SDI0,15 €
Documento letto dall'IA (scansione email, indirizzo di inoltro, caricamento)0,03 €
Conto bancario collegato, al mese2,00 €
Movimento bancario importato0,02 €
F24 pagato (qualsiasi F24: IVA, bollo, ritenute, INPS, acconti)1,00 €
LIPE inviata3,00 €
Dichiarazione OSS inviata3,00 €
Dichiarazione IVA annuale inviata12,00 €
Dichiarazione IRES/IRAP inviata9,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

  • 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), 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).

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

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)

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.

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).

In questa pagina