Connect the Germany Fiscaly App

Step 1 - Connect the Germany Fiscaly App

1. In Cloudbeds, navigate to Marketplace
2. Click the Apps tab and search for Germany Fiscaly: How to connect an app to Cloudbeds PMS
3. Click the app and follow the authorization flow. If prompted with an authorization error, click Allow Access and retry.
4. Once connected, the app appears under Connected Apps with a green Connected badge.

The Connected Apps view in Marketplace. Germany Fiscaly shows the date it was enabled and its required permissions.

Step 2 - Open the Fiskaly DE Setup Screen

1. From Marketplace→ Connected Apps, click the Germany Fiscaly app.
2. The Fiskaly DE screen opens with three tabs: Einrichtung (Setup), Kassenabschluss (Cash Register Closing), and Transaktionen (Transactions).
3. The initial status banner shows "Einrichtung unvollständig" (Setup incomplete) — this is expected until all fields are saved.

The Einrichtung tab on first open. The orange banner indicates tax details have not yet been configured.

Step 3 - Enter Tax Information

Under the Einrichtung tab, scroll to Steuerinformationen and fill in the following fields:

Step 4 - Enter Company & Address Information

Scroll to Personenart and Unternehmensinformationen:

Select the correct legal entity type and enter the registered company name and legal form.

Scroll further to Betriebsstätte (Business Location):

Enter the full business address. Use the Bezeichnung field to label multiple locations. Click Speichern to save.

Click Speichern (Save) at the bottom of the page once all fields are complete.

Step 5 - Create and Initialize the TSS

After saving, the system verifies the TSS status. You will briefly see a loading state:

After saving, the system checks TSS and regulatory submission status. This loading state is temporary.

Once the check completes, the TSS erstellen (Create TSS) button appears:

Click TSS erstellen to begin Technical Security System creation. Training Mode is enabled by default.

Create the TSS

1. Click TSS erstellen.
2. A dialog appears displaying your Admin-PUK code.

The Admin-PUK dialog. Copy and store this code securely before closing — you need it to complete TSS initialization.

Close the dialog after copying the Admin-PUK.

Set the Admin-PIN

The TSS section now shows "In Bearbeitung" (In Progress) with three input fields:

Enter the Admin-PUK from the previous step, then choose and confirm an Admin-PIN.

All three fields completed. Click Admin-PIN setzen to proceed.

Enter all three values and click Admin-PIN setzen (Set Admin-PIN).

Initialize the TSS

After the PIN is set, the screen updates to the final initialization step:

• Enter your Admin-PIN one final time and click Initialisieren to complete TSS setup.
• Enter your Admin-PIN in the field provided.
• Click Initialisieren (Initialize).

Step 6 - Confirm TSS is Active

Once initialization completes, the TSS status changes to verified:

A green "Verifiziert" status confirms the TSS is initialized and ready for payment processing.

The app tile in Marketplace also updates to a green "Bereit" (Ready) indicator:

The "Bereit" status confirms the integration is fully active and ready to fiscalize payments.

Step 7 - Test in Training Mode

Before processing live transactions, run through realistic test scenarios with Training Mode on:

1. Confirm Trainingsmodus is toggled on in the Einrichtung tab.
2. Create a test reservation and add charges to a folio.
3. Post a payment — a fiscalized receipt with a QR code should be generated automatically.
4. Generate an invoice and verify the full workflow end-to-end.
5. Test edge cases: advance payments, multi-night stays, payment failures.

Step 8 - Go Live

Once testing is complete and all issues are resolved:

1. Return to the Einrichtung tab.
2. Toggle Trainingsmodus to off.
3. All subsequent payment postings will be reported to the German fiscal authority in real time.