Skip to main content

City Sightseeing Italy: Reseller Connection

Connect City Sightseeing Italy to Ventrata to scan its vouchers for your products at your entrance, with each voucher recorded as a booking and redeemed automatically.

City Sightseeing Italy logo

 

City Sightseeing Italy runs open-top hop-on hop-off routes in fourteen Italian cities including Rome, Florence, Milan, Naples, Palermo, Turin, Verona, Genoa, Livorno and Civitavecchia, with more than 100 red buses. It sells multi-day tickets with multilingual commentary through its app and a website in English, Italian, Spanish and French, plus gift vouchers. For operators, it brings bus passengers and website visitors who add local tours and attraction entries to their bus ticket, international city-break visitors and cruise passengers calling at Civitavecchia, Livorno and Messina.

 

Connecting City Sightseeing Italy to Ventrata lets you accept City Sightseeing Italy vouchers for your products. When you scan a voucher, Ventrata checks it with City Sightseeing Italy, records it as a booking in Ventrata and redeems it.

 

To learn more about partnering with City Sightseeing Italy, visit city-sightseeing.it.

 

Primary website

Tags

Operator Reselling Others · Sightseeing & Hop-On Hop-Off

Destination markets

🇮🇹 Italy

Source markets

🌎 Global

Connection features

Product Mapping · Redemption Sync · Pass Walkup Scanning Sync

Developed by

