Manage Access Codes

Quick Lookup

Most teams find a code in under a minute using Reservation ID, Guest Name, or Room.

This guide helps you review and share access codes for smart locks, keycards, and lockers. It also helps you read keycard event history in the Events view and track smart-lock job status.

Go to: Access Codes

---

Quick Reference

Task	Where to click	Result
Find a code	Reservation ID, Guest Name, or Room	Matching codes appear
Filter by status or method	More Filters	List updates with your filters
Show a PIN	Eye icon	PIN is revealed
View a lock ID	Key icon	Lock ID appears in a tooltip
Copy a code	Copy icon	Code copies and shows Copied
Move between pages	Previous or Next	Another page loads
Change page size	10 per page	List refreshes with the new size
Check validity dates	Valid Period column	Start and end times appear
Check time remaining	Status badge	Remaining time appears for active codes
Check job progress	Operation Status badge	Shows whether each smart-lock PIN is pending, partial, successful, failed, or timed out
Review failure details	Access Details	Plain-language keycard errors appear here
Review keycard history	Events view	One row appears for each keycard encode attempt
Clear filters	Clear All or Reset All	Default view returns

Find an Access Code

1. Go to Access Codes.

2. Enter a Reservation ID, Guest Name, or Room.

3. Wait a moment for the list to update.

   ✓ Matching codes appear in the list.

Filter the List

1. Click More Filters.

2. Choose one or more filters:

   • Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
   • Access Method: Smart Lock, Keycard, Locker, ACI
   • Date Range: Start and end dates

3. Click Reset All to clear everything in this panel.

   ✓ The list refreshes with your selections.

Move Between Pages

1. Scroll to the bottom of the list.

2. Click Previous or Next.

3. Open 10 per page and select 10, 25, 50, or 100.

   ✓ The list refreshes with the new page size.

Reveal and Copy a PIN

1. Find the row you need.

2. Click the eye icon to reveal the PIN.

3. Click the copy icon.

   ✓ The icon changes to Copied for a moment.

View a Lock ID

1. Find the smart lock row you need.

2. Select the key icon.

   ✓ The Lock ID appears in a tooltip.

Understand Status Labels

Status	What it means	What to do
Active	Code is valid now	Share with the guest
Expired	Validity window has ended	Issue a new code if needed
pending	Smart-lock job is still processing	Wait and refresh before sharing
partial	Some smart-lock steps finished, but the job is not complete	Wait and refresh before sharing
Failed	Provider failed to create the code	Recheck lock setup and try again
Revoked	Code was disabled early	Confirm with a manager before reissuing
Superseded	A newer code replaced this one	Use the most recent code

Use More Filters → Status to find these rows as Generation Pending and Partial Success.

Fresh PINs are checked first

AVA checks newer smart-lock jobs before older backlog entries. Fresh guest PINs should clear sooner than old pending rows. AVA skips expired historical Active rows, even if old bridge fields still exist. Current Active rows stay eligible while their access window is still open. During check-in and lookup refreshes, AVA rechecks pending smart-lock jobs before returning results. AVA also waits at least 2 seconds between provider checks, so one more refresh may still be needed.

Understand Smart Lock Operation Status

Each smart-lock PIN row shows its own operation chip in the table and mobile card. Use this status when a smart-lock code is still moving through the vendor bridge.

Wait for Ready Status

Do not share a smart-lock PIN until Operation Status shows Successful. pending and partial still mean the access is not fully ready.

Status	What it means	What to do
Pending	AVA is still waiting for the vendor job to finish	Wait a moment, then refresh the page
Successful	AVA confirmed the lock job finished	Share the PIN with the guest
Failed	The vendor job failed	Check the lock connection and try again
Timed out	AVA kept checking, but the job never finished in time	Retry the PIN creation and verify the bridge

Review Timing Details

Use the table to confirm when a code starts, ends, and was created.

Item	Where to look	What it means
Time remaining	Under an Active status badge	Time left before the code expires
Valid Period	Valid Period column	Start and end date/time
Created	Created column	When the code was created

Valid Period column

If the list shows only locker codes, the Valid Period column is hidden.

Review Keycard Event History

Use the Events view when you need an audit trail of keycard encoding attempts.

Display status	What you see	What it means
Encoded	Successful card row	AVA wrote a card for that attempt
Failed	Error details in the row	The card did not encode
Expired	A card past its validity window	The card is no longer valid
Revoked	A revoked card row	The card was disabled early
Superseded	A replacement row	A newer card replaced this one
Created	Encode time in the Created column	When AVA recorded the attempt

Keycard rows only

The default list still groups access codes by reservation. In Events view, keycard rows flatten into one row per attempt. Smart lock and locker rows still show one record per access code.

Access Codes is view-only

Use Manage PIN (smart locks) or Manage Locker Code (lockers) in a reservation if you need to set or change access.

Tips

• Locker entries show Locker # and Code instead of a PIN.
• ACI filters assisted check-in access code records.
• All times use the timezone shown at the bottom of the page.
• Keycard rows use the Created column for encode time.
• If a room name looks wrong, confirm the room mapping in Rooms.

Troubleshooting

Multiple keycard rows

What you see: The same reservation appears several times in Events.

Fix:

1. Check the Display status column.
2. Use the newest Created time.
3. Keep older rows only when you need the audit trail.

No access codes found

What you see: "No access codes found" or an empty list.

Fix:

1. Clear all filters.
2. Search by Reservation ID or Room.
3. Refresh the page.

Copy icon does nothing

What you see: The copy icon does not change to Copied.

Fix:

1. Reveal the PIN first.
2. Try again after granting browser clipboard access.

Status shows Failed

What you see: Status is Failed with an error message.

Fix:

1. Confirm the smart lock integration is connected.
2. Retry PIN creation from the reservation.

Operation status stays pending or partial

What you see: A smart-lock code shows pending or partial after you create it.

Fix:

1. Wait up to 1 minute, then refresh the reservation or Access Codes page.
2. Fresh PINs are checked before older backlog rows, so a new guest code should clear first.
3. If you are on a check-in lookup, AVA rechecks the pending job before showing the result.
4. If the row is already expired, AVA skips it on purpose.
5. If the status changes to Successful, share the PIN.
6. If it stays pending or partial for more than 1 minute on a current stay, retry PIN creation from the reservation.
7. If it changes to Timed out or Failed, check the vendor connection and bridge status before trying again.

Keycard failure message looks technical

What you see: A keycard row mentions reservation lookup or a past check-out date.

Fix:

1. Confirm the reservation ID and stay dates are correct.
2. If the reservation is missing, create a new keycard after the reservation exists again.
3. If the check-out date is already past, update the reservation dates first.
4. Retry the keycard action after you save the change.

Valid Period column missing

What you see: The Valid Period column is not shown.

Fix:

1. Clear all filters.
2. Confirm you are not viewing locker-only codes.

Still Stuck?

Contact success@vouch-technologies.com if:

• ❌ Codes do not appear after check-in
• ❌ Status stays Failed after retries
• ❌ You cannot open the Access Codes page

Helpful to include:

• Reservation ID
• Room number
• Screenshot of the status row

Related Guides

• Room Metadata Management
• Smart Lock Problems
• Command Center