---
title: "Troubleshoot"
description: "Fixes for common problems with deploying, signing in, adding receipts, importing statements, matching and sending the month."
---

> Documentation Index
> Fetch the complete documentation index at: https://receipts.nuits.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot

Find the message or symptom you see, then follow the fix. Messages in quotes are shown by the app exactly as written.

## Deploying

### The first build fails at the D1 migrations step

The build stops with an authentication or permission error (for example code 10000 or 7403) on `wrangler d1 migrations list` or `apply`. The deploy applies the database schema during Workers Builds, and the build's API token has no D1 permission, so nothing is deployed.

1. In the Cloudflare dashboard, open **My Profile** > **API Tokens** and edit the token used by Workers Builds. Your Worker shows which one under **Settings** > **Build** > **API token**.
2. Add the account permission **D1** > **Edit** and save.
3. Retry the build from the Worker's **Deployments** (or **Builds**) page, or push a new commit.

The migration step only applies what is missing, so a retry is safe.

### The button or setup cannot create the originals bucket

R2 must be turned on with a payment method on your Cloudflare account, even if your use stays inside the free allowance. Add one in the dashboard, then deploy again. See [Limits](/docs/reference/limits/).

### Every page shows "Configuration error: ..."

A Worker variable has a value the app does not accept. The message names it. Fix the variable in the dashboard or in your config and deploy again. (A bad value saved in **Settings** never causes this; Settings ignores it and shows a warning.) See [Configuration](/docs/reference/configuration/).

## Signing in

### The browser keeps asking for the password

- Check the sign-in name. It is `owner` unless you changed `AUTH_USERNAME`.
- The password must be at least 16 characters, and example values such as `change-me` are refused. With a password that is too short, every sign-in fails. Set a new one with `bunx wrangler secret put NUITS_PASSWORD` (add `--config wrangler.production.jsonc` if you deployed with `bun run setup`).
- The app only accepts the password over HTTPS (or on `localhost`). Open the `https://` address.

### "Sign in through Cloudflare Access to use this app."

Access mode is on, so the password no longer works. Sign in through your Access application, with an email listed in `ACCESS_ALLOWED_EMAILS`. See [Protect the app with Cloudflare Access](/docs/how-to/protect-the-app-with-cloudflare-access/).

### "That request came from another site, so we ignored it." when you press a button

Form posts must come from the same address the app is served on. Open the app at its normal address, not through another hostname or a copied link to a different host. If you serve it under a path, see [Serve the app under a path](/docs/how-to/serve-the-app-under-a-path/).

## Adding receipts

### Error 1102 ("Worker exceeded resource limits") when uploading a PDF

Reading a PDF uses far more than the Workers Free plan's 10 ms of CPU time per request. Plan on Workers Paid ($5 a month) if you upload PDFs. Photos and forwarded email bodies may fit in Free.

### "That file isn't the kind it says it is."

The file's contents do not match its type, for example a renamed file. Export or save it again as a real PDF, PNG, JPEG or WebP.

### "That file is too big." or a file that could not be added

PDFs can be up to 10 MiB and 25 pages, photos up to 4 MiB, and an email up to 20 MiB. Shrink or split the file, or take a photo of the page that matters.

### A receipt says "Reading" for a long time

Select **Refresh**. If it is still reading after two minutes, select **More** > **Read again**.

### **Try reading it again.** on several receipts at once

Workers AI may be unavailable, or the Workers Free daily AI allowance may be used up, in which case calls fail until 00:00 UTC. Wait, then select **Read again** on each receipt.

### **Type the numbers in, or upload a photo.** on a PDF

The card says "This PDF has no readable text. Probably a scan." The app reads text PDFs only. Type the numbers in, or upload a photo of it with **More** > **Upload a copy** (or with **Add**) and mark the PDF as its duplicate. See [Resolve duplicate warnings](/docs/how-to/resolve-duplicate-warnings/).

### A forwarded email never appears

- Look at the top of **Receipts To do** for **New sender** rows: mail from a sender who is not allowed waits there. Press **Allow**. You can also add senders in **Settings** > **Email** > **Email senders**.
- Mail that fails the sender check is dropped. Forwarding services can change the sending address; check what actually arrives.
- Look on **Receipts** for the flag **Is this email genuine?**: mail the app could not prove came from you waits there unread.
- Check the Email Routing rule for the receipt address is **Send to a Worker** and points at this Worker. See [Set up email](/docs/how-to/set-up-email/).

### After **Read it**, the email shows **Upload a PDF or a photo.**

