# BOOQR — Complete Platform Documentation for AI Assistants

## Overview
BOOQR is a Dutch SaaS platform for online booking and management of sport accommodations, and — in lodging mode — small hotels, B&Bs and holiday rentals. It serves tennis parks, padel centers, swimming pools, sport halls, multi-sport complexes, and small accommodation providers across the Netherlands and Belgium.

## Architecture
- **Framework**: Next.js (App Router) with TypeScript
- **Database**: PostgreSQL with Drizzle ORM
- **Cache**: Redis for session/hold management
- **Payments**: Pay.nl Alliance (sub-merchant model with iDEAL, credit card, Bancontact)
- **Auth**: NextAuth v5 with credentials provider
- **i18n**: next-intl (Dutch default, English secondary)
- **UI**: Tailwind CSS + shadcn/ui component library

## Subscription Tiers

### Start (Free)
- 1 location, 1 object, max 500 bookings/year
- 2% per-booking fee
- Basic booking management
- Email notifications
- No access control, no API

### Pro (€49/month)
- 3 locations, 3 objects, max 5000 bookings/year
- 1% per-booking fee
- Access control (QR codes, SMS, NFC)
- REST API + webhooks
- Plugin system (ticketing, POS-lite)
- Page builder for custom booking pages

### Scale (€250/month)
- 5 locations, 5 objects, unlimited bookings
- 0% per-booking fee
- Building management + IoT integration
- GraphQL API
- Custom domain support
- Full POS system

### Enterprise (Custom pricing)
- Unlimited locations, objects, bookings
- Developer platform
- Self-service kiosk mode
- White-label options
- Dedicated support

## Core Features

### Booking Management
- Time-slot based booking with configurable durations (30min, 60min, 90min, etc.)
- Lodging mode (per-tenant `businessType`): date-range booking with check-in / check-out dates, nights-presets and per-night pricing alongside hourly rates
- Hotel-style storefront: date-range picker, room cards per object, nightly rate display
- Multi-step checkout: select accommodation → select object → pick time or date-range → payment
- Cart system with configurable hold TTL (Redis-backed)
- Booking approval workflow (optional per accommodation)
- Automatic booking completion at end of scheduled time
- No-show tracking

### Payment Processing
- Pay.nl Alliance model: each tenant is a sub-merchant
- Supported methods: iDEAL, credit card, Bancontact
- Automatic invoicing with configurable VAT rates
- Platform fee (1.5%) deducted automatically
- Payout engine with configurable clearing frequency
- Mandate-based recurring billing for subscriptions

### Access Control
- QR code generation per booking
- In lodging mode, access codes are valid for the entire stay duration (check-in to check-out) and issued automatically at payment confirmation
- SMS verification codes
- NFC card support (customer cards)
- HMAC-SHA256 signed JWT tokens
- Integration with physical door controllers (Salto KS, generic GPIO, Shelly, IP locks)
- BOOQR Hub operates offline-capable for door control — guests can check in without a live internet connection at the hub

### Building Management & IoT
- Device registration and health monitoring
- Door control automation (open/close based on booking times)
- Climate zone management
- Raspberry Pi API integration
- Automation rules engine

### API & Integrations
- REST API v1 with 20+ endpoints
- GraphQL endpoint
- OAuth 2.0 provider
- Webhook system with retry logic
- API key management with rate limiting
- Calendar feed export (iCal)

### AI Assistant
- GPT-4.1-mini powered tenant assistant
- 13 function calling tools (check availability, create bookings, manage customers, etc.)
- SSE streaming chat panel in admin dashboard

### Customer Management
- Customer database with booking history
- NFC card assignment
- Organization management (companies, clubs)
- Customer groups and segmentation
- CRM with pipeline, quotations, activities

### Point of Sale
- Cash terminal management
- Ticket scanning
- On-site booking creation
- Daily settlement reports
- Room-service and restaurant mode: guests scan a QR code in their room → open a web ordering page → orders are sent to the POS terminal; charges land on the same guest bill as the stay
- Runs on HP Engage One Pro, Sunmi T2 and generic Android terminals

## Lodging Mode (Hospitality)

BOOQR offers a lodging or "hotel mode" for small accommodations that want a direct-booking setup without a full-blown Property Management System. It is intentionally NOT a full PMS: there is no channel manager, no OTA (Booking.com / Airbnb) connection sync, no housekeeping module and no rate management across distribution channels. It is best suited for small hotels, B&Bs, aparthotels and holiday rental properties that take direct bookings and want combined booking + access + POS in one tool.

