<!-- https://unlockos.io/manual/checkin-history -->

# Check-in History Help

## Overview

Check-in History displays past check-in and check-out records. Use filter functions to narrow down by specific periods or statuses.

![Check-in History screen](https://unlockos.io/help/images/checkin-history/main.en.webp)

## Key Features

- View list of check-in/check-out history
- Filter by date, email, plan name, etc.
- Display statistics
- View entry/exit keys

---

## Filters

| Filter | Description |
|--------|-------------|
| Date Range | Specify start and end dates |
| Time Range | Specify start and end times |
| Email Address | Search by guest email address |
| Plan Name | Filter by plan name used |
| Reservation Number | Reservation number (for accommodation plans) |
| Stay Status | Before Use/Staying/Checked Out |
| Event | Check-in/Check-out/Cancel, etc. |

---

## Display Fields

| Field | Description |
|-------|-------------|
| Email Address | Guest's email address |
| Check-in Date/Time | Date and time of check-in |
| Check-out Date/Time | Date and time of check-out |
| Check-in Plan Name | Applied pricing plan |
| Check-in Status | Check-in state |
| Check-out Status | Check-out state |
| Total Payment Amount | Total payment amount |
| Entrance Key | Display entry QR code |
| Exit Key | Display exit QR code |

---

## Stay Status

| Status | Description |
|--------|-------------|
| Before Use | Reserved but not yet checked in |
| Staying | Checked in and currently in use |
| Auto-Checkout Pending | Auto-checkout is being processed |
| Checked Out | Check-out complete |

---

## Statistics

The following statistics are displayed on the right side of the screen:

| Statistic | Description |
|-----------|-------------|
| Total Check-ins | Total check-ins within the displayed period |
| Staying | Number of guests currently staying |
| Before Use | Number of reservations waiting to check in |
| Checked Out | Number of completed check-outs |
| Total Usage Amount | Total amount for the displayed period |

---

## Actions

### Viewing Entry/Exit Keys

Click the "Entrance Key" or "Exit Key" button on each history item to display the QR code.

### Recording a receipt against a postpaid balance (settling outstanding cash)

For a stay on a postpaid plan (the amount is finalized after use) with an outstanding balance, a red **"Outstanding: ¥○○"** label and a **"Record payment"** button appear below the stay's total amount. Neither appears on a stay with a ¥0 outstanding balance (fully settled).

1. Click **"Record payment"** to open the receipt dialog
2. Enter the amount received (defaults to the full outstanding amount), the payment method (cash / bank transfer / other), the date and time received, and an optional note
3. Click **"Record receipt"** — the receipt is recorded and the outstanding amount is reduced by that amount

> **⚠️ This is the one screen that accepts a partial receipt.** A reservation's or a membership fee's receipt only records an amount that exactly matches what is due, but here you can record only part of the outstanding balance (e.g. recording ¥1,000 against an outstanding ¥3,000 is valid). You cannot, however, record more than the outstanding amount — doing so returns "The amount received does not match the amount due."

> This screen settles a postpaid balance on a stay that has already checked in — it does not issue a new key (the guest is already checked in). For settling an on-site payment before check-in, see ["Received on-site" on the reservation detail](reservation.md#recording-an-on-site-payment-received-on-site); for on-site membership fees, see [Membership Plans and Usage Quotas](membership-plans.md#feature-17-recording-an-on-site-fee-receipt).

### Data Export

Currently, on-screen data export functionality is not provided. You can retrieve data using the API.

---

## Auto-Checkout

Auto-checkout automatically checks out guests when their plan's usage period ends. No manual action is required from facility owners or guests.

### How Auto-Checkout Works

Guests are automatically checked out at the following times depending on the plan type:

| Plan Type | Auto-Checkout Timing |
|-----------|---------------------|
| Accommodation | At the reservation end date/time |
| Daily Flat | At the end of the usage period |
| Hourly | At business hours closing time (24 hours after check-in for 24H facilities) |
| Time Slot Booking | At the end of the booked time slot |
| Duration Flat | At the end of the usage period |
| One-Time | 24 hours after check-in |

### Auto-Checkout in History

Auto-checkout records are displayed with the checkout type "Auto." Manual checkouts display as "Manual," so you can easily distinguish between them.

### Auto-Checkout Pending Status

When an auto-checkout is being processed, the status shows "Auto-Checkout Pending." This typically changes to "Checked Out" within a few minutes.

---

## FAQ

### Q: How long is check-in history stored?
A: History is stored indefinitely.

### Q: Can I force checkout a staying guest?
A: Forced checkout is not available from this screen. Guests must perform checkout themselves, or wait for the auto-checkout to occur when the plan's usage period ends.

### Q: Can I use past QR codes?
A: No, QR codes for checked-out guests are invalidated. Also, QR codes have an expiration time.

### Q: What is auto-checkout?
A: Auto-checkout is a feature that automatically checks out guests when their plan's usage period ends. For example, accommodation plans auto-checkout at the reservation end time, and hourly plans auto-checkout when business hours end. No manual checkout action is needed.

### Q: What happens with billing when auto-checkout occurs?
A: Billing follows the plan's payment settings. For prepaid plans, payment has already been completed at check-in. For postpaid plans, the amount is finalized based on the actual usage time.

### Q: Can I disable auto-checkout?
A: Auto-checkout is automatically configured based on the plan type and cannot be disabled individually. All plans have auto-checkout at the end of their usage period.

### Q: The "Record payment" button doesn't show up
A: The button does not appear on a stay with a ¥0 outstanding balance (already settled), or on a stay that has no postpaid balance to begin with (a fully prepaid stay).

### Q: Can I record a receipt for more than the outstanding amount?
A: No. Entering an amount greater than the outstanding balance returns "The amount received does not match the amount due" and is not recorded. Handle any excess separately, for example with a refund.

---

## Related Pages

- [Check-in List](checkin-list.md)
- [Check-in Configuration](checkin-config-form.md)
- [Unlock Lab](unlock-lab.md)
- [Reservation Creation & Editing](reservation.md)
- [Membership Plans and Usage Quotas](membership-plans.md)
- [Ticket Books](ticket-books.md)

---

Last updated: 2026-09-08 - Documented recording a receipt against a postpaid balance ("Record payment" button, partial receipts allowed) (Epic #3421 / #3428)
