Sixth Day Studios

← InvoiceWarden

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

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.

  1. Type the email address and leave Backend on graph.
  2. Click Sign in. A short code appears and your browser opens Microsoft's sign-in page.
  3. Enter the code, sign in as that mailbox and approve the permission. InvoiceWarden only asks to read mail.
  4. 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.

IMAP (Gmail, Fastmail, Yahoo, iCloud and others)

IMAP needs an app password, not your normal password. For Gmail:

  1. In your Google account, turn on 2-Step Verification. App passwords aren't available without it.
  2. Go to myaccount.google.com/apppasswords, name the password "InvoiceWarden" and click Create. Copy the 16 characters. Spaces are fine.
  3. 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.
  4. 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

  1. Sign in to ServiceM8 on the web as the account owner.
  2. Open the top-right menu and choose Add-ons.
  3. Scroll to For Developers and choose Create a Private Application.
  4. Give it a name. Tick the scopes it needs: at least Job, Attachment and Client, with read and write for attachments.
  5. Save, then copy the API Key it shows.
  6. 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.

If the AI service is briefly unavailable, InvoiceWarden tries the email again on the next scans.

First run: what the first scan does

  1. 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.
  2. 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.
  3. The first scan of a newly added mailbox looks back 14 days. For older mail, use Catch up.
  4. 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.

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.

  1. Read the reason, then fix the cause. For example, add the supplier on the Suppliers tab, or create the job in ServiceM8.
  2. 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.

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

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.