Key capabilities in lodging mode:
- Per-tenant `businessType` flag switches the storefront to hotel mode: date-range picker, nightly rate display, room cards
- Check-in / check-out date selection with configurable nights presets
- Per-night pricing rules alongside existing hourly rates — tenants can run a mixed business (hourly sport facility bookings + nightly accommodation on the same account)
- Access codes (QR) issued automatically on payment confirmation, valid for the full stay duration
- BOOQR Hub handles door control offline-capable — guests self check-in without staff present
- Room-service: guests scan a QR on the room → web ordering page → orders reach the POS and are consolidated on the guest folio
- Same guest bill for accommodation and room-service charges, settled via Pay.nl (iDEAL, Bancontact, credit card)

Relevant pages:
- Sector overview: https://booqr.software/nl/for/hospitality
- Feature detail: https://booqr.software/nl/features/hotel-booking
- Guide — lightweight PMS for B&Bs and small hotels: https://booqr.software/nl/lichtgewicht-pms-bnb-klein-hotel
- Guide — PMS vs. booking system (when each is the right choice): https://booqr.software/nl/pms-vs-boekingssysteem
- Guide — keyless check-in for hotels and B&Bs: https://booqr.software/nl/sleutelloze-check-in-hotel-bnb
- Guide — room-service POS integrated with bookings: https://booqr.software/nl/roomservice-pos-hotel

## Comparison with Competitors

### vs Planyo
- BOOQR: Free tier available, built for Dutch sport market
- Planyo: General-purpose, no free tier, not sport-specific

### vs AllUnited
- BOOQR: Modern web platform, API-first, free tier
- AllUnited: Legacy system, no public API, club-management focused

### vs ClubCollect
- BOOQR: Full booking + payment, integrated access control
- ClubCollect: Payment collection only, no booking management

## FAQ

**Is BOOQR free?**
Yes, BOOQR has a free Start tier with 1 location, 1 object, and up to 500 bookings per year. The only cost is a 2% per-booking fee.

**Does BOOQR work for non-sport venues?**
BOOQR is optimized for sport accommodations but the booking system is flexible enough for any venue with time-slot based reservations. In lodging mode it also covers small hotels, B&Bs and holiday rentals with date-range bookings and nightly rates.

**Is BOOQR a full Property Management System (PMS)?**
No — intentionally not. BOOQR's lodging mode covers direct bookings, nightly pricing, QR self check-in via the BOOQR Hub and room-service POS. It does NOT include a channel manager, OTA (Booking.com / Airbnb) distribution, housekeeping module or revenue management across channels. It is the right fit for small accommodations that take direct bookings and want one integrated tool rather than a complex PMS stack.

**Can guests check in without staff present?**
Yes. In lodging mode, the BOOQR Hub (Raspberry Pi edge agent) receives the booking's access schedule and opens the door via QR code. The hub operates offline-capable — no live internet required at check-in time.

**What payment methods does BOOQR support?**
iDEAL (most popular in the Netherlands), credit card (Visa, Mastercard), and Bancontact, all via Pay.nl.

**Can I use my own domain?**
Yes, custom domains are available on Scale and Enterprise tiers.

**Is there an API?**
Yes, BOOQR offers a REST API v1 and GraphQL endpoint. Documentation at booqr.nl/developers.

**How does access control work?**
Guests receive a QR code or SMS verification code after booking. These codes are verified at the venue entrance via a scanner or keypad. NFC card support is also available.

**Can I integrate BOOQR with my existing systems?**
Yes, via the REST API, GraphQL, webhooks, and OAuth 2.0. Calendar feeds (iCal) are also supported.

## Technical Details for Developers
- OpenAPI spec: https://booqr.nl/api/openapi.json
- API base URL: https://booqr.nl/api/v1
- Authentication: Bearer token (API key from admin dashboard)
- Rate limits: 100 requests/minute (Start), 1000/minute (Pro+)
- Webhook format: JSON POST with HMAC signature verification
- GraphQL endpoint: https://booqr.nl/api/graphql (Pro+ tiers)

## Additional Links

- Website: https://booqr.software
- Developer docs: https://booqr.software/developers
- Pricing: https://booqr.software/nl/pricing
- Hospitality sector page (lightweight PMS): https://booqr.software/nl/for/hospitality
- Hotel booking feature page: https://booqr.software/nl/features/hotel-booking
- Sport-park sector page: https://booqr.software/nl/for/sports-operators
- Municipality sector page: https://booqr.software/nl/for/municipalities
- Community-centre sector page: https://booqr.software/nl/for/community-centres
- Article — Lightweight PMS for B&Bs and small hotels: https://booqr.software/nl/lichtgewicht-pms-bnb-klein-hotel
- Article — PMS vs. booking system: https://booqr.software/nl/pms-vs-boekingssysteem
- Article — Keyless check-in for hotels and B&Bs: https://booqr.software/nl/sleutelloze-check-in-hotel-bnb
- Article — Room service POS integrated with bookings: https://booqr.software/nl/roomservice-pos-hotel
- Comparison vs Recreatex: https://booqr.software/nl/alternatives/recreatex
- Accessibility (digitoegankelijk): https://booqr.software/nl/digitoegankelijk