Opera Romana Pellegrinaggi is the pilgrimage organization of the Vicariate of Rome, serving pilgrims since 1933 with Rome and Vatican itineraries, Holy Land, Lourdes, Fatima and Santiago journeys, and the OMNIA Vatican and Rome card. It brings Italian and international faith travelers, parish groups and schools booking guided religious and cultural programs in Rome and the Vatican, in Italian, English, Spanish, French and German.
Connecting Opera Romana Pellegrinaggi to Ventrata lets you resell products from operators that use Opera Romana Pellegrinaggi as their booking system. Ventrata reads their live availability from Opera Romana Pellegrinaggi, and every booking you take is created directly in the operator's Opera Romana Pellegrinaggi account.
To learn more about Opera Romana Pellegrinaggi, visit operaromanapellegrinaggi.org.
Primary website | |
Tags | Custom / Proprietary Operator System |
Connection features | Availability Sync · Bookings Sync |
Developed by | Ventrata (using Opera Romana Pellegrinaggi API) |
This operator connection (also called a backend) lets you resell products from operators that use Opera Romana Pellegrinaggi as their primary booking system, with every booking created directly in Opera Romana Pellegrinaggi. Features of this connection include:
Availability Sync – live availability comes from the operator's Opera Romana Pellegrinaggi account.
Bookings Sync – bookings post from Ventrata to Opera Romana Pellegrinaggi, and Opera Romana Pellegrinaggi issues the tickets or vouchers.
Opera Romana Pellegrinaggi's external API used for this connection is a custom API that does not follow the OCTO API standard, which may limit certain functionality and capabilities.
Creating the Opera Romana Pellegrinaggi 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 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 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 Opera Romana Pellegrinaggi and enter the API key.
Press Update Operator.
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 Opera Romana Pellegrinaggi.
Press Update Product.
Mapping Products to Opera Romana Pellegrinaggi
‼️ IMPORTANT
Mapping tells Ventrata which Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi product, option and units from the dropdowns, which Ventrata loads from Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi account.
Managing the Opera Romana Pellegrinaggi Connection
Update the mapping when the operator changes products, options or units in Opera Romana Pellegrinaggi.
Replace the key on the operator if Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi.
Connection Features Detailed
This section is for anyone who wants to know exactly how the Opera Romana Pellegrinaggi connection works. Here the direction is the opposite of a reseller connection: Ventrata calls Opera Romana Pellegrinaggi, using Opera Romana Pellegrinaggi API. For each feature, it explains which calls Ventrata makes, when, and what that means for you.
In short: Ventrata asks Opera Romana Pellegrinaggi for availability whenever someone looks at a backend-connected product, and creates every booking in the operator's Opera Romana Pellegrinaggi account. Opera Romana Pellegrinaggi doesn't send changes back to Ventrata.
Timings are typical for Opera Romana Pellegrinaggi and rounded, and they can change.
Product Mapping | ✅ |
You map each Ventrata product, option and unit to the operator's Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi. Ask them to. |
Content Sync | ❌ |
Ventrata doesn't import product content from Opera Romana Pellegrinaggi. Ventrata doesn't import product content from Opera Romana Pellegrinaggi. You create and describe the products in Ventrata yourself. |
Availability Sync | ✅ |
With Backend Availability on, Ventrata checks the operator's live availability in Opera Romana Pellegrinaggi. This works as follows:
What this means for you: customers book against the operator's live Opera Romana Pellegrinaggi availability, so you can't oversell a slot the operator has already sold elsewhere. |
Pricing Sync | ❌ |
Ventrata doesn't read prices from Opera Romana Pellegrinaggi. Ventrata doesn't read prices from Opera Romana Pellegrinaggi. Products use the prices you set in Ventrata, and bookings still post to Opera Romana Pellegrinaggi. |
Promotions Sync | ❌ |
Promotions aren't sent to Opera Romana Pellegrinaggi. Promotions aren't sent to Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi account. This works as follows:
‼️ IMPORTANT – Bookings sync one way, from Ventrata to Opera Romana Pellegrinaggi. If the operator changes or cancels a booking in Opera Romana Pellegrinaggi, 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 Opera Romana Pellegrinaggi. Pickup and drop-off details aren't passed to Opera Romana Pellegrinaggi. Share them with the operator another way if a product needs them. |
Custom Questions Sync | ❌ |
Answers to your booking questions aren't passed to Opera Romana Pellegrinaggi. Answers to your booking questions aren't passed to Opera Romana Pellegrinaggi. Share them with the operator another way if they need them. |
Extras Sync | ❌ |
Extras and add-ons aren't booked in Opera Romana Pellegrinaggi. Extras and add-ons aren't booked in Opera Romana Pellegrinaggi. Only the main product, option and units are. |
Redemption Sync | ❌ |
Redemptions and other status changes in Opera Romana Pellegrinaggi aren't sent back to Ventrata after a booking is confirmed. Redemptions and other status changes in Opera Romana Pellegrinaggi aren't sent back to Ventrata after a booking is confirmed. |
Pass Walkup Scanning Sync | ❌ |
Pass walk-up scanning isn't available with Opera Romana Pellegrinaggi. Pass walk-up scanning isn't available with Opera Romana Pellegrinaggi. |
Gift Card Sync | ❌ |
Ventrata gift cards aren't passed to Opera Romana Pellegrinaggi. Ventrata gift cards aren't passed to Opera Romana Pellegrinaggi. Gift card payments stay in Ventrata. |
✅ supported · ❌ not supported
Good to know: limits and details of the Opera Romana Pellegrinaggi connection
Good to know: limits and details of the Opera Romana Pellegrinaggi connection
Live availability: availability comes from Opera Romana Pellegrinaggi as people browse.
One-way bookings: changes the operator makes in Opera Romana Pellegrinaggi don't reach Ventrata.
Custom API: Opera Romana Pellegrinaggi's API isn't OCTO, so some features may be limited compared with OCTO backends.
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 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 Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi. If the issue persists, contact our Technical Support.
📚 More about Ventrata connections
Partner Information
Opera Romana Pellegrinaggi
Via della Pigna
13/a, 00186 Roma (RM), Italy
Ventrata Partner ID: 71406b6f-be42-4a0e-82bf-8ff5d63c156a