Skip to content

Ticket listings and sources

OPERO counts the tickets of an event only from listings that are linked to the event. This page explains what a listing is, where it comes from, how to link it on Tickets → To review, and how syncing works on Sources.

  • A listing is one performance as a box office sells it: a name, a date and time, a place, and the ticket sales the box office reports for it.
  • A listing has a source:
    • Scraper: OPERO imports the listing and its sales from a box office that is set up on Sources.
    • Manual: OPERO creates the listing when somebody adds sales by hand (door sales, complimentary tickets, history from before a box office was connected). See Manual sales entries.
  • A listing does not belong to an event until a person links it. OPERO and its AI can suggest an event, but a suggestion never counts.
  • When a listing is Confirmed to an event, OPERO adds the listing’s tickets to the event and books its revenue as ticket income on the event (one income line per box office or channel, in the Ticket Sales category). The income is what buyers paid, with VAT, at the event’s ticket VAT rate. See Ticketing settings.

A listing that is not confirmed adds nothing to any event. It waits on To review until somebody decides.

Access level To review and Sources
Full access Everything: link, unmap, ignore, create events from listings, sync.
Venue manager Link, unmap and ignore listings.
Finance See the tabs and create events from listings. Finance cannot link, unmap or ignore.
Other levels Tickets is not in their sidebar.

Use whichever way is easiest:

  • In the sidebar, under Sales, select Tickets, then To review.
  • On an event, open the Tickets tab and select Map tickets (or Map a listing if no listing is linked yet). The list then shows only the listings for that event and the listings within 14 days of its date. To see all listings again, select the × on the event name above the list.
  • On the Events list, an event that has a waiting listing shows Map in the Tickets column.
The To review tab of the Tickets page: the status filter set to All, Group By, and a list of listings with the columns Listing, Match, Status, Mapped event and Listing date.The To review tab of the Tickets page: the status filter set to All, Group By, and a list of listings with the columns Listing, Match, Status, Mapped event and Listing date.

The line at the top right says when the last sync ran and when the next one runs.

Column What it shows
Listing The name of the performance as the box office calls it.
Match How well the listing agrees with its suggested or linked event, for example 3/4.
Status Where the listing is in the review (see below).
Mapped event The event the listing is confirmed or suggested to. Empty if nothing is linked.
Listing date The date of the performance on the box office.
Location The place the box office gives.
Platform The box office, or the channel of a manual entry.
Revenue The money on the listing, with VAT.

Use Columns to show or hide columns, for example Source, Account, Created and Last Modified.

The status filter starts on Needs action, which is the same number as on the tab. It also has All, Unmapped, Pending (AI Suggested and Needs Review together), AI Suggested, Needs Review, Linked and Ignored. Each option shows its count. Use Source, Match, Listing date, Created and Last Modified to narrow the list, Filter for your own rules and Sort to change the order.

Status Meaning What to do
Unmapped Nothing has been proposed. Usually the event does not exist in OPERO yet. Pick the event, or create it from the listing.
AI Suggested The AI proposed an event, and the name and the date or city agree. The tickets do not count yet. Check the comparison and confirm, or pick another event.
Needs Review The listing needs a person: the proposal was weak, or the listing was unmapped or returned from Ignored. Same as above.
Confirmed The listing counts towards its event. The filter calls these listings Linked. Nothing.
Ignored The listing is not yours (for example another promoter’s show on the same box office account). Nothing.
  1. On To review, select the listing. Its panel opens on the right.

    A listing panel: the Comparison table of the listing against the event (name, date, time, location), the AI suggestion, and Other events with a search field.A listing panel: the Comparison table of the listing against the event (name, date, time, location), the AI suggestion, and Other events with a search field.
  2. Read the Comparison. It sets the listing (left column, headed with the box office name) beside the OPERO event (right column) field by field: name, date, time and location. A tick means the field agrees, a cross means it differs. The last line says how many fields agree, for example “4 of 4 comparable fields agree”, with a score.

  3. Choose the event:

    • If there is an AI suggestion, it is at the top. OPERO ticks it for you only when the name and the date or the city agree.
    • Otherwise, pick one of the events under Other events (or Opero events). OPERO lists the closest candidates with their score, for example 2/4.
    • If the right event is not in the list, type part of its name in Search events… and pick it.

    When you pick an event, the comparison updates for that event.

  4. Select the confirm button. It reads Confirm mapping when all compared fields agree. When some do not, it says so, for example Confirm anyway — 2 fields differ. Read the comparison again before you confirm a partial match.

