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.
How it fits together
Section titled “How it fits together”- 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.
Who can do this
Section titled “Who can do this”| 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. |
Open the list to review
Section titled “Open the list to review”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 line at the top right says when the last sync ran and when the next one runs.
The list
Section titled “The list”| 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.
Statuses
Section titled “Statuses”| 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. |
Link a listing to an event
Section titled “Link a listing to an event”-
On To review, select the listing. Its panel opens on the right.
-
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.
-
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.
-
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.
What happens after you confirm
Section titled “What happens after you confirm”- 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.
Warnings before you confirm
Section titled “Warnings before you confirm”- 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.
Work through many listings
Section titled “Work through many listings”A box office often sends every date of a show at once. You do not have to open them one by one.
Group by show
Section titled “Group by show”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.
Confirm several matches
Section titled “Confirm several matches”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.
The selection bar
Section titled “The selection bar”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.
AI suggestions
Section titled “AI suggestions”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.
Create events from a listing
Section titled “Create events from a listing”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.
One event
Section titled “One event”-
Select the listing on To review.
-
Select Create event from listing. The Create event from this listing window opens.
-
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.
-
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.
-
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.
A whole tour, or events in a show
Section titled “A whole tour, or events in a show”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.
Ignore a listing
Section titled “Ignore a listing”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.
Unmap a listing
Section titled “Unmap a listing”Use this when a listing was confirmed to the wrong event.
-
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.
-
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?”.
-
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.
Sales rows that belong to no listing
Section titled “Sales rows that belong to no listing”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 and syncing
Section titled “Sources and syncing”Sources lists each box office account and manual entry.
| 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. |
When OPERO syncs
Section titled “When OPERO syncs”- 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.
Sync now
Section titled “Sync now”To fetch the latest sales without waiting, select Sync now at the top right of the Tickets page and choose a range.
- 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.
Load history
Section titled “Load history”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.