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

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

You can find a guide for the company on how to appoint an Appointee here.

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