Skip to main content

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.

Official response from the Italian Revenue Agency

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.

VAT rates are mandatory

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.

We advise against company Fisconline credentials

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.

  1. Log in to the Revenue Agency portal using the legal representative's SPID.
  2. Click "Profilo utente", then in the left-hand bar select "Incarichi".
  3. In the delegation management section click "Come rappresentante legale".
  4. Enter the organization's tax code or VAT number.
  5. 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.

  1. Log in to the Revenue Agency portal with your personal SPID or CIE credentials.
  2. 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.
  3. 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.
  4. In the left panel click "Credenziali / PIN" and then "Prelievo credenziali".
  5. 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).
  6. 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 initial password is not used to log in

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.

  1. Log in to the Voucherly Dashboard.
  2. Go to Impostazioni > Scontrini e fatture and enable the Scontrino elettronico option.
  3. In the Configurazione AdE box, open the credentials form and enter the Revenue Agency credentials:
    • Utente (the delegate's tax code — the individual)
    • Partita IVA (company)
    • Password (the final one set during the reset)
    • PIN (10 digits: 4 on screen + 6 by email)
  4. Save the settings.

Once saved, Configurazione AdE shows the Configurato status and, with Scontrino elettronico enabled, 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.

The credentials are dedicated to Voucherly

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.

Troubleshooting​

When you save your credentials in Impostazioni > Scontrini e fatture > Configurazione AdE, Voucherly logs in to the Revenue Agency portal in several steps. If something goes wrong, the message shown tells you at which step the login stopped. Find the message you received below and how to fix it.

"Credenziali Fisconline non valide" (invalid Fisconline credentials)​

Credenziali Fisconline non valide. Controlla Utente, Password e PIN inseriti.

The Fisconline login was rejected: one of Utente, Password or PIN is wrong. Check that:

  • Utente is the tax code of the delegated individual, not the VAT number;
  • Password is the final one you set during the reset, not the initial password received by email;
  • PIN is made up of 10 digits: 4 shown on screen + 6 received by email.
tip

If in doubt, repeat the Fisconline credentials retrieval procedure and reset the password.

"Nessun incarico trovato per la Partita IVA indicata" (no delegation found for the VAT number)​

Nessun incarico trovato per la Partita IVA indicata. Verifica di aver conferito l'incarico su Fisconline e che la Partita IVA sia corretta.

The login succeeded, but on the Revenue Agency portal the individual you are using is not delegated to operate for the VAT number provided.

  • Make sure you have granted the delegation on Fisconline to the individual whose credentials you are entering.
  • Check that the Partita IVA entered in Voucherly is the one of the company the delegation was granted for.
  • If you have just granted the delegation, wait a few minutes: the Revenue Agency may take a while to make it active.
Sole proprietorship

If you operate as a sole proprietorship, no delegation is required. Make sure you use the owner's Fisconline credentials and the business VAT number.

"Adesione ai servizi non attiva" (service membership not active)​

Accesso riuscito, ma l'adesione ai servizi di fatturazione e corrispettivi non risulta attiva sul portale AdE.

The credentials are valid, but on the Fatture e Corrispettivi portal the membership to the services required to issue the commercial document is not active.

Log in to the Fatture e Corrispettivi portal with the delegated user, complete the service membership, then try saving the credentials in Voucherly again.

"Revenue Agency portal unreachable" or temporary error​

Al momento non è possibile raggiungere il portale dell'Agenzia delle Entrate. Riprova tra qualche minuto.

Accesso riuscito, ma la configurazione non è andata a buon fine. Riprova, se il problema persiste contatta il supporto.

This is a temporary communication problem with the Revenue Agency systems (portal unreachable or unavailable at that moment).

Try again after a few minutes. If the error persists, write to support@voucherly.it stating the time of the attempt, or send a support request at voucherly.it/contattaci.

Frequently asked questions​

Can I use the same Fisconline credentials on my cash-register software too?

No. Voucherly automatically rotates the password every 90 days to comply with the Revenue Agency policy: at the next rotation your cash-register software would find the credentials no longer valid. If you also need to issue receipts from another system, grant a second Fisconline delegation and use dedicated credentials.

What happens when the Fisconline password expires?

Nothing: Voucherly detects it before the 90-day deadline and renews it automatically on the Italian Revenue Agency portal. You do not have to do anything.

Do I need to grant the delegation if I am a sole proprietor?

No. For sole proprietorships it is enough to log in to the Revenue Agency portal with the owner's SPID/CIE and proceed directly to obtaining your Fisconline credentials.

Is the receipt issued by Voucherly fully valid?

Yes. It is an online commercial document issued through the Italian Revenue Agency's official procedure, exactly like the one you would obtain by filling in the form manually. Software automation is expressly confirmed by ruling no. 413/2020.