Skip to main content

Prague Boats: Operator Backend

Connect Prague Boats to Ventrata to resell Prague Boats operators' products with live availability, prices and bookings.

Prague Boats logo

 

Prague Boats is a river cruise operator on the Vltava in Prague, running sightseeing, lunch and dinner cruises since 1993 on a fleet that includes glass-roofed boats and fully electric catamarans. It sells to leisure visitors to Prague, with corporate charters, conferences, weddings and private celebrations on board alongside seasonal Advent, Christmas and New Year cruises.

 

Connecting Prague Boats to Ventrata lets you resell products from operators that use Prague Boats as their booking system. Ventrata reads their live availability and prices from Prague Boats, and every booking you take is created directly in the operator's Prague Boats account.

 

To learn more about Prague Boats, visit prague-boats.cz.

 

📗 TIP

Make a test booking after mapping and ask Prague Boats to confirm it arrived in their system.

 

Primary website

Tags

Custom / Proprietary Operator System

Connection features

Availability Sync · Pricing Sync · Bookings Sync

Developed by

Ventrata (using Prague Boats OCTO API)

 

This operator connection (also called a backend) lets you resell products from operators that use Prague Boats as their primary booking system, with every booking created directly in Prague Boats. Features of this connection include:

  • Availability Sync – live availability comes from the operator's Prague Boats account.

  • Pricing Sync – prices come from Prague Boats, or you set prices in Ventrata.

  • Bookings Sync – bookings, updates and cancellations post from Ventrata to Prague Boats, and Prague Boats issues the tickets or vouchers.

 

Creating the Prague Boats Connection

🔐 Required Role Permissions: See Operators, Modify Operators, See Products, Modify Products

Before you begin:

  • You must have a commercial agreement with the operator for their rates and terms.

  • You must have the OCTO API Key for the operator. See the steps below.

  • A commercial agreement with Prague Boats to resell their products.

  • You must recreate the operator's products in Ventrata. See how to create products. The connection syncs availability, pricing and bookings, but doesn't create products in Ventrata.

 

Step 1: Configure the Operator in Ventrata

Contact Prague Boats and request the OCTO API Key.

 

  1. In the Ventrata Dashboard, go to Products → Operators and open the operator. If they don't exist yet, create them as an operator first.

  2. In the Backend Partner section, select Prague Boats and enter the OCTO API Key.

  3. Press Update Operator.

 

 

 

📒 NOTE – Each OCTO API Key connects you to one operator. Set up each Prague Boats operator separately.

 

Step 2: Connect Each Product

  1. Open the operator's product in Products → Products and edit it. Check that Operator is set to this operator.

  2. Tick Backend Connected. Tick Backend Availability to use availability from Prague Boats, and Backend Pricing to use prices from Prague Boats.

  3. Press Update Product.

📒 NOTE

Prague Boats sends both retail and net prices. With Backend Pricing ticked, Ventrata records the retail price as your selling price and the net price as your cost price, whatever cost percentage is set on the operator.

 

Check Backend Availability to pull availability and Backend Pricing to pull pricing.

 

Without those, the product uses the availability and pricing set in Ventrata but still sends bookings to Prague Boats.

 

 

Mapping Products to Prague Boats

‼️ IMPORTANT

Mapping tells Ventrata which Prague Boats product, option and units to check availability for and book. If a backend-connected product isn't mapped correctly, its bookings fail. A red highlight across the product row shows an incorrectly mapped product.

 

  1. In the Ventrata Dashboard, go to Products → Products and open the product.

  2. Open the Mappings tab. It appears once the product is set to Backend Connected.

  3. For each Ventrata option and unit, select the matching Prague Boats product, option and units from the dropdowns, which Ventrata loads from Prague Boats. Don't leave any field empty.

  4. Press Save Changes.

 

📗 TIP

Make a test booking after mapping, and ask the operator to confirm it arrived in their Prague Boats account.

 

Managing the Prague Boats Connection

  • Update the mapping when the operator changes products, options or units in Prague Boats.

  • Replace the key on the operator if Prague Boats or the operator issues a new one.

  • Switch Backend Availability or Backend Pricing off on a product to use Ventrata's own availability or prices instead. Bookings still post to Prague Boats.

 

Connection Features Detailed

This section is for anyone who wants to know exactly how the Prague Boats connection works. Here the direction is the opposite of a reseller connection: Ventrata calls Prague Boats, using Prague Boats OCTO API. For each feature, it explains which calls Ventrata makes, when, and what that means for you.

 

In short: Ventrata asks Prague Boats for availability and prices whenever someone looks at a backend-connected product, and creates every booking in the operator's Prague Boats account. Prague Boats doesn't send changes back to Ventrata.

 

Timings are typical for Prague Boats and rounded, and they can change.

 

Product Mapping

✅

You map each Ventrata product, option and unit to the operator's Prague Boats product in the Ventrata Dashboard.

This works as follows:

  • Get Products (GET /products) – Ventrata reads the operator's Prague Boats products, options and units to fill the dropdowns on the Mappings tab.

 

What this means for you: if something is missing from the dropdown, the operator hasn't made it available to you in Prague Boats. Ask them to.

