
FreeAgent Accounting for OpenCart — invoices from orders in FreeAgent (United Kingdom)
FreeAgent for OpenCart 4.x, 3.x, 2.3 (United Kingdom): invoices from orders free of charge, in Pro by status, payments, credit notes, a journal. Licence for life.
- Compatibility
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · interface language: English
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- 14.11.2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What the seller gets
The order page gets a “FreeAgent invoice” box: the VAT number field of a business buyer, the buyer line with the address, a note on the payment term and on whether the invoice will be a draft, a table of rows (Item, Qty, Unit price (net), VAT, Net) with shipping and coupons, the total and the “Create the invoice in FreeAgent” button.
In the admin
Extensions → Extensions → Modules → FreeAgent Accounting: the tabs “Connection”, “Invoice”, “Automation”, “Accounts” and “Pro”.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; the cURL and OpenSSL extensions.
A FreeAgent account and the store’s own OAuth app at dev.freeagent.com; the Redirect URI is taken from the “Connection” tab.
The VAT rates of the order have to be among the rates of the FreeAgent account (for example 20%, 5%, 0%): FreeAgent accepts any number by itself, so the module checks the rates and stops the sending with an explanation. For an account that is not VAT registered the invoice goes with the buyer’s prices without rates.
The buyer’s country has to be in the module’s table (252 codes from the FreeAgent menu): otherwise FreeAgent would quietly put United Kingdom, and the sending stops; if FreeAgent changes its list of countries, the module needs an update.
FreeAgent does not let you change the country of a contact that has drafts: the module then makes a new contact, so duplicate contacts are possible in FreeAgent.
The free version makes invoices only in the currency of the books of the account; an invoice in another currency is Pro.
A payment or a refund (Pro) creates a bank transaction on the chosen FreeAgent account; if a bank feed is connected to it, duplicates with the real incoming money are possible, so an account of its own for the store, for example “Shop payments”, is better.
If the invoice total does not match the order (for example a fee with a fixed amount and no rate), the sending stops with an explanation before FreeAgent is called.
The module does not use FreeAgent webhooks: “paid in FreeAgent” is picked up by polling in a round (Pro).
After a lost answer the invoice is looked up by the PO reference “Order N” among the 50 newest invoices of the contact; if the PO reference is changed by hand in FreeAgent, a retry can make a second invoice.
The module interface is in English.
Version history
FreeAgent invoices from the order page, VAT with a rate check, PDF; Pro: statuses, payments, credit notes, a journal.
Frequently bought with FreeAgent Accounting


Royal Mail Click & Drop Sync for OpenCart 2.3, 3.x and 4.x — orders to Click & Drop, tracking back

Capsule CRM Sync for OpenCart — customers and orders in Capsule CRM (United Kingdom)

