# Cespiti, stime e POS–RT (https://docs.getbeel.com/it/api/tax-tools)

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](/it/guide/cespiti), [Stima imposte](/it/guide/stima-imposte), [POS e RT](/it/guide/collegamento-pos-rt).

## Cespiti [#cespiti]

```bash
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 [#stima-delle-imposte]

```bash
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 [#collegamenti-posrt]

```bash
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 [#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`.
