Record a fee subject to withholding
A fee not received through SDI (paper invoice, notula of occasional work). withheld_amount is computed when left out. Live keys only (403 livemode_required). Free.
A fee not received through SDI (paper invoice, notula of occasional work). withheld_amount is computed when left out. Live keys only (403 livemode_required). Free.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255Getbeel-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.
uuidapplication/json- body
recipient*The percipiente: the professional or agent the fee is paid to
document?The invoice, parcella or notula (receipt for occasional work) the fee is billed on
invoice_id?stringThe received invoice (GET /received-invoices) it pays
1 <= length <= 100type*stringRT01 natural person, RT02 company or other entity
"RT01""RT01""RT02"causale*stringCU causale (punto 1): A lavoro autonomo abituale, M occasionale, Q/R provvigioni agente mono/plurimandatario, … (CU 2026 instructions)
"A""A""B""C""D""E""F""G""H""I""J""K""L""L1""M""M1""M2""N""O""O1""P""Q""R""S""T""U""V""V1""V2""W""X""Y""Z""ZO"rate*unknownDecimal string (or number)
gross_amount*unknownAmmontare lordo (CU punto 4): the fee net of VAT, without the contributo integrativo of the professional funds
not_subject_amount?unknownSums not subject to the ritenuta (CU punto 7), e.g. expenses advanced for you, the 50% of provvigioni. Default 0
withheld_amount?unknownRitenuta withheld (CU punto 9). Omit to compute (gross − not subject) × rate
paid_on?|The day the fee was paid: the ritenuta is made then (art. 25 DPR 600/1973) and paid with F24 1040 by the 16th of the next month
notes?stringFree-text note, up to 500 characters
length <= 500OK
application/json- response
id*stringobject*stringsource*stringsdi: read from the DatiRitenuta of an invoice received from SDI; manual: typed in
"sdi""manual"invoice_id*string|nullrecipient*document*type*string"RT01""RT02"causale*stringrate*stringDecimal amount as a string
^-?\d+\.\d{2}$gross_amount*stringCU punto 4
^-?\d+\.\d{2}$not_subject_amount*stringCU punto 7
^-?\d+\.\d{2}$taxable_amount*stringCU punto 8
^-?\d+\.\d{2}$withheld_amount*stringCU punto 9
^-?\d+\.\d{2}$tax_code*stringpaid_on*|nullperiod*|Month the ritenuta was made (the month of paid_on)
status*string"unpaid""withheld""remitted"due_date*|F24 deadline: the 16th of the next month, moved off holidays
overdue*booleanfiling_id*|The withholdings F24 that paid it (status remitted)
needs_review*booleanRead from an invoice whose figures need a check (notes says why)
notes*string|nullcreated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X POST 'https://www.getbeel.com/api/v1/withholdings' \ -H 'Content-Type: application/json' \ -d '{ "recipient": { "name": "Mario Rossi" }, "type": "RT01", "causale": "A", "rate": "20", "gross_amount": "1000.00"}'{ "id": "wht_3f2a…", "object": "withholding", "source": "sdi", "invoice_id": "string", "recipient": { "name": "string", "fiscal_code": "string", "vat": "string" }, "document": { "number": "string", "date": "2026-10-29" }, "type": "RT01", "causale": "string", "rate": "122.00", "gross_amount": "122.00", "not_subject_amount": "122.00", "taxable_amount": "122.00", "withheld_amount": "122.00", "tax_code": "1040", "paid_on": "2026-10-29", "period": "string", "status": "unpaid", "due_date": "2026-10-29", "overdue": true, "filing_id": "string", "needs_review": true, "notes": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}List withholdings (ritenute owed), newest first GET
Ritenute d’acconto the company withholds as sostituto d’imposta on fees paid to professionals and agents, one per received fee. Fees on professionals’ invoices received from SDI (DatiRitenuta RT01/RT02) are recorded on arrival; set paid_on when you pay the fee: the ritenuta is then due with F24 code 1040 by the 16th of the next month (art. 25 DPR 600/1973, art. 18 D.Lgs. 241/1997).
A withholding GET
Next Page