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.
Warning

Only companies have the ability to designate a third party for sending receipts. Freelancers (liberi professionisti) and sole proprietorship (aziende individuali) cannot appoint a third party for this task, so they must submit their credentials.

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

The A-Cube platform will automatically send an email message to notify you of the expiration. Following the link inside that mail you will reach a guided procedure that will give you two choices:

  1. You can tell us the new Tax Authority password that you already changed on the Government portal.
  2. Change the Tax Authority password, letting us know the new value. (You obviously have to take note of the new password, that will be required to access the portal).

To create manually the link to start this procedure, you can call two APIs.

For updating a Business Registry Configuration password:

Copy
Copied
POST /business-registry-configurations/{fiscal_id}/credentials/fisconline/interactive

For updating an Appointee password:

Copy
Copied
POST /ade-appointees/{fiscal_id}/credentials/fisconline/interactive

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 by a legal representative of the company connecting to the Agenzia delle Entrate portal. Ask our support team to have a full guide on this.

info

Please note that the procedure that made use of SPID is no longer available.

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

Set up the appointee

If you are a reseller or a partner, you can ask A-Cube to set up the appointee for you by contacting A-Cube support

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. Legal representative of the fiscal entity has to log on the Agenzia delle Entrate portal to appoint the Appointee (ask our support team to have a full guide on this)
  5. Assign the BusinessRegistryConfiguration to the previously created AdEAppointee .

Please note that with this process:

  • 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.