GetbeelDocs

Fixed assets, estimates and POS–RT

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, Tax estimate, POS and tills.

Fixed assets

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

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.

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

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.

On this page