Massive download from "Cassetto Fiscale"

With A-Cube platform you can download invoices that are in the "Cassetto Fiscale" for a given company.

The company you want to download the invoices for must be set up in the A-Cube platform and you must have the credentials to access the "Cassetto Fiscale" portal.

Follow our guide to onboard a company and set up the credentials to access the "Cassetto Fiscale" portal.

Please note that
  • Invoices may not be available in real time in the "Cassetto Fiscale", it may take up to 72 hours.
  • The electronic invoice files issued and received through the SdI are made available in the consultation area until December 31 of the year following the one in which the invoices were received by the Sistema di Interscambio.

How to schedule invoices download

You can schedule the download of invoices from the "Cassetto Fiscale" portal by using the API

Copy
Copied
POST /schedule/invoice-download/{fiscal_id}
Content-Type: application/json
Accept: application/json

{
  "download_archive": false,
}

By calling this API you are scheduling the download of invoices for the Business Registry Configuration identified by {fiscal_id}. The API will return a 201 Created response if the request is valid and the download is scheduled.

By default, the schedule is set to run once per day at 03:00 UTC, each run will download all the invoices that have been issued or received in the past 3 days and that are not yet downloaded,

If you want to download the entire archive of invoices too, you can send the request with the following body:

Copy
Copied
POST /schedule/invoice-download/{fiscal_id}
Content-Type: application/json
Accept: application/json

{
  "download_archive": true,
}

In this case, the API will download all the invoices that are available from 1st Jan of the past year.

Pricing

The scheduled download of invoices is a paid service. Please contact our Sales Team for more information.

Retrieve scheduled download information

You can retrieve the status of the scheduled invoices download by using the API GET /schedule/invoice-download/{fiscal_id}. The API will return a 200 OK response with the following body:

Copy
Copied
{
    "enabled": false,
    "valid_until": null,
    "auto_renew": null
}

Delete scheduled download

You can delete the scheduled download of invoices by using the API DELETE /schedule/invoice-download/{fiscal_id}.

Disable scheduled download subscription

You can disable the subscription auto-renew by using the API PUT /schedule/invoice-download/{fiscal_id} and sending the following body:

Copy
Copied
{
    "auto_renew": false
}

How to create an invoice download request

If you don't want to schedule the download of invoices, you can create a single request to download invoices by using the Jobs API

Copy
Copied
POST /jobs/invoice-download/{fiscal_id}
Content-Type: application/json
Accept: application/json

{
  "from_date": "YYYY-MM-DD",
  "to_date": "YYYY-MM-DD",
  "fiscal_id": "the fiscal identifier of the company registered in the Business Registry Configuration",
}

How to retrieve the downloaded invoices

You can retrieve the downloaded invoices by using the API GET /invoices.

The daily job will download the invoices from the "Cassetto Fiscale" portal and make them available in the A-Cube platform.

For each downloaded invoice you will be able to:

And in general you will be able to execute any operation / API call available for the invoice.