# Fixed assets, estimates and POS–RT (https://docs.getbeel.com/en/api/tax-tools)

Fixed assets and depreciation with the libro cespiti, the tax estimate (IRES, IRAP, IRPEF, forfettario, minimi, INPS) and POS–RT links with the Agenzia delle Entrate CSV.

The same features as **Tasse → Cespiti**, **Tasse → Stima imposte** and **Tasse → POS e RT**. Scope `taxes:read` to read, `taxes:write` to write; writes need a live key (`403 livemode_required`) and are free. Italian companies only (`400 taxes_not_available`). Rules and sources are in the guides: [Fixed assets](/en/guide/cespiti), [Tax estimate](/en/guide/stima-imposte), [POS and tills](/en/guide/collegamento-pos-rt).

## Fixed assets [#fixed-assets]

```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 from GET /v1/received-invoices>",
    "in_service_date": "2026-03-15"
  }'
```

- `category_code` picks the DM 31/12/1988 coefficient (`GET /v1/fixed-asset-categories`); without it send `category_label` and `coefficient`. A coefficient above the category's answers `400 coefficient_above_maximum`.
- `received_invoice_id` fills date, supplier and number from the received invoice; in the tax estimate the asset's cost leaves the year's costs.
- `expense_in_full: true` deducts a tangible asset up to €516.46 in full (`400 not_a_small_asset` otherwise).
- The response has `schedule` (year, `max_amount`, `amount`, accumulated, residual), `status`, `accumulated_depreciation` and `residual_value` at the end of `as_of_year`.
- `PATCH /v1/fixed-assets/{id}` with `disposal_date` and `disposal_amount` records a disposal: a positive `disposal.gain` is a gain, negative a loss. `depreciation_overrides` (`{"2027": "100.00"}`) records quotas below the maximum.
- `GET /v1/companies/me/fixed-assets-register?year=2026` is the year's libro cespiti with `totals`, `by_category` and `closing_entries` (summary of the year-end entries); `&format=csv` or `xlsx` returns the file.

## Tax estimate [#tax-estimate]

```bash
curl "https://www.getbeel.com/api/v1/companies/me/tax-estimate?year=2026" \
  -H "Authorization: Bearer $GETBEEL_API_KEY"
```

`reliable` is always `false` and `label` is "Stima, da verificare con il commercialista". `figures` shows what came from Getbeel (issued and received invoices, payments, depreciation); `ires`/`irap` (companies), `forfettario`, `irpef` (individuals in the ordinary regime) or `minimi` (regime di vantaggio, quadro LM lines), and `inps`; `installments` the advances and balance with F24 tax code, `due_date` and `confirmed` (`false` for dates not yet confirmed by a source in force); `warnings` what is missing.

`PUT /v1/companies/me/tax-estimate` saves for the year what Getbeel cannot know (`entity`, `ateco_code` or `forfettario_group`, `inps_scheme`, `personnel_costs`, `permanent_staff_costs`, `irap_rate`, `prior_year_ires`…) and returns the recomputed estimate. Fields not sent keep their value; the next year starts from the same answers. Amounts are decimal strings (`"12000.00"`) like everywhere in the API; plain numbers are accepted too.

## POS–RT links [#posrt-links]

```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` is a physical POS and needs its `terminal_id` (`400 terminal_id_required` without it); for `01`, a virtual POS, `terminal_id` is ignored and stored empty.
- Each link has `status` (`to_file`, `filed`, `end_to_file`, `ended`) and `pending`: the operation to communicate (`I` or `C`) with the `from`–`due` window of AdE provvedimento 424470/2025.
- After it is communicated a link cannot change (`409 link_already_filed`): `PATCH` with `ended_on` ends it, and the end becomes the next thing to communicate.
- `GET /v1/pos-rt-links/export?part=1` returns the CSV (`csv`, up to 1,000 rows per part), the same rows tab-separated (`tsv`) to paste into the AdE template, `links` (id and operation of each row), which parts of the format are official and which are not (`layout`), and the portal steps (`next_steps`). `&format=csv` returns the file.
- After the upload in Fatture e Corrispettivi, `POST /v1/pos-rt-links/mark-filed` with those `links` marks them communicated; a link whose pending operation changed meanwhile is left alone.
- `GET /v1/pos-rt-links/{id}` reads one link. `PATCH /v1/pos-rt-links/{id}` changes it; once communicated, only `label` and `ended_on` (the last day of use, which makes the end the next thing to communicate). `DELETE /v1/pos-rt-links/{id}` deletes a link not communicated yet; a communicated one answers `409 link_already_filed`: end it instead.

Getbeel never uploads the file or signs in to the portal for you.

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