Skip to main content

Clorian Operator Connection

Learn how to connect to Clorian and resell operator products through Ventrata.

CLORIAN - RO.ME Museum Exhibition

Clorian is a ticketing platform for major cultural sites and venues. It handles over 32 million tickets annually and links with a network of over 14,000 distributors. Connecting Clorian through Ventrata automates booking management and inventory synchronisation via Clorian's B2B API.

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

Capabilities:

  • Sync live availability & static pricing from Clorian system, excluding promotional pricing.

  • Post bookings and cancellations from Ventrata to Clorian.

Does not support:

  • Booking updates from Ventrata to Clorian.

  • Products with promotions, including promotions via API


Create Connection

Prerequisites:

  • Commercial Agreement

    Sign a commercial agreement with the operator whose products you intend to resell through Clorian.

  • System Configuration

    Contact Clorian and request:

    • your API Key

    • Clorian credentials: Username and Password

Create Operator in Ventrata

To create the connection in Ventrata, follow these steps:

📗 TIP

Only fields marked with an asterisk * are required.

  1. In the Ventrata dashboard, go to Products > Operators.

    Operators

  2. Press the + New Operator button.

    New Operator

  3. (Required) Enter the operator's name.

    Operator Name

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

    Code

  5. (Optional) Enter the name of a contact person on the operator's side.

  6. (Optional) Enter an email address and password the operator can use to log into the operator portal if one is created.

    Operator Contact Details

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

    Address

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

    Country

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

    Tax ID & Tax Office

  10. (Optional) Enable sending notifications to the operator about new bookings.

  11. (Optional) Enter the email address(es) where the notifications will be sent.

    Notifications

  12. (Optional) Calculate the cost rate of products assigned to the operator.

  13. (Optional) Select which rate is the cost calculated from:

    • Retail Rate

    • Wholesale Rate

  14. (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

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

    Invoice Noshow

  16. (Optional) Enable automatic invoicing, setting the following parameters:

    Automatic Invoicing

  17. (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

  18. (Optional)Select how often operator invoices are generated.

  19. (Optional) Select which day of the week or month operator invoices are generated.

    Invoice Period & Day

  20. (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

  21. (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

  22. (Optional) Automatically redeem tickets when the operator prints them.

    Redeem on Print

  23. (Optional) Allow the operator to change the availability of products in the operator portal.

    Allow Update Availability

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

    See Only Redeemed Bookings

  25. (Optional) In the 'Backend Partner' field, select 'Clorian'.

    Backend Partner

  26. (Required) Enter the credentials you received from Clorian:

    • API Key

    • Username

    • Password

    Clorian Credentials

  27. (Optional) Select your preferred payment method for your products:

    • Deferred Payment (default by Clorian) - invoicing at a later date

    • Pre-payment - deposit


    📒 NOTE

    If your product inventory requires both payment payment methods, create two separate operators in Ventrata to handle payments correctly.


  28. 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.

  1. In the Ventrata dashboard, go to Products > Products.

    Products

  2. Select a product from the list.

  3. Press the pen and paper icon to edit the product.

    Edit Product Details

  4. Scroll down the product form or search for 'Operator'.

  5. Check the 'Backend Connected' box.

  6. Keep 'Backend Availability' checked.

    Assign Operator

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

    Backend Pricing

  8. Click the Update Product button.

    Update Product


Map Products

❗️IMPORTANT❗️

Mapping tells Ventrata which product to request availability from Clorian. 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

  1. On the product level, navigate to the Mapping tab.

    Mapping

  2. Select the mapped product from the dropdown list.

    This tells Ventrata which product to ask Clorian for.

    Select Product

  3. Map options if available.

    Backend Option

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

    Map Units

  5. Press the SAVE CHANGES button to save the mapping.

    Save Changes

  6. Make a test booking and ask Clorian to confirm the booking appears in their system.


Partner Information

Address:

Carrer de Veneçuela, 103, 1,

Sant Martí, 08019 Barcelona

Spain

Did this answer your question?