ZenotiHelp

Mandatory Guest Fields Check at Invoice Close

ZTZenoti Docs Team Updated September 8, 2026 6 min readGuide

When a guest's profile is missing required information, Zenoti automatically surfaces the gap at the moment you close an invoice. This prevents invoices from being finalized with incomplete guest records and ensures that mandatory profile data is collected before the transaction completes. In addition, when your organization requires guests to be checked in before payment, Zenoti verifies check-in status as the very first step of the close sequence β€” before any other prompt appears.

Audience: Front desk staff who close invoices at the point of sale.


On this page


Before you begin

  • The guest must be added to the invoice before you attempt to close it.
  • Your organization must have at least one mandatory guest profile field configured. If no mandatory fields are set, the profile fields check does not appear and the invoice closes without interruption. For information about which fields are configured as mandatory in your organization, contact your Zenoti administrator or see your organization's configuration settings.
  • If your organization has enabled the Don't enable payments without check-in setting, the guest must be checked in before you can close a single invoice. This check runs before any other close-time prompt β€” including payment notes and the mandatory profile fields screen.
  • The check-in gate applies to single invoices only. Group invoices are not subject to this requirement.

Permission: You need the Add or Edit permission on the Appointments security object to close invoices at the point of sale. Admin path: Security Roles > [your role] > Permissions tab > Appointments > Add / Edit

Steps

Close an invoice when the guest has not been checked in

Note: This section applies only when your organization has enabled the Don't enable payments without check-in setting, and only for single invoices. Group invoices are not affected.

  1. Open the guest's single invoice in the point of sale (POS).
  2. Proceed through the invoice β€” add items, apply discounts as needed.
  3. Select the option to close the invoice.
  4. Because the guest has not been checked in, the system stops the close immediately and displays the reason. No other prompt β€” such as a receipt email address or payment notes β€” appears. The close action is released so you can take the next step.
  5. Check the guest in using the Appointment Book.
  6. Return to the invoice and select the option to close it again. The close sequence continues normally from this point.

Note: The blocked-close message appears exactly once. If you see a blank message or the same message twice, see Troubleshooting below.

Worked example: A guest named Maya arrives for a massage. The front desk agent opens Maya's invoice and selects close. Because Maya has not been checked in yet, the system immediately stops the close and displays the reason β€” without asking for a receipt email address or any other information. The agent checks Maya in from the Appointment Book, returns to the invoice, and selects close again. The invoice proceeds normally.

Close an invoice with all mandatory fields already complete

  1. Open the guest's invoice in the point of sale (POS).
  2. Proceed through the invoice β€” add items, apply discounts, and collect payment as usual.
  3. Select the option to close the invoice.
  4. Because all mandatory guest profile fields are already filled in, the system proceeds directly to payment notes without interruption. The invoice closes normally.

Close an invoice when mandatory guest profile fields are missing

  1. Open the guest's invoice in the point of sale (POS).
  2. Proceed through the invoice β€” add items, apply discounts, and collect payment as usual.
  3. Select the option to close the invoice.
  4. Before reaching payment notes, the system checks the guest's profile for mandatory fields. If any required fields are missing, the guest profile screen opens automatically, focused on the fields that need to be completed.
  5. Fill in the required fields. The specific fields presented depend on which profile fields your organization has marked as mandatory (for example, referral source or nationality).
  6. Submit the updated guest profile information.
  7. Once the required fields are submitted, the invoice close proceeds and continues to payment notes as normal.

Note: You cannot skip this step. The invoice close does not continue until you submit the required guest profile information.

Worked example: A guest named Alex visits your center for a facial. When the front desk agent selects close on Alex's invoice, the system detects that Alex's profile is missing a referral source and nationality. The guest profile screen opens, pre-focused on those two fields. The agent selects "Walk-in" for referral source and enters Alex's nationality, then submits. The invoice close immediately continues to payment notes.

Tips

  • Check guests in promptly on arrival. When your organization requires check-in before payment, checking guests in as they arrive prevents the close from being stopped at the payment step. This is especially important during busy periods when delays at checkout affect the entire queue.
  • The check-in gate does not apply to group invoices. If your center regularly uses group invoices (for example, for couples or families), those invoices are not subject to the check-in requirement and close normally regardless of check-in status.
  • Complete guest profiles at check-in. Encourage front desk staff to review and complete a guest's profile when they arrive, rather than waiting until invoice close. This avoids delays at a busy checkout point.
  • Know your organization's mandatory fields. Familiarize yourself with which fields your organization requires so you can proactively gather the information from guests during the appointment.
  • The prompt is per-guest, not per-invoice. Once a guest's mandatory fields are on file, the prompt will not appear again for that guest on future visits β€” unless additional fields are later configured as mandatory by your administrator.

Troubleshooting

Symptom Likely cause Resolution
The close is blocked with a check-in message even though you believe the guest is checked in The check-in status may not have refreshed after the guest was checked in, or the check-in was recorded against a different appointment Verify the guest's check-in status in the Appointment Book, confirm it is linked to the correct appointment, then retry closing the invoice
The blocked-close message appears twice, or an empty message appears A display issue occurred during the close-blocked notification Dismiss all messages, then retry closing the invoice; if the problem recurs, refresh the page and reopen the invoice
The close is blocked with a check-in message on a group invoice Group invoices are not subject to the check-in gate; a different issue is preventing the close Check for other blocking conditions (such as open sub-invoices or a financial lock) and resolve them; the check-in gate itself does not apply to group invoices
The guest profile screen appears every time you close this guest's invoice A mandatory field was saved blank or the submission did not complete successfully on the previous visit Open the guest profile directly, locate the mandatory fields, enter valid values, and save the profile before attempting to close the invoice again
The guest profile screen opens but does not show any fields to fill in A configuration mismatch may exist between the mandatory fields list returned by the server and the fields available on the profile screen Ask your Zenoti administrator to verify that the mandatory fields are correctly configured in your organization's guest profile settings
The invoice close does not continue after you submit the guest profile The submission may not have completed β€” a network interruption or a validation error on the profile form can prevent the close from resuming Check the profile form for any remaining validation errors, correct them, and resubmit; if the problem persists, refresh the page and reopen the invoice
Was this article helpful?
Your feedback helps us improve our documentation.