Come connettere Italy Fiscal Receipts / How to connect Italy Fiscal Receipts

Questa guida fornisce istruzioni passo passo per installare e configurare l'integrazione della stampante Epson per scontrini fiscali Italia. Questa integrazione consente di elaborare i pagamenti all'interno dell'interfaccia di Cloudbeds e di stampare automaticamente scontrini fiscali conformi con l'hardware Epson.

Requisiti hardware e software

Prima di iniziare, assicurati che la tua configurazione soddisfi i seguenti criteri:

• Sistema operativo: Windows 10 e versioni successive.
• Modelli supportati: stampanti Epson modelli FP 89 II e FP 91 III

Configurazione delle imposte 

1. Vai su Account-> Impostazioni-> Pagamenti-> Imposte e spese e assicurati che, tra quelle elencate di seguito, siano configurate le imposte necessarie per la tua struttura 

   ❗È importante impostare la Classificazione su IVA: si tratta di una nuova impostazione di Cloudbeds necessaria per questa integrazione.  

2. Vai su Account->Impostazioni-> Struttura->Fonti e assicurati che a tutte le fonti siano assegnate le imposte corrette.

3. Vai su Account->Impostazioni->Prodotti e assicurati che a tutti i prodotti e servizi siano assegnate le
   imposte corrette.

   

Installazione e configurazione

1. Installare il software FpMate

   Il software e l'assistenza per l'installazione devono essere forniti dal tuo rivenditore Epson. Cloudbeds non può fornire direttamente questo software.

• Scarica e installa FpMate v3.7.0.0 o una versione successiva.

• Segui la Guida alla configurazione di Epson FpMate.

• Importante: annota il percorso di installazione del file Settings.xml. Di solito si trova in: C:\Program Files (x86)\Epson\FpMate\Settings.xml.

2. Configurare la stampante fiscale

1. Collega la stampante Epson al computer tramite USB o rete.

2. Configura la stampante seguendo la Guida alla configurazione della stampante fiscale Epson.

3. Apri FpMate per verificare che la stampante sia riconosciuta e "Pronta".

3. Connessione al Marketplace

1. Accedi a Cloudbeds e vai su Account-> App e Marketplace

2. Cerca Italy Fiscal Printer.

3. Fai clic su Connetti app.

4. Ti verrà chiesto di autorizzare l'accesso ai dati. Fai clic su Consenti accesso.
   

   4. Installare l'app Cloudbeds Bridge

   L'app Bridge funge da traduttore tra Cloudbeds e l'hardware Epson locale.

   1. Dopo il passaggio precedente verrai reindirizzato alla pagina App connesse. 

   2. Trova "Italy Fiscal Printer" e fai clic su Pagina dell'app per iniziare la configurazione.

   3. Nella Pagina dell'app fai clic su Impostazioni.

   4. Scarica l'ultimo programma di installazione: cloudbeds-bridge-latest.msi.
   

   ‼️Il software Cloudbeds Bridge deve essere installato.

5. Installa il file cloudbeds-bridge-latest.msi sul computer.
6. Avvia il servizio Cloudbeds Bridge
7. L'avvio dell'app aprirà una finestra del browser con l'accesso a Cloudbeds. Se hai già effettuato l'accesso, puoi passare al passaggio successivo.
8. Fai clic su Consenti accesso per autorizzare Cloudbeds Bridge a connettersi a Cloudbeds.
   
9. Vedrai un messaggio di conferma.
10. Ora dovresti vedere il servizio Cloudbeds Bridge in esecuzione nell'area di notifica di Windows.
    
11. Hai completato la configurazione dell'app Cloudbeds Bridge e ora puoi configurare la nuova integrazione all'interno di Cloudbeds.
    

4. Impostazioni dell'applicazione

Nella pagina dell'app di integrazione, fai clic su Impostazioni e completa quanto segue:

Abilitare la modalità di formazione (Training Mode)

Consigliamo vivamente di abilitare la Modalità di formazione durante la configurazione. In questo modo puoi testare la stampa degli scontrini senza trasmettere i dati all'amministrazione fiscale (Agenzia delle Entrate).

Percorso del file delle impostazioni di FP Mate

Inserisci il percorso del file Settings.xml che hai annotato nella Fase 1 (ad es. C:\Program Files (x86)\Epson\FpMate\Settings.xml).

Mappatura delle imposte

Associa le imposte configurate nel tuo Cloudbeds PMS ai corrispondenti Reparti IVA impostati nel software FpMate. In questo modo sullo scontrino fiscale vengono riportate le aliquote IVA corrette.

Mappatura degli operatori

Associa gli utenti di Cloudbeds agli utenti configurati in FpMate.

• Utente predefinito: questo valore viene usato se manca una mappatura specifica o se un'azione automatica (come un'integrazione) genera uno scontrino.

❗Fai sempre clic su Salva, in basso a destra, dopo aver apportato le modifiche.

