> ## Documentation Index > Fetch the complete documentation index at: https://wiki.distribution-os.ch/llms.txt > Use this file to discover all available pages before exploring further. # Load provisional results from MaccsBox > Fetch daily box office from MaccsBox or upload a CSV, review the rows DOS could not place, and see the provisional figures land on your Bookings. Provisional results are the unofficial daily figures for a Booking: admissions, box office and shows per day. They come from MaccsBox, from a cinema's daily email, or from figures you type in. They let you follow a film while it plays. They are not the cinema's settlement report, and they never replace it. You load MaccsBox figures from **MaccsBox Import** in the **Programming** group of the sidebar. ## Provisional and definitive figures DOS keeps two kinds of figures for the same Booking and never mixes them silently. | | Provisional | Definitive | | - | - | - | | Source | MaccsBox, daily cinema emails, figures typed in by hand | The cinema's settlement report (PDF) | | Status | Unofficial, can still change | Official | | Used for | Following a film week by week | The invoice | | Where you work with it | **Provisional Results**, **MaccsBox Import** | **Definitive Results**, the **To check** list on Invoices | When the settlement report arrives, you check it and its figures replace the provisional ones. See [Check a cinema report](https://wiki.distribution-os.ch/results/check-a-cinema-report.md). ## Before you start * The films, cinemas and Bookings you want figures for already exist in DOS. * Your role needs edit rights on provisional results. Resolving held rows needs the admin or operations role. Without it, the **Review** table does not appear. ## Fetch a period from MaccsBox **1. Open MaccsBox Import** Choose **MaccsBox Import** in the sidebar. The period starts at the most recent Wednesday. **2. Choose the period** Pick **Start Wednesday** and **End Wednesday**. Both must be Wednesdays, and the end must be after the start. Use the arrows to move the period back or forward. **3. Narrow it down (optional)** Pick one film in the film list, or type in the **Cinema**, **City**, **Payer** or **Language region** boxes. **4. Select Fetch and stage** DOS asks MaccsBox for each week as its own report. You can leave the page while it loads. **Refresh source** fetches again without reusing a recent copy. Each week shows as a chip: **Waiting**, **Loading…**, **Failed**, the number of rows, or **No figures**. A line above the table counts rows as imported, **ready to import**, **to review** and **left out**. ## Review the rows DOS could not place DOS imports the rows it is sure about by itself. Rows that need a person appear in the **Review** table, grouped by why they wait: * **Film** and **Cinema**: DOS does not know the title or cinema as MaccsBox printed it. * **Language version**: the label does not clearly match one Booking of that week. * **Format**: another format (for example 3D) next to the standard one. * **New Booking**: the cinema has no Booking that week. * **Day the Booking does not play**: figures on a day outside the Booking's playing days. * **Held by the import** and **Cannot be read**. Each row has a **Suggestion** already selected, a **Confidence** bar and one button that answers it, such as connecting a film, connecting a Booking, creating a Booking or ignoring the row. Select a row to open its details and the figures by day. > [!NOTE] > > For a language version, DOS suggests the version of the film that fits the MaccsBox label. Confidence tells you how clearly one option stood out. It does not tell you the option is right, so check it before you confirm. Your decision is recorded. If you create a Booking, it is created then, and the import writes the figures. ## Import a CSV instead Use **Import CSV** when you have a MaccsBox "Figures by day" export. **1. Choose the file** Select **Choose CSV**, then **Prepare**. **2. Reconcile** Match films and cinemas that were not found, or select **Add as new film** or **Add as new cinema**. Language labels are suggested from the film's versions: choose a version and select **Approve**. **3. Create missing Bookings** Tick the Bookings to create and select **Create … booking & continue**, or **Continue** if none are needed. **4. Import** Select **Import … results**. **Recent imports** lists earlier files. ## What you'll see The figures appear on the Booking as provisional results. On **Provisional Results**, the **Entry** tab shows a week per Booking, with a **MaccsBox feed** or **Imported result** tag on imported days. The **Full table** tab lists every result with its **Source**. Imported figures are locked. Use the unlock button on the row if you must correct one. ## If something looks wrong > [accordion] A row sits in Review and will not import > > DOS never writes a row it had to guess. Answer the row with its button. A held row for a missing Booking needs the Booking created first. > [accordion] No MaccsBox results found > > The period and filters completed but returned no cinema and film figures. Widen the period or clear the filters. > [accordion] A week failed to fetch > > The page says the weekly MaccsBox request failed. Open Background activity to review or retry. > [accordion] The end date is refused > > The message "The end must be a Wednesday after the start." means the end date was not later than the start. > [accordion] Rows are held because of the language > > The language MaccsBox printed does not match the Booking or is not approved. Select **Review language labels** on the CSV summary, or pick the Booking in the **Review** table. > [accordion] I cannot import > > The CSV page shows "You don't have permission to import (operations only)." Ask an admin or operations user. > [!NOTE] > > DOS also fetches MaccsBox by itself every morning at about 08:10 Swiss time, so most days you only need to answer the rows in **Review**. ## Related * [Check a cinema report](https://wiki.distribution-os.ch/results/check-a-cinema-report.md) * [Read performance](https://wiki.distribution-os.ch/results/performance.md) * [Create a Booking](https://wiki.distribution-os.ch/bookings/create-a-booking.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.