VAT for a month or quarter (estimate)
Sales VAT from the issued e-invoices accepted by SDI (credit notes subtract, split payment left out, deferred VAT apart) and an estimate of purchase VAT from reviewed supplier invoices in euros. reliable is always false: deductibility, the month of receipt and reverse charge are not known, so treat it as an estimate to check with the accountant ("da verificare"). It is never used for an F24.
Sales VAT from the issued e-invoices accepted by SDI (credit notes subtract, split payment left out, deferred VAT apart) and an estimate of purchase VAT from reviewed supplier invoices in euros. reliable is always false: deductibility, the month of receipt and reverse charge are not known, so treat it as an estimate to check with the accountant ("da verificare"). It is never used for an F24.
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*stringno_vat_regime*booleanvat_periodicity*|nullsales_vat*stringDecimal amount as a string
^-?\d+\.\d{2}$sales_invoices*integer-9007199254740991 <= value <= 9007199254740991deferred_sales_vat*stringDecimal amount as a string
^-?\d+\.\d{2}$split_payment_invoices*integer-9007199254740991 <= value <= 9007199254740991purchase_vat_estimate*stringDecimal amount as a string
^-?\d+\.\d{2}$purchase_invoices*integer-9007199254740991 <= value <= 9007199254740991purchases_skipped_foreign_currency*integer-9007199254740991 <= value <= 9007199254740991balance_estimate*stringPositive: VAT to pay; negative: credit. An estimate.
^-?\d+\.\d{2}$reliable*booleannote*stringcurl -X GET 'https://www.getbeel.com/api/v1/companies/me/vat-position?period=2026-Q3'{ "object": "vat_position", "period": "string", "start": "2026-10-29", "end": "2026-10-29", "currency": "EUR", "no_vat_regime": true, "vat_periodicity": "monthly", "sales_vat": "122.00", "sales_invoices": -9007199254740991, "deferred_sales_vat": "122.00", "split_payment_invoices": -9007199254740991, "purchase_vat_estimate": "122.00", "purchase_invoices": -9007199254740991, "purchases_skipped_foreign_currency": -9007199254740991, "balance_estimate": "122.00", "reliable": false, "note": "string"}The tax calendar as an iCal feed GET
For Google, Outlook or Apple calendars. Authenticated by the secret feed token from the app (Taxes → Add to calendar), not by an API key; rotating it there cuts off old subscriptions. Unknown tokens get 404.
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).