6. Verifica e test

1. Crea una prenotazione di prova: usa una prenotazione "fittizia" per non influire sulla disponibilità reale.

2. Aggiungi addebiti: registra un piccolo addebito di camera o di servizio nel conto.

3. Elabora un pagamento: usa il pannello laterale "Aggiungi pagamento". Per i passaggi dettagliati, segui la Guida all'uso della stampante Epson per l'Italia.

4. Conferma il risultato:

   • Verifica che venga stampato uno scontrino fiscale fisico.

     

   • Controlla la scheda Documenti nella prenotazione per assicurarti che compaia una copia digitale dello scontrino.

     

   • Se tutto è corretto, torna in Impostazioni per disattivare la Modalità di formazione e passare all'ambiente di produzione.

English version:

This guide provides step-by-step instructions for installing and configuring the Italy Fiscal Receipts Epson Printer integration. This integration allows you to process payments within the Cloudbeds UI and automatically print compliant fiscal receipts using your Epson hardware.

Hardware and Software Requirements

Before beginning, ensure your setup meets the following criteria:

• Operating System: Windows version 10 & above.
• Supported Models: Epson printer models FP 89 II and FP 91 III

Tax Configuration 

1. Go to Account-> Settings-> Payments-> Taxes and Fees and make sure that, from the list below, you have the necessary taxes configured for your property 

   ❗Its important to set the Classification to VAT, this is a new setting withing Cloudbeds necessary for this integration.  

2. Go to Account->Settings-> Property->Sources and make sure all sources have the right taxes assigned.

3. Go to Account->Settings->Products and make sure all products and services have the right
   taxes assigned.

   

Setup and Configuration

1. Install FpMate Software

   Software and installation assistance must be provided by your Epson vendor. Cloudbeds cannot provide this software directly.

• Download and install FpMate v3.7.0.0 or later.

• Follow the Epson FpMate Configuration Guide.

• Important: Note the installation path of the Settings.xml file. It is typically found at: C:\Program Files (x86)\Epson\FpMate\Settings.xml.

2. Configure the Fiscal Printer

1. Connect your Epson printer to the computer via USB or Network.

2. Configure the printer using the Epson Fiscal Printer Configuration Guide.

3. Open FpMate to verify the printer is recognized and "Ready."

3. Marketplace Connection

1. Log in to Cloudbeds and navigate to the Account-> Apps& Marketplace

2. Search for Italy Fiscal Printer.

3. Click Connect App.

4. You will be prompted to authorize data access. Click Allow Access.
   

   4. Install Cloudbeds Bridge app

   The Bridge App acts as the translator between Cloudbeds and your local Epson hardware.

   1. After the previous step you will be redirected back to the Connected Apps page. 

   2. Find "Italy Fiscal Printer" and click App Page to begin configuration.

   3. On the App Page click Settings.

   4. Download the latest installer: cloudbeds-bridge-latest.msi.
   

   ‼️The Cloudbeds Bridge software must be installed.

5. Install the cloudbeds-bridge-latest.msi file onto the computer.
6. Start the Cloudbeds Bridge Service
7. Starting the app will open a browser window with a Cloudbeds login. If you are already logged in, you can proceed to the next step.
8. Click Allow Access to grant Cloudbeds Bridge access to connect to Cloudbeds.
   
9. You will see a success message.
10. You should now see the Cloudbeds Bridge service running in your Windows system tray.
    
11. You have now successfully set up the Cloudbeds Bridge App and are ready to configure the new integration within Cloudbeds.
    

4. Application Settings

Once on the Integration App Page, click Settings and complete the following:

Enable Training Mode

We strongly recommend enabling Training Mode during setup. This allows you to test receipt printing without sending data to the government (Agenzia delle Entrate).

FP Mate Settings File Path

Enter the file path for the Settings.xml file you noted in Phase 1 (e.g., C:\Program Files (x86)\Epson\FpMate\Settings.xml).

Tax Mapping

Map the taxes configured in your Cloudbeds PMS to the corresponding Tax Departments set up in your FpMate software. This ensures the correct VAT rates appear on the fiscal receipt.

Operator Mapping

Map your Cloudbeds users to the users configured in FpMate.

• Default User: This value is used if a specific mapping is missing or if an automated action (like an integration) triggers a receipt.

❗Always click Save in the bottom right corner after making changes.

6. Verification & Testing

1. Create a test reservation: Use a "dummy" booking to avoid affecting real availability.

2. Add charges: Post a small room charge or service to the folio.

3. Process a payment: Use the "Add Payment" drawer. For detailed steps, follow the Italy Epson Printer Usage Guide.

4. Confirm Output:

   • Verify a physical fiscal receipt is printed.

     

   • Check the Documents tab in the reservation to ensure a digital copy of the receipt appears.

     

   • If everything looks correct, return to Settings to disable Training Mode for live production.