Italy Epson Fiscal Printer: Usage Guide

Mariia Korostashevych

Updated May 19, 2026 12:53

Stampante fiscale Epson per l'Italia: guida all'uso

Questa guida spiega come gestire pagamenti, rimborsi e ricevute utilizzando l'integrazione per la stampante fiscale Epson.

❗ Per le norme fiscali italiane, viene generata una ricevuta solo quando un pagamento è stato associato a degli specifici addebiti.

Mappatura delle tasse

Prima di utilizzare la stampante, è necessario mappare le tasse di Cloudbeds con i reparti corretti della stampante Epson. Questo assicura che la stampante sappia quale categoria fiscale applicare a ciascun addebito.

Come mappare le tasse:

Naviga su Impostazioni stampante Epson nel Marketplace di Cloudbeds.
Individua la sezione Mappatura delle tasse.
FPer ogni Nome della tassa, seleziona il Reparto della stampante corrispondente dal menu a discesa (es. Merci - IVA 10% [Rep.: 61]).
Gestione delle tasse scadute: Se ricevi l'errore "ID tassa non trovato" per una vecchia prenotazione, attiva l'opzione Mostra tasse inattive. Questo ti consentirà di mappare le tasse scadute che potrebbero essere ancora collegate a prenotazioni esistenti, garantendone la corretta stampa.

1. Aggiungere un pagamento (Conto standard)

Per i pagamenti inseriti direttamente nel conto dell'ospite:

1. Vai alla scheda Conto della prenotazione.

2. Fai clic sul pulsante Aggiungi pagamento.

3. Seleziona gli Addebiti e inserisci i Dati di pagamento.

4. Fai clic su Salva.

5. La ricevuta fiscale verrà stampata automaticamente una volta completato il salvataggio.

Le tasse aggiunte manualmente che non sono collegate all'addebito di una camera appariranno ora come singole voci separate sulla ricevuta stampata.

2. Rimborsare o annullare un pagamento

Se devi annullare una transazione:

1. Vai alla scheda Documenti e seleziona Fatture e ricevute .

2. Individua nell'elenco la ricevuta che desideri rimborsare/annullare.

3. Fai clic su Annulla.

4. Viene stampata automaticamente una Ricevuta di rimborso per documentare lo storno ai fini fiscali.

3. Gestione di specifici scenari di prenotazione

Negli scenari seguenti, la ricevuta non è sempre automatica e occorre un passaggio manuale di assegnazione per attivare la stampante.

Motore di prenotazione, pagamento da OTA e "Hotel Collect" (Pagamenti Cloudbeds)

Quando un pagamento arriva tramite il Motore di prenotazione o una OTA (come Expedia), oppure quando viene raccolto tramite Cloudbeds Pay:

1. Cerca la riga del pagamento nel Conto.

2. Seleziona Assegna pagamento.

3. Seleziona gli specifici addebiti che il pagamento deve coprire.

4. Fai clic su Salva . Ora verrà stampata la ricevuta.

Le tasse personalizzate generate da integrazioni esterne (es. sistemi POS) sono pienamente supportate e verranno elaborate correttamente sulla ricevuta.

4. Aggiungere un articolo con un pagamento

Se inserisci un addebito e un pagamento contemporaneamente:

1. Cerca la riga del pagamento nel Conto.

2. Seleziona Assegna pagamento.

3. Seleziona gli addebiti e fai clic su Salva. Verrà stampata la ricevuta.

5. Visualizzare una copia digitale

Cloudbeds registra tutte le transazioni fiscali, per permetterti di rivederle:

1. Vai alla scheda Documenti e seleziona Fatture e ricevute.

2. Cerca la ricevuta che ti interessa.

3. Fai clic sul menu con i tre puntini (⋮) a destra e seleziona Visualizza.

6. Risoluzione dei problemi con le ricevute

Se una ricevuta non viene stampata (per esempio, se la stampante è senza carta o spenta), apparirà brevemente un messaggio di errore nell'angolo in basso a sinistra.

Per vedere i dettagli dell'errore in seguito:

1. Vai alla scheda Documenti.

2. Individua la ricevuta con l'indicazione in rosso "Non riuscito".

