Invoice Auto-Lock After Payment or Close
When a guest pays or a receipt is retrieved, Zenoti can automatically lock the closed invoice to prevent accidental edits. This article explains how the auto-lock behavior works and how to unlock a locked invoice when corrections are needed.
Audience: Front desk staff and managers who manage invoice corrections and receipt retrieval at the point of sale (POS).
On this page
- Before you begin
- How auto-lock works
- Link or unlink invoices
- Unlock a locked invoice
- Tips
- Troubleshooting
- Related articles
Before you begin
- The auto-lock behavior described in this article is active only when the Close invoice automatically after payment organization-level setting is enabled. Contact your administrator if you are unsure whether this setting is on for your organization.
- To unlock a locked invoice, you need the unlock permission assigned to your security role. Your administrator can verify this under Security Roles > [your role] > Permissions.
- Confirm the invoice is in a closed state before attempting to unlock it. Open invoices are not subject to auto-lock.
Permission: Unlocking a locked invoice requires the appropriate unlock permission on your security role. Contact your administrator to confirm access.
How auto-lock works
When the auto-lock setting is enabled at the organization level, Zenoti locks a closed invoice automatically in two situations:
- After the invoice is closed β As soon as the invoice closes successfully (for example, when the due amount reaches zero and the invoice auto-closes, or when a staff member manually closes it), the system locks the invoice immediately.
- After a receipt is retrieved β When a staff member prints or emails a receipt for a closed invoice, the system locks the invoice at the point the receipt action completes.
Locking prevents further edits to the invoice, protecting the accuracy of the closed record.
What happens when auto-lock fails
If the auto-lock cannot complete β for example, due to a temporary connectivity issue β Zenoti displays a warning notification. This warning does not indicate a failure of the close or receipt action itself. The invoice closes and the receipt delivers successfully. The auto-lock warning is informational only; the primary action is not reversed or blocked.
Note: If you see a lock warning and the invoice remains unlocked, you can manually lock it or contact your administrator to investigate.
Link or unlink invoices
You can associate one invoice with another using the Link invoice action. Linking is useful when related transactions β such as a deposit and a final payment β need to be connected for reference or reconciliation purposes.
Link an invoice
- Open the invoice you want to link from.
- Select the three-dot menu on the invoice.
- Select Link invoice.
- Select the target invoice from the list or enter the invoice reference.
- Confirm the selection.
When the link is created successfully, Zenoti displays a confirmation message and refreshes the invoice automatically so the linked relationship is visible without you needing to reopen the invoice.
If the link cannot be created, the invoice is left unchanged and an error message appears. Review the error and try again, or contact your administrator.
Remove a link between invoices
- Open the invoice that has an existing link you want to remove.
- Select the three-dot menu on the invoice.
- Select Link invoice.
- Select the option to remove the existing link.
- Confirm the action.
When the link is removed successfully, Zenoti displays a confirmation message and refreshes the invoice automatically so the change is visible immediately.
If the unlink action does not succeed, the invoice is left unchanged and an error message appears. No partial change is applied.
Note: The invoice refresh after a successful link or unlink is automatic. You do not need to close and reopen the invoice to see the updated state.
Unlock a locked invoice
Use this procedure when a closed, locked invoice requires a correction.
Steps
Open the Appointment Book and locate the appointment associated with the invoice.
Select the appointment to open the invoice context menu.
Select the three-dot menu, then select I want to, and then select the option to unlock the invoice.
Permission: The unlock option is visible only when your security role includes the appropriate unlock permission. If the option does not appear, contact your administrator.
Review the invoice to confirm the correction you need to make.
Make the required changes to the invoice.
When finished, close or re-lock the invoice as appropriate.
Important: Unlocking a closed invoice allows edits. Ensure you have reviewed the invoice carefully before making changes, as edits to a closed invoice affect financial records for the period in which the invoice was closed.
Guards that block unlock
Certain conditions prevent the unlock action from completing. When a guard is triggered, Zenoti displays an inline error message describing the reason. Common blocking conditions include:
- The invoice has already been refunded.
- The invoice contains a sold and redeemed membership, package, or gift card.
- The invoice is subject to a financial lock for the period.
- The invoice was created under a compliance framework that restricts post-closure edits (for example, a jurisdiction-specific e-invoicing requirement).
If you see a blocking error message, do not attempt to bypass it. Review the error, and if a correction is still needed, contact your administrator.
Tips
- Re-lock after corrections. After making edits to an unlocked invoice, close or re-lock it promptly to maintain record integrity. Leaving a corrected invoice unlocked exposes it to further unintended changes.
- Use the audit log to verify lock events. Invoice lock and unlock actions are recorded in the invoice audit log. To review these events, open the invoice and select View Logs from the more-actions menu. For details, see View invoice audit logs with the New POS Experience.
- Check for the warning notification at the end of a transaction. If auto-lock fails silently and the invoice is not locked after close, the warning notification appears briefly. Train front desk staff to watch for this notification and escalate to a manager if it appears.
- Auto-lock does not replace financial locks. The auto-lock setting protects individual invoices from casual edits. Organization-wide financial locks (which block edits across all invoices for a period) are configured separately. For period-level controls, contact your administrator.
- Verify a link before attempting to remove it. The invoice refreshes automatically after a successful link or unlink, so the current state of any linked relationship is always visible when you reopen the invoice.
Troubleshooting
The unlock option does not appear in the more-actions menu.
Your security role may not include the unlock permission. Contact your administrator and ask them to verify your role under Security Roles > [your role] > Permissions. The unlock option is only visible to roles with the appropriate permission assigned.
A warning notification appeared after closing the invoice, and the invoice is not locked.
The auto-lock action failed after the invoice closed. The close itself was successful β the invoice is closed and the financial record is intact. The lock failure is non-blocking. To resolve: attempt to lock the invoice manually, or contact your administrator to investigate repeated auto-lock failures.
An inline error message appeared when attempting to unlock the invoice.
A guard condition is preventing the unlock. Read the error message carefully β it identifies the specific reason. Common causes include a prior refund on the invoice, a sold and redeemed membership or package, or a financial lock on the period. If the correction is still required, escalate to your manager or administrator.
The receipt was emailed or printed, but the invoice does not appear locked.
Confirm that the Close invoice automatically after payment setting is enabled at the organization level. If the setting is off, auto-lock after receipt retrieval does not occur. If the setting is confirmed on and the invoice is still not locking, note the time of the event and contact your administrator to review system logs.
The invoice was locked, but the guest's receipt shows incorrect information.
Unlock the invoice using the procedure above, make the required correction, then close and re-lock the invoice. Reprint or re-email the receipt to the guest. The new receipt reflects the corrected invoice. To confirm the correction is recorded, check the invoice audit log via View Logs in the more-actions menu.
An error appeared when trying to link or unlink an invoice, and no change was made.
The link or unlink action did not complete. The invoice is left in its previous state β no partial change is applied. Review the error message for a specific reason. If the issue persists, contact your administrator.