Locker Troubleshooting

Quick Fix

Verify the locker assignment first, then re-send the locker code. This takes about 2 minutes.

This guide helps you resolve common locker pickup issues.

Quick reference

What you see	Why it happens	Do this
Guest can’t open locker	Wrong code or stuck locker	Check the locker assignment
Auto-assign says it needs a room assignment	Reservation has no room assigned in the PMS yet	Assign the room first
Auto-assign says stay dates are missing	Check-in or check-out date is missing in the PMS	Fix stay dates
Auto-assign shows "Missing Lock Mapping"	Room is not mapped for room access	Check room mapping
Wrong key in locker	Misplaced key or wrong assignment	Verify room-to-locker mapping
All lockers appear assigned	Stale assignments	Clear assignments

Auto-Assign says waiting for room assignment

What you see: Auto-assign results show "Waiting for room assignment" or "Needs room assignment".

Fix:

1. Assign a room to the reservation in your PMS.
2. Wait for the updated room assignment to sync into AVA.
3. Retry auto-assign, or assign a locker manually from the reservation.

Auto-Assign says stay dates are incomplete

What you see: Auto-assign results say stay dates are incomplete or missing.

Fix:

1. Open the reservation in your PMS.
2. Confirm Check-in and Check-out dates are both set.
3. Save changes and wait for AVA to sync.
4. Retry auto-assign.

Auto-Assign shows "Missing Lock Mapping"

What you see: Auto-assign results show "Missing Lock Mapping" or an error with "(404)".

Fix:

1. Confirm the reservation has a room assigned in the PMS.
2. Confirm the room appears correctly in AVA.
3. Recheck your room access setup:
   • Locker grid configuration: Set Up Locker Systems
   • Room list and mapping: Room Metadata Management
4. Retry the assignment.

Guest can’t open locker

What you see: Guest enters the code and the locker does not open.

Fix:

1. Verify the locker code is correct.
2. Confirm the locker is assigned to the reservation.
3. Check for physical obstructions.
4. Use the manual override if available.

Wrong key in locker

What you see: Guest retrieves a key for another room.

Fix:

1. Check the room-to-locker assignment.
2. Verify housekeeping placed the correct key.
3. Reassign the locker and update the key.

All lockers appear assigned

What you see: The grid shows only assigned (blue) cells.

Fix:

1. Confirm check-outs are processed in the PMS.
2. In Locker Setup, click Clear Assignments.
3. Retry assignment for new check-ins.

Still Stuck?

Contact success@vouch-technologies.com if:

• ❌ Lockers remain assigned after clearing assignments
• ❌ Guests cannot open lockers across multiple attempts
• ❌ Locker codes are not generated

Helpful to include:

• Locker system type
• Screenshot of the locker grid
• Time the issue started

Related Guides

• Locker Systems Overview
• Set Up Locker Systems
• Locker Guest Instructions