Electronic receipts with AdE - Documento Commerciale on line
Voucherly issues legally compliant electronic receipts by integrating directly with the official web procedure of the Italian Revenue Agency (Agenzia delle Entrate) called "Documento Commerciale on line". When your customer pays, Voucherly authenticates on Fisconline on your behalf and generates the commercial document, ready to print or send by email.
In this guide you will see how to obtain your Fisconline credentials, grant the delegation for companies/associations where needed, and connect everything to Voucherly in a few minutes.
With ruling no. 413 of 25/09/2020, the Italian Revenue Agency confirmed that the web procedure for issuing online commercial documents (electronic receipts) can be automated via software. Read the official ruling no. 413/2020.
To issue the receipt correctly, you must include the VAT rates in the details of every payment request. Voucherly forwards this information directly to the Revenue Agency: without VAT, a valid commercial document cannot be generated.
Prerequisites
What you need depends on the legal form of your business:
- Sole proprietorship — the owner's SPID or CIE credentials are enough. You can skip the delegation step and go straight to Obtain your Fisconline credentials.
- Company, association or entity — you need the SPID / CIE credentials of the legal representative, and you must first grant a delegation on Fisconline to the individual who will manage the integration.
In both cases we recommend a device with a large screen (PC or tablet) for the procedures on the Revenue Agency portal.
The procedure to obtain Fisconline credentials issued directly to the company is slow and cumbersome. It is much faster to grant a delegation to an individual and use their personal Fisconline credentials.
Grant the delegation on Fisconline (companies only)
This procedure is only required for companies, associations and entities. Sole proprietorships can skip to the next section.
- Log in to the Revenue Agency portal using the legal representative's SPID.
- Click "Profilo utente", then in the left-hand bar select "Incarichi".
- In the delegation management section click "Come rappresentante legale".
- Enter the organization's tax code or VAT number.
- Click "Aggiungi gestore incaricato" and enter the tax code of the individual who will operate on behalf of the company (typically the legal representative themselves).
The delegate designated in this way is the person whose Fisconline credentials you will enter in Voucherly in the next step.
Obtain your Fisconline credentials
The Fisconline credentials (tax code + password + 10-digit PIN) allow Voucherly to authenticate on the Revenue Agency portal without manual intervention.
- Log in to the Revenue Agency portal with your personal SPID or CIE credentials.
- In the top right, make sure you are in individual mode. If a VAT number is selected, click "Cambia Utenza" and switch to the individual.
- Open "Il tuo profilo" and, in the Contatti section, make sure there is at least one email contact with all the checkboxes enabled: it is used to receive the second part of the PIN and the initial password by email.
- In the left panel click "Credenziali / PIN" and then "Prelievo credenziali".
- Note down the first 4 digits of the PIN shown on screen. The remaining 6 digits of the PIN and the initial password will be sent to you by email: together with the 4 on screen they form a complete 10-digit PIN (exactly what Voucherly asks for).
- Reset the initial password on the Fisconline password reset page: use the initial password received by email to set a new one of your choice. It is this new password that you will enter in Voucherly.
The password you receive by email is only for the first reset. Keep it — you will need it for any future resets — but do not use it to log in to Fisconline or to configure Voucherly: always use the password you set yourself in step 6.
Configure Voucherly
Once you have the delegate's tax code, the company's VAT number, the final password and the 10-digit PIN, activation on Voucherly takes just a few seconds.
- Log in to the Voucherly Dashboard.
- Go to Attività > Integrazioni and select AdE - Documento Commerciale on line.
- Click Configura (the pencil icon in the top right).
- Enter the Revenue Agency credentials:
- Codice Fiscale (the delegate — the individual)
- Partita IVA (company)
- Password (the final one set during the reset)
- PIN (10 digits: 4 on screen + 6 by email)
- Save the settings and click Attiva.
If activation is successful, the integration switches to the Active state and Voucherly starts issuing commercial documents on every successful payment.
Important notes
Automatic password rotation every 90 days
The Italian Revenue Agency requires the Fisconline password to expire every 90 days. To avoid service interruptions, Voucherly changes the password on its own before it expires. Once the integration is active, the configured password changes over time and no longer matches the one you entered initially.
Because of the automatic rotation, the same Fisconline credentials cannot be used in parallel on other systems (cash-register software, third-party software, manual portal access): as soon as Voucherly rotates the password, the other system would be left with credentials that are no longer valid.
If you need to issue commercial documents from another application as well, grant a second Fisconline delegation to another individual and use those — separate — credentials on the other system.
VAT rates on every payment request
As mentioned at the beginning, every line of the payment request must include the VAT rate: without it, the Revenue Agency rejects the issuance of the commercial document.