Content Sync

❌

Ventrata doesn't import product content from Prague Boats.

Ventrata doesn't import product content from Prague Boats. You create and describe the products in Ventrata yourself.

Availability Sync

✅

With Backend Availability on, Ventrata checks the operator's live availability in Prague Boats.

This works as follows:

  • Availability Check (POST /availability) – when someone uses the availability calendar in Ventrata, for example in the Dashboard, your web checkout or a terminal, Ventrata asks Prague Boats live for the dates on screen.

  • Syncs availability from Prague Boats' system.

 

What this means for you: customers book against the operator's live Prague Boats availability, so you can't oversell a slot the operator has already sold elsewhere.

Pricing Sync

✅

With Backend Pricing on, Ventrata takes prices from Prague Boats.

This works as follows:

  • Availability Check with the octo/pricing capability – Ventrata asks Prague Boats for prices with each availability request.

  • Syncs pricing from Prague Boats' system.

  • With Backend Pricing off, the product uses the prices you set in Ventrata, and bookings still post to Prague Boats.

Prague Boats sends both retail and net prices. With Backend Pricing ticked, Ventrata records the retail price as your selling price and the net price as your cost price, whatever cost percentage is set on the operator.

Promotions Sync

❌

Promotions aren't sent to Prague Boats.

Promotions aren't sent to Prague Boats. Your Ventrata promotions still apply to the price your customer pays in Ventrata.

Bookings Sync

✅

Bookings made in Ventrata for a backend-connected product are created in the operator's Prague Boats account.

This works as follows:

  1. Hold: Booking Reservation (POST /bookings) – when the product is added to the cart in Ventrata, Ventrata reserves the places in Prague Boats.

  2. Confirm: Booking Confirmation (POST /bookings/{uuid}/confirm) – after payment, Ventrata confirms the booking in Prague Boats with the customer's contact details, and the ticket or voucher Prague Boats returns becomes the Ventrata ticket or voucher.

  3. Change: Booking Update (PATCH /bookings/{uuid}) – changes made in Ventrata are sent to Prague Boats.

  4. Cancel: Booking Cancellation (POST /bookings/{uuid}/cancel) – cancellations made in Ventrata are sent to Prague Boats.

Sends bookings, updates and cancellations from Ventrata to Prague Boats.

 

‼️ IMPORTANT – Bookings sync one way, from Ventrata to Prague Boats. If the operator changes or cancels a booking in Prague Boats, Ventrata isn't notified. Ask the operator to tell you about any changes they make.

Pickups/Dropoff Sync

❌

Pickup and drop-off details aren't passed to Prague Boats.

Pickup and drop-off details aren't passed to Prague Boats. Share them with the operator another way if a product needs them.

Custom Questions Sync

❌

Answers to your booking questions aren't passed to Prague Boats.

Answers to your booking questions aren't passed to Prague Boats. Share them with the operator another way if they need them.

Extras Sync

❌

Extras and add-ons aren't booked in Prague Boats.

Extras and add-ons aren't booked in Prague Boats. Only the main product, option and units are.

Redemption Sync

❌

Redemptions and other status changes in Prague Boats aren't sent back to Ventrata after a booking is confirmed.

Redemptions and other status changes in Prague Boats aren't sent back to Ventrata after a booking is confirmed.

Pass Walkup Scanning Sync

❌

Pass walk-up scanning isn't available with Prague Boats.

Pass walk-up scanning isn't available with Prague Boats.

Gift Card Sync

❌

Ventrata gift cards aren't passed to Prague Boats.

Ventrata gift cards aren't passed to Prague Boats. Gift card payments stay in Ventrata.

✅ supported · ❌ not supported

 

Good to know: limits and details of the Prague Boats connection

  • Live availability: availability comes from Prague Boats as people browse.

  • One-way bookings: changes the operator makes in Prague Boats don't reach Ventrata.

 

FAQs

I get an error when I save the operator's backend configuration.

The OCTO API Key or endpoint is most likely incorrect. Check them with your operator. If the issue persists, contact our Technical Support.

There's no Backend Connected box in the product settings.

The operator set on the product most likely doesn't have a backend configured. Check the operator's Backend Partner settings and try again. If the issue persists, contact our Technical Support.

The product, option or unit I want to map isn't in the dropdown.

The dropdowns list what the operator has made available to you in Prague Boats. Ask the operator. If the issue persists, contact our Technical Support.

Bookings fail for a backend-connected product.

Check the product's mapping first: every option and unit must be mapped. Then check that the slot is still available in Prague Boats. If the issue persists, contact our Technical Support.

I get an error when saving the operator's backend configuration.

The credentials are most likely incorrect. Double-check them with Prague Boats. If the issue persists, contact Technical Support.

There is no Backend Connected checkbox in the product settings.

The operator selected on the product most likely has no backend configured. Check the operator's backend configuration and try again.

 

Useful Resources

 

 

Partner Information

Prague Boats

Nad Vavruskou 696/19

181 00 Prague 8, Czech Republic

 

Ventrata Partner ID: 64caef6d-3295-4558-905a-868e53e1607c

Did this answer your question?