Abkus Travel — Manual
The full operating manual for guests, hosts and managers. Two views over the same help articles: step by step by task, and a summary by topic.
Summary by topic
General Travel
Getting Started
StayOps Manager
Food Manager
Stay Clean Manager
Stay Maintenance Manager
Cars Clean Manager
Cars Maintenance Manager
Flys Maintenance Manager
Flys Ground Support Manager
Tour Guide Manager
Transfer Manager
Activity Operator Manager
Stays Manager
Cars Fleet Manager
Flys Airline Manager
Agency Manager
Property Management
Pricing & Payments
Billing
Troubleshooting
Legal & Compliance
Professional Directories
Fiscal & Invoices
Step by step, by task
Abkus Travel Platform Overview
- **Client 360**: Unified client view across all modules
- **Partner Network**: 1-3 partner hosts per vertical with commission sharing
- **AI Agents**: 16 built-in AI routines for automation
- **API Access**: Programmatic access with least-privilege keys
Getting Started as a Subscriber
- **ADMIN**: Full access to all settings and operations
- **OPERATOR**: Can manage reservations and daily operations
- **STAFF**: Limited access for task execution
AI Agents — Complete Reference
- **Cash Flow & Financial Alert** — Monitors payables and alerts on cash flow risks
- **Inventory & Procurement** — Tracks supply levels and auto-reorders
- **Client Profitability Scoring** — Scores clients A-D by margin analysis
- **Workload Forecasting** — Projects job hours vs staff availability
- **Client Prospecting** — Identifies warm leads from review signals
- **Route Optimization** — Calculates most efficient daily job sequences
- **Staff Productivity Analysis** — Compares job duration vs estimates
- **Invoice & Billing Automation** — Drafts invoices on job completion
- **Dynamic Pricing** — Auto-adjusts rates based on demand
- **Guest Concierge** — Drafts contextual guest responses
- **Guest Risk & Trust Scoring** — Assigns trust tiers from booking history
- **Damage Detection** — Analyzes inspection photos for vehicle damage
- **Renter Risk Scoring** — Evaluates driver risk from license/claim history
- **Maintenance Predictor** — Predicts fleet maintenance needs
- **Package Builder** — Combines Flys + Stays + Cars into itineraries
- **Supplier Performance Ranking** — Ranks operators by reliability
StayOps — Managing Cleaning Tasks
- **CHECKOUT**: Full cleaning after guest departure (auto-generated on reservation completion)
- **MID_STAY**: Light cleaning during extended stays
- **DEEP_CLEAN**: Periodic deep cleaning scheduled manually
- **PENDING**: Created, awaiting assignment
- **IN_PROGRESS**: Staff assigned and working
- **DONE**: Completed
StayOps — Staff Productivity & AI Analysis
- **A** (Top Performer): ≥ 90% completion rate AND ≥ 80% on-time
- **B** (Solid): ≥ 75% completion rate
- **C** (Below Average): ≥ 50% completion rate
- **D** (Low Performer): < 50% completion rate
Food Manager — Restaurant & Menu Setup
- **À la Carte**: Individual items with pricing, dietary tags (vegan, gluten-free, etc.)
- **Fixed Menu**: Set meals at fixed prices (e.g., lunch special, tasting menu)
- **Group Menu**: Pre-set menus for tour groups with negotiated pricing
Food Manager — Group Meals & Tour Integration
- Pre-set menus with per-person pricing
- Dietary tracking per guest
- Table layout and seating arrangements for groups
- Pre-payment or invoicing options
- **Tour Guide Manager**: Lunch included in day tours
- **Transfer Manager**: Coordinated meal stops on transfer routes
- **Stays Manager**: Breakfast packages for hotel guests
- Cooking classes with local chefs
- Wine tasting and vineyard tours
- Market visits with guided tasting
- Craft brewery and distillery tours
- Cross-sell as add-ons to accommodation packages
Stay Clean Manager — Task & Staff Management
- **CHECKOUT**: Full clean after guest departure (auto-generated from reservation completion)
- **MID_STAY**: Light touch during extended stays
- **DEEP_CLEAN**: Scheduled periodic deep cleaning
- **A**: ≥ 90% completion, ≥ 80% on-time
- **B**: ≥ 75% completion
- **C**: ≥ 50% completion
- **D**: < 50% completion
Flys Maintenance Manager — Aircraft MRO Operations
- **Scheduled**: A/B/C/D checks per flight hour/cycle intervals
- **Unscheduled**: Corrective maintenance, AD compliance, LLP removal
Flys Maintenance Manager — MRO Supplier Management
- **FAA Part 145** (US): Repair station certificate
- **RBAC 145** (Brazil): Certificado de oficina de manutenção
- **EASA Part 145** (Europe): Maintenance organization approval
Flys Ground Support Manager — Supplier & Performance
- **Ground Handling**: Ramp, pushback, de-icing, passenger handling
- **Fuel Suppliers**: Jet fuel, AVGAS, sustainable aviation fuel (SAF)
- **Catering**: In-flight meal preparation and delivery
- **Aircraft Detailing**: Exterior and interior cleaning
- On-time delivery rate
- Response time to service requests
- Incident/complaint rate
- Score: A (excellent) to D (poor)
Stays — Setting Up Your Property
- **Name**: A descriptive name for your property
- **Type**: Select from available property types
- **Address**: Street, city, state, country, and postal code (validated for BR and US)
- **Max Guests**: Maximum occupancy
- **Listing Type**: ENTIRE_PLACE, ROOMS_ONLY, or BOTH
- Name, description, and unit type
- Nightly rate in cents (e.g., 15000 = $150.00)
- Amenities, bed configuration, accessibility features
- Bathrooms, bedrooms, beds count
Stays — Managing Reservations
- **PENDING**: Awaiting confirmation or payment
- **CONFIRMED**: Payment received, booking secured
- **IN_PROGRESS**: Guest checked in
- **COMPLETED**: Stay finished, checkout processed
- **CANCELLED**: Booking cancelled
- Auto-generates cleaning tasks for the unit
- Triggers staff commission if an assignedStaffUserId is configured
- Updates availability calendar
Cars — Fleet Management
- Make, model, year, plate, VIN
- Transmission, fuel type, doors, seats
- Daily rate in cents
- Color, cargo volume, features
- **AVAILABLE**: Ready to rent
- **RENTED**: Currently on rental
- **MAINTENANCE**: In service
- **OUT_OF_SERVICE**: Permanently removed
- Record current mileage and fuel level
- Set nextMaintenanceKm for automatic alerts
- View maintenance history via VehicleMaintenanceOrder
- Use the AI Maintenance Predictor for proactive service scheduling
Cars — Rental Operations
- Select vehicle, customer, dates
- Set pickup/dropoff branch (optional)
- Record initial fuel level and mileage
- License number and expiry date
- Points tracking and blacklist status
- Rental history for risk assessment
- License points (> 10 = HIGH risk)
- Past damage claims (3+ = HIGH risk)
- Blacklist status (flagged = HIGH risk)
- Recommended deposit levels adjust automatically
Flys — Aircraft & Flight Operations
- Make, model, year, registration (tail number)
- Engine type, serial numbers, max takeoff weight
- Airworthiness certificate type and expiry
- Insurance details and coverage limits
- Origin/destination (ICAO/IATA codes)
- Scheduled departure/arrival times
- Crew assignments (pilot, co-pilot, cabin crew)
- Aircraft assignment
- Passenger count and revenue tracking
- Pilot and crew licensing with type ratings
- Medical certificate expiry tracking
- Flight hour logging (total, last 30 days, last 7 days)
- Duty time compliance
Flys — Maintenance & Compliance
- MRO provider assignment
- Maintenance type and ATA chapter
- Hours and cycles at maintenance event
- Component replacements and life-limited parts
- **MRO Providers**: Aircraft maintenance organizations
- **Ground Handling**: Ramp and ground services
- **Catering**: In-flight catering providers
- **Detailing**: Aircraft detailing and cleaning
- **Crew Staffing**: Temporary crew placement
- On-time departure percentage
- Cancellation rate
- Maintenance reliability
- Score: A (≥ 90% on-time, zero cancellations) to D (< 50% on-time)
Agency — Booking & Service Order Management
- Select tour type, date, and provider
- Enter client information (auto-resolves to Client 360)
- Set total price and currency
- Track status: DRAFT → CONFIRMED → COMPLETED
- Link to an existing booking
- Select the activity operator provider
- Set service type: TOUR, TRANSFER, or ACTIVITY
- Record cost and commission percentage
- On COMPLETED, automatically records SERVICE commission
- Full name, document type and number
- Nationality and date of birth
- Special needs accommodations
- Required for charter and group transport compliance
- **Tour Guides**: Licensed guides with language, specialization, and rates
- **Transfer Providers**: Transport companies with fleet details
- **Activity Operators**: Activity organizers with commission configuration
Agency — Commission Configuration
- Setting commissionPercent on the user's profile
- Setting assignedStaffUserId on the booking
- Select a partner host per vertical
- Set the commission percentage
- Future bookings involving both hosts can trigger PARTNERSHIP commissions
Subscription Gating & Data Retention
- The user is locked out of all operational dashboard areas and redirected to the **Billing page** ('/dashboard/settings/payments').
- **Data Safety:** During this suspension, all your database records, configurations, and history are **safely preserved and secure**. No data is lost.
US sales tax helpers
- Keep **Abkus-managed default** in Settings — estimates apply automatically on US bookings.
- Keep property addresses accurate (lodging uses the stay location) and Client ZIP/state when known.
- Only if you already pay for a tax engine: paste **HTTPS base URL + token** under Own mode. That is the only subscriber action required for BYO.
- Settings: [/dashboard/settings/sales-tax](/dashboard/settings/sales-tax)
- Fiscal NF-e (Brazil): [/help/fiscal-nfe-provider](/help/fiscal-nfe-provider)
- Subscriber FAQ: [/help/fiscal-faq-subscribers](/help/fiscal-faq-subscribers)
NF-e transmission provider (anti-tying)
- Open **Settings → Fiscal NF-e**.
- Select **Abkus-managed default** (usual) or **Your own NF-e API**.
- For Own mode, paste base URL + API token only — the token is encrypted at rest with a key derived from Abkus Hub (no server-side env key needed).
- Settings: [/dashboard/settings/fiscal](/dashboard/settings/fiscal)
- US sales tax: [/help/us-sales-tax-helpers](/help/us-sales-tax-helpers)
- Subscriber FAQ: [/help/fiscal-faq-subscribers](/help/fiscal-faq-subscribers)
Fiscal FAQ for subscribers (all managers)
- Open **Settings → US sales tax** and/or **Settings → Fiscal NF-e**.
- Leave Abkus default — **or** paste base URL + API token (Own mode).
- Keep property / branch / Client ZIP-state accurate when you have them.
- Book as usual: entered amounts are **subtotals**; estimated US tax is snapshotted on guest bookings when applicable.
- [/help/us-sales-tax-helpers](/help/us-sales-tax-helpers)
- [/help/fiscal-nfe-provider](/help/fiscal-nfe-provider)
- Sales and learning tours on each manager dashboard (last step is fiscal)
- Module Help hubs link back to this FAQ
Travel Provider Integrations
- **Hotelbeds APItude** — 185,000+ hotels in 185 countries, plus 70,000+ activities (transfers, theme parks, tickets)
- **Amadeus Self-Service** — 300+ airlines, 400,000+ hotels, 45 car rental companies
- **Duffel Flights** — 20+ airlines via modern REST API, no GDS legacy
- **SiteMinder** — Sync availability with Booking, Expedia, Airbnb, Agoda
- **Cloudbeds** — PMS with booking engine, payments
- **Mews** — Modern PMS with booking, payments
- Register directly with the provider and obtain your API credentials
- Go to **Dashboard → Settings → Integrations**
- Select the provider and enter your credentials
- Save. Provider inventory becomes available in search and package building.