Invoice Lock β Locked and Date-Locked Invoices
A locked invoice is a read-only invoice that Zenoti prevents staff from modifying. Zenoti supports two distinct lock types: a payroll lock, which protects invoices included in a processed payroll run, and a financial date lock, which protects invoices from a period that has been financially closed. Understanding what each lock type blocks β and how each communicates its status to staff β helps front desk teams respond correctly when a guest's invoice cannot be edited.
Audience: Front desk staff and center managers who encounter locked invoices during checkout or post-checkout workflows.
On this page
- Before you begin
- How locked invoices behave
- What the lock message tells you
- What appears on the right panel of a locked invoice
- Commission editing on locked invoices
- Adding an item that requires a date of birth
- Tips
- Troubleshooting
- Related articles
Before you begin
- You need access to the point of sale (POS) to view invoices.
Permission: Viewing and working with invoices in POS requires the Add, Edit, or ContextMenu permission under Security Roles > [your role] > Permissions > Appointments.
- Locked invoices are read-only by design. No front desk action can unlock a payroll-locked invoice. A financial date lock can only be lifted by an administrator who adjusts the financial lock date in organization settings.
- The lock messages that appear on locked invoices are configured by your organization's administrator. If the messages are missing or unclear, contact your administrator.
How locked invoices behave
When you open an invoice that has been locked β either by a payroll run or by a financial date close β the invoice displays in read-only mode. The following actions are blocked regardless of your role or permissions:
- Adding items to the invoice
- Overriding item prices
- Applying or removing discounts
- Editing tip amounts
An inline message appears directly on the invoice to inform you that it is locked. The message text depends on which type of lock is in effect.
Important: A locked invoice cannot be modified by front desk staff. If the guest's situation requires a change, contact your center manager or administrator to determine the appropriate resolution path (such as processing a refund on a separate invoice or adjusting the financial lock date).
What the lock message tells you
The message displayed on a locked invoice identifies the type of lock in effect:
| Lock type | When it applies | Message source |
|---|---|---|
| Payroll lock | The invoice falls within a payroll period that has already been processed | Message configured by your administrator for payroll-locked invoices |
| Financial date lock | The invoice falls within a financial period that has been closed by an administrator | Message configured by your administrator for financially locked invoices |
Both message texts are set by your organization's administrator. If you are unsure which lock applies, read the message displayed on the invoice β it will reflect the lock type your administrator configured.
Note: If you are an administrator and need to update these messages, configure them in your organization's POS settings. The payroll lock message and the financial date lock message are each set independently.
What appears on the right panel of a locked invoice
On an open invoice, the right panel displays tabs for Items, Discounts, and Tips (depending on your organization's configuration). On a locked invoice, the panel behaves differently:
| Tab | Behavior on a locked invoice |
|---|---|
| Items | Always hidden. No items can be added to a locked invoice. |
| Discounts | Shown only when at least one discount has already been applied to the invoice. If no discounts exist on the invoice, this tab is hidden. |
| Tips | Shown only when at least one tips-related feature is enabled for your organization or center (tips, service charges, environmental fee, cashback, or donations). If none of these features are enabled, this tab is hidden. |
This means the right panel of a locked invoice may appear minimal or empty β this is expected behavior, not an error.
Note: Even when the Discounts or Tips tabs are visible on a locked invoice, they are read-only. You can view the values that were applied, but you cannot change them.
Worked example
A guest visits the front desk to ask about a discount on an invoice from last month. You open the invoice and see the financial date lock message. The right panel shows only the Discounts tab (because a 10% service discount was applied at the time of checkout) and the Tips tab (because your center has tips enabled). The Items tab is not visible. You can show the guest the applied discount and tip amounts, but you cannot modify either.
Commission editing on locked invoices
On a payroll-locked invoice, commission editing is blocked for all line items. If a staff member attempts to edit the commission on any line item of a payroll-locked invoice, Zenoti displays an error message indicating that the action is not permitted.
Important: Commission edits on payroll-locked invoices are blocked to protect the integrity of a processed payroll run. Allowing changes after payroll has been run would create discrepancies between what was paid to providers and what the system records. If a commission correction is genuinely required, contact your administrator or payroll manager to determine the correct resolution process.
Commission editing on invoices locked only by a financial date lock follows the same blocked behavior as payroll-locked invoices β the invoice is read-only in its entirety.
Adding an item that requires a date of birth
Some items in your catalog β such as certain services or products β require a guest's date of birth before they can be added to an invoice. This applies to unlocked, open invoices only; locked invoices block all item additions regardless of guest profile completeness.
When you select an item that requires a date of birth and the guest's profile does not yet include one, Zenoti opens the guest screen scoped to the date-of-birth field. The rest of the guest profile is not shown β you only see what is needed to unblock the item.
Steps
- Select the item you want to add to the invoice from the appropriate catalog tab (Services, Products, Packages, Memberships, or Gift Cards).
- If the guest's date of birth is missing, the guest screen opens automatically, displaying only the date-of-birth field.
- Enter the guest's date of birth and save.
- Once saved, Zenoti adds the item to the invoice automatically. You do not need to re-select the item.
- If you close the guest screen without saving a date of birth, the item is not added. The rest of the invoice remains unchanged β no other items or payments are affected.
Note: If you need to add the item but the guest declines to provide their date of birth, close the guest screen. The invoice returns to its previous state with the item not added. You can continue with other items on the invoice or proceed to payment.
Worked example
A front desk associate selects a facial treatment that has a minimum-age requirement. The guest's profile has no date of birth on record. The guest screen opens showing only the Date of Birth field. The associate enters the guest's date of birth (for example, 15 March 1990) and saves. The facial treatment is immediately added to the invoice without any further action from the associate.
Tips
- If you regularly encounter locked invoices when trying to assist guests with post-visit changes, ask your administrator whether the financial lock date is set appropriately for your center's workflows.
- When a guest requests a change to a locked invoice, document the request and escalate to your manager. In many cases, the appropriate resolution is a separate adjustment or refund rather than modifying the original invoice.
- The Discounts tab on a locked invoice is useful for showing guests exactly which discounts were applied at checkout. You can use this view to explain the invoice total without needing to unlock anything.
- When the date-of-birth prompt appears, gather the information from the guest before closing the screen β closing without saving means you must select the item again to retry.
Troubleshooting
The locked invoice shows no right-panel tabs at all.
This occurs when no discounts were applied to the invoice and no tips-related features (tips, service charges, environmental fee, cashback, or donations) are enabled for your organization or center. This is expected behavior. The Items tab is always hidden on locked invoices, and the other two tabs appear only under the conditions described above. No action is needed.
The lock message on the invoice is missing or blank.
The message text is configured by your administrator. A blank message means the administrator has not yet set the message for that lock type. Contact your administrator to configure the payroll lock message or the financial date lock message in your organization's POS settings.
A provider reports they cannot edit commission on a line item, but the invoice does not appear locked.
Verify whether the invoice falls within a processed payroll period. Payroll locks may not always be obvious from the invoice view alone. If payroll has been run for the period containing that invoice, commission editing will be blocked. The provider or manager should contact your payroll administrator for guidance.
A manager needs to correct an invoice that is financially locked.
Only an administrator can lift a financial date lock by adjusting the financial lock date in the organization settings. Front desk staff cannot bypass or override this lock. Escalate to an administrator with the appropriate access.
The guest screen opened when I selected an item, but I accidentally closed it without saving.
The item was not added to the invoice. The rest of the invoice is unchanged. Select the item again from the catalog tab to re-trigger the date-of-birth prompt, then enter and save the guest's date of birth.
Entering credentials in the Unlock prompt does not unlock a group invoice.
The Unlock prompt (user name and password of a user whose role can reopen invoices) removes the lock that is applied when an invoice is printed or emailed, and it works on one invoice at a time. A group invoice locked this way has no unlock action, and unlocking one of its invoices does not unlock the group β no error is shown. Contact Zenoti Support to unlock a group invoice. The prompt never lifts a financial date lock: an invoice inside the financial lock period shows "This invoice is under financial lock. Unlocking is not allowed", and only an administrator changing the financial lock date can release it β see Secure financial and inventory data.