Compliance Framework
Zenoti routes invoice compliance processing through a regional framework that identifies the correct handler for each center and logs every submission for audit purposes. This article explains how to understand the compliance framework, verify your center's compliance type, and confirm that QR codes are being stored and displayed correctly.
Note: For conceptual background on regional compliance integrations, see Integrations Overview.
Before you begin
- You must have administrator access to your Zenoti organization.
- Each compliance accordion is specific to one country and appears on the center-scope Integration Settings page only for organizations in that country.
- Each center has its own compliance configuration. Verify the correct center is selected before reviewing compliance settings.
Permission: You need the Configuration access permission to view and manage integration settings. Admin path: Configuration > Integrations > Integration Settings at center scope (the compliance accordions render on the center-scope page only)
Steps
Understand how compliance types are identified
Zenoti identifies each center's regional compliance integration using a compliance type value. The following compliance types are supported:
| Compliance type | Region | Integration |
|---|---|---|
| Fiskaly | Spain, Germany, Austria | Fiskaly e-invoicing service |
| ZATCA | Saudi Arabia | Zakat, Tax and Customs Authority (ZATCA) |
| Montenegro DDDI | Montenegro | Montenegro digital fiscal invoicing |
| Malaysia e-Invoicing | Malaysia | Malaysia Inland Revenue Board (LHDN) |
Important: Each center is mapped to exactly one compliance type. If your organization operates in multiple regions, each center must be configured independently.
Verify your center's compliance routing
When an invoice is closed, Zenoti routes the compliance submission to the handler that matches the compliance type enabled for that center. To confirm which compliance type is active for a center:
- Select the center in the scope selector, then navigate to Configuration > Integrations > Integration Settings.
- Expand the compliance accordion for your region: Spain E - Invoicing (Fiskaly), Zatca e - Invoicing, Montenegro - Invoicing, or Malaysia E - Invoicing. An accordion appears only for organizations in that country.
- Confirm the integration is enabled and the required credentials are saved.
Note: If no compliance integration is expanded or enabled for a center, Zenoti does not submit invoices to a compliance authority for that center. Verify with your regional compliance team that this is intentional.
Review compliance submission logs
Zenoti logs every compliance submission with the following information:
| Log field | Description |
|---|---|
| Invoice reference | The Zenoti invoice identifier submitted to the compliance authority |
| Submission timestamp | The date and time the submission was sent |
| Compliance type | The regional compliance handler that processed the submission |
| Submission status | Whether the submission succeeded or failed |
| Authority response | The response code or message returned by the compliance authority |
To review submission logs, contact Zenoti Support or use the compliance-specific report for your region. For Spain (Fiskaly) and Saudi Arabia (ZATCA), submission outcomes are visible in the integration configuration screen after each invoice is processed.
Tip: If you are troubleshooting a failed submission, the submission status and authority response fields are the most useful starting points. See Submit invoices to regional tax authorities for step-by-step guidance.
Confirm QR code storage and display
For compliance types that require a QR code on the invoice (such as ZATCA for Saudi Arabia), Zenoti stores the QR code and makes it available for display on printed and digital invoices.
- Close a test invoice at a center where compliance is enabled.
- Open the closed invoice and verify that a QR code appears on the invoice preview or printed receipt.
- If the QR code does not appear, confirm the following:
- The compliance integration is enabled and credentials are saved for this center.
- The invoice was closed after the compliance integration was activated (invoices closed before activation are not retroactively submitted).
- The receipt printer format is set to a format that supports QR code display. Navigate to Configuration > POS and verify the Printer formats setting includes QR code support for your region.
Important: QR codes are generated by the compliance authority and stored by Zenoti after a successful submission. If the compliance submission fails, no QR code is stored and none will appear on the invoice. Resolve the submission failure before reprinting.
Tips
- Enable compliance for a center before going live with invoicing in that region. Invoices closed before compliance is activated are not retroactively submitted.
- Each regional compliance integration has its own credential requirements. Refer to the region-specific setup article for the exact fields required before you begin configuration.
- If your organization operates in Spain, confirm whether the center falls under a special territory (such as the Basque Country or Canary Islands), as these territories may have different compliance rules. The Territory field in the Fiskaly configuration captures this distinction.
- Submission logs are your primary tool for diagnosing compliance failures. Review the authority response field before contacting Zenoti Support, as it often contains the specific error code returned by the compliance authority.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| QR code does not appear on the invoice | Compliance submission failed or integration is not enabled | Verify the compliance integration is enabled and credentials are saved. Check the submission log for a failure status and authority response code. |
| Invoices are not being submitted to the compliance authority | Compliance type is not enabled for the center | At center scope, navigate to Configuration > Integrations > Integration Settings, expand the compliance accordion for the region, and confirm the integration is active for the correct center. |
| Submission status shows a failure after invoice closure | Invalid or expired credentials | Re-enter the credentials in the compliance integration configuration screen and close a new test invoice to verify the submission succeeds. |