Project description:

Tour booking integration specification

Set in the shadow of the Virunga Volcanoes and the Albertine branch of the African Rift Valley, Kingfisher Journeys (KFJ) is the adventure activity tour operator for Rwanda, a small but spectacular country in East Africa and home to the mountain gorillas!

With a British owner KFJ is a small company that employs local African guides and takes clients on tours to small remote communities where sadly, many people still live in poverty. We’re therefore helping to transform lives of people who work with us – not with aid, but by giving them the opportunity to earn a living. 

With no tourists visiting Rwanda because of the coronavirus, this is a tough time – but we’re determined to bounce back as quickly as possible when people begin to travel again. And to do that we need an integrated booking platform that will link the booking of our activities with hotels to create fully bookable tours.

If this project is a success and you help us to make significant bookings as a result, you will be offered a free tour in Rwanda to see the gorillas!

~

The purposed of this project is therefore to develop a tour booking integration from which we can sell complete tours to retail, business clients and via third party Online Travel Agency websites. 

Each tour we run includes multiple pre-defined instances of the following components:

·       Activities (See TrekkSoft API: https://developer.trekksoft.com)

·       Hotels (See HotelBeds API: https://developer.hotelbeds.com/docs/read/apitude_booking)

The platform will use these services to:

·       Allow the admin user to

o   Create, manage and delete multiple tour templates including

§  Define the channels (retail / API) and if API which agent(s) may query about and book the tour.

§  Define a discount (as percentage or absolute) that will be applied to the price for each channel / agent.

§  Specify the valid dates on which each tour can begin.

§  Define the activities in each tour and the day of the tour on which they should be booked

§  Define the hotels and available hotel rooms in each tour and the day of the tour on which they should be booked

§  Define whether hotel rooms will be booked on a twin sharing basis with single supplement or on an individual basis.

§  Required information needed to be supplied by retail clients and agents (eg guest names / passport numbers etc)

o   List tour bookings, showing relevant details including:

§  Booking customer (or agent)

§  Tour booked 

§  Date of booking

§  Date of tour start

§  Date of tour end

§  Price paid

§  Status, reserved, paid or cancelled.

o   Manually create, manage and cancel tour bookings

§  Where the APIs allow activity and hotel bookings to be amended or cancelled similar functions should also available to the admin user.

o   Manage a list of approved agents

·       Query TrekkSoft and HotelBeds to:

o   Find the availability and price of each activity / hotel rooms on the relevant date for each tour

o   Calculate the availability and price of the complete tour on each valid date

o   Process reservations, bookings and cancelations of the activities and hotels rooms

·       Present a website widget for retail clients to use on KFJ’s website:

o   Present a calendar of valid dates on which the tour is available for booking

o   Allow the user to add tours to an online cart that allows the client to enter all required information

o   Process payment via a Payment Gateway

·       And for agents (who could be human run tour operators or online travel agents)

o   Provide an agent API and a web interface for human agent users to:

§  Query/ view the list of available tours

§  Query/ view the availability and price of any available tour on any given date or via a calendar

§  Create a reservation of any available tour 

§  List the Bookings that the agent has made

§  Send a request to cancel any booking that they have made

o   The API only should allow the processing of payments

Example:

Tour A has the following itinerary:

Day 1: 

·       Activity: City Tour

·       Hotel A

Day 2:

·       National Park 

·       Hotel B

Day 3:

·       Activity: Nature walk

·       Hotel C

So if the tour is available on 01 Jan 2021, 08 Jan 2021 and 15 Jan 2021, then:

·       The City Tour and Hotel A will be booked on 01 Jan 2021, 08 Jan 2021 and 15 Jan 2021

·       The National Park and Hotel B will be booked on 02 Jan 2021, 09 Jan 2021 and 16 Jan 2021

·       The Nature walk and Hotel C will be booked on 03 Jan 2021, 10 Jan 2021 and 22 Jan 2021