GetbeelDocs

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_code sceglie il coefficiente del DM 31/12/1988 (GET /v1/fixed-asset-categories); senza, passa category_label e coefficient. Un coefficiente superiore a quello della categoria risponde 400 coefficient_above_maximum.
  • received_invoice_id compila data, fornitore e numero dalla fattura ricevuta; nella stima delle imposte il costo del cespite esce dai costi dell'anno.
  • expense_in_full: true deduce per intero un bene materiale fino a 516,46 € (400 not_a_small_asset altrimenti).
  • La risposta ha schedule (anno, max_amount, amount, fondo, residuo), status, accumulated_depreciation e residual_value a fine as_of_year.
  • PATCH /v1/fixed-assets/{id} con disposal_date e disposal_amount registra la cessione: disposal.gain positivo è 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 con totals, by_category e closing_entries (riepilogo delle scritture di chiusura); &format=csv o xlsx restituisce 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_type 00 è un POS fisico e richiede il suo terminal_id (senza, 400 terminal_id_required); per 01, un POS virtuale, terminal_id è ignorato e salvato vuoto.
  • Ogni collegamento ha status (to_file, filed, end_to_file, ended) e pending: l'operazione da comunicare (I o C) con la finestra from–due del provvedimento AdE 424470/2025.
  • Dopo la comunicazione un collegamento non si modifica (409 link_already_filed): PATCH con ended_on lo chiude e la chiusura diventa la prossima cosa da comunicare.
  • GET /v1/pos-rt-links/export?part=1 restituisce 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=csv restituisce il file.
  • Dopo il caricamento in Fatture e Corrispettivi, POST /v1/pos-rt-links/mark-filed con quei links le 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, solo label ed ended_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 risponde 409 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.

In questa pagina