VAT settlement (liquidazione) of a month or quarter
The liquidazione IVA computed now from the VAT registers, in the rows of the LIPE (VP2–VP14): VAT due and deducted, debt up to €100 or credit carried from the previous period of the same year (saved, or else computed by getbeel from its registers: see previous), prior-year credit used, 1% interest for quarterly payers, acconto in December/Q4. amount_to_pay is what the F24 pays now. The period must match the VAT periodicity set in the app. saved is the version last saved with POST /v1/filings (type vat_payment), which the LIPE reports. Always to check ("da verificare").
The liquidazione IVA computed now from the VAT registers, in the rows of the LIPE (VP2–VP14): VAT due and deducted, debt up to €100 or credit carried from the previous period of the same year (saved, or else computed by getbeel from its registers: see previous), prior-year credit used, 1% interest for quarterly payers, acconto in December/Q4. amount_to_pay is what the F24 pays now. The period must match the VAT periodicity set in the app. saved is the version last saved with POST /v1/filings (type vat_payment), which the LIPE reports. Always to check ("da verificare").
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
period*stringA month (monthly VAT) or a quarter (quarterly VAT), as the company settles VAT
^\d{4}-(Q[1-4]|0[1-9]|1[0-2])$OK
application/json- response
object*stringperiod*stringperiodicity*string"monthly""quarterly"start*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])))$dateend*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])))$datecurrency*stringlipe*result*stringVP14: positive to pay, negative a credit
^-?\d+\.\d{2}$amount_to_pay*stringWhat the F24 pays now: 0.00 for a credit, for up to €100 carried to the next period, and for Q4 of quarterly payers (paid with the annual balance)
^-?\d+\.\d{2}$carried_debt*stringDecimal amount as a string
^-?\d+\.\d{2}$carried_credit*stringDecimal amount as a string
^-?\d+\.\d{2}$tax_code*string|nulldue_date*|nullnotes*array<>previous*|Where VP7 / VP8 come from: the previous period of the same year. null for the first period of the year, or when Getbeel has no earlier data that year (notes: previous_missing; send previous_credit / previous_debt)
inputs*registers*saved*|The liquidazione as last saved (POST /v1/filings type vat_payment); the LIPE reports saved ones
computed_at*stringWhen these numbers were computed. They are recomputed from the registers on every read, so they include every document in Getbeel up to now
^(?:(?:\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-timereliable*booleannote*stringcurl -X GET 'https://www.getbeel.com/api/v1/companies/me/vat-settlements?period=2026-Q3'{ "object": "vat_settlement", "period": "string", "periodicity": "monthly", "start": "2026-10-29", "end": "2026-10-29", "currency": "EUR", "lipe": { "operations_active": "122.00", "operations_passive": "122.00", "vat_due": "122.00", "vat_deducted": "122.00", "vat_balance_debit": "122.00", "vat_balance_credit": "122.00", "previous_debt": "122.00", "previous_credit": "122.00", "annual_credit": "122.00", "car_payments": "122.00", "tax_credits": "122.00", "interest": "122.00", "advance": "122.00", "advance_method": -9007199254740991, "amount_due": "122.00", "amount_credit": "122.00" }, "result": "122.00", "amount_to_pay": "122.00", "carried_debt": "122.00", "carried_credit": "122.00", "tax_code": "6010", "due_date": "2026-10-29", "notes": [ "interest_added" ], "previous": { "period": "string", "source": "saved", "carried_credit": "122.00", "carried_debt": "122.00" }, "inputs": { "previous_credit": "122.00", "previous_debt": "122.00", "annual_credit_used": "122.00", "advance": "122.00", "advance_method": -9007199254740991 }, "registers": { "sales": { "documents": -9007199254740991, "taxable": "122.00", "vat": "122.00", "vat_counted": "122.00", "excluded": -9007199254740991, "adjusted": -9007199254740991, "to_review": -9007199254740991, "by_rate": [ { "rate": "122.00", "natura": "string", "taxable": "122.00", "vat": "122.00" } ] }, "purchases": { "documents": -9007199254740991, "taxable": "122.00", "vat": "122.00", "vat_counted": "122.00", "excluded": -9007199254740991, "adjusted": -9007199254740991, "to_review": -9007199254740991, "by_rate": [ { "rate": "122.00", "natura": "string", "taxable": "122.00", "vat": "122.00" } ] }, "missing": -9007199254740991 }, "saved": { "id": "string", "result": "122.00", "amount_to_pay": "122.00", "updated_at": "2019-08-24T14:15:22Z", "outdated": true }, "computed_at": "2019-08-24T14:15:22Z", "reliable": false, "note": "string"}VAT registers of a month or quarter GET
Registro IVA vendite and acquisti, row by row with the amounts per rate and natura: issued e-invoices accepted by SDI (credit notes subtract; split payment recorded but not due; deferred VAT counted when paid or after a year), supplier invoices as soon as the AI has read them, those not reviewed yet flagged unreviewed (by the period of receipt; foreign VAT never counts) and autofatture TD16–TD19/TD28 on both sides (reverse charge). vat_counted is what enters the liquidazione after the user's exclusions and adjustments (made in the app, with a reason). missing lists the documents of the period not in the registers yet. Always to check ("da verificare").
Management report: P&L, cash flow or receivables aging GET
Management figures from the invoices and bank movements in getbeel, net of VAT: NOT the statutory financial statements (bilancio), always to check with the accountant ("da verificare"). profit-and-loss: revenue from issued e-invoices accepted by SDI and costs from reviewed supplier invoices, by document date as the competence date (art. 2423-bis c.c.); credit notes subtract; autofatture and other VAT-only documents (TD16–TD23, TD27–TD29) are left out; TD26 (fixed-asset sales) and documents still at SDI or not reviewed are listed in not_included. cash-flow: money in and out of the bank accounts (uploaded statements and connected banks) by booking date, outflows by the category of the matched supplier invoice; payments recorded on issued invoices are shown apart. aging: what customers still owe on issued invoices today, by days past the due date (not due, 1–30, 31–60, 61–90, over 90); without a due date, 30 days after the invoice date (art. 4 D.Lgs. 231/2002). period, from and to are ignored. period is a year (2026), quarter (2026-Q3) or month (2026-10), or send from and to (at most two years); default the current year.