GetbeelDocs

Create a quote

Same customer, lines, payment and notes as POST /invoices, plus valid_until. Numbered per year (12/2026), separately for test and live keys.

POST
/quotes

Same customer, lines, payment and notes as POST /invoices, plus valid_until. Numbered per year (12/2026), separately for test and live keys.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Idempotency-Key?string

Recommended. 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.

Lengthlength <= 255
Getbeel-Company?string

Act 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.

Formatuuid
application/json
  1. body
customer*

The buyer (CessionarioCommittente): denominazione, or nome and cognome; partita_iva or codice_fiscale; address; codice_destinatario or pec for delivery

date?string

Quote date (default: today in Italy)

Match^(?:(?:\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])))$
Formatdate
currency*string

ISO 4217 currency code; default EUR

Match^[A-Z]{3}$
Default"EUR"
lines*array<>

Invoice lines (DettaglioLinee), 1–200

Items1 <= items <= 200
withholding?

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?string

Printed on the invoice as its Causale

Length1 <= length <= 1000
valid_until?string

Last day the offer holds

Match^(?:(?:\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])))$
Formatdate

Corpo della risposta

OK

application/json
  1. response
object*string
id*string
livemode*boolean
number*string

Number and year, one sequence per year

status*string

draft → sent (emailed) → accepted or declined; a draft or sent quote past valid_until reads as expired

Value in"draft""sent""accepted""declined""expired"
date*string
Match^(?:(?:\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])))$
Formatdate
valid_until*|null
customer*
lines*array<>
notes*string|null
currency*string
amount_subtotal*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
amount_tax*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
amount_total*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
invoice_id*|

The invoice draft created by POST /quotes/{id}/convert

sent_at*|null
accepted_at*|null
declined_at*|null
converted_at*|null
created_at*string
Match^(?:(?:\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))$
Formatdate-time
updated_at*string
Match^(?:(?:\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))$
Formatdate-time
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/quotes' \  -H 'Content-Type: application/json' \  -d '{  "customer": {    "country": "IT"  },  "currency": "EUR",  "lines": [    {      "description": "Consulenza ottobre 2026",      "unit_price": "100.00"    }  ]}'
Esempio di risposta
{  "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"}