Center Integration Settings β Germany e-Invoicing (Fiskaly) Accordion
The Germany e-Invoicing (Fiskaly) accordion on the center Integration Settings page provides access to the Fiskaly configuration surface for German fiscal compliance. This accordion appears only when Germany e-invoicing has been enabled for your center by Zenoti.
Note: For conceptual background on regional compliance integrations, see Integrations Overview.
Before you begin
- Germany e-invoicing must be enabled for your center by Zenoti. Contact Zenoti Support to request enablement. The Germany e-Invoicing (Fiskaly) accordion does not appear until this is active for your center.
- You must have access to your center's Integration Settings page in Zenoti.
- Have your Fiskaly credentials ready before beginning configuration. Obtain these from your Fiskaly account or your organization's compliance administrator.
Availability: Requires CSM or Zenoti Support enablement of Germany e-invoicing for your center before the accordion appears.
Steps
Open Integration Settings for your center
- In Zenoti, click Configuration in the left navigation.
- Navigate to Integrations > Integration settings.
- On the Integration settings page, locate and expand the Germany e-Invoicing (Fiskaly) accordion.
Important: If the Germany e-Invoicing (Fiskaly) accordion is not visible, Germany e-invoicing has not been enabled for this center. Contact Zenoti Support to request activation before continuing.
Configure the Fiskaly connection
The accordion embeds the Fiskaly configuration surface directly within the Integration settings page.
Within the Germany e-Invoicing (Fiskaly) accordion, complete the following fields:
- API key β Enter the API key from your Fiskaly account.
- API secret β Enter the API secret from your Fiskaly account.
- SIGN DE host URL β Enter the SIGN DE host URL provided by Fiskaly.
- DSFinV-K host URL β Enter the DSFinV-K host URL provided by Fiskaly.
- ELSTER host URL β Enter the ELSTER host URL provided by Fiskaly.
- TSS ID β Enter the Technical Security System (TSS) ID assigned by Fiskaly. The TSS is a tamper-proof module required under German fiscal law to sign transaction data.
- TSS state β Displays the current state of the TSS connection after configuration is saved. This field is read-only; do not attempt to edit it.
- Fiskaly establishment id β Enter the establishment ID from your Fiskaly account, which identifies this center as a fiscal establishment.
Click Save to apply the configuration.
Provision the TSS
After saving your credentials, you can provision the TSS connection.
- Click Provision to initiate TSS provisioning.
Note: The Provision button is unavailable until you have saved valid credentials in the previous step. If the button remains inactive, verify that all required fields were completed and that Save completed without errors.
Configure cash registers
The Germany e-Invoicing (Fiskaly) accordion displays a grid of cash registers linked to this center. Each row represents one register and must be individually configured and provisioned.
For each cash register row, enter the following:
- Client serial number β Enter the serial number of the cash register client as assigned in your Fiskaly account.
- Fiskaly client ID β Enter the Fiskaly client ID for this register.
Click the save action for that register row to save the client serial number and Fiskaly client ID for that register.
Click the provision action for that register row to provision the register against the Fiskaly TSS.
Note: Column headers for the cash registers grid are subject to confirmation against the live product. The DSFinV-K state, Submit state, and Last error columns are read-only and reflect the current compliance status of each register after provisioning.
Accept legal consent and transmit
Select the legal consent check box to confirm that you have reviewed and accepted the compliance terms required for German fiscal e-invoicing.
Click the transmit button to submit fiscalization data to the Fiskaly service.
Important: The transmit action is only available after the legal consent check box is selected. Ensure all cash registers have been saved and provisioned before transmitting.
Tips
- Obtain all Fiskaly credentials β API key, API secret, host URLs, TSS ID, and establishment ID β from your Fiskaly account portal or your organization's compliance administrator before starting setup. Having them ready prevents interruptions mid-configuration.
- The TSS state field is read-only and reflects the current connection status after you save. If the state does not update as expected, verify that your credentials are correct and that the Fiskaly service is reachable.
- If your organization operates multiple centers in Germany, each center requires its own Fiskaly configuration with its own establishment ID. Repeat this process for each center that requires German fiscal compliance.
- Complete the configuration-level Save and Provision steps before working through the cash registers grid. The register-level provision action depends on a successfully provisioned TSS at the configuration level.
Troubleshooting
| Problem | Resolution |
|---|---|
| The Germany e-Invoicing (Fiskaly) accordion does not appear on the Integration settings page | Germany e-invoicing has not been enabled for this center. Contact Zenoti Support to request activation. |
| The Provision button is inactive after saving credentials | Confirm that all required fields β API key, API secret, and host URLs β were completed and that Save completed without errors. Reload the page and verify the fields are populated before attempting to provision again. |
| The TSS state field shows an error or does not update after saving | Verify that all credentials β API key, API secret, host URLs, and TSS ID β are entered exactly as provided by Fiskaly. Recheck for extra spaces or incorrect character casing. |
| The Fiskaly establishment id field is rejected on save | Confirm that the establishment ID matches the value in your Fiskaly account for this specific center. Each center has a unique establishment ID. |
| A cash register row shows an error in the Last error column after provisioning | Review the error message displayed in that column. Verify that the client serial number and Fiskaly client ID for that register are correct, then save and re-provision the affected register. |
| The transmit button is unavailable | Ensure the legal consent check box is selected. Also confirm that all cash registers have been saved and provisioned successfully before attempting to transmit. |