Tour America NYC is a New York sightseeing operator running guided tours of Manhattan, Harlem, Brooklyn, Queens and the Bronx, plus full-day trips to Washington, Boston, Philadelphia and Amish Country and a daily shuttle to Woodbury Common outlets. It sells in English and Spanish to domestic and international visitors, with licensed guides and drivers.
Connecting Tour America NYC to Ventrata lets you resell products from operators that use Tour America NYC as their booking system. Ventrata reads their live availability and prices from Tour America NYC, and every booking you take is created directly in the operator's Tour America NYC account.
To learn more about Tour America NYC, visit touramericanyc.com.
📒 NOTE
Live article says this connection is in testing and may not be available to all users.
Primary website | |
Tags | Custom / Proprietary Operator System |
Connection features | Availability Sync · Pricing Sync · Bookings Sync |
Developed by | Ventrata (using Tour America NYC OCTO API) |
This operator connection (also called a backend) lets you resell products from operators that use Tour America NYC as their primary booking system, with every booking created directly in Tour America NYC. Features of this connection include:
Availability Sync – live availability comes from the operator's Tour America NYC account.
Pricing Sync – prices come from Tour America NYC, or you set prices in Ventrata.
Bookings Sync – bookings, updates and cancellations post from Ventrata to Tour America NYC, and Tour America NYC issues the tickets or vouchers.
Creating the Tour America NYC 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.
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
Ask the operator for the OCTO API Key for your account.
In the Ventrata Dashboard, go to Products → Operators and open the operator. If they don't exist yet, create them as an operator first.
In the Backend Partner section, select Tour America NYC and enter the OCTO API Key.
Press Update Operator.
📒 NOTE – Each OCTO API Key connects you to one operator. Set up each Tour America NYC operator separately.
Step 2: Connect Each Product
Open the operator's product in Products → Products and edit it. Check that Operator is set to this operator.
Tick Backend Connected. Tick Backend Availability to use availability from Tour America NYC, and Backend Pricing to use prices from Tour America NYC.
Press Update Product.
📒 NOTE
Tour America NYC 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.
Mapping Products to Tour America NYC
‼️ IMPORTANT
Mapping tells Ventrata which Tour America NYC 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.
In the Ventrata Dashboard, go to Products → Products and open the product.
Open the Mappings tab. It appears once the product is set to Backend Connected.
For each Ventrata option and unit, select the matching Tour America NYC product, option and units from the dropdowns, which Ventrata loads from Tour America NYC. Don't leave any field empty.
Press Save Changes.
📗 TIP
Make a test booking after mapping, and ask the operator to confirm it arrived in their Tour America NYC account.
Managing the Tour America NYC Connection
Update the mapping when the operator changes products, options or units in Tour America NYC.
Replace the key on the operator if Tour America NYC 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 Tour America NYC.
Connection Features Detailed
This section is for anyone who wants to know exactly how the Tour America NYC connection works. Here the direction is the opposite of a reseller connection: Ventrata calls Tour America NYC, using Tour America NYC OCTO API. For each feature, it explains which calls Ventrata makes, when, and what that means for you.
In short: Ventrata asks Tour America NYC for availability and prices whenever someone looks at a backend-connected product, and creates every booking in the operator's Tour America NYC account. Tour America NYC doesn't send changes back to Ventrata.
Timings are typical for Tour America NYC and rounded, and they can change.
Product Mapping | ✅ |
You map each Ventrata product, option and unit to the operator's Tour America NYC product in the Ventrata Dashboard. This works as follows:
What this means for you: if something is missing from the dropdown, the operator hasn't made it available to you in Tour America NYC. Ask them to. |
Content Sync | ❌ |
Ventrata doesn't import product content from Tour America NYC. Ventrata doesn't import product content from Tour America NYC. You create and describe the products in Ventrata yourself. |
Availability Sync | ✅ |
With Backend Availability on, Ventrata checks the operator's live availability in Tour America NYC. This works as follows:
What this means for you: customers book against the operator's live Tour America NYC availability, so you can't oversell a slot the operator has already sold elsewhere. |
Pricing Sync | ✅ |
With Backend Pricing on, Ventrata takes prices from Tour America NYC. This works as follows:
Tour America NYC 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 Tour America NYC. Promotions aren't sent to Tour America NYC. 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 Tour America NYC account. This works as follows:
‼️ IMPORTANT – Bookings sync one way, from Ventrata to Tour America NYC. If the operator changes or cancels a booking in Tour America NYC, 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 Tour America NYC. Pickup and drop-off details aren't passed to Tour America NYC. Share them with the operator another way if a product needs them. |
Custom Questions Sync | ❌ |
Answers to your booking questions aren't passed to Tour America NYC. Answers to your booking questions aren't passed to Tour America NYC. Share them with the operator another way if they need them. |
Extras Sync | ❌ |
Extras and add-ons aren't booked in Tour America NYC. Extras and add-ons aren't booked in Tour America NYC. Only the main product, option and units are. |
Redemption Sync | ❌ |
Redemptions and other status changes in Tour America NYC aren't sent back to Ventrata after a booking is confirmed. Redemptions and other status changes in Tour America NYC aren't sent back to Ventrata after a booking is confirmed. |
Pass Walkup Scanning Sync | ❌ |
Pass walk-up scanning isn't available with Tour America NYC. Pass walk-up scanning isn't available with Tour America NYC. |
Gift Card Sync | ❌ |
Ventrata gift cards aren't passed to Tour America NYC. Ventrata gift cards aren't passed to Tour America NYC. Gift card payments stay in Ventrata. |
✅ supported · ❌ not supported
Good to know: limits and details of the Tour America NYC connection
Good to know: limits and details of the Tour America NYC connection
Live availability: availability comes from Tour America NYC as people browse.
One-way bookings: changes the operator makes in Tour America NYC don't reach Ventrata.
FAQs
I get an error when I save the operator's backend configuration.
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.
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 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 Tour America NYC. Ask the operator. If the issue persists, contact our Technical Support.
Bookings fail for a backend-connected product.
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 Tour America NYC. If the issue persists, contact our Technical Support.
📚 More about Ventrata connections
Partner Information
Tour America NYC
Ventrata Partner ID: e3c4c14e-65c5-4b37-8769-16b558cecaa1