Document AI: bills and receipts read for you

Document AI is for anyone who types supplier bills and till receipts into NaliSuite: owners, bookkeepers and purchasing staff. You upload a PDF bill or a photo of a receipt taken with your phone, and Claude (Anthropic's AI) reads the supplier, invoice number, dates, lines, VAT and totals for you. You check what was read, then make it a draft bill or, for a receipt already paid, an expense in the books. This page covers switching it on, adding your Anthropic API key, uploading, checking and correcting, creating bills and expenses, and what to do when a document could not be read.

Document AI is a marketplace module. It works with the Purchases app; recording receipts as expenses also needs the Accounting app. Its screen is Purchases → Scan bills and receipts.

Note: You need the document_ai.use permission to see and use Scan bills and receipts. Owners and admins have it. Set permissions under Settings → Roles.

Switch it on

  1. Open Settings → Marketplace and type Document AI in the Search add-ons… box (marker 1).
  2. On the Document AI card (marker 2), click Start free trial (or Add to subscription) and confirm. Scan bills and receipts appears under Purchases in the left menu.
Marketplace with the add-on search box and the Document AI card marked
Marketplace with the add-on search box and the Document AI card marked

If the card says Not available for purchase yet (as in the screenshot), the add-on has not been priced for your plan: ask NaliSuite support to switch it on. See Billing and marketplace.

Add your Anthropic API key

Document AI reads with your workspace's own Anthropic API key. NaliSuite does not share one key between businesses, so reading is billed to your Anthropic account (see Good to know).

Get a key from Anthropic

These steps happen on Anthropic's website, not in NaliSuite.

  1. Sign in, or create an account, at console.anthropic.com.
  2. Add a payment method or credit under billing, so the key can be used.
  3. Open API keys and create a key, for example named "NaliSuite Document AI". Copy it straight away: Anthropic shows it only once. It starts with sk-ant-.

Enter it in NaliSuite

  1. In the menu, open Settings → Preferences.
  2. Click the Document AI tab (marker 1).
  3. Paste the key into Anthropic API key (marker 2). It is stored encrypted; click the eye to check it.
  4. Choose the Model (marker 3):
    • Claude Opus 5.5 (most accurate): the default.
    • Claude Sonnet 5.5 (faster, lower cost).
    • Claude Haiku 5.5 (fastest, lowest cost).
  5. Click Save preferences (marker 4).
Preferences on the Document AI tab with the tab, Anthropic API key, Model and Save preferences marked
Preferences on the Document AI tab with the tab, Anthropic API key, Model and Save preferences marked

Tip: Start with the default model. If your bills are clear, printed PDFs, try Sonnet or Haiku to spend less, and check a few results before you rely on them.

Upload bills and receipts

  1. In the menu, open Purchases → Scan bills and receipts.
  2. Click Upload bills and receipts (marker 1 in the list screenshot below).
  3. Drag your files into Files (marker 2), or click Browse. On a phone, Browse lets you take a photo of the receipt.
  4. Click Submit (marker 3). You see "Reading one document" or "Reading 3 documents".
Upload bills and receipts window with the description, Files and Submit marked
Upload bills and receipts window with the description, Files and Submit marked

What you can upload:

Limit
File types PDF, or a JPEG, PNG, GIF or WebP photo.
How many Up to 20 files at a time.
PDF size Up to 30 MB each.
Photo size Up to 5 MB each. A larger photo uploads but cannot be read; take it again at a lower resolution or upload a PDF.

Other file types are refused by the upload box. Each file is stored privately in your workspace and read in the background, one document per file. You can leave the page; the list updates by itself while anything is being read.

Important: If the window says "Add your Anthropic API key under Settings → Preferences → Document AI first.", the key is missing. Files you upload anyway show Could not read; add the key, then use Read again.

Tip: For photos, lay the receipt flat in good light and fill the frame. A sharp photo reads better than a large one.

The list and its statuses

The list shows every uploaded file with its Status (marker 2), the Supplier with "Bill" or "Receipt" and the number that was read, the Date on the document and the Total with its currency.

Scan bills and receipts list with Upload bills and receipts, the Status column, a Could not read reason, Create bill, Record expense and the actions menu marked
Scan bills and receipts list with Upload bills and receipts, the Status column, a Could not read reason, Create bill, Record expense and the actions menu marked
Status What it means What you do
Reading (grey) Waiting to be read, or being read now. Wait. The list refreshes every few seconds.
Ready to check (orange) Read. Nothing has been created yet. Check it, then Create bill (marker 4) or Record expense (marker 5).
Could not read (red) Reading failed. The reason shows under the file name (marker 3). See When something could not be read.
Done (green) A draft bill or an expense was created from it. Nothing. Open the bill from ⋮ if you need it.

More actions are under ⋮ at the end of each row (marker 6).

To see only one status, click the filter icon and choose a Status (marker 1), then Apply filters. The search box finds documents by file name. A column called Uploaded (when each file was uploaded) can be shown or hidden with the columns icon next to the filter.

Filters panel with the Status filter marked
Filters panel with the Status filter marked

Check and correct what was read

Always check a document before you create anything from it. The AI copies what the document says and leaves empty anything it cannot see, but it can still misread a blurred figure.

  1. Click ⋮ on a document that is Ready to check, then Check and correct.
  2. Check the top part, What was read:
    • This is (marker 1): A bill to pay later or A receipt, already paid. This decides whether you get Create bill or Record expense.
    • Supplier in Contacts (marker 2): the supplier NaliSuite found in your contacts, by tax number first and then by name. Choose another supplier if it is wrong, or leave it empty to add the supplier from Supplier name on the document when you create the bill.
    • Supplier tax number (marker 3), for example a KRA PIN or TIN.
    • Invoice or receipt number, Currency (a three-letter code such as KES), Date, Due date and Paid by (for example M-Pesa or cash).
    • Subtotal, Tax and Total (marker 4).
Check and correct window with This is, Supplier in Contacts, Supplier tax number and Total marked
Check and correct window with This is, Supplier in Contacts, Supplier tax number and Total marked
  1. Scroll down to Lines. Each line (marker 1) has a Description, Qty, Unit price before tax and Tax % (marker 2), for example 16 for 16% VAT, or empty when the line has no tax. Correct any line, click the bin to remove one, or click Add to lines (marker 3) to add one.
  2. Fix the Notes if needed; they go onto the bill.
  3. Click Save changes (marker 4).
Lines in the Check and correct window with a line, Tax %, Add to lines and Save changes marked
Lines in the Check and correct window with a line, Tax %, Add to lines and Save changes marked

When you save, a date that is not a full date and a currency that is not a three-letter code are cleared, and a line without a description is dropped.

Create a draft bill

  1. On a bill that is Ready to check, click Create bill (marker 4 in the list screenshot).
  2. NaliSuite creates a draft bill, shows "Draft bill created; check it and post it" and opens the bill. The document's status becomes Done.
  3. Check the bill and click Post (marker 6) when it is right, as for any vendor bill. See Purchases and bills.
Draft bill created from a scanned document with Vendor, Vendor's invoice number, a line's Tax, the Tax total, Vendor's invoice and Post marked
Draft bill created from a scanned document with Vendor, Vendor's invoice number, a line's Tax, the Tax total, Vendor's invoice and Post marked

What lands on the bill:

On the bill Comes from
Vendor (marker 1) Supplier in Contacts if you chose one. Otherwise the supplier in your contacts with the same tax number (spaces and capitals ignored), then one with exactly the same name. If none matches, a new supplier is added with the name, tax number and currency on the document.
Vendor's invoice number (marker 2) The invoice number that was read.
Bill date and Due date The dates that were read. With no date, today. With no due date, the supplier's payment terms or your default from purchase settings.
Currency The currency that was read, otherwise the supplier's, otherwise your company's.
Lines One line per line that was read: description, quantity and price before tax.
Tax on each line (marker 3) Your active purchase tax with the same rate, for example VAT 16% for 16. Withholding taxes are never chosen. If no tax has that rate, the line has no tax: choose one before you post.
Totals (marker 4) Worked out from the lines, as on any bill. Compare them with the document.
Vendor's invoice (marker 5) The original file you uploaded, attached as the vendor's invoice.
Notes The notes that were read.

If the document had no itemised lines, the bill gets one line for the amount before tax (the subtotal, or the total less the tax), with the tax rate worked out from the tax and the amount.

Important: The bill is a draft. Nothing is in your books until you post it, so check the vendor, amounts and taxes first.

Record a paid receipt as an expense

A till or cash receipt that was paid on the spot can go straight into the books as an expense. This needs the Accounting app; without it, Record expense is not shown and you can still use Create bill instead.

  1. On a receipt that is Ready to check, click Record expense (marker 5 in the list screenshot).
  2. Choose the Expense category (account) (marker 1), for example office supplies, from your expense accounts.
  3. Choose where it was Paid from (marker 2): one of your bank, cash or mobile-money accounts, for example your M-Pesa account.
  4. Click Submit. You see "Expense recorded with the receipt attached".
Record expense window with Expense category (account) and Paid from marked
Record expense window with Expense category (account) and Paid from marked

The expense is posted for the Total that was read, dated with the receipt's date, with the receipt number as its reference and a description such as "Receipt: Naivas Supermarket 4471-0098812". The tax is your purchase tax with the receipt's rate, so the VAT is split out of the total (on a KES 2,320 receipt at 16%, KES 2,000 goes to the expense category and KES 320 to VAT you can claim). If none of your purchase taxes has that rate, the whole total is the expense. The supplier is the one in Supplier in Contacts; no new contact is added for a receipt. A copy of the photo or PDF is attached to the expense, which you find under Accounting → Expenses. If you have approval rules for expenses, they apply as usual.

Create bill instead

To pay a receipt later, or treat it as a supplier bill for another reason, click ⋮ on it, then Create bill instead (marker 2). You get a draft bill exactly as for a bill. Check and correct (marker 1) and Delete (marker 3) are in the same menu.

Actions menu on a receipt with Check and correct, Create bill instead and Delete marked
Actions menu on a receipt with Check and correct, Create bill instead and Delete marked

Read again, download and delete

All of these are under ⋮ on the document.

Read again confirmation with the warning and Confirm marked
Read again confirmation with the warning and Confirm marked
Actions menu on a Done document with the Done status, Open the bill and Download the file marked
Actions menu on a Done document with the Done status, Open the bill and Download the file marked

When something could not be read

The reason shows in red under the file name. Fix the cause, then click ⋮ → Read again.

Message What to do
Add your Anthropic API key under Settings → Preferences → Document AI first. Enter the key (see Add your Anthropic API key), then Read again.
Anthropic refused the API key. Check it under Settings → Preferences → Document AI. The key is wrong, or was deleted or disabled on the Anthropic console. Create a new key if needed, paste it under Settings → Preferences → Document AI, click Save preferences, then Read again.
Anthropic is busy or your account has reached its limit. Try reading it again in a minute. Wait a minute and Read again. If it keeps happening, check your usage limits on the Anthropic console.
Could not reach Anthropic. Try reading it again in a minute. A connection problem. Read again in a minute.
Anthropic could not read the file: … Anthropic's own reason follows the colon. If it says your credit balance is too low, add credit on the Anthropic console and Read again. If the file is damaged or password-protected, save or scan it again and upload the new file.
The document could not be read automatically. Enter the bill by hand. The AI declined this document. Enter the bill under Purchases → Vendor bills, then delete the scanned document.
The document is too long to read in one go. Enter the bill by hand or upload fewer pages. Upload only the pages with the bill on them, or enter the bill by hand.
Nothing could be read from the document. Usually a blank, blurred or very dark photo. Take it again and upload the new file.
The photo is larger than 5 MB. Take it again at a lower resolution or upload a PDF. Lower the camera resolution, or scan it to PDF, and upload again.
The PDF is larger than 30 MB. Split the PDF or scan at a lower resolution.
Upload a PDF or a JPEG, PNG, GIF or WebP photo. Convert the file to JPEG or PDF and upload it again.
The uploaded file is missing. Upload it again. Delete the document and upload the file again.

Messages you may see when creating something:

Message What to do
Choose the supplier: no name could be read from the document. Open Check and correct and choose Supplier in Contacts, or type the Supplier name on the document.
Enter the lines or the total before creating the bill. Add the lines, or at least the Subtotal or Total, in Check and correct.
Enter the total paid before recording the expense. Type the Total in Check and correct.
Turn on Accounting to record receipts as expenses. Switch on Accounting, or use Create bill instead.
This document has already been recorded. It is Done already. Open the bill or expense instead of creating another.
The document has not been read yet. Wait for Reading to finish, or Read again if it failed.

Good to know

What does it cost? Each read, including Read again, is one request billed by Anthropic to your own Anthropic account, at the price of the model you chose. NaliSuite does not add a charge per document; the module itself is billed like any marketplace app. Claude Sonnet 5.5 costs less than the default Claude Opus 5.5, and Claude Haiku 5.5 costs least. You can set a monthly spending limit on the Anthropic console.

Where do my files go? Uploaded files are stored privately in your workspace, never on a public link. For reading, each file is sent only to Anthropic, with your API key. The original is attached to the bill it becomes, and a copy is attached to an expense.

Is it always right? No. It copies what it can see and leaves the rest empty rather than guessing, but check every document before you create a bill or expense, and post bills only after checking them.

Can I upload from my phone? Yes. Open NaliSuite in your phone's browser or the installed app, go to Purchases → Scan bills and receipts, click Upload bills and receipts and take a photo.

Does it work for purchase orders or sales invoices? No. It reads supplier bills and receipts only, and creates draft vendor bills or expenses. A draft bill it creates is not linked to a purchase order.