CU and 770 data of a year
Per percipiente and causale, the fees paid in the year (cash principle) as the Certificazione Unica (lavoro autonomo, provvigioni e redditi diversi) reports them: punto 4 gross, 7 not subject, 8 taxable, 9 ritenute; the 770 quadro ST lines per month (codice 1040). Deadlines from the CU 2026 instructions: CU to each percipiente by 16 March; to the AdE by 16 March, or 30 April for lavoro autonomo abituale and non-occasional provvigioni; 770 by 31 October. format=csv returns a spreadsheet (text/csv). Not the telematic file.
Per percipiente and causale, the fees paid in the year (cash principle) as the Certificazione Unica (lavoro autonomo, provvigioni e redditi diversi) reports them: punto 4 gross, 7 not subject, 8 taxable, 9 ritenute; the 770 quadro ST lines per month (codice 1040). Deadlines from the CU 2026 instructions: CU to each percipiente by 16 March; to the AdE by 16 March, or 30 April for lavoro autonomo abituale and non-occasional provvigioni; 770 by 31 October. format=csv returns a spreadsheet (text/csv). Not the telematic file.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
year*integerThe year the fees were paid (cash principle)
2020 <= value <= 2100format?stringcsv: one row per percipiente and causale (semicolons, Italian decimals, for Excel)
"json""json""csv"Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
object*stringyear*integer-9007199254740991 <= value <= 9007199254740991recipients*array<>totals*deadlines*missing_fiscal_codes*integer-9007199254740991 <= value <= 9007199254740991form_770*array<>770 quadro ST, sezione I, per month
curl -X GET 'https://www.getbeel.com/api/v1/withholdings/cu?year=2026'{ "object": "withholdings_cu", "year": -9007199254740991, "recipients": [ { "key": "string", "name": "string", "fiscal_code": "string", "vat": "string", "lines": [ { "causale": "string", "gross_amount": "122.00", "not_subject_amount": "122.00", "taxable_amount": "122.00", "withheld_amount": "122.00", "remitted_amount": "122.00", "payments": -9007199254740991 } ], "ade_due_date": "2026-10-29", "missing_fiscal_code": true } ], "totals": { "recipients": -9007199254740991, "gross_amount": "122.00", "not_subject_amount": "122.00", "taxable_amount": "122.00", "withheld_amount": "122.00", "remitted_amount": "122.00" }, "deadlines": { "to_recipients": "2026-10-29", "to_ade": "2026-10-29", "to_ade_professionals": "2026-10-29", "form_770": "2026-10-29" }, "missing_fiscal_codes": -9007199254740991, "form_770": [ { "period": "string", "period_label": "string", "withheld_amount": "122.00", "paid_amount": "122.00", "paid_on": "2026-10-29", "tax_code": "1040", "filing_id": "string" } ]}Read withholdings from received SDI invoices POST
Reads the invoices received from SDI that have no withholding yet and records those with DatiRitenuta RT01/RT02. Up to 100 per call; call again while has_more. Live keys only (403 livemode_required). Free.
Get the tax settings GET
VAT periodicity and whether the company is a withholding agent, as Tasse → Impostazioni. null means not set: the deadlines that depend on it are left out of the tax calendar (missing_settings). Both key modes.