ThatFiscal Knowledge Base

Invoice Didn't Fiscalise? The Three Usual Causes

the 3 usual suspects: API key · tax mapping · currency

With other providers, invoices sometimes fail silently — nothing fiscalises and no error appears anywhere. ThatFiscal is built so that never happens: every failure is recorded with a plain-language cause and the fix. Here is the 2-minute drill:

Step 1

Open Portal → Dashboard → Integration Health

It shows each connected system, when the last invoice arrived, this week's volume, and — if anything failed — the likely cause and exactly what to do.

Step 2

Invoice missing entirely from Integration Health?

Then the request never reached ThatFiscal. In practice this is almost always the API key: your key changes at go-live, so re-copy it from Portal → Settings into your Odoo script / webhook header (X-Api-Key). Second suspect: the endpoint URL.

Step 3

Invoice shows as Error?

Open it under Invoices — the drawer names the cause: tax mapping (line tax must be 15.5, 0, or blank for exempt — fix the tax on the product in your accounting system), currency (send USD or ZWG and make sure the currency is enabled on your account), or a validation field with the exact ZIMRA message. Fix, press Resend, done.

Test it end to end: after any setup change, post one small test invoice and watch it appear in the portal within seconds. If you and your reseller did a test together and later invoices stop arriving, something changed — Integration Health tells you what.
← All Knowledge Base Guides