Cespiti, stime e POS–RT
Cespiti e ammortamenti con il libro cespiti, la stima delle imposte (IRES, IRAP, IRPEF, forfettario, minimi, INPS) e i collegamenti POS–RT con il file CSV dell'Agenzia delle Entrate.
Le stesse funzioni di Tasse → Cespiti, Tasse → Stima imposte e Tasse → POS e RT. Scope taxes:read per leggere, taxes:write per scrivere; le scritture richiedono una chiave live (403 livemode_required) e sono gratis. Solo aziende italiane (400 taxes_not_available). Le regole e le fonti sono nelle guide: Cespiti, Stima imposte, POS e RT.
Cespiti
curl -X POST "https://www.getbeel.com/api/v1/fixed-assets" \
-H "Authorization: Bearer $GETBEEL_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "Notebook",
"category_code": "altre.macchine_ufficio_elettroniche",
"cost": "1200.00",
"received_invoice_id": "<id da GET /v1/received-invoices>",
"in_service_date": "2026-03-15"
}'category_codesceglie il coefficiente del DM 31/12/1988 (GET /v1/fixed-asset-categories); senza, passacategory_labelecoefficient. Un coefficiente superiore a quello della categoria risponde400 coefficient_above_maximum.received_invoice_idcompila data, fornitore e numero dalla fattura ricevuta; nella stima delle imposte il costo del cespite esce dai costi dell'anno.expense_in_full: truededuce per intero un bene materiale fino a 516,46 € (400 not_a_small_assetaltrimenti).- La risposta ha
schedule(anno,max_amount,amount, fondo, residuo),status,accumulated_depreciationeresidual_valuea fineas_of_year. PATCH /v1/fixed-assets/{id}condisposal_dateedisposal_amountregistra la cessione:disposal.gainpositivo è una plusvalenza, negativo una minusvalenza.depreciation_overrides({"2027": "100.00"}) registra quote dedotte minori del massimo.GET /v1/companies/me/fixed-assets-register?year=2026è il libro cespiti dell'anno contotals,by_categoryeclosing_entries(riepilogo delle scritture di chiusura);&format=csvoxlsxrestituisce il file.
Stima delle imposte
curl "https://www.getbeel.com/api/v1/companies/me/tax-estimate?year=2026" \
-H "Authorization: Bearer $GETBEEL_API_KEY"reliable è sempre false e label è "Stima, da verificare con il commercialista". figures mostra cosa viene da Getbeel (fatture emesse e ricevute, pagamenti, ammortamenti); ires/irap (società), forfettario, irpef (persone fisiche in regime ordinario) o minimi (regime di vantaggio, righi del quadro LM), e inps; installments gli acconti e il saldo con codice tributo F24, due_date e confirmed (false per le date non ancora confermate da una fonte in vigore); warnings cosa manca.
PUT /v1/companies/me/tax-estimate salva per l'anno quello che Getbeel non sa (entity, ateco_code o forfettario_group, inps_scheme, personnel_costs, permanent_staff_costs, irap_rate, prior_year_ires…) e restituisce la stima ricalcolata. I campi non inviati restano com'erano; l'anno successivo parte dalle stesse risposte. Gli importi sono stringhe decimali ("12000.00") come in tutta l'API; sono accettati anche numeri semplici.
Collegamenti POS–RT
curl -X POST "https://www.getbeel.com/api/v1/pos-rt-links" \
-H "Authorization: Bearer $GETBEEL_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"rt_serial": "99IEY928374",
"acquirer_id": "04107060966",
"acquirer_name": "NEXI PAYMENTS S.P.A.",
"pos_type": "00",
"terminal_id": "54281242",
"contract_number": "0840003060",
"province": "MI", "municipality": "Milano",
"street": "Via Roma", "street_number": "1", "postal_code": "20121",
"active_from": "2026-11-02"
}'pos_type00è un POS fisico e richiede il suoterminal_id(senza,400 terminal_id_required); per01, un POS virtuale,terminal_idè ignorato e salvato vuoto.- Ogni collegamento ha
status(to_file,filed,end_to_file,ended) epending: l'operazione da comunicare (IoC) con la finestrafrom–duedel provvedimento AdE 424470/2025. - Dopo la comunicazione un collegamento non si modifica (
409 link_already_filed):PATCHconended_onlo chiude e la chiusura diventa la prossima cosa da comunicare. GET /v1/pos-rt-links/export?part=1restituisce il CSV (csv, al massimo 1.000 righe per parte), le stesse righe separate da tabulazioni (tsv) da incollare nel modello AdE,links(id e operazione di ogni riga), cosa è ufficiale e cosa no del formato (layout) e i passaggi nel portale (next_steps).&format=csvrestituisce il file.- Dopo il caricamento in Fatture e Corrispettivi,
POST /v1/pos-rt-links/mark-filedcon queilinksle segna come comunicate; un collegamento la cui operazione da comunicare è cambiata nel frattempo resta com'è. GET /v1/pos-rt-links/{id}legge un collegamento.PATCH /v1/pos-rt-links/{id}lo modifica; dopo la comunicazione, sololabeledended_on(l'ultimo giorno di utilizzo, che rende la cessazione la prossima cosa da comunicare).DELETE /v1/pos-rt-links/{id}elimina un collegamento non ancora comunicato; uno già comunicato risponde409 link_already_filed: va cessato.
Getbeel non carica il file né accede al portale per te.
MCP
list_fixed_assets, register_fixed_asset, update_fixed_asset, delete_fixed_asset, get_fixed_assets_register, get_tax_estimate, save_tax_estimate_inputs, list_pos_rt_links, add_pos_rt_link, end_pos_rt_link, get_pos_rt_csv, mark_pos_rt_links_filed.
Regole fiscali
I valori e le proroghe dietro lo scadenzario e le stime, con le fonti ufficiali; per gli amministratori di getbeel, le proposte del controllo settimanale delle fonti.
Ritenute d'acconto
Fatture con ritenuta e cassa previdenziale, ritenute dovute come sostituto d'imposta, F24 codice 1040 e dati per la Certificazione Unica e il 770.