Ventrata (using City Sightseeing Italy's API)

 

This reseller connection lets you accept City Sightseeing Italy vouchers at your entrance without entering bookings by hand. Features of this connection include:

  • Product Mapping – City Sightseeing Italy's products are listed on the connection, and you map each one to your Ventrata product and option.

  • Redemption Sync – vouchers you scan are redeemed with City Sightseeing Italy.

  • Pass Walkup Scanning Sync – customers with a City Sightseeing Italy voucher can be scanned at your entrance without a booking in Ventrata.

 

Creating the City Sightseeing Italy Connection

🔐 Required Role Permissions: See Connections, Modify Connections

Before you begin:

  • You must have a commercial agreement with City Sightseeing Italy for them to sell your products. To inquire about partnering with them, contact them via city-sightseeing.it.

  • You must have City Sightseeing Italy created as a Reseller in Ventrata.

  • You must have an API key from City Sightseeing Italy.

  • Your Ventrata products must have the unit types City Sightseeing Italy sells, such as Adult, Child, Infant or Family.

 

  1. In Ventrata Dashboard, go to Connections → Connections, click + New Connection, and select City Sightseeing Italy from the list of partners.

  2. Select City Sightseeing Italy Reseller from the list of your resellers (must be created before creating a connection).

  3. Enter the API Key from City Sightseeing Italy.

  4. (Optional) You can also set the connection Name of your choosing, which may be helpful if you plan to have multiple City Sightseeing Italy connections and would like to differentiate between them more easily in the future.

  5. Create the connection. Ventrata checks the API key and loads City Sightseeing Italy's products into the connection. If the key is wrong, you'll see an error on the API Key field.

 

Mapping City Sightseeing Italy Products

Each City Sightseeing Italy product appears as a row on the connection. Map each one you accept to a Ventrata product and option:

  1. In Ventrata Dashboard, open the City Sightseeing Italy connection.

  2. For each City Sightseeing Italy product, select the matching Ventrata product and option.

  3. Save your changes.

 

📒 NOTE

You don't map units. Ventrata matches each ticket type on the voucher to a unit on your product: Adult to an adult unit, Reduced to a child unit, Infant to an infant unit and Family to a family unit. If your product doesn't have the matching unit, the voucher can't be redeemed.

 

📗 TIP

When City Sightseeing Italy adds or removes products, refresh the connection's mappings so the list matches.

 

Managing the City Sightseeing Italy Connection

  • Scan vouchers wherever you redeem Ventrata tickets. Ventrata looks up the voucher with City Sightseeing Italy, creates an open-dated booking for the mapped product and option with the ticket quantities on the voucher, and redeems the voucher with City Sightseeing Italy.

  • Update the mapping when City Sightseeing Italy changes its products.

  • Replace the API key if City Sightseeing Italy issues a new one.

 

Connection Features Detailed

This section is for anyone who wants to know exactly how the City Sightseeing Italy connection works. Here Ventrata calls City Sightseeing Italy's API: to load its products when you save the connection, and to look up and redeem each voucher you scan.

 

In short: customers buy your product from City Sightseeing Italy and get a City Sightseeing Italy voucher. When they arrive, you scan it, and Ventrata creates the booking and redeems the voucher with City Sightseeing Italy.

 

Product Mapping

✅

You map each City Sightseeing Italy product to a Ventrata product and option on the connection.

This works as follows:

  • When you save or refresh the connection, Ventrata reads City Sightseeing Italy's product list and shows each product as a row to map.

  • Ticket types on a voucher (Adult, Reduced, Infant, Family) are matched to your product's units automatically.

  • Rows for products City Sightseeing Italy no longer offers are removed.

Content Sync

❌

City Sightseeing Italy doesn't read your product content from Ventrata.

City Sightseeing Italy uses the content set up on its own side.

Availability Sync

❌

City Sightseeing Italy doesn't check your availability.

Bookings from City Sightseeing Italy are open-dated and created only when a voucher or pass is scanned, so they don't use your availability ahead of time.

Pricing Sync

❌

City Sightseeing Italy doesn't read your prices.

City Sightseeing Italy sets its own prices. Settle the amounts for each redemption with City Sightseeing Italy under your agreement.

Promotions Sync

❌

Your Ventrata promotions don't apply on City Sightseeing Italy.

Set up any promotions with City Sightseeing Italy directly.

Bookings Sync

❌

City Sightseeing Italy doesn't send bookings to Ventrata in advance.

A booking is created in Ventrata only when you scan the voucher or pass at your entrance.

Pickups/Dropoff Sync

❌

Not part of this connection.

Arrange any pickups with the customer directly.

Custom Questions Sync

❌

Not part of this connection.

Ask the customer for any extra details at your entrance.

Extras Sync

❌

Not part of this connection.

Sell extras separately, for example on arrival.

Redemption Sync

✅

When you scan, Ventrata redeems the voucher or pass with City Sightseeing Italy.

This works as follows:

  • Ventrata looks up the voucher with City Sightseeing Italy and checks that it's mapped.

  • Ventrata redeems the voucher with City Sightseeing Italy and saves the booking in Ventrata.

  • If the voucher is already recorded in Ventrata, the existing booking is used instead of creating a new one.

Pass Walkup Scanning Sync

✅

Customers with a City Sightseeing Italy voucher or pass can be scanned at your entrance without a booking in Ventrata.

This works as follows:

  • Scan the City Sightseeing Italy voucher code wherever you redeem Ventrata tickets.

  • Ventrata creates an open-dated booking for the mapped product and option, with one ticket per person on the voucher.

Gift Card Sync

❌

Ventrata gift cards can't be sold or redeemed through City Sightseeing Italy.

Gift cards bought in Ventrata can't be used on City Sightseeing Italy.

✅ supported · ❌ not supported

 

Good to know: limits and details of the City Sightseeing Italy connection

  • One product per voucher: all tickets on a voucher must be for the same product. Otherwise the voucher is rejected with "Option code mis-match".

  • Open-dated bookings: voucher bookings aren't tied to a date or time slot.

  • Unit types: your product needs a unit for each ticket type on the voucher.

 

FAQs

I see "... is not mapped in ..." when I scan a voucher.

The City Sightseeing Italy product on the voucher isn't mapped yet. Open the connection, map the product to a Ventrata product and option, and scan again.

I see "... is not available for product ..." when I scan a voucher.

Your Ventrata product doesn't have a unit for one of the ticket types on the voucher. Add the matching unit (adult, child, infant or family) to the product and scan again.

I see "Redemption not allowed" when I scan a voucher.

The voucher wasn't found or can't be redeemed. Check the code with the customer or with City Sightseeing Italy. If the issue persists, contact our Technical Support.

I get an error on the API Key field when I save the connection.

Ventrata couldn't read City Sightseeing Italy's products with this key. Check the API key with City Sightseeing Italy. If the issue persists, contact our Technical Support.

 

 

Partner Information

City Sightseeing Italy

 

Ventrata Partner ID: f490bad6-cb69-4dc7-9988-2768c6b75d24

Did this answer your question?