After about a second, OPERO moves on to the next listing in the list.

  • The listing’s status changes to Confirmed, and the event shows in Mapped event.
  • OPERO recalculates the event’s ticket income: it creates or updates one income line per box office on the event, with the confirmed revenue. You see it on the event’s Finance tab and in Finance.
  • The event’s Tickets tab, the Tickets column on the Events list and the event’s break-even marker now count these tickets. See Ticket sales and pacing colours.
  • This event already has a confirmed listing (orange): the event already has tickets from another source. Confirming adds this listing’s sales on top. That is right if the event really sells through both (for example a box office and door sales). It is wrong if this listing is a different performance.
  • This event already has another … listing (red): the event already has a listing from the same box office. Two listings from one box office for one performance is almost always a mistake: check the date and the city.
  • Cannot be told apart from another event: two events agree with the listing in exactly the same way (for example the same show, date and city at 18:00 and at 21:00). OPERO does not let you confirm, because the choice would be a guess. Set the time on the events: the listing carries a time, so a time on the event decides it.

A box office often sends every date of a show at once. You do not have to open them one by one.

Select Group By and Show. Listings with the same title, ignoring case and accents, form one group. The group row shows the number of listings, how many are matched and how many have no event (“15 / 19 matched”, “4 no event”), the show or tour most of them belong to, the date range, the number of cities, the box offices and the revenue. Expand all and Collapse all open or close every group.

The ··· menu of a group has what fits the group:

  • Confirm N suggestions: link each listing to its suggested event.
  • Create N events in and the show’s name: when the show exists in OPERO but the events on these dates do not.
  • Create tour with N events…: see below.
  • Link to show…: link each listing to the show’s event on the same date. Listings with no such event, or with two, stay in To review.
  • Select the group: tick all its listings, also in a collapsed group.
  • Ignore all: asks first, with an optional reason.

When some listings have a suggestion on which all compared fields agree, a button Confirm N matches appears beside Group By. It counts the listings under the current filter. OPERO shows the list of listing and event in Confirm N suggestions?, and you confirm it with Confirm N. Partial matches stay for you to check.

Tick listings in the list. A bar at the bottom of the screen says how many are selected and what they are, for example “19 selected · 15 matched · 4 no event”, with the actions that fit:

  • Confirm N suggestions: choose Only where all fields agree or Every suggestion. Listings without a match are skipped and stay in To review.
  • Create N events: one event per listing, named and dated as the box office lists it, and linked to it.
  • Create tour… and Link to show…: as in the group’s menu.
  • Suggest now: ask the AI for a suggestion for the listings with no event. The list updates when it answers.
  • Ignore: asks first, with an optional Reason. Listings already linked to an event are skipped.

The same actions, one listing at a time, are in the ··· menu of a row: Confirm suggestion, Create event…, Suggest now, Link to show…, Open and Ignore.

OPERO asks the AI after each sync for new listings, and again when an event is created or changed on a date with waiting listings. Suggest now asks at once. A suggestion is only a proposal: the AI never links a listing. If the AI is off or has reached its daily limit, a note above the list says so.

Use this when the performance does not exist in OPERO yet. The button is not offered when an event already agrees on every field, so you cannot create a duplicate.

  1. Select the listing on To review.

  2. Select Create event from listing. The Create event from this listing window opens.

  3. Check what is Carried from the listing: the name (you can change it here), the date and the time. The city is not copied, because an event takes its city from its venue. OPERO lists venues in that city that you can attach afterwards.

  4. If other unlinked listings have the same name (the same show on other dates), OPERO lists them. Tick the ones you want to create too. Each gets its own event, linked to its own listing. No tour is set.

  5. Select Create event (or Create 3 events, with the number you ticked).