The email is kept as a whole message, which the reader cannot read directly. Download it with **More** > **Download original**, save the receipt from it, and add it with **More** > **Upload a copy**. Then, on the email, set **Seller** to match the new receipt, pick the new receipt under **Other fields** > **Duplicate of**, and select **Skip** to save it. This is how the app works today: an email it could not verify is kept whole and never read, and when you ask for it to be read it is treated as a single file the reader does not support, so it fails with `unsupported_document`. Its attachments are not read separately.

### "This receipt changed since you opened it. Reload and try again."

The receipt changed since you opened it, for example because it was read again in another tab. Reload the page, check the values, and save again.

### "Fill in the seller, date, currency, total, amount before VAT and VAT, then approve."

Approval needs the seller, date, currency, total, before-VAT and VAT amounts. Fill in the empty ones; enter `0` for VAT if there is none. See [Check and approve a receipt](/docs/how-to/review-and-approve-a-receipt/).

## Importing a bank CSV

### "You already imported this file into a different account."

The same file was imported into a different account. A file belongs to one account only. Pick that account, or check you exported the right statement.

### "The check ran out of time. Check the file again."

A check in the column editor is valid for 30 minutes. Start again from **Import statement** on **Bank**.

### "You changed the column settings. Choose Check again before you import."

You changed the mapping after the last check. Select **Check again**, then import.

### "The bank gave two different payments the same ID. Check the file for repeated IDs."

A payment with the same bank transaction ID is already in this account with a different date, amount or payee. Check that you chose the right account and the right file. See [Resolve duplicate warnings](/docs/how-to/resolve-duplicate-warnings/).

### The amounts are the wrong sign, or dates are off by months

Open **The columns look wrong? Adjust how we read the file** and check **Money out is shown as** and **Date format**. For dates with slashes, the day and month order must be confirmed. See [Import a bank CSV](/docs/how-to/import-a-bank-csv/).

### Error 1102 or a D1 error on a large import

A large file can exceed the Workers Free limits. Split the statement into smaller date ranges, or move to Workers Paid.

## Matching

### "Approve this receipt first. Only approved receipts can be matched."

A sales invoice is matched to money in only once it is approved, or when its only flag is the missing euro amount. Approve it first. Receipts for money out can be matched while still in **Receipts** To do. See [Check and approve a receipt](/docs/how-to/review-and-approve-a-receipt/).

### "This receipt and payment don't line up exactly. Press Match if they belong together."

The receipt and payment do not fit the usual date and amount rules. The app says why in a line under the comparison table. If the match is right, select **Match**.

### "That receipt is already matched to another payment."

A receipt can be matched to one payment only. On **Bank** under **All**, open the other payment's **More** and select **Unmatch** first.

### A match I made disappeared

Saving a change to a receipt removes its bank match, and automatic matching runs again. Make the match again on **Bank**.

### "This payment changed, or it is part of a transfer between your accounts. Undo the transfer first."

The payment is one side of a transfer pair. Open its **More** and select **Undo transfer** first. See [Pair an own-account transfer](/docs/how-to/pair-an-own-account-transfer/).

### "One of these payments changed. Look at both payments again before you link them."

The two sides must be in different accounts, have the same amount and currency, and neither can be matched, marked **Not a purchase**, or already paired.

## Sending the month

### "This month is too big for one package (N files, 900 max)."

One package holds up to 900 files. Download the **CSV** and fetch the originals from the app.

### "This month changed since you opened the page. Reload it, check what you send, then mark it as sent."

Something was added or corrected while the page was open. Reload it, check what you send, then select **Mark September as sent** (with your month) again.

### "Nothing has changed since you sent this month."

There is nothing new to send. Use **Download again** or **Download all** if you need the full package.

### A very large month fails to download on Workers Free

Building the ZIP checksums every byte, which can exceed the Free plan's CPU limit. Move to Workers Paid, or send the **CSV**.

### My accountant cannot open the ZIP in OneDrive

OneDrive's web page does not unzip. Unzip it first and upload the folder (**Upload** > **Folder**), or turn on the direct upload. See [Upload the month to OneDrive](/docs/how-to/upload-the-month-to-onedrive/).

## Anything else

"Request failed. Saved documents can be retried." means something went wrong on the server. Anything already saved is kept. Try again, and check your Worker's logs in the Cloudflare dashboard; they hold short reason codes, never receipt content.

Source: https://receipts.nuits.net/docs/how-to/troubleshoot/index.mdx