Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

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.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
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
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

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.

Feature Free Pro
Connects through OAuth with your own FreeAgent app, tokens encrypted and renewed by themselves ✔ ✔
An invoice from an order with one button and a preview: rows, prices without VAT, rates ✔ ✔
The buyer as a FreeAgent contact: a returning buyer is the same contact, the address is brought up to date ✔ ✔
VAT rates from the order checked against the rates of the account; not VAT registered — prices without rates ✔ ✔
Shipping and fees with VAT, coupons as discount rows by rate, a gift voucher at 0%, a Rounding row ✔ ✔
The order number as the PO reference, the VAT number of a business buyer from the checkout field ✔ ✔
A draft or "marked as sent", PDF, status refresh, "Mark as sent" from the order ✔ ✔
Checks before sending: total, country, VAT rate — without a match nothing is sent ✔ ✔
Duplicate protection and a lookup of the invoice by PO reference after a lost answer ✔ ✔
Interface in English ✔ ✔
Invoice currency only the currency of the books of the account any currency
FreeAgent accounts one up to 3 extra
Invoices automatically by order status — ✔
Payment in FreeAgent on a bank account: paid at the checkout straight away, the rest at a status — ✔
Credit note at a status or by a button: set against the debt or refunded from the bank — ✔
E-mail from FreeAgent to the buyer (account template) — ✔
Payments entered in FreeAgent seen in the store — ✔
Journal with filters, period totals and CSV, bulk invoicing, Retry all — ✔

What it looks like

FreeAgent box in an order
The “FreeAgent invoice” box in an order: the VAT number, rows with prices without VAT and rates, the total and the button that creates the invoice.
Invoice and credit note in an order
Order documents: a credit note with the status “refunded” and a paid invoice, the PDF, Refresh status and E-mail (Pro) buttons.
Connecting to FreeAgent
The “Connection” tab: the Redirect URI, the OAuth identifier and secret, the connected account, the bank account for payments (Pro).

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

v1.0.0 Current 14.11.2026

FreeAgent invoices from the order page, VAT with a rate check, PDF; Pro: statuses, payments, credit notes, a journal.

Frequently bought with FreeAgent Accounting

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

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

  1. Install the archive for your OpenCart version and install the module in Extensions → Modules.
  2. Create a free account at dev.freeagent.com and press “Create New App”: any name will do.
  3. In the “OAuth Redirect URIs” field of the app, paste the “OAuth Redirect URI of this shop” address from the module’s “Connection” tab.
  4. 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.
  5. On the “Invoice” tab choose drafts or “marked as sent” and the payment methods paid later, and create the VAT number field if needed.
  6. Open an order, look at the rows and the total and press “Create the invoice in FreeAgent”.
  7. 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

  1. 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).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → FreeAgent Accounting: install it and open the settings.
  4. 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”.
  5. 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.

@catcode_support Setup, compatibility, activation
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.

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