🏨 Travel Broker Admin Documentation

Welcome to the Travel Broker Admin Panel!
This comprehensive guide will walk you through the process of extracting hotel offers from our admin search system and integrating them into the bookingTravel website. As an administrator, you can search for hotel offers using HyperGuest hotel codes, view NET prices for 2-person stays, and generate the necessary codes and URLs for product integration. The results are organized by room types and rate plans (full board, self-catering, etc.), making it easy to select the right offer for your customers.

📋 Overview of the Process

The admin panel allows you to:

Search Hotels: Use HyperGuest hotel codes to find available offers
View NET Prices: See wholesale prices for 2-person stays
Generate Integration Codes: Get EAN_ISBN codes for product creation
Extract Availability URLs: Get iframe URLs for product pages
Organize Results: View offers grouped by room type and rate plan

🔍 Step-by-Step Guide

Access the Admin Search Panel

Navigate to the admin search interface to begin your hotel offer search.

URL: /admin/search

💡 Tip: You can access this directly from the main dashboard or by typing the URL in your browser.

Enter Hotel Search Parameters

Fill in the required search parameters to find hotel offers:

Hotel ID: Enter the HyperGuest hotel code (e.g., 19912)
Check-in Date: Select your desired check-in date
Number of Nights: Specify the duration of stay

                    Example Search:

                    Hotel ID: 19912

                    Check-in: 2024-03-15

                    Nights: 3

⚠️ Important: Make sure to use valid HyperGuest hotel codes. Invalid codes will return no results.

Execute the Search

Click the search button to query the HyperGuest API and retrieve available offers.

The system will automatically query HyperGuest with the following default parameters:

Number of Guests: 2 adults
Currency: EUR
Customer Nationality: DE (Germany)

Analyze Search Results

The search results will display NET prices from HyperGuest for the total stay duration for 2 people. Results are organized in a hierarchical structure:

🏠 Room Type Grouping

Results are first grouped by room types (e.g., Standard Double, Deluxe Suite, etc.)

🍽️ Rate Plan Subgrouping

Within each room type, offers are organized by rate plans:

Rate Plan Type	Description	Typical Code
BB	Bed & Breakfast	Room Only + Breakfast
HB	Half Board	Breakfast + Dinner
FB	Full Board	All Meals Included
SC	Self Catering	Room Only
AI	All Inclusive	All Meals + Drinks

Extract EAN_ISBN Integration Code

For each rate plan option, you'll see an input field containing the integration code. This code is crucial for product creation:

                    EAN_ISBN Code Format:

                    19912-12345-67890
                    19912 = Hotel ID
12345 = Room ID
67890 = Rate Plan ID

                

✅ Usage: Copy this complete code and paste it into the EAN_ISBN field when creating a new product in the bookingTravel website. This ensures the product links directly to this specific hotel, room type, and rate plan combination.

Generate Availability iframe URL

Click the "View Availability" button next to your chosen rate plan to generate the iframe URL for the product page.

🎯 Purpose: This button generates a direct URL to the availability calendar that can be embedded as an iframe in your product sales page.

                    Example Generated URL:
                    /availability/hotel/19912/12345/67890?month=2&year=2024
                

                    iframe Integration:

                    Use this URL in an iframe tag on your product page:

                    <iframe src="/availability/hotel/19912/12345/67890" width="100%" height="600"></iframe>

Create Product in bookingTravel Website

Now you have all the information needed to create a new product in your booking website:

📝 Required Information:

Hotel Details: Name, location, star rating (from search results)
Room Information: Room type name and features
Rate Plan: Board type and inclusions
Pricing: NET price for cost calculation
EAN_ISBN Code: The integration code you copied
Availability iframe: The URL for the availability calendar

⚠️ Critical: Always use the exact EAN_ISBN code from the search results. This code ensures that customer bookings are directed to the correct hotel, room, and rate plan combination.

Test the Integration

After creating the product, perform these verification steps:

Availability Check: Verify the iframe displays correctly on the product page
Voucher Test: Create a test voucher with the EAN_ISBN code
Booking Flow: Test the complete booking process
Price Verification: Confirm prices match the NET rates from search

✅ Success Indicators:

Availability calendar loads correctly
Voucher validation works with test codes
Booking redirects to correct hotel/room/rate plan
Prices are consistent throughout the flow

📊 Understanding the Data Structure

🏨 Hotel Information

Each search result provides comprehensive hotel details:

Property Info: Hotel name, star rating, location
Contact Details: Address, city, country
Amenities: Available facilities and services

🛏️ Room Details

Room information includes:

Room ID: Unique identifier for the room type
Room Name: Descriptive name (e.g., "Deluxe Ocean View")
Capacity: Maximum occupancy
Features: Room amenities and specifications

💰 Pricing Structure

Price Type	Description	Usage
NET Price	Wholesale price from HyperGuest	Your cost basis for margin calculation
Sell Price	Recommended retail price	Reference for competitive pricing
Currency	Price denomination (EUR, USD, etc.)	Ensure currency consistency

🔧 Troubleshooting Common Issues

❌ No Search Results

Verify the hotel ID is correct and active in HyperGuest
Check if the selected dates are in the future
Ensure the hotel has availability for the specified period
Confirm your API credentials are valid

🔗 iframe Not Loading

Verify the generated URL is complete and correctly formatted
Check for any JavaScript errors in the browser console
Ensure the iframe dimensions are appropriate
Confirm the availability endpoint is accessible

🎫 Voucher Validation Fails

Double-check the EAN_ISBN code format (hotelId-roomId-ratePlanId)
Verify the code was copied completely without extra characters
Ensure the voucher database entries are properly formatted
Check that the voucher hasn't already been redeemed

📈 Best Practices

✅ Optimization Tips

Regular Updates: Refresh hotel offers weekly to maintain current pricing
Seasonal Planning: Search for offers during different seasons to understand price variations
Rate Plan Analysis: Compare different rate plans to offer variety to customers
Documentation: Keep records of EAN_ISBN codes and their corresponding products
Testing: Regularly test the booking flow to ensure everything works smoothly

            💡 Pro Tips
            Use descriptive product names that include room type and board type
Set competitive margins based on NET vs. sell price comparisons
Create product categories for different types of accommodations
Monitor booking success rates to identify popular combinations
Keep backup EAN_ISBN codes for high-demand periods

        

📧 Email Testing

📧

Test Booking Confirmation Email

Use this button to send a test booking confirmation email to verify the email system is working correctly.

💡 Note: The test email will be sent with mock booking data to verify the email template and SMTP configuration are working correctly.

📞 Support and Additional Resources

🆘 Need Help?

If you encounter any issues or need clarification on any step:

Technical Support: Contact the development team for API or integration issues
HyperGuest API: Refer to HyperGuest documentation for hotel code queries
Database Issues: Check voucher database integrity and format requirements

🎯 Quick Reference

Admin Search URL: /admin/search
EAN_ISBN Format: hotelId-roomId-ratePlanId
iframe URL Format: /availability/hotel/{hotelId}/{roomId}/{ratePlanId}
Default Parameters: 2 guests, EUR currency, DE nationality

Travel Broker Admin Documentation - Version 7

Last Updated: 2025 | Author: DerekSolutions, S.L