Onboarding a new company

There are two methods for registering a new company:

1. By submitting the necessary credentials for the Tax Authority's "Fatture e corrispettivi" portal, which include the Tax Code, Pin, and Password.
2. By designating a third party to represent the company.

Onboarding with credentials

Through an API call, it is possible to automate the onboarding procedure to enable a company to send commercial documents to the Tax Authority.

The required information is the credentials to the Tax Authority's "Fatture e corrispettivi" portal:

• 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 you don't have the BusinessRegistryConfiguration in place you can create it with the following API: POST /business-registry-configuration. Remember to set "receipts_enabled": true.

Store the credentials in the BusinessRegistryConfiguration entity by using the API PUT /business-registry-configurations/{id}/credentials/fisconline

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

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

If the password has been changed but not communicated via API to A-Cube, on the first authentication error, A-Cube will send a message via webhook to your platform.

Onboarding with a third party

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

The third party is an entity that in the A-Cube Platform is named Appointee.

An Appointee must have its own credentials to access the Tax Authority's "Fatture e corrispettivi" portal. The company must appoint the Appointee to act on its behalf. This can be accomplished with SPID authentication of the legal representative of the company using this endpoint: POST /business-registry-configuration/{fiscal_id}/appoint/spid.

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

To sum up, the process that involves an AdE Appointee is as follows:

1. Ask A-Cube to set up an AdE Appointee. We need the name and the fiscal id of this person .
2. Use this API to store the Appointee password and PIN that are necessary for connecting to the Agenzia delle Entrate portal. The same API has to be periodically called to tell us the user renewed password on AdE website.
3. Create a BusinessRegistryConfiguration for each fiscal entity that wants to send smart receipts. Please remember to set "receipts_enabled": true
4. Appoint the previously created AdEAppointee , identified by the appointee_fiscal_id parameter in the body of the request. The procedure requires the use of SPID by a legal representative of the company that will send the receipts. The legal representative will also need to digitally sign an agreement document using an OTP password that will be sent by SMS to the provided cell phone number.

Please note that with this process:

• end customers' SPID credentials do not pass through our systems;
• end customers do not have the burden of periodically renewing passwords on our applications;
• only AdEAppointee credentials are stored under encryption in our databases;
• only the AdEAppointee will have to notify us periodically of password changes.