Integrations

Keep your system. Fiscalise its invoices.

Your accounting system or POS keeps its screens, its reports and its people. ThumaBooks is the fiscal device behind it: each invoice is checked against ZIMRA's rules, signed, sent and answered with the verification code and QR your system prints.

How each connection works today. Every system below connects through document forwarding: the invoice, exactly as that system's own API returns it, is sent to POST /api/v1/fiscal/invoices/from/<system> — by your developer, your reseller, an automation tool such as Zapier or Make, or a small script — and we map it. One-click "Connect" buttons inside each system's app marketplace are being built and are marked Coming soon; they need each marketplace to approve our app.
Accounting

Xero

What is fiscalised: sales invoices (ACCREC) and credit notes (ACCRECCREDIT). Bills are refused — they are not sales.

  • Tax-exclusive and tax-inclusive line amounts both handled; each line's own TaxAmount is used, so nothing is estimated.
  • A credit note is linked to its invoice through its allocation; if it has none, you name the invoice. A credit note refunded in Xero is filed as money back.
  • The contact's tax number becomes the buyer's TIN (10 digits) or VAT number (9).
  • Map your tax rates once: anything 0 % that isn't clearly zero-rated or exempt asks you which it is.

Document forwarding Connect button — coming soon

Accounting

QuickBooks Online

What is fiscalised: invoices and credit memos.

  • QuickBooks gives tax for the whole invoice; it is spread over the taxed lines to the cent, so the receipt adds up to what the customer was charged.
  • An invoice discount is spread across its lines and you are told so — ZIMRA receipts carry discounts in the line prices.
  • Paid in full: fiscalised with its payment. Otherwise: on account, against the customer.

Document forwarding Connect button — coming soon

Accounting

Zoho Books

What is fiscalised: invoices and credit notes.

  • Inclusive or exclusive of tax, per line, by Zoho's own tax_percentage.
  • HSN/SAC codes carry across as HS codes when present.
  • A credit note applied to an invoice is linked to it automatically.

Document forwarding Marketplace listing — coming soon

Accounting

Sage Business Cloud Accounting

What is fiscalised: sales invoices and sales credit notes.

  • Each line's net, tax and total are read as Sage states them.
  • A quantity whose price can't reach its total to the cent is kept, with its quantity in the description — never rounded away.

Document forwarding Connect button — coming soon

ERP

Odoo

What is fiscalised: customer invoices (out_invoice) and refunds (out_refund). Vendor bills are refused.

  • Section and note lines are skipped; product lines carry their tax-inclusive total.
  • A refund names its reversed invoice, so the credit note links itself.
  • Works with Odoo Online, Odoo.sh and on-premise, over Odoo's standard JSON-RPC.

Document forwarding Odoo app — coming soon

Spreadsheet

Excel and Google Sheets

For anyone without an API. One row per line; rows with the same document_id are one invoice. Save as CSV, then check it and import it from the Books Desk — or send it to POST /api/v1/fiscal/imports.

  • Check first: test mode says exactly what each document would be, files nothing.
  • Import the same file twice and nothing is filed twice.
  • Each bad row is named, with why; the good ones still go.
  • Excel's semicolon CSVs (comma-decimal locales) read as well as comma ones.

Download the template Available

ERP

Sage Pastel, Sage Evolution, SAP Business One, Palladium, IQ Retail and others

Desktop and on-premise systems connect through the Fiscal API: your integrator sends each invoice in our format (a dozen fields) and prints what comes back. Our partners can do this for you.

Fiscal API Find or become a partner

Point of sale

Your POS

A POS keeps its screens; ThumaBooks is the fiscal device behind it. The answer includes the 80 mm or 58 mm slip, line by line, ready to print, and the A4 PDF.

Fiscal API Read the API

Forwarding a document, in one request

The body is { "document": … , "options": … }: the document exactly as the other system returned it, and the choices only you can make.

POST /api/v1/fiscal/invoices/from/xero
Authorization: Bearer tbk_live_…
Idempotency-Key: 5b1c…-xero

{
  "document": { …the Invoice exactly as Xero's API returns it… },
  "options": {
    "paidBy": "card",                       // when Xero says it is paid, how
    "taxMap": { "NONE": "exempt" },         // 0 % codes, once
    "correctsExternalId": null              // a credit note with no allocation
  }
}

The answer is the fiscalised invoice — and warnings: each judgement the mapping made, such as a rate that isn't 15.5 % or a discount spread over lines, so the person importing sees what changed. Sources: xero, quickbooks, zoho, sage, odoo.