MuteroDocs

Sage One (Sage Business Cloud) Integration Guide

Connect Sage One / Sage Business Cloud Accounting (accounting.sageone.co.za) in the Mutero Integrations Hub. Discover company profiles automatically, enter optional custom API keys, map tax types for ZIMRA, auto-fiscalize tax invoices and customer returns, and write FRN verification links back to the Sage invoice Message field.

Invoice numbering stubs
Mutero prefixes Sage One documents for idempotency: invoices become SAZ-{DocumentNumber}, and credit notes / customer returns become SAZ-CN-{DocumentNumber}. This is separate from Pastel Partner (SP-) and Evolution (SE-).
Sage One / Sage Business Cloud in Zimbabwe & South Africa
In Zimbabwe and South Africa, Sage One (branded as Sage Business Cloud Accounting) runs at accounting.sageone.co.za. That product authenticates with your login email, password, and Company ID (with optional API key). It is separate from the UK/EU/US OAuth API.
No native webhooks
Sage One does not push invoice events. Use Sync Now or rely on the Integrations Hub 3-minute background poller.
DIY setup checklist
If you are connecting this yourself, follow this guide end-to-end before Sync. Mutero blocks Sync when tax setup is incomplete. Prefer assisted setup? Request it for a once-off $50 from the Integrations Hub.

1. Overview

Connect your Sage One company from the Mutero Integrations Hub. After connect:

  • Tax invoices sync and auto-fiscalize (when enabled).
  • Customer returns / credit notes fiscalize only when linked to an already-fiscalized Mutero original (ZIMRA RCPT015 / RCPT032).
  • After ZIMRA confirm, Mutero appends FRN and verification URL to the Sage invoice Message field.

2. What you need

Entered in the Integrations Hub

  • Email / Username — The login email you use to sign in at accounting.sageone.co.za.
  • Password — Your Sage One login password.
  • API Key (Optional) — Enter your custom Sage developer API key if you have one, or leave blank to use Mutero's default server key.
  • Company ID — Numeric identifier for your Sage One company.
    Tip: In Mutero's connection modal, click Discover Companies to automatically fetch and select your company name from a dropdown without needing to look up numbers manually.

3. Connect Sage One

  1. Confirm you can sign in to your dashboard at accounting.sageone.co.za.
  2. Open Integrations Hub.
  3. Locate Sage One (Sage Business Cloud) and click Connect.
  4. Enter your email and password. Click Discover Companies to load your companies, then select your company profile from the dropdown.
  5. Click Connect. Mutero tests credentials, verifies your company, and checks tax types against ZIMRA rules.

4. Tax Mapping

Map Sage tax type names (or ids / rate strings like 15%) to ZIMRA tax IDs under Tax Mapping → Sage Accounting ZA. At minimum, map a ~15% sales rate to ZIMRA Standard (tax ID 1). Default mappings for common names are seeded on connect.

Use Configure → Recheck tax after changing mappings. Sync is blocked while setup_health.tax_ok is false.

5. Sync & Fiscalize

  1. Ensure Automated Sync & Fiscalize is on (Configure).
  2. Click Sync Now, or wait for the dashboard poller (~3 minutes).
  3. Tax invoices are claimed with the SAZ- prefix and queued for ZIMRA.
  4. After confirm, Mutero writes FRN + verification URL into the Sage invoice Message.

6. Credit Notes

ZIMRA requires every credit note to reference a previously fiscalized original (RCPT015 / RCPT032).

  • Easiest: open the fiscalised invoice in Mutero → Issue Credit Note.
  • In Sage: create a customer return / credit allocated to the original tax invoice, then Sync Now in Mutero. Mutero stores it as SAZ-CN-….

7. Operations notes

  • If the Sage password changes, open Configure and save the new password.
  • Desktop Pastel Partner / Evolution are separate connectors for on-prem products — do not confuse them with this cloud ZA API.
  • Disconnect removes the Mutero integration document. Re-enter credentials to reconnect.