InvoiceWarden help and FAQ
From a fresh install to your first supplier invoice filed against a ServiceM8 job, plus what to do when something goes wrong. Quick answers are at the bottom of the page.
On this page
- What you need before you start
- Opening InvoiceWarden for the first time
- Connecting your mailbox
- Getting a ServiceM8 API key
- Choosing an AI provider and getting a key
- First run: what the first scan does
- Suppliers and the NEW flag
- The Activity Log and Error Log
- Catching up on older mail
- Accounting systems
- Common problems
- Frequently asked questions
What you need before you start
- A Windows PC that stays on and online. InvoiceWarden checks your mailbox every few minutes while it runs.
- The mailbox your suppliers send invoices to. It can be Microsoft 365 or Outlook.com, the classic Outlook desktop app, or Gmail and most other email (IMAP).
- A ServiceM8 account with an API key. Your ServiceM8 plan must allow API access.
- Your own AI key from Google Gemini, OpenAI, Anthropic (Claude), or an OpenAI-compatible service. InvoiceWarden doesn't supply one, and the AI provider bills you directly.
- The app has a Test button for the service, mailbox and AI steps below, so you can check each one before you move on.
Opening InvoiceWarden for the first time
InvoiceWarden is one program that runs without an install or administrator rights. It isn't signed yet, so Windows SmartScreen may show a warning saying Windows protected your PC. This is expected. Click More info, then Run anyway.
Click Settings in the header to start. Everything below happens on the Settings tab. Under Deployment, the Service system should be ServiceM8. Other systems in that list are marked as previews and can't file invoices yet. Click Save settings when you've entered a section.
Every section has a Setup guide button with the same steps as this page, plus a ? beside most fields.
Connecting your mailbox
Under Email accounts, click + Add an email account. You can add up to 10 mailboxes, each with its own sign-in. A switch on each row turns a mailbox off without deleting its settings. Choose the option that matches your email.
Microsoft 365 or Outlook.com (sign in with a code)
This works for work and personal Microsoft accounts, and with the new Outlook for Windows. There's no Azure setup.
- Type the email address and leave Backend on graph.
- Click Sign in. A short code appears and your browser opens Microsoft's sign-in page.
- Enter the code, sign in as that mailbox and approve the permission. InvoiceWarden only asks to read mail.
- The row then shows signed in as and your address. Click Test.
Each mailbox needs its own sign-in. The browser may end on a Microsoft page saying This is not the right page. That's normal: check the sign-in window in InvoiceWarden for the real result. A work or school account may ask an administrator to approve InvoiceWarden once for the organisation.
Classic Outlook on this PC
Choose the Outlook backend (com). No sign-in is needed, because InvoiceWarden uses the classic Outlook desktop app that's already signed in on this PC.
- Enter the mailbox address exactly as it appears in Outlook, or leave it blank for the default account.
- The folder is Inbox unless you name another.
- Outlook needs to be running or able to start.
- The new Outlook for Windows (the Store app) can't be used this way. If Test shows only an empty Outlook Data File, your mail isn't in a classic profile. Use the Microsoft sign-in above instead.
IMAP (Gmail, Fastmail, Yahoo, iCloud and others)
IMAP needs an app password, not your normal password. For Gmail:
- In your Google account, turn on 2-Step Verification. App passwords aren't available without it.
- Go to myaccount.google.com/apppasswords, name the password "InvoiceWarden" and click Create. Copy the 16 characters. Spaces are fine.
- In InvoiceWarden, set the backend to IMAP, then enter server imap.gmail.com, port 993, your full Gmail address as the username, the app password, and folder INBOX.
- Click Save settings, then Test mailbox.
Other servers use port 993 too: Fastmail imap.fastmail.com, Yahoo imap.mail.yahoo.com, iCloud imap.mail.me.com, Zoho imap.zoho.com. Business email is usually mail.yourdomain.com: your host's "email client settings" page has it. For a sub-folder, use the full path as the server names it, such as INBOX/Invoices. If the name is wrong, Test mailbox lists the folders it can see.
Outlook.com, Hotmail and Live addresses can't use IMAP. Microsoft turned off app passwords for personal accounts on 16 September 2024. Use the Microsoft sign-in instead.
In every case InvoiceWarden reads mail without marking it as read, and only looks at emails that have attachments.
Getting a ServiceM8 API key
- Sign in to ServiceM8 on the web as the account owner.
- Open the top-right menu and choose Add-ons.
- Scroll to For Developers and choose Create a Private Application.
- Give it a name. Tick the scopes it needs: at least Job, Attachment and Client, with read and write for attachments.
- Save, then copy the API Key it shows.
- In InvoiceWarden, paste it into the Private App API Key field and click Test service.
InvoiceWarden matches the job number on an invoice to a ServiceM8 job, checking the job number first, then the internal job number and the purchase order number. Ask your suppliers to quote the ServiceM8 job number on their invoices. If you can't see For Developers, your plan may not allow API access.
Choosing an AI provider and getting a key
InvoiceWarden uses AI to read each invoice. You bring your own key. Under Deployment, pick the AI provider, paste the key, then click Test AI. Leave Model blank to use the default.
- Google Gemini: go to aistudio.google.com, sign in, choose Get API key, then Create API key. The free tier is usually enough for invoice volumes. On Google's free tier, Google may use what's sent to improve its products. A paid key keeps your invoices out of that, and usually costs well under A$1 a month.
- OpenAI: go to platform.openai.com, open API keys and choose Create new secret key. Add billing credit under Settings, Billing first.
- Anthropic (Claude): go to console.anthropic.com and add credit under Billing. Then open Settings, API keys and choose Create Key. Copy it straight away, because it's shown once.
- OpenAI-compatible: for services such as OpenRouter, Groq, Azure OpenAI, or a local server such as Ollama or LM Studio. Enter the base URL, which ends in /v1 (for example http://localhost:11434/v1 for Ollama), the model name that host uses, and a key if it needs one. A local server usually needs no key.
If the AI service is briefly unavailable, InvoiceWarden tries the email again on the next scans.
First run: what the first scan does
- Check the Watcher section of Settings. The poll interval is 5 minutes unless you change it. You can also choose to start the watcher when the app opens, and to run InvoiceWarden when Windows starts.
- Click Start Watcher in the header. The border around the tabs pulses while it's running. Click Scan now to check straight away instead of waiting.
- The first scan of a newly added mailbox looks back 14 days. For older mail, use Catch up.
- For each email with attachments, InvoiceWarden reads every attachment separately, works out the supplier and job number, and files the invoice to the matching ServiceM8 job. Watch the Activity Log to see what happened.
Only invoices and credit notes are filed. Statements, quotes, remittance advices and delivery dockets are skipped, and the Activity Log says so. If a document can't be recognised, it's treated as an invoice. An invoice that's already been sent to a job is skipped, even if it's emailed twice or arrives at two mailboxes.
Suppliers and the NEW flag
You don't set up suppliers first. When an invoice arrives from someone InvoiceWarden hasn't seen, it adds them for you. It never stops a scan to ask.
- A new supplier is marked NEW in yellow on the Suppliers tab.
- New suppliers start with the ServiceM8 upload on, the accounting upload off, and file type PDF only.
- To review one, open it, check the switches and click Save. Saving clears the NEW flag. That's all reviewing means.
- Sort the list by name, newest or oldest added, or New / unreviewed first (the default). Show new only hides suppliers you've already checked, and a counter shows how many are still new.
- Aliases are other names a supplier trades under, separated by commas. An invoice matches on the supplier name or any alias, so adding them stops duplicates. Slightly different spellings, such as "Acme Pty Ltd" and "ACME PTY. LIMITED", are treated as the same supplier.
- You can add a supplier yourself with New supplier, and delete one you don't want.
If the supplier's name is read with low confidence and the supplier isn't on file yet, InvoiceWarden holds the invoice instead of inventing a supplier. It appears in the Error Log. The cut-off is Min confidence to add a supplier in the Watcher settings (0.4 by default).
The Activity Log and Error Log
Activity Log
A record of each result, one line each: invoices filed, credit notes linked, duplicates skipped, suppliers added and errors. Each line shows the time, the system, the supplier, the invoice number, what happened and the file name. Use the search box to filter by supplier, reference or text. Tick Advanced to see the routine step-by-step events.
Credit notes usually don't carry a job number. InvoiceWarden links a credit note to the job of the original invoice it quotes. If it can't find that invoice, it uses the job of the most recent invoice from the same supplier and marks the line as a best guess for you to check. If there is no earlier invoice from that supplier at all, the credit note goes to the Error Log. Process the original invoice first, then retry.
Error Log
Anything that needs your attention is here, with the file name. Examples are a supplier name that couldn't be read, or a job number that doesn't exist in ServiceM8. If no job matched, the error lists every number it tried.
- Read the reason, then fix the cause. For example, add the supplier on the Suppliers tab, or create the job in ServiceM8.
- Click Retry on that line.
Show resolved displays ones already dealt with. Clear all dismisses every open item without retrying, and asks first. Cached attachments are kept for 30 days by default so that a failed upload can be retried (Settings, Watcher).
Catching up on older mail
Catch up... in the header scans invoice emails that are already in the mailbox. Use it after the app has been switched off for a while, or on a newly added mailbox.
- It asks how many days back to scan. 90 is suggested.
- You can add a job-number range. A bare number such as 15000 is a floor: anything below it is skipped. 15000-15010 is a range.
- An invoice outside the range, or whose job number can't be read, is skipped and not filed anywhere. It stays available for a later Catch up.
- The button shows a spinning "Catching up" indicator until the scan finishes.
Accounting systems
InvoiceWarden files to ServiceM8. Sending bills to an accounting system (Xero, MYOB, QuickBooks) is not available yet. Leave Accounting system under Deployment on None, and leave the accounting switch off on each supplier.
Common problems
- Test mailbox fails with IMAP. Check you used an app password, not your normal password, and that 2-Step Verification is on. Outlook.com, Hotmail and Live can't use IMAP: use the Microsoft sign-in.
- Classic Outlook finds nothing. You're probably on the new Outlook for Windows, or your mail isn't in a classic profile. Use the Microsoft sign-in.
- An invoice sits in the Error Log with "no job matched". The invoice may not show the job number, or the job doesn't exist in ServiceM8. The error lists the numbers it tried. Fix it, then Retry.
- ServiceM8 says the key is wrong. Paste the key again from the Private Application, with no spaces, and click Test service.
- Test AI fails. Check the key, that billing credit is on the account, and (for an OpenAI-compatible host) that the base URL ends in /v1 and the model name is one that host offers.
- A supplier was added twice. Add the other name to the first supplier's Aliases and delete the duplicate.
- Nothing is being picked up. Check the watcher is running and the mailbox row is switched on. Only emails with attachments are looked at, and with Only process UNREAD emails ticked, mail you've already opened is ignored.
- A mailbox was offline for a while. Each mailbox keeps its own place, so missed invoices are picked up when it comes back.
- Windows blocks the program. See opening InvoiceWarden for the first time.
Frequently asked questions
What does InvoiceWarden work with?
ServiceM8 for jobs. For email, Microsoft 365 or Outlook.com, the classic Outlook desktop app, and Gmail or most other email through IMAP. Other systems you may see in the app's lists, including the accounting systems, are not available yet.
Do my suppliers have to change anything?
No. InvoiceWarden reads the inbox you already use, so every supplier works from day one.
Who pays for the AI?
You do, directly to the AI provider you pick. A free Google Gemini key works, but on Google's free tier Google may use what's sent to improve its products. A paid key, usually well under A$1 a month, keeps your invoices out of that.
Do my invoices go through Sixth Day Studios?
No. Invoices go only between your email, ServiceM8 and the AI service you choose. Saved logins are encrypted on your PC. See the privacy policy.
Why did suppliers appear by themselves?
That's normal. A supplier is added when its first invoice arrives and is marked NEW until you open it, check it and save.
Does it work with the new Outlook for Windows?
Not through the Outlook desktop connection. Use the Microsoft sign-in, which works with the new Outlook.
Can it watch more than one mailbox?
Yes, up to 10, each with its own sign-in. You can mix types, for example two Microsoft 365 mailboxes and a Gmail address. The same invoice arriving at two addresses is still filed once.
What happens to credit notes?
They're linked to the job the original invoice went to. See the Activity Log section.
What if it can't work out the supplier or the job?
It doesn't guess. The invoice goes to the Error Log with the reason. Fix the cause and click Retry.
How do I file old invoices already in the inbox?
Use Catch up... in the header and choose how many days back. See Catching up on older mail.
Are my emails marked as read?
No. InvoiceWarden reads mail without changing it, and only looks at emails that have attachments.
Can I run two copies?
No. Only one copy of InvoiceWarden runs at a time, so a second launch closes. This stops invoices being uploaded twice.
How do updates work?
InvoiceWarden checks Sixth Day Studios for new versions when it opens, shows what changed and asks before installing. You can turn the check off or run it yourself under Settings, Updates.
What does it cost, and can I get a refund?
See the product page for the price and trial, and the refund policy.
Still need help?
Send me a message from the support page or email hello@sixthdaystudios.com. Never send passwords, API keys or app passwords.