How to configure the ticket/voucher delivery format for tours

Blanca Castillo
Blanca Castillo
  • Updated

Where do I find it?

PRODUCTS > TOURS > SETUP > OPERATIONS/ SUPPLIERS

eefb9799-61ac-4657-aca5-94c5d7078a14.png

6ac03736-58cf-4fe5-8c37-571911da6569.png

 

 

012ccc48-4a2b-438c-b79b-fce4448c8b2d.png


What does it mean?

The OCTO integration requires predefined formats for delivering barcodes and vouchers. So, we have added various configuration options within TourCMS tours, allowing API-consumed users to specify delivery formats in advance.

 

What should I do?

To provide API consumers with this information, navigate to PRODUCTS > TOURS > SETUP > OPERATIONS / SUPPLIER tab and select the appropriate options:

5989e63d-f954-468b-a903-7674541c8c39.png

 

Ticket/voucher format

Give agents and other API consumers an indication of the voucher format(s) that will be provided to bookers. Barcodes should either be provided by a subsystem or uploaded using the TourCMS barcode upload feature.

  • QR Code
  • Code 128A
  • PDF link (application/pdf)

OCTO Integration

OCTO behaviour for PDF links

When a tour is set to PDF link, and the connected subsystem sends a PDF voucher URL (application/pdf), OCTO will expose that URL to the OTA.

If the subsystem provides only HTML or other non‑PDF formats, OCTO will not return the URL, even if a link exists. This is by design to stay within the OCTO spec.

 

OCTO Integration

Multiple formats (HTML + PDF)

For OCTO‑based OTAs, it is safe to configure both HTML and PDF voucher formats. OCTO will internally:

  • Accept the product as long as PDF is one of the configured options.
  • Expose only the PDF voucher URL to the OTA.

Barcode formats

OCTO now supports CODE128 barcodes. Tours using CODE128 are fully compatible and will not be blocked by OCTO.

 

Ticket/voucher quantity

Give agents and other API consumers an indication of whether this product's ticket/voucher/barcodes are provided once per person/ticket or booking. Per ticket uploads must either be uploaded to TourCMS or provided by a subsystem.

  • Not selected
  • Per person/ticket: one barcode per person/ticket in the booking.
  • Per tour: one barcode per tour.
  • Per booking: one barcode per booking, regardless of how many tours are booked.


Ticket/voucher redemption method

Provide information about the redemption/check-in process for the tour.

  • Not selected
  • Manifest - Manual process: turn up and give your name.
  • Digital - The voucher/ticket will be scanned but will not need to be printed.
  • Print - The voucher/ticket must be printed and presented on arrival.

All this information is included in the response of the Show Tour API method.