What happens next:

  • The new event is created empty: no show, no venue and no tour. So no budget, venue fee or crew is copied from any template. Its ticket sales are the only thing it starts with. Sells tickets is on.
  • The listing is Confirmed to the new event at once, and the ticket income is booked.
  • Open the event and attach its show and venue. The templates of the show and the venue apply then, as with any edit. See Edit, reschedule or cancel an event.

Who can do it: Full access and Finance. Finance cannot use New Event, so this is the only way Finance creates events.

Create tour with N events… opens Create a tour from these listings. Create N events in a show opens Create events in a show. Both show the plan before anything is written:

  • Tour name (for a tour) and Show.
  • For each listing, whether OPERO will create an event or link it to the show’s existing event on that date.
  • New venues: venues that do not exist yet. They are created with a name and a city only, with no pricing model, so no venue fee. If the box office sent no city, type it here.
  • Costs the templates add: what the show, venue or tour templates will add to the new events.

Select Create tour and N events or Create N events.

If a listing is not yours, select it and select Ignore in its panel. Its status changes to Ignored and it stops asking for attention. If it was confirmed, its revenue is removed from the event.

To undo, set the status filter to Ignored, select the listing and select Return to review. It goes back to Needs Review (or to Unmapped if it was never linked). Nothing is confirmed by this.

Use this when a listing was confirmed to the wrong event.

  1. Open the confirmed listing: on To review, set the status filter to Linked and select the listing. Or, on the event’s Tickets tab, select Unlink in the Linked listings card.

  2. Select Unmap. A window tells you exactly what changes: how much revenue and how many tickets leave the event, and whether other confirmed listings stay on it. From the event the window is called “Unlink this listing?”.

    The Unmap this listing? window, saying how much revenue and how many tickets leave the event, with Cancel and Unmap.The Unmap this listing? window, saying how much revenue and how many tickets leave the event, with Cancel and Unmap.
  3. Select Unmap to go ahead, or Cancel to keep the link.

The listing returns to Needs Review. It is not deleted, and its sales stay. The event’s ticket income is recalculated at once: if nothing else is confirmed to the event, its ticket income line is removed. Then link the listing to the right event.

Sometimes a box office sends sales without a listing. They can never be linked. If there are any, an amber line on To review says how many rows and how much money, with a Show button. In the window you can Write off a row (you must give a reason) or Restore a written-off row.

Sources lists each box office account and manual entry.

The Sources tab: a box office account and Manual entry with the columns Source, Status, Last sync, Next run, Listings, Linked and History loaded, and below them the Box offices section with Sync history and Add box office.The Sources tab: a box office account and Manual entry with the columns Source, Status, Last sync, Next run, Listings, Linked and History loaded, and below them the Box offices section with Sync history and Add box office.
Column What it shows
Source The account and its platform, or Manual entry.
Status OK, Syncing, Failed or Never synced. The number of failed sources shows on the tab.
Last sync When it last ran, how long it took and what it changed.
Next run When the next scheduled sync runs. Manual entry says “By hand”.
Listings, Linked How many listings it has, and how many of them count towards an event.
History loaded The day the sales history is loaded until.
  • Every hour from 08:00 to 23:00: today’s sales.
  • Every night at 02:00: the last three days.

New listings appear on To review. A listing that is already linked updates by itself.

To fetch the latest sales without waiting, select Sync now at the top right of the Tickets page and choose a range.

The Sync now menu with Today, Last 3 days and Choose dates.The Sync now menu with Today, Last 3 days and Choose dates.
  • Today: the same range as the hourly sync.
  • Last 3 days: the same range as the nightly sync.
  • Choose dates…: a range you pick.

While a sync runs, the line shows its progress with Stop beside it.

Some box offices can send the day-by-day sales from before you connected them. Open the ··· menu of the account on Sources and select Load history. OPERO asks first in Load history?, because a load can take 3 to 4 hours. It runs in the background. A blue line above the list shows Loading sales history from and the box office, with the days done, the time left and Stop.

The same ··· menu has Sync now, Sync dates… and, if your level has it, Sync log. On Manual entry it has Add entry.

Below the list is the Box offices section, the same as in Ticketing settings.