Invoices

Count invoices per payment state

Returns how many invoices are pending payment vs fully settled, for the tab counters above the mobile list. Accepts the same filters as GET /v1/invoices minus payment_filter and pagination (q, from/to/preset with the same date-filter semantics), so the numbers always match what the list shows. The applied range is echoed in date_filter.

get/v1/invoices/payment-counts

Request

  • Base URL: https://api.officina.it
  • URL: https://api.officina.it/v1/invoices/payment-counts
  • Auth: HTTP bearer

Query parameters

qstring

Substring match on invoice display fields.

fromstring date
tostring date
preset'rel30' | 'rel90' | 'rel365' | 'year' | 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'month' | 'custom' | 'all'

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.

fiscal_statusstring

Filtra per stato fiscale del documento.

Response

Counts per payment state.

object'invoice_payment_counts' required
pendinginteger required
settledinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.