Dealership report widget
the Situazione Concessionaria dashboard, mirroring the officina report surface (one route per widget, progressive loading, the same date filter as the list endpoints).
Widget keys:
kpis the web KPI row bundled: vehicles-sold, total-revenue, total-margin, average-days, average-profit-per-vehicle, immobilized-capital, loss-sales-percentage, average-markup-percentage — each with the previous-period delta sales-chart revenue + margin series per period bucket top-profitable-sales ranked best sales by profit bottom-profitable-sales ranked worst sales by profit top-giacenza-sales fastest vehicles (lowest days in stock) bottom-giacenza-sales slowest vehicles (highest days in stock)
Gate: dealership.read + reports.read, like the web dashboard (the module flag gates the menu client-side).
Request
- Base URL: https://api.officina.it
- URL: https://api.officina.it/v1/dealership-report/{widget}
- Auth: HTTP bearer
Query parameters
Inizio dell'intervallo, formato YYYY-MM-DD.
Date filter preset. Relative presets (rel30/rel90/rel365) are resolved server-side from "now" and ignore from/to. Absolute presets (year, Q1-Q4, month, custom) require both from and to. all returns everything (no time bound). Unknown values are rejected with 422.
Omitting from/to/preset gives the default window, the last 12 months. This tier is stateless: a selection applies to the request that carries it and is never stored, so the same request always covers the same range. The effective range is echoed back in date_filter.
Fine dell'intervallo, formato YYYY-MM-DD.
Response
success
Changes
No recorded changes to this operation across all 1 revision of this API.