Skip to main content
Download OpenAPI

F24 massive download

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

The company you want to download the F24 forms 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
  • F24 forms may not be available in real time in the "Cassetto Fiscale", it may take up to 72 hours.

How to schedule F24 forms download​

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

POST /schedule/f24-download/{fiscal_id}
Content-Type: application/json
Accept: application/json

By calling this API you are scheduling the download of F24 forms 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 05:00 UTC, each run will download all the F24 forms related to the past 30 days and that are not yet downloaded.

Pricing

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

Sandbox

Scheduled downloads are not available in the sandbox environment: every call to /schedule/f24-download/{fiscal_id}, including the GET one, returns 402 Payment Required. The same applies to storing the "Cassetto Fiscale" credentials, so the whole F24 download flow is only available in production.

Retrieve scheduled download information​

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

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

Delete scheduled download​

You can delete the scheduled download of F24 forms by using the API DELETE /schedule/f24-download/{fiscal_id}. The API will return a 204 No Content response and any pending job created by the schedule is removed.

How to create an F24 form download request​

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

POST /jobs/f24-download
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"
}

The requested date range is bound: from_date cannot be earlier than the 1st of January of the previous year, and to_date cannot be later than the day the job runs. Dates outside these bounds return a 400 Bad Request response listing the offending fields in violations.

How to retrieve the downloaded F24 forms​

You can retrieve the downloaded F24 forms by using the API GET /f24-forms.

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

For each downloaded F24 form you will be able to:

Last updated on