GetbeelDocs

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").

GET
/companies/me/vat-settlements

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").

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Parametri query

period*string

A month (monthly VAT) or a quarter (quarterly VAT), as the company settles VAT

Match^\d{4}-(Q[1-4]|0[1-9]|1[0-2])$

Corpo della risposta

OK

application/json
  1. response
object*string
period*string
periodicity*string
Value in"monthly""quarterly"
start*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
end*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
currency*string
lipe*
result*string

VP14: positive to pay, negative a credit

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

What 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)

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

Decimal amount as a string

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

Decimal amount as a string

Match^-?\d+\.\d{2}$
tax_code*string|null
due_date*|null
notes*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*string

When these numbers were computed. They are recomputed from the registers on every read, so they include every document in Getbeel up to now

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
reliable*boolean
note*string
Esempio di richiesta
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/vat-settlements?period=2026-Q3'
Esempio di risposta
{  "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.