MTD VAT Returns for OpenCart 2.3, 3.x and 4.x — UK VAT returns from the admin
Full module description
FreeAgent Accounting for OpenCart 4.x, 3.x and 2.3 creates invoices in the UK accounting software FreeAgent straight from store orders through API v2: a button on the order page saves the buyer as a FreeAgent contact and sends the rows with prices without VAT and the UK VAT rate, and the invoice total has to match the order total, otherwise nothing is sent.
What you need. A FreeAgent account and your own OAuth app for the store: it is created free of charge at dev.freeagent.com, and the Redirect URI from the module settings goes into it (steps below). FreeAgent plans are paid separately.
What the seller gets
The order page gets a “FreeAgent invoice” box: the VAT number field of a business buyer, the buyer line with the address, a note on the payment term and on whether the invoice will be a draft, a table of rows (Item, Qty, Unit price (net), VAT, Net) with shipping and coupons, the total and the “Create the invoice in FreeAgent” button.
After sending, the box shows every document (invoice, credit note) with its number, amount, status (draft, open, paid, refunded) and the buttons “PDF”, “Refresh status”, “Mark as sent” and “E-mail” (Pro). An invoice is never made twice: six simultaneous clicks give one row and one invoice. If FreeAgent hangs, the button answers within 8-9 seconds with “FreeAgent did not answer. The module will try again.”, and before a retry the module looks for the buyer’s invoice by its PO reference, so no duplicate appears.
The order number goes onto the invoice as the PO reference, and the VAT number of a business buyer goes to the contact and onto the invoice. The VAT number field at the checkout is created with a button on the “Invoice” tab; an empty field does not get in the way of the order.
In the admin
Extensions → Extensions → Modules → FreeAgent Accounting: the tabs “Connection”, “Invoice”, “Automation”, “Accounts” and “Pro”. The first one holds the module switch, the instructions with the Redirect URI of your store, the OAuth identifier and OAuth secret fields, the buttons “Connect to FreeAgent”, “Check the connection”, “Connect again” and “Disconnect”, and the income categories for products and for shipping and fees. The secret is stored encrypted and never shown again; the access tokens renew themselves.
On the “Invoice” tab: invoices are made as drafts (you check and send them in FreeAgent) or straight away as “marked as sent”; the invoice date (the day it is made or the day of the order); the codes of payment methods paid later (the rest count as paid at the checkout, and the invoice is due on receipt); the payment term in days; the invoice language; the VAT number field; a comment under the order number at the bottom of the invoice.
Without a key the “Automation” and “Accounts” tabs open with an explanation and disabled fields, and saved Pro values are not shown.
Pro makes the invoice by itself when an order reaches a chosen status: once per order, in the background after the buyer has been answered, never during the checkout. Payments are recorded in FreeAgent on a chosen bank account: straight away for orders paid at the checkout, at a status for the rest (bank transfer, cash on delivery); foreign currency at the invoice rate. A credit note at a status such as Refunded, or by a button, mirrors the rows of the invoice: it is set against what the invoice still owes, and for a paid invoice the money paid back is recorded on the bank account (Credit Note Refund).
The e-mail from FreeAgent goes to the buyer with the e-mail template of your account, or, when there is none, with a short text of the module from the verified sender address. Payments entered in FreeAgent appear in the store: the module reads 5 unpaid invoices at a time in a round, every 15 minutes, the oldest first, and adds a line to the order history. The journal in the Sales menu (“FreeAgent invoices”) shows every document with filters by period, account and status, period totals, a CSV export, bulk invoicing and a “Retry all stopped” button. Up to three extra FreeAgent accounts: the stores ticked in a slot work with the account of that slot through the same app.
How it works, step by step
- Install the archive for your OpenCart version and install the module in Extensions → Modules.
- Create a free account at dev.freeagent.com and press “Create New App”: any name will do.
- In the “OAuth Redirect URIs” field of the app, paste the “OAuth Redirect URI of this shop” address from the module’s “Connection” tab.
- Copy the OAuth identifier and OAuth secret of the app into the module, press “Save”, then “Connect to FreeAgent”, log in to FreeAgent and allow access. The module shows the company name, the currency of the books and the VAT rates of the account.
- On the “Invoice” tab choose drafts or “marked as sent” and the payment methods paid later, and create the VAT number field if needed.
- Open an order, look at the rows and the total and press “Create the invoice in FreeAgent”.
- For Pro: a key or the trial on the “Pro” tab, then statuses, payments and credit notes on the “Automation” tab.
Under the hood
- FreeAgent API v2: OAuth 2.0 (authorization code and refresh token), contacts, invoices, credit notes, bank accounts, bank transaction explanations, categories, company, email addresses; the secret and the tokens are stored encrypted (AES-256).
- The invoice rows go with prices without VAT and the rate; coupons as discount rows by rate, a gift voucher as a 0% row, the pennies of VAT-inclusive prices as a Rounding row; the total is compared with the order before the call.
- Timeout: a budget of 9 seconds per document; the module does not call FreeAgent at the checkout, and the work on statuses runs after the buyer has been answered.
- Background work (invoices by status, payments, polling of payments) runs on the OpenCart schedule and from page visits; a server cron on the address from the “Automation” tab every 5 minutes makes it more dependable.
Installation
- Extensions → Installer: upload the archive for your version without renaming the file (OpenCart 4 — cc_freeagent.ocmod.zip, 3.x — cc_freeagent-oc3.ocmod.zip, 2.3 — cc_freeagent-oc23.ocmod.zip; for 2.3 the contents of the upload/ folder are copied to the store root).
- For 3.x and 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → FreeAgent Accounting: install it and open the settings.
- Create an app at dev.freeagent.com, paste the Redirect URI from the “Connection” tab into it and the keys of the app into the module, and press “Connect to FreeAgent”.
- For Pro: enter a key or start the trial on the “Pro” tab.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this an official FreeAgent module?
No, it is an independent integration with FreeAgent by CatCode. FreeAgent is a trademark of its owner.
What do I need to start?
A FreeAgent account and your own OAuth app at dev.freeagent.com (free): the Redirect URI from the module settings goes into the app, and its identifier and secret go into the module.
Why do I create the app myself?
Each store connects with its own FreeAgent app: the keys and access tokens live only in your store. Step-by-step instructions are in the module settings.
How is VAT worked out?
The rate comes from the order and is checked against the rates of the FreeAgent account. A rate the account does not have stops the sending with an explanation. For an account without VAT the invoice goes with prices without rates.
What if FreeAgent does not answer?
Within 8-9 seconds the button says that FreeAgent did not answer. Before a retry the module looks for the buyer's invoice by its PO reference, so a second invoice is not made (unless the PO reference was changed by hand in FreeAgent).
Are there credit notes and refunds?
Yes, in Pro: a credit note at a status or by a button is set against what the invoice owes, and for a paid invoice the refund is recorded on the FreeAgent bank account.
Does a payment entered in FreeAgent appear in the store?
Yes, in Pro: the module reads 5 unpaid invoices at a time every 15 minutes and adds a line to the order history.
Can I use several FreeAgent accounts?
Yes, in Pro up to three extra accounts by store. Without Pro the order of such a store does not go to the main account but stops with an explanation.
Which OpenCart versions?
OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence for life?
Yes, for OpenCart it is one payment and a licence for life, for two sites.
What happens after the trial?
Pro turns off, an invoice by status, a payment or a credit note waiting in the queue stops with a reason, and the free part keeps working.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















