Cassetto Fiscale

Cassetto Fiscale is the Tax Authority portal where companies can manage their commercial documents (invoices, receipts, etc...).

A-Cube can manage the access to the portal on behalf of the company, acting as a proxy. The credentials that A-Cube can use are those named Fisconline credentials.

A-Cube can manage two different type of users for the Cassetto Fiscale portal:

• Business Registry Configuration: the company that wants to automate operations in the Tax Authority web portal.
• Appointee: a third party that acts on behalf of the company.

Which operations can be automated

By using the A-Cube API, you can automate the following operations on the Cassetto Fiscale portal:

• Manage Smart Receipt, the Smart Receipt is the online commercial document that replaces the issuance of a receipt via a telematic cash register.
• Download invoices: download invoices that have been sent or received through a third party provider.

Onboarding a Business Registry Configuration with credentials

Through an API call, it is possible to automate the onboarding procedure to enable a company to automate A-Cube services for the "Cassetto Fiscale" portal.

The required information is the Fisconline credentials:

• Tax code
• Password
• Pin

If the company does not have the credentials, it is possible to request them through the Government website.

During the first onboarding, the provided credentials will be validated.

Set up the company credentials

If the credentials are not correct, the API will return a 422 error.

Onboarding a Business Registry Configuration with an Appointee

If the company does not have the credentials to access the Tax Authority's "Fatture e corrispettivi" portal, or prefers not to use them, it is possible to appoint a third party to act on behalf of the company.

A-Cube offers a default appointee, or you can ask to create your own appointee for your direct customers.

To sum up, the process to onboard a Business Registry Configuration with an Appointee is the following:

1. Ask A-Cube to set up an Appointee. We need the name and the fiscal identifier of the individual who will act as appointee.
2. Use this API to store the Appointee password and PIN that are necessary to connect to the Agenzia delle Entrate portal.
3. Create a BusinessRegistryConfiguration for each fiscal entity that wants to automate access to the Agenzia delle Entrate portal.
4. Legal representative of the fiscal entity has to log on the Agenzia delle Entrate portal to appoint the Appointee (ask A-Cube support to have a full guide on this)
5. Assign the BusinessRegistryConfiguration to the previously created Appointee.

Please note that with this process:

• End customers are relieved from the responsibility of periodically renewing passwords in our applications.
• Only Appointee credentials are securely stored in our databases using encryption.
• Only the Appointee is required to inform us periodically of any password changes.

Password Management

The password for accessing the Tax Authority's "Fatture e corrispettivi" portal expires in 90 days.

The password provided during onboarding must be updated if:

• The password has expired
• The password has been changed

API

A Business Registry Configuration password can be updated by calling PUT /business-registry-configurations/{id}/credentials/fisconline

The Appointee password can be updated by calling PUT /ade-appointees/{id}/credentials/fisconline

EMAIL notification

The A-Cube platform will automatically send an email notification to inform you of the password expiration.

By following the link in the email, you will be guided through a procedure that offers two options:

1. Provide the new Tax Authority password that you have already updated on the Government portal.
2. Change the Tax Authority password by providing the new value, and A-Cube will communicate it to the Tax Authority. (Important: Make sure to note the new password, as it will be required to access the portal).