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_codepicks the DM 31/12/1988 coefficient (GET /v1/fixed-asset-categories); without it sendcategory_labelandcoefficient. A coefficient above the category's answers400 coefficient_above_maximum.received_invoice_idfills date, supplier and number from the received invoice; in the tax estimate the asset's cost leaves the year's costs.expense_in_full: truededucts a tangible asset up to €516.46 in full (400 not_a_small_assetotherwise).- The response has
schedule(year,max_amount,amount, accumulated, residual),status,accumulated_depreciationandresidual_valueat the end ofas_of_year. PATCH /v1/fixed-assets/{id}withdisposal_dateanddisposal_amountrecords a disposal: a positivedisposal.gainis a gain, negative a loss.depreciation_overrides({"2027": "100.00"}) records quotas below the maximum.GET /v1/companies/me/fixed-assets-register?year=2026is the year's libro cespiti withtotals,by_categoryandclosing_entries(summary of the year-end entries);&format=csvorxlsxreturns 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.
POS–RT links
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_type00is a physical POS and needs itsterminal_id(400 terminal_id_requiredwithout it); for01, a virtual POS,terminal_idis ignored and stored empty.- Each link has
status(to_file,filed,end_to_file,ended) andpending: the operation to communicate (IorC) with thefrom–duewindow of AdE provvedimento 424470/2025. - After it is communicated a link cannot change (
409 link_already_filed):PATCHwithended_onends it, and the end becomes the next thing to communicate. GET /v1/pos-rt-links/export?part=1returns 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=csvreturns the file.- After the upload in Fatture e Corrispettivi,
POST /v1/pos-rt-links/mark-filedwith thoselinksmarks 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, onlylabelandended_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 answers409 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.
Tax rules
The rule values and proroghe behind the tax calendar and estimates, with their official sources; for getbeel administrators, the proposals of the weekly rules watch.
Withholding tax (ritenute)
Invoices with ritenuta and cassa previdenziale, withholdings owed as sostituto d'imposta, F24 code 1040 and data for the Certificazione Unica and the 770.