---
title: "One card of the Fiscale report"
method: GET
path: "/v1/reports/fiscal/{widget}"
tags: ["Reports"]
---

# One card of the Fiscale report

`GET /v1/reports/fiscal/{widget}`

## Request

- Base URL: `https://api.officina.it`
- URL: `https://api.officina.it/v1/reports/fiscal/{widget}`
- Auth: HTTP bearer

One Fiscale card for a liquidation period (`period`, from
`GET /v1/reports/fiscal`; default the last completed one). `kpis` and
`iva` carry the same liquidation (`VATSummary`); `deadlines` does not
depend on the period. Hidden (`visible: false`) until the profile is
complete, and for the forfettario. Needs `prices.read` too.

## Query parameters

- `period` string

## Response `200`

The card.

- ReportFiscalWidgetEnvelope
  - `object` 'report_fiscal_widget', required
  - `widget` string, required
  - `period` ReportVATPeriod, required
    - `key` string
    - `label` string
    - `from` string, date
    - `to` string, date
    - `current` boolean: Still running today.
    - `due_date` string, date: F24 deadline.
    - `due_code` string: Codice tributo.
  - `visible` boolean, required
  - `data` union, required
    - ReportVATSummary: `kpis` / `iva`: the liquidation. `status`: nothing, credit (carried over; `to_pay` is the credit), below_minimum (under 25,82 €: carried over) or due. Quarterly adds 1% interest. `split_payment`: IVA on split-payment invoices, listed but not owed by the shop.
      - `debit` number
      - `credit` number
      - `balance` number
      - `interest` number
      - `to_pay` number
      - `status` 'nothing' | 'credit' | 'below_minimum' | 'due'
      - `quarterly` boolean
      - `sales_documents` integer
      - `purchase_documents` integer
      - `split_payment` number
      - `due_date` string, date
      - `due_code` string
      - `days_until_due` integer
    - ReportVATRates: `rates`: IVA per aliquota. `kind` margin groups vehicle sales and rentals with other rates or the margin scheme.
      - `rates` object[]
        - `kind` 'rate' | 'exempt' | 'margin'
        - `rate` number
        - `vat_code` string
        - `label` string
        - `imponibile` number
        - `imposta` number
      - `total_imponibile` number
      - `total_imposta` number
      - `split_payment` number
    - ReportVATHistory: `history`: the balance of the period and the 3 before it, oldest first.
      - `periods` object[]
        - `key` string
        - `short_label` string
        - `balance` number
    - ReportVATAdvance: `advance`: acconto IVA due 27/12. Storico: 88% of the last period of the year before (under 103,29 € not paid); previsionale: computed by the commercialista, `amount` null.
      - `method` 'storico' | 'previsionale'
      - `status` 'due' | 'below_minimum' | 'previsionale'
      - `amount` number, nullable
      - `base` number, nullable
      - `base_period` ReportVATPeriod
        - `key` string
        - `label` string
        - `from` string, date
        - `to` string, date
        - `current` boolean: Still running today.
        - `due_date` string, date: F24 deadline.
        - `due_code` string: Codice tributo.
      - `due_date` string, date
      - `tax_code` '6013' | '6035'
    - ReportVATDeadlines: `deadlines`: the next IVA payments from today, soonest first, at most 4.
      - `deadlines` object[]
        - `date` string, date
        - `kind` 'liquidation' | 'advance'
        - `label` string
        - `period_key` string
        - `days_until` integer
        - `next` boolean
    - ReportVATExportCounts: `export`: how many documents the period export holds.
      - `sales_documents` integer
      - `purchase_documents` integer

## Other responses

- `401`: Missing, malformed, expired, or wrong-audience bearer token.
- `402`: The company has no active subscription, or its plan does not include API access. API access is included in the Business and Illimitato plans.
- `403`: The authenticated user lacks the required permission.
- `404`: Resource does not exist OR belongs to a different company. The two cases are intentionally indistinguishable.
- `500`: Unhandled server error. Detail is logged, not exposed.

---

[API](https://skmtc.dev/officina/apis/officina-it-api.md) · [All operations](https://skmtc.dev/officina/apis/officina-it-api/llms.txt) · [OpenAPI document](https://skmtc.dev/officina/apis/officina-it-api/revisions/7da3fccfe551?raw)