Integrate ZIMRA Fiscalisation into Any App

Welcome to the Mutero VFD documentation. Learn how to connect your accounting software, storefront, or custom POS terminal to ZIMRA FDMS with automated signing, receipt verification writebacks, and real-time tax compliance.

ZIMRA FDMS Certified Infrastructure

Mutero VFD manages device certificate handshakes, payload signing algorithms, and fiscal day closures automatically. All API requests are processed through compliant ZIMRA security gateways.

Core Guides & Documentation

Quickstart Guide

Step-by-step setup guide for business owners and developers to activate virtual fiscal devices and configure ZIMRA tax mappings.

Zoho Books API v3

Configure OAuth 2.0 access, automated invoice sync, ZIMRA tax mapping rules, and verification link writebacks.

Xero Accounting

Connect in the Hub, map tax rates, auto-fiscalize XR- invoices and credit notes, and get FRN history writeback.

QuickBooks Online

Connect via Intuit OAuth, sync QBO- / QBO-CN- stubs, auto-fiscalize, and write FRNs back from the Integrations Hub.

Sage Accounting ZA

Connect accounting.sageone.co.za with username, password, and Company ID. SAZ- stubs, Sync Now / Hub poller (no webhooks), FRN Message writeback.

Odoo Cloud

Odoo Online / Odoo.sh via JSON-RPC in the Hub. ODC- stubs, posted invoices & refunds, chatter writeback, 3-minute poller.

Excel & Mutero Desktop

Excel template, Office.js add-in, offline queue, XL- stubs, and shared FDMS preflight.

QuickBooks Desktop

QBWC / qbXML listener, QB- stubs, fail-closed tax mapping, and credit memo rules.

Odoo & Mutero Desktop

LAN / self-hosted Odoo JSON-RPC poller, OD- stubs, chatter writeback. Prefer Odoo Cloud for Odoo Online.

Sage Pastel Partner

ODBC poller on HistoryHeader/Lines, SP- stubs, fail-closed tax, and FRN writeback.

Sage Evolution

SQL Server ODBC on InvNum / _btblInvoiceLines, SE- stubs, optional Freedom Service check, FRN writeback.

Mutero FDMS Sandbox

FDMS-compatible Online developer gateway — docs, OpenAPI, and console. No subscription required.

Custom POS & Direct API

Integrate custom backends and point-of-sale hardware via Bearer API keys and real-time status callback webhooks.

Webhooks Reference

Subscribe to real-time events for invoice signing results, fiscal day closures, and ZIMRA verification confirmations.

Quick Integration Example

Fiscalize a sale invoice directly via the Mutero VFD API:

POST /api/v1/vfd/invoices/submitbash

curl -X POST https://www.mutero.online/api/v1/vfd/invoices/submit \
  -H "Authorization: Bearer mutero_live_key_9f82a1..." \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_number": "INV-2026-0042",
    "currency": "USD",
    "total_amount": 115.00,
    "tax_amount": 15.00,
    "items": [
      {
        "name": "Dell Laptop 15 inch",
        "hs_code": "8471.30.00",
        "quantity": 1,
        "unit_price": 100.00,
        "tax_code": "A"
      }
    ]
  }'

Integration Project Architecture

src/lib/integrations

core

types.ts

base-adapter.ts

registry.ts

zoho-books

client.ts

adapter.ts

types.ts

xero

client.ts

adapter.ts

process-credit-note.ts

types.ts

sage-accounting-za

client.ts

adapter.ts

types.ts

odoo-cloud

client.ts

adapter.ts

types.ts

sage-evolution

adapter.ts

index.ts

custom-pos

client.ts

webhook-handler.ts