GetbeelDocs

Management report: P&L, cash flow or receivables aging

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.

GET
/companies/me/reports/{type}

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

type*string
Value in"profit-and-loss""cash-flow""aging"

Parametri query

period?string

A year (2026), quarter (2026-Q3) or month (2026-10). Default: the current year. Not used by aging

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

First day, with to, instead of period (at most two years)

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
to?string

Last day, with from

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

Corpo della risposta

OK

application/json
  1. response
object*string
type*string
Value in"profit_and_loss""cash_flow""aging"
period*string|null
start*|null
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
management_figures*boolean
reliable*boolean
note*string
profit_and_loss?
cash_flow?
aging?
Esempio di richiesta
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/reports/profit-and-loss'
Esempio di risposta
{  "object": "report",  "type": "profit_and_loss",  "period": "string",  "start": "2026-10-29",  "end": "2026-10-29",  "currency": "EUR",  "management_figures": true,  "reliable": false,  "note": "string",  "profit_and_loss": {    "revenue": {      "sales": "122.00",      "credit_notes": "122.00",      "total": "122.00",      "documents": -9007199254740991    },    "costs": {      "purchases": "122.00",      "credit_notes": "122.00",      "total": "122.00",      "documents": -9007199254740991,      "by_category": [        {          "category": "string",          "label": "string",          "amount": "122.00",          "documents": -9007199254740991        }      ]    },    "result": "122.00",    "by_month": [      {        "month": "2026-10",        "revenue": "122.00",        "costs": "122.00",        "result": "122.00"      }    ],    "not_included": {      "pending_sdi": {        "documents": -9007199254740991,        "amount": "122.00"      },      "unreviewed_purchases": {        "documents": -9007199254740991,        "amount": "122.00"      },      "asset_sales": {        "documents": -9007199254740991,        "amount": "122.00"      },      "foreign_currency": {        "documents": -9007199254740991      }    }  },  "cash_flow": {    "inflows": "122.00",    "outflows": "122.00",    "net": "122.00",    "movements": -9007199254740991,    "outflows_by_category": [      {        "category": "string",        "label": "string",        "amount": "122.00",        "movements": -9007199254740991      }    ],    "by_month": [      {        "month": "string",        "inflows": "122.00",        "outflows": "122.00",        "net": "122.00"      }    ],    "invoice_payments_recorded": {      "amount": "122.00",      "payments": -9007199254740991    },    "not_included": {      "foreign_currency": {        "movements": -9007199254740991      }    }  },  "aging": {    "as_of": "2026-10-29",    "total": "122.00",    "overdue": "122.00",    "documents": -9007199254740991,    "buckets": [      {        "bucket": "not_due",        "amount": "122.00",        "documents": -9007199254740991      }    ],    "customers": [      {        "customer_name": "string",        "customer_vat": "string",        "total": "122.00",        "overdue": "122.00",        "documents": -9007199254740991      }    ],    "invoices": [      {        "id": "string",        "number": "string",        "date": "2026-10-29",        "due_date": "2026-10-29",        "due_date_assumed": true,        "customer_name": "string",        "customer_vat": "string",        "outstanding": "122.00",        "days_overdue": -9007199254740991,        "bucket": "not_due"      }    ],    "has_more": true,    "not_included": {      "foreign_currency": {        "documents": -9007199254740991      }    }  }}

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

ZIP for the accountant (XML, prima nota, VAT registers) GET

Everything an accountant imports for a year, quarter or month: the FatturaPA XML files of issued invoices (as sent to SDI), of received invoices (as received, or the attached file) and of the autofatture getbeel sent; prima-nota-iva.csv (one line per document and VAT rate or natura, with the XML file name); the VAT registers of each settlement period (CSV); bank movements (CSV); and LEGGIMI.txt listing any file that could not be read. Accounting packages (TeamSystem, Zucchetti, Profis and others) import the XML files with their e-invoice import; no vendor-specific layout is produced. CSV: semicolon, decimal comma, UTF-8. Italian companies only. Needs the invoices:read, received_invoices:read and bank:read scopes too. 422 too_many_documents when the period is too large for one file: ask for a quarter or a month.