Integration Guides
Task-shaped walkthroughs for getting invoices into qbill. Every ERP is served from day one — you don't need a native connector to be compliant.
Ways invoices get in
- Submission API — post invoices from any system that can make an HTTP request. See API Reference.
- CSV and Excel bulk upload — download a template, fill it in, and get per-row validation before anything is submitted.
- ERP connectors — guided setup for Odoo, QuickBooks Online and Zoho Books, below.
- Manual creation — create invoices in the dashboard, with live tax totals and validation as you type.
Odoo integration
qbill connects to your Odoo instance over its API, pulls invoices on a schedule you choose, and submits them to NRS.
Before you start
- An Odoo instance reachable from the internet
- A user account on that instance with read access to invoices
- Your Odoo database name
Your organisation must also be verified and have NRS credentials saved — a connector can pull invoices in, but nothing transmits until those are in place.
What you'll need
| Field | Where to find it |
|---|---|
| Instance URL | The base URL of your Odoo instance |
| Database name | Odoo → Settings → the database selector |
| Username | The integration user's login |
| API key or password | Odoo → Preferences → Account Security → API Keys |
Connecting
- In the dashboard, go to ERP Integration and choose Odoo.
- Enter the credentials above and save the connection.
- Run the connection test — it fails loudly if the credentials are wrong, so don't skip it.
- Choose a sync frequency and finish. qbill runs a first sync immediately, so you can confirm invoices actually arrive before you walk away.
After it's connected
- The connector card shows last sync time, status, invoices synced, and a running failure count.
- Transient failures are retried automatically with exponential backoff. A connection that keeps failing is paused rather than retried forever — the owner is notified, and it waits for you to fix the cause and replay it.
- Synced invoices land as drafts unless you enable automatic submission, so you can review before anything reaches NRS.
QuickBooks Online integration
qbill reads invoices from your QuickBooks company and submits them to NRS.
Token handling is manual for now
Before you start
- A QuickBooks Online company
- Access to the Intuit developer portal to obtain a token
Your organisation must also be verified and have NRS credentials saved — a connector can pull invoices in, but nothing transmits until those are in place.
What you'll need
| Field | Where to find it |
|---|---|
| Access token | Intuit developer portal |
| Realm (company) ID | Intuit developer portal |
Connecting
- In the dashboard, go to ERP Integration and choose QuickBooks Online.
- Enter the credentials above and save the connection.
- Run the connection test — it fails loudly if the credentials are wrong, so don't skip it.
- Choose a sync frequency and finish. qbill runs a first sync immediately, so you can confirm invoices actually arrive before you walk away.
After it's connected
- The connector card shows last sync time, status, invoices synced, and a running failure count.
- Transient failures are retried automatically with exponential backoff. A connection that keeps failing is paused rather than retried forever — the owner is notified, and it waits for you to fix the cause and replay it.
- Synced invoices land as drafts unless you enable automatic submission, so you can review before anything reaches NRS.
Zoho Books integration
qbill reads invoices from your Zoho Books organisation and submits them to NRS.
Token handling is manual for now
Before you start
- A Zoho Books organisation
- Access to the Zoho API console to generate a token
Your organisation must also be verified and have NRS credentials saved — a connector can pull invoices in, but nothing transmits until those are in place.
What you'll need
| Field | Where to find it |
|---|---|
| Access token | Zoho API console |
| Organization ID | Zoho Books → Settings → Organisation |
| Region | The Zoho data centre your account lives in (e.g. .com, .eu) |
Connecting
- In the dashboard, go to ERP Integration and choose Zoho Books.
- Enter the credentials above and save the connection.
- Run the connection test — it fails loudly if the credentials are wrong, so don't skip it.
- Choose a sync frequency and finish. qbill runs a first sync immediately, so you can confirm invoices actually arrive before you walk away.
After it's connected
- The connector card shows last sync time, status, invoices synced, and a running failure count.
- Transient failures are retried automatically with exponential backoff. A connection that keeps failing is paused rather than retried forever — the owner is notified, and it waits for you to fix the cause and replay it.
- Synced invoices land as drafts unless you enable automatic submission, so you can review before anything reaches NRS.
SAP, Dynamics & others
SAP S/4HANA and Microsoft Dynamics 365 connectors are on the roadmap but not built yet — a dedicated guide will follow once they are. In the meantime, the Submission API and CSV bulk upload work with any system that can export or call an HTTP endpoint.