Skip to content

How AI document processing works

Every document you upload to OPERO is read by AI. The AI decides what kind of document it is, whether it is about money coming in or going out, and reads the key facts from it. OPERO then files the document, and in some cases creates the expense or income for you. Anything the AI is not sure about waits for a person.

The AI helps you. It does not replace your check: always look at what it read before you rely on it.

  1. You upload a file on the Documents page or on a record’s Documents tab. See Upload documents to an event, show or venue.
  2. The AI reads it. It works in the background, usually for a few seconds. PDF files and images are read as pictures, so scans and photos work. Excel, CSV, Word and text files are read as text.
  3. OPERO sorts it. It sets the document’s type, direction and status. If the document is linked to a record, OPERO keeps that link.
  4. OPERO acts, or waits for you. A clear invoice or receipt for one event becomes an expense or income by itself. A contract gets its terms read and checked. Everything else waits under Needs review until a person decides.
  5. You get a notification with the result, for example “Review needed: Invoice — 2 601,50 EUR”.

Open a document (select it on the Documents page or on a Documents tab). The pane shows what OPERO knows about it.

The top of a document pane: the Review & Create button, the document name, and the rows Status, Type, Direction and File.The top of a document pane: the Review & Create button, the document name, and the rows Status, Type, Direction and File.

At the top:

Row What it means
Status Where the document is in its life. See Document statuses. Beside it, the AI’s confidence in percent.
Type The kind of document. You can change it here.
Direction Income (money comes in to your company), Expense (money goes out) or Neutral (no money moves, for example a contract or a rider). The selected one is coloured. Select another one to change it, or the cross to clear it.
File The file. Select it to see the file.

The types are: Invoice, Proforma Invoice, Receipt, Contract / Agreement, Rider, Technical Document, Act / Acceptance Act, Bank Statement, Payment Proof, Report / Statement, Tax Document and Other. When a document does not clearly match one type, the AI chooses Other rather than guess. A rider or a technical document is never a contract, even when it belongs to one.

On the Details tab, Extracted data lists what the AI read from the document. Empty facts are not shown.

Extracted data of an invoice: Amount, Currency, Date, Document #, Due date, Counterparty and Description.Extracted data of an invoice: Amount, Currency, Date, Document #, Due date, Counterparty and Description.
Fact What it is
Amount The total on the document.
Currency The currency, for example EUR.
Date The date of the document.
Document # The invoice, receipt or contract number.
Due date When it must be paid, if the document says so.
Counterparty The other party: the supplier, the client or the authority. Never your own company.
Category A hint for the expense or income category, for example marketing or transport. Not every document has one.
Description A short description of what the document is for.

The AI also reads the VAT rate when the document shows one. You see it when you create the expense or income.

Select AI details under the facts to see the confidence as a bar and the AI’s reasoning: who it thinks the buyer and the seller are, which one is your company, and why it chose the direction. Select Hide AI details to close it again.

The confidence (0–100%) says how sure the AI is about the type and the facts:

  • 90% and more: all key facts are readable and the type is clear.
  • 70–90%: good quality, most facts readable.
  • 50–70%: some facts are unclear.
  • Below 50%: poor quality, or the type is uncertain. Check everything.

A high confidence is not a guarantee. A blurred photo or a document with two totals can still be read wrong.

The lists (Documents page, Documents tabs) show four short words with a coloured ring. The open document shows the exact status.

In the list Exact status What it means What you do
Processing (grey or blue) Pending AI, Processing The AI is reading the document. Wait.
Review (amber) Needs Classification The AI could not tell what the document is. Set the type and the direction.
Review (amber) Needs Assignment The document is not linked to any record. Use Assign to record.
Review (amber) Pending Review It is linked, but OPERO did not finish the job by itself: a money document that was not sure enough, a contract or rider to look at, or a file the AI cannot read. Check it, then create the entry or leave it.
Linked (green) Completed OPERO created the expense or income by itself. Check the created entry.
Linked (green) Linked A person assigned the document to its records. Nothing.
Error (red) Error The reading failed. Use Reprocess, or see Troubleshooting.

On the Documents page, the Status filter offers Needs review, Linked and Error. On a Documents tab, the Needs review count shows how many documents still need someone.

When OPERO creates an expense or income by itself

Section titled “When OPERO creates an expense or income by itself”

OPERO creates the expense or income without asking only when all of these are true:

  • The type is Invoice or Receipt.
  • The direction is Expense or Income.
  • The document is linked to exactly one event (or one tour, or overhead). A document linked only to a show, a venue or an artist, or to several events, waits for you: OPERO does not guess which event an invoice belongs to.
  • The AI’s confidence is at least the auto-create threshold in Settings → AI (85% unless your workspace changed it).
  • The AI read a VAT rate from the document (0% counts as a rate).

Then the status becomes Completed and the pane shows Created record with a link to the new expense or income and an Add payment button. If you link the document to its one event later, OPERO tries the same once more.

In all other cases, a money document waits for you, and the pane shows what the AI would create under AI suggests creating: the entry type and category, the amount, who it is from, the confidence and why.

The button at the top right of the open document is the next step.

  • Review & Create (or Create Expense / Create Income when the AI is very sure) opens the new expense or income form, already filled in from the document. Check every field, then save it. The document is then linked to the entry. See Add an expense with a receipt.
  • Assign to record links the document to records without creating money. Select it, type in Search records…, choose one or more events, tours, shows, venues, artists, expenses, incomes or overhead, and select Save assignment. The status becomes Linked. The button then reads Assigned and the number of records.
  • Type and Direction can be changed at any time. They save at once.
  • The ··· menu has Reprocess (the AI reads the document again; your links stay) and Delete document.
  • The amount and the VAT. Is the total the right one (with or without VAT)? Is the VAT rate right?
  • The direction. Did your company pay (Expense) or get paid (Income)? The AI decides this from who is the buyer and who is the seller; check it on invoices you issued yourself.
  • The date and the due date. Dates on photos are often misread.
  • The counterparty and the category. They decide where the money shows in Finance.
  • The event. An expense belongs to the event you link it to. Make sure it is the right date and venue.

What you can see and change depends on your access level (see Invite members). Some levels see only some documents, for example only non-financial documents or only documents of events they are assigned to. Buttons you are not allowed to use are not shown.

People with Full access find the AI settings in the workspace menu: select the workspace name at the top of the sidebar, then Settings, then AI.

  • Claude API key — the key the workspace’s AI features use. The page shows whether a key is saved and when it was last verified. A key is checked before it is saved, and it is never shown again. Test checks it now; Remove key removes it.
  • Fast model — used for document reading, ticket and campaign mapping, bank-feed suggestions and the Home briefing.
  • Smart model — used for the assistant, file import and contract terms.
  • Process uploaded documents with AI automatically — when this is off, documents are stored but not read.
  • Auto-create threshold — the confidence (0 to 1, for example 0.85) from which OPERO creates the expense or income by itself. Review threshold — the confidence from which the AI’s type is offered for review.
  • Tone and vocabulary — what your company calls things and the voice you want the AI to use.

Select Save changes to save.

If no key is set, AI features are off: Home says “AI is off until an account admin adds an API key in AI Settings”. If the key stops working, OPERO shows “AI key isn’t working — check AI Settings”.