VAT registers of a month or quarter
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").
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").
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
period*stringA month (2026-10) or a quarter (2026-Q3)
^\d{4}-(Q[1-4]|0[1-9]|1[0-2])$OK
application/json- response
object*stringperiod*stringstart*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*stringsales*purchases*missing*array<>Documents of the period that are not in the registers yet: purchases the AI is still reading (processing), amounts without euro values, invoices and autofatture waiting for SDI, and foreign purchases whose reverse-charge TD17/TD18/TD19 was not sent to SDI yet (autofattura_missing, due by the 15th of the next month). Unreviewed purchases are in the registers, flagged unreviewed
computed_at*stringWhen the registers were computed: they are rebuilt from the documents on every read
^(?:(?:\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-registers?period=2026-Q3'{ "object": "vat_registers", "period": "string", "start": "2026-10-29", "end": "2026-10-29", "currency": "EUR", "sales": { "rows": [ { "key": "string", "source": "issued_invoice", "document_id": "string", "number": "string", "date": "2026-10-29", "received_date": "2026-10-29", "counterparty_name": "string", "counterparty_vat": "string", "tipo_documento": "string", "breakdown": [ { "rate": "122.00", "natura": "string", "taxable": "122.00", "vat": "122.00" } ], "taxable": "122.00", "vat": "122.00", "vat_counted": "122.00", "counted": true, "flags": [ "credit_note" ], "adjustment": { "action": "exclude", "vat_amount": "122.00", "reason": "string" } } ], "totals": { "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": { "rows": [ { "key": "string", "source": "issued_invoice", "document_id": "string", "number": "string", "date": "2026-10-29", "received_date": "2026-10-29", "counterparty_name": "string", "counterparty_vat": "string", "tipo_documento": "string", "breakdown": [ { "rate": "122.00", "natura": "string", "taxable": "122.00", "vat": "122.00" } ], "taxable": "122.00", "vat": "122.00", "vat_counted": "122.00", "counted": true, "flags": [ "credit_note" ], "adjustment": { "action": "exclude", "vat_amount": "122.00", "reason": "string" } } ], "totals": { "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": [ { "source": "issued_invoice", "id": "string", "number": "string", "date": "2026-10-29", "name": "string", "reason": "processing" } ], "computed_at": "2019-08-24T14:15:22Z", "reliable": false, "note": "string"}Draft of the quarterly OSS return GET
For a company registered in the OSS union scheme: per Member State of the consumer, the taxable amount and the VAT of the quarter from the issued invoices with Natura N7 to EU consumers, at each State's standard rate on the invoice date (VAT rounded per line, then added up; vat_country_level shows the per-country computation, rounding_gap when they differ by more than €0.01). Credit notes on earlier quarters are corrections; a State's negative balance is refunded, never offset. doubtful lists the invoices that need a decision (reason). deadline is the nominal date, never moved; reference is the payment reference. Free and read-only: the return is entered and paid in the AdE Portale OSS with the company's own credentials, never with F24. reliable is always false (reduced rates and goods are not modelled).
VAT settlement (liquidazione) of a month or quarter GET
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").