Update a quote
Not after it was converted (quote_converted) or accepted (quote_not_editable).
Not after it was converted (quote_converted) or accepted (quote_not_editable).
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-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
customer?The buyer (CessionarioCommittente): denominazione, or nome and cognome; partita_iva or codice_fiscale; address; codice_destinatario or pec for delivery
currency?stringISO 4217 currency code; default EUR
^[A-Z]{3}$"EUR"lines?array<>Invoice lines (DettaglioLinee), 1–200
1 <= items <= 200withholding?Ritenuta d'acconto: income tax the customer withholds from the payment and pays to the State on the issuer's behalf (DatiRitenuta). Omit when there is none.
cassa_previdenziale?Cassa previdenziale: the professional's social-security contribution charged to the customer (DatiCassaPrevidenziale), e.g. the 4% INPS rivalsa. Omit when there is none.
payment?Payment terms printed on the invoice (DatiPagamento): method, terms, due date and bank details
notes?stringPrinted on the invoice as its Causale
1 <= length <= 1000valid_until?|Last day the quote is valid (YYYY-MM-DD); null removes it
OK
application/json- response
object*stringid*stringlivemode*booleannumber*stringNumber and year, one sequence per year
status*stringdraft → sent (emailed) → accepted or declined; a draft or sent quote past valid_until reads as expired
"draft""sent""accepted""declined""expired"date*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])))$datevalid_until*|nullcustomer*lines*array<>notes*string|nullcurrency*stringamount_subtotal*stringDecimal amount as a string
^-?\d+\.\d{2}$amount_tax*stringDecimal amount as a string
^-?\d+\.\d{2}$amount_total*stringDecimal amount as a string
^-?\d+\.\d{2}$invoice_id*|The invoice draft created by POST /quotes/{id}/convert
sent_at*|nullaccepted_at*|nulldeclined_at*|nullconverted_at*|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 PATCH 'https://www.getbeel.com/api/v1/quotes/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "object": "quote", "id": "qt_5b0e…", "livemode": true, "number": "12/2026", "status": "draft", "date": "2026-10-29", "valid_until": "2026-10-29", "customer": { "name": "string", "email": "string", "partita_iva": "string", "codice_fiscale": "string", "country": "string", "address": "string", "postal_code": "string", "city": "string", "province": "string", "codice_destinatario": "string", "pec": "string" }, "lines": [ { "description": "string", "quantity": 0, "unit_price": 0, "unit": "string", "vat_rate": 0, "natura": "string", "amount": "122.00" } ], "notes": "string", "currency": "string", "amount_subtotal": "122.00", "amount_tax": "122.00", "amount_total": "122.00", "invoice_id": "string", "sent_at": "2019-08-24T14:15:22Z", "accepted_at": "2019-08-24T14:15:22Z", "declined_at": "2019-08-24T14:15:22Z", "converted_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}