Onboarding a new company

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.