GetbeelDocs

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

GET
/companies/me/vat-registers

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

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

period*string

A month (2026-10) or a quarter (2026-Q3)

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

Response Body

OK

application/json
  1. response
object*string
period*string
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
sales*
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*string

When the registers were computed: they are rebuilt from the documents on every read

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
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/vat-registers?period=2026-Q3'
Example Response
{  "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"}