Surfaces
Shop Order Claim
Shop order lookup, QR scan support, pickup release, eligibility checks, and claim audit records.
First created Last updated
Overview
Shop Order Claim is the event-day release surface for shop orders. It works like a dedicated claim/check-in desk for merch orders rather than attendee entry. Staff can search by order reference, buyer email/name, pasted QR payload, or camera QR scan where the browser supports QR detection.
Dashboard route
/ems/manage/shop-order-claim?id=:eventId
Lookup methods
| Method | Use for |
|---|---|
| Order reference | Fast lookup when the buyer shows a shop order reference. |
| Buyer search | Finds orders by buyer email or display name. |
| Pasted QR payload | Use when scanner hardware or camera support is unavailable. |
| Camera QR scan | Uses browser QR detection where supported. |
QR payloads are normalized before lookup, so staff can scan or paste a plain ref, a URL with an order ref, or a JSON-like payload containing a ref.
Release rules
Only confirmed paid orders in a release-eligible state can be released. If an order is unpaid, rejected, cancelled, voided, or not ready, resolve the issue in Shop Orders before handing over items.
The release action stores:
| Field | Why it matters |
|---|---|
| Order ID and event ID | Ties the release to the exact shop order. |
| Lookup method | Shows whether staff used QR, order ref, search, or manual lookup. |
| Claimant name | Helps resolve pickup disputes. |
| Released by | Records the staff account that released the order. |
| Notes | Stores operational context for exceptions. |
Related surfaces
Use Shop Orders for payment review, internal notes, and status changes. Use Shop Orders Dashboard to monitor ready-for-claim and release throughput. Use Inventory Tracking to check stock if a release cannot be completed.
Common mistakes
- Do not release an order before payment is confirmed.
- Do not release an order that is not physically ready.
- Do not use attendee check-in as proof that a standalone shop order has been claimed.
- Do not skip claimant notes when someone other than the buyer picks up the order.