Onebox is a centralized ticket distribution system (TDS) that acts as a backend operator connecting primary event organisers with third-party sales channels. For suppliers already using Ventrata, Onebox functions as a single API gateway providing real-time access to a unified database of live event inventory, pricing, and assigned seating maps from multiple venues.

This operator connection (also referred to as backend) allows you to connect with operators that use Onebox as their booking system to resell their products through Ventrata.

Capabilities:

Sync live availability & static pricing from Onebox system.
Post bookings from Ventrata to Onebox.

Does not support:

Booking updates and cancellations from Ventrata to Onebox.

Create Connection

Prerequisites:

Commercial Agreement
Sign a commercial agreement with the operator whose products you intend to resell through Onebox.
System Configuration
Contact Onebox and request the following credentials:
- Channel ID
- Client Secret

Create Operator in Ventrata

To create the connection in Ventrata, follow these steps:

📗 TIP

Only fields marked with an asterisk * are required.

In the Ventrata dashboard, go to Products > Operators.

Operators
Press the + New Operator button.

New Operator
(Required) Enter the operator's name.

Operator Name
(Optional) Enter an internal reference, or a code, for the operator.

Code
(Optional) Enter the name of a contact person on the operator's side.
(Optional) Enter an email address and password the operator can use to log into the operator portal if one is created.

Operator Contact Details
(Optional) Enter or select the address of the operator's head office from the drop down.

Address
(Optional) Select the country where the operator's head office is located.

Country
(Optional) Enter the operator's tax ID and the tax office they report to.

Tax ID & Tax Office
(Optional) Enable sending notifications to the operator about new bookings.
(Optional) Enter the email address(es) where the notifications will be sent.

Notifications
(Optional) Calculate the cost rate of products assigned to the operator.
(Optional) Select which rate is the cost calculated from:
- Retail Rate
- Wholesale Rate
(Optional) Enter the default cost rate percentage.

📗 TIP
The default cost percentage is applied to a product's retail rate to calculate the operator cost rate. This cost rate is then accounted for with any product assigned to the operator.

Cost
(Optional) Check the 'Invoice Noshow' to invoice unredeemed tickets.

Invoice Noshow
(Optional) Enable automatic invoicing, setting the following parameters:

Automatic Invoicing
(Optional) Select the date used to determine which operator bookings are included on an invoice:
- Travel Date - the booking is included in the invoice if the travel date falls between the invoicing period
- Booking Date - the booking is included in the invoice if the booking is made within the invoicing period
- Redemption Date - the booking is included in the invoice if the booking is redeemed within the invoicing period
Invoice Date Field
(Optional) Select how often operator invoices are generated.
(Optional) Select which day of the week or month operator invoices are generated.

Invoice Period & Day
(Optional) Enter an email address of a manager on the operator's side, who will receive warnings when the number of assigned barcodes is below the set threshold.

Barcode Warning Email
(Optional) Enter a number denoting the lower limit of assigned operator barcodes. When the number of available barcodes falls below this limit, a warning email is triggered (see above).

Barcode Warning Threshold
(Optional) Automatically redeem tickets when the operator prints them.

Redeem on Print
(Optional) Allow the operator to change the availability of products in the operator portal.

Allow Update Availability
(Optional) Allow the operator to see only redeemed bookings in the operator portal.

See Only Redeemed Bookings
(Optional) In the 'Backend Partner' field, select 'Onebox'.

Backend Partner
(Required) Enter the credentials you received from Onebox:
- Channel ID
- Client Secret
Onebox Credentials
(Optional) Press the Create Operator button.

Create Operator

Assign Operator to Each Product

📒 NOTE

Recreate the products from Onebox in Ventrata, matching the Onebox configuration exactly.

In the Ventrata dashboard, go to Products > Products.

Products
Select a product from the list.
Press the pen and paper icon to edit the product.

Edit Product Details
Scroll down the product form or search for 'Operator'.
Check the 'Backend Connected' box.
Keep 'Backend Availability' checked.

Assign Operator
If you want to inherit pricing from the backend partner, check the 'Backend Pricing' box.

Backend Pricing
Click the Update Product button.

Update Product

Map Products

❗️IMPORTANT❗️

Mapping tells Ventrata which product to request availability from Onebox. If your backend connected products are not properly mapped, bookings of this product will fail. A red highlight across the product row indicates that a product is not correctly mapped.

Mapped Products - Correct & Incorrect Mapping

On the product level, navigate to the Mapping tab.

Mapping
Select the mapped product from the dropdown list.
This tells Ventrata which product to ask Onebox for.

Select Product
Map options if available.

Backend Option
Map the units. This tells Ventrata which units to request availability for and book.

Map Units
Press the SAVE CHANGES button to save the mapping.

Save Changes
Make a test booking and ask Onebox to confirm the booking appears in their system.