3. Posiziona il mouse sull'indicazione in rosso "Non riuscito" per visualizzare il messaggio di errore fornito dalla stampante.

Soluzioni comuni:

Stampante offline/Carta esaurita: Assicurati che l'hardware sia pronto.
Tassa non trovata: Se visualizzi un errore relativo a un "ID tassa", verifica che la tassa sia mappata correttamente nelle impostazioni di Cloudbeds. (Nota: un bug precedente che causava errori con le tasse delle integrazioni personalizzate è stato risolto).
Tassa di soggiorno mancante: Se le tasse non appaiono sulla stampa, verifica la mappatura Tassa-Reparto nelle impostazioni dell'integrazione.

English version:

This guide explains how to manage payments, refunds, and receipts using the Epson Fiscal Printer integration.

❗To comply with Italian fiscal regulations, a receipt is only triggered once a payment is allocated to specific charges.

Configuration: Tax Mapping

Before using the printer, you must map your Cloudbeds taxes to the correct Epson Printer Departments. This ensures the printer knows which fiscal category to apply to each charge.

How to Map Taxes:

Navigate to the Epson Printer Settings in the Cloudbeds Marketplace.
Locate the Tax Mapping section.
For each Tax Name, select the corresponding Printer Department from the dropdown menu (e.g., Goods - VAT 10% [Dept: 61]).
Handling Expired Taxes: If you receive a "Tax ID not found" error for an older reservation, click the Show inactive taxes toggle. This allows you to map expired taxes that may still be linked to existing bookings so they can print correctly.

Adding a Payment (Standard Folio)

For payments taken directly on the guest folio:

Navigate to the Folio tab of the reservation.
Click the Add Payment button.
Select the Charges and enter the Payment Details.
Click Save.
The fiscal receipt will print automatically once the save is successful.

Manually added taxes that are not linked to a room charge will now appear as standalone line items on the printed receipt.

Refunding or Voiding a Payment

If you need to reverse a transaction:

Go to the Documents tab, then select Invoices and Receipts.
Locate the receipt you wish to refund/void from the list.
Click Void.
A Refund Receipt will print automatically to document the reversal for fiscal records.

Taking Payment when Adding Item

This functionality currently requires an extra step to allocate payment and print the receipt.

Add Item with a Payment
Find the line for the Payment in the Folio, select Allocate Payment.

Select charges for the payment, click Save.

A Payment receipt will now be printed.

Handling Specific Booking Scenarios

For the following scenarios, the fiscal receipt is not always automatic and requires a manual Allocation step to trigger the printer.

Booking Engine, OTA Paid, or "Hotel Collect" (Cloudbeds Payments)

When a payment arrives via the Booking Engine, an OTA (like Expedia), or is captured via Cloudbeds Pay:

Find the payment line in the Folio.
Select Allocate Payment.
Select the specific charges (including room revenue and taxes) this payment should cover.
Click Save. The receipt will now print.

Custom taxes generated by external integrations (e.g., POS systems) are fully supported and will resolve correctly on the receipt.

Adding an Item with Payment

If you post a charge and payment simultaneously:

Find the payment line in the Folio.
Select Allocate Payment.
Select the charges and click Save. The receipt will print.

Viewing a Digital Copy

Cloudbeds keeps a record of all fiscal transactions for your review:

Go to the Documents tab and select Invoices and Receipts.
Find the specific receipt.
Click the three-dot menu (⋮) on the right and select View.

Troubleshooting Receipt Failures

If a receipt fails to print (e.g., the printer is out of paper or offline), an error message will appear briefly in the lower-left corner.

To find the error details later:

Go to the Documents tab.
Locate the receipt marked with a red "Failed" status.
Hover your mouse over the red "Failed" box to see the specific error message provided by the printer.

Common Fixes:

Printer Offline/Out of Paper: Ensure hardware is ready.
Tax not found: If you see an error regarding a "Tax ID," check that the tax is correctly mapped in your Cloudbeds settings. (Note: A previous bug causing failures for custom integration taxes has been resolved).
Missing City Tax: If taxes aren't appearing on the printout, verify your Tax-to-Department mapping in the integration settings.