
FreeAgent Accounting для OpenCart — счета из заказов в FreeAgent (Великобритания)
FreeAgent для OpenCart 4.x, 3.x, 2.3 (Великобритания): счета из заказов бесплатно, в Pro по статусу, оплаты, кредит-ноты, журнал. Лицензия навсегда.
- Совместимость
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · язык интерфейса: English
- Версия
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Лицензия
- сайт + тестовая копия, навсегда
- Триал
- 7 дней, без карты, один на сайт
- Обновлено
- 14.11.2026
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получает продавец
На странице заказа появляется блок «FreeAgent invoice»: поле НДС-номера покупателя-бизнеса, строка покупателя с адресом, примечание о сроке оплаты и о том, будет ли счёт черновиком, таблица строк (Item, Qty, Unit price (net), VAT, Net) с доставкой и купонами, итог и кнопка «Create the invoice in FreeAgent».
Что в админке
Extensions → Extensions → Modules → FreeAgent Accounting: вкладки «Connection», «Invoice», «Automation», «Accounts» и «Pro».

Триал стартует, когда вы попросите
Свежая установка — бесплатная версия, ничего не включается само. Кнопка «Попробовать Pro 7 дней» → e-mail → ключ сразу в окне и письмом.

Один ключ — сайт и тестовая копия
Переносите сайт — отвяжите лицензию на старом домене и активируйте на новом сами. Тестовая копия (staging., dev.) работает с тем же ключом и места сайта не занимает. Для студий — ключи на 5, 25 сайтов или без ограничений.
Технические требования
OpenCart 4.0.2.x–4.1.x, 3.0.x или 2.3.0.2; расширения cURL и OpenSSL.
Аккаунт FreeAgent и собственное OAuth-приложение магазина в dev.freeagent.com; адрес Redirect URI берётся с вкладки «Connection».
Ставки НДС из заказа должны быть среди ставок аккаунта FreeAgent (например 20%, 5%, 0%): FreeAgent сам принимает любое число, поэтому модуль сверяет ставки и останавливает отправку с пояснением. Для аккаунта без регистрации НДС счёт идёт ценами покупателя без ставок.
Страна покупателя должна быть в таблице модуля (252 кода из меню FreeAgent): иначе FreeAgent молча поставил бы United Kingdom, и отправка останавливается; если FreeAgent изменит список стран, нужно обновление модуля.
FreeAgent не даёт изменить страну контакта, у которого есть черновики: тогда модуль создаёт новый контакт, поэтому в FreeAgent возможны дубликаты контактов.
Бесплатная версия выписывает счета только в валюте книг аккаунта; счёт в другой валюте — Pro.
Оплата или возврат (Pro) создаёт банковскую транзакцию на выбранном счёте FreeAgent; если к нему подключена банковская лента, возможны дубликаты с реальным поступлением, поэтому для магазина лучше отдельный счёт, например «Shop payments».
Если итог счёта не сходится с заказом (например, сбор с фиксированной суммой без ставки), отправка останавливается с пояснением до вызова FreeAgent.
Вебхуки FreeAgent модуль не использует: «оплачено в FreeAgent» берётся опросом по кругу (Pro).
После потерянного ответа счёт ищется по PO reference «Order N» среди 50 новейших счетов контакта; если вручную изменить PO reference в FreeAgent, повтор может создать второй счёт.
Интерфейс модуля на английском.
История версий
Счета FreeAgent со страницы заказа, НДС со сверкой ставок, PDF; Pro: статусы, оплаты, кредит-ноты, журнал.
Вместе с FreeAgent Accounting покупают


Royal Mail Click & Drop Sync для OpenCart 2.3, 3.x и 4.x — заказы в Click & Drop, трекинг обратно

Capsule CRM Sync для OpenCart — покупатели и заказы в Capsule CRM (Великобритания)

MTD VAT Returns для OpenCart 2.3, 3.x и 4.x — декларация НДС Великобритании из админки
Полное описание модуля
FreeAgent Accounting для OpenCart 4.x, 3.x и 2.3 создаёт счета в британской бухгалтерской программе FreeAgent прямо из заказов магазина через API v2: кнопка на странице заказа сохраняет покупателя как контакт FreeAgent и передаёт строки с ценами без НДС и ставкой британского НДС, а итог счёта должен совпасть с суммой заказа, иначе ничего не уходит.
Что нужно. Аккаунт FreeAgent и собственное OAuth-приложение магазина: его создают бесплатно в dev.freeagent.com и вписывают в него адрес Redirect URI из настроек модуля (шаги ниже). Тарифы FreeAgent оплачиваются отдельно.
Что получает продавец
На странице заказа появляется блок «FreeAgent invoice»: поле НДС-номера покупателя-бизнеса, строка покупателя с адресом, примечание о сроке оплаты и о том, будет ли счёт черновиком, таблица строк (Item, Qty, Unit price (net), VAT, Net) с доставкой и купонами, итог и кнопка «Create the invoice in FreeAgent».
После отправки в блоке видны каждый документ (счёт, кредит-нота), его номер, сумма, статус (draft, open, paid, refunded) и кнопки «PDF», «Refresh status», «Mark as sent» и «E-mail» (Pro). Счёт не создаётся дважды: шесть одновременных нажатий дают одну строку и один счёт. Если FreeAgent зависает, кнопка за 8–9 секунд отвечает «FreeAgent did not answer. The module will try again.», а перед повтором модуль ищет счёт покупателя по PO reference, так что дубль не появляется.
Номер заказа идёт в счёт как PO reference, НДС-номер покупателя-бизнеса — в контакт и на счёт. Поле НДС-номера на чекауте создаётся кнопкой на вкладке «Invoice»; пустое поле не мешает оформлению.
Что в админке
Extensions → Extensions → Modules → FreeAgent Accounting: вкладки «Connection», «Invoice», «Automation», «Accounts» и «Pro». На первой — переключатель модуля, инструкция с адресом Redirect URI вашего магазина, поля OAuth identifier и OAuth secret, кнопки «Connect to FreeAgent», «Check the connection», «Connect again» и «Disconnect», категории дохода для товаров и для доставки и сборов. Секрет хранится зашифрованным и больше не показывается, токены доступа обновляются сами.
На вкладке «Invoice»: счета создаются черновиками (вы смотрите их и отправляете в FreeAgent сами) или сразу «marked as sent»; дата счёта (день создания или день заказа); коды способов оплаты, которые оплачиваются позже (остальные считаются оплаченными на чекауте, и счёт имеет срок «due on receipt»); срок оплаты в днях; язык счёта; поле НДС-номера; комментарий под номером заказа внизу счёта.
Вкладки «Automation» и «Accounts» без ключа открываются с пояснением и отключёнными полями, сохранённые Pro-значения не показываются.
Pro создаёт счёт сам, когда заказ достигает выбранного статуса: один раз для заказа, в фоне после ответа покупателю, никогда во время чекаута. Оплаты записываются в FreeAgent на выбранный банковский счёт: для заказов, оплаченных на чекауте, сразу, для остальных (перевод, наложенный платёж) по статусу; иностранная валюта — по курсу счёта. Кредит-нота по статусу вроде Refunded или кнопкой — зеркало строк счёта: она зачитывается в долг по счёту, а для оплаченного счёта возврат денег записывается на банковский счёт (Credit Note Refund).
Письмо от FreeAgent уходит покупателю с шаблоном письма вашего аккаунта, а когда шаблона нет — с коротким текстом модуля с верифицированного адреса отправителя. Оплаты, внесённые в FreeAgent, появляются в магазине: модуль по кругу читает по 5 неоплаченных счетов раз в 15 минут, самые старые первыми, и добавляет строку в историю заказа. Журнал в меню Sales («FreeAgent invoices») показывает каждый документ с фильтрами по периоду, аккаунту и статусу, итогами периода, экспортом CSV, массовым выставлением счетов и кнопкой «Retry all stopped». До трёх дополнительных аккаунтов FreeAgent: магазины, отмеченные в слоте, работают с аккаунтом этого слота через то же приложение.
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите модуль в Extensions → Modules.
- В dev.freeagent.com создайте бесплатный аккаунт и нажмите «Create New App»: название любое.
- В поле «OAuth Redirect URIs» приложения вставьте адрес «OAuth Redirect URI of this shop» с вкладки «Connection» модуля.
- Скопируйте OAuth identifier и OAuth secret приложения в модуль, нажмите «Save», затем «Connect to FreeAgent», войдите в FreeAgent и разрешите доступ. Модуль покажет название компании, валюту книг и ставки НДС аккаунта.
- На вкладке «Invoice» выберите черновики или «marked as sent», способы оплаты, которые оплачиваются позже, и при необходимости создайте поле НДС-номера.
- Откройте заказ, просмотрите строки и сумму и нажмите «Create the invoice in FreeAgent».
- Для Pro: ключ или пробный период на вкладке «Pro», дальше статусы, оплаты и кредит-ноты на вкладке «Automation».
Что под капотом
- FreeAgent API v2: OAuth 2.0 (authorization code и refresh token), contacts, invoices, credit notes, bank accounts, bank transaction explanations, categories, company, email addresses; секрет и токены хранятся зашифрованными (AES-256).
- Строки счёта идут с ценами без НДС и ставкой; купоны — строками скидки по ставкам, подарочный сертификат — строкой 0%, копейки НДС-цен — строкой Rounding; итог сравнивается с заказом до вызова.
- Таймаут: бюджет 9 секунд на документ; на чекауте модуль FreeAgent не вызывает, работа по статусам идёт после ответа покупателю.
- Фоновая работа (счета по статусу, оплаты, опрос оплат) идёт по расписанию OpenCart и с открытий страниц; серверный cron по адресу с вкладки «Automation» раз в 5 минут делает её надёжнее.
Как установить
- Extensions → Installer: загрузите архив для вашей версии, не переименовывая файл (OpenCart 4 — cc_freeagent.ocmod.zip, 3.x — cc_freeagent-oc3.ocmod.zip, 2.3 — cc_freeagent-oc23.ocmod.zip; для 2.3 содержимое папки upload/ копируется в корень магазина).
- Для 3.x и 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → FreeAgent Accounting: установите и откройте настройки.
- Создайте приложение в dev.freeagent.com, вставьте в него адрес Redirect URI с вкладки «Connection», а ключи приложения — в модуль, и нажмите «Connect to FreeAgent».
- Для Pro: введите ключ или запустите пробный период на вкладке «Pro».
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль FreeAgent?
Нет, это независимая интеграция с FreeAgent от CatCode. FreeAgent — торговая марка её владельца.
Что нужно, чтобы начать?
Аккаунт FreeAgent и собственное OAuth-приложение в dev.freeagent.com (бесплатно): в него вписывается адрес Redirect URI из настроек модуля, а его identifier и secret — в модуль.
Почему приложение создаётся самому?
Каждый магазин подключается собственным приложением FreeAgent: ключи и токены доступа лежат только в вашем магазине. Пошаговая инструкция есть в настройках модуля.
Как считается НДС?
Ставка берётся из заказа и сверяется со ставками аккаунта FreeAgent. Ставка, которой в аккаунте нет, останавливает отправку с пояснением. Для аккаунта без НДС счёт идёт ценами без ставок.
Что, если FreeAgent не ответил?
Кнопка за 8–9 секунд отвечает, что FreeAgent не ответил. Перед повтором модуль ищет счёт покупателя по PO reference, поэтому второй счёт не создаётся (если PO reference в FreeAgent не меняли вручную).
Есть ли кредит-ноты и возвраты?
Да, в Pro: кредит-нота по статусу или кнопкой зачитывается в долг по счёту, а для оплаченного счёта возврат записывается на банковский счёт FreeAgent.
Появляется ли в магазине оплата, внесённая в FreeAgent?
Да, в Pro: модуль по кругу читает по 5 неоплаченных счетов раз в 15 минут и добавляет строку в историю заказа.
Можно ли несколько аккаунтов FreeAgent?
Да, в Pro до трёх дополнительных аккаунтов по магазинам. Без Pro заказ такого магазина не идёт в основной аккаунт, а останавливается с пояснением.
Какие версии OpenCart?
OpenCart 4.0.2.x–4.1.x, 3.0.x и 2.3.0.2: три отдельных архива в одном товаре.
Лицензия навсегда?
Да, для OpenCart одна оплата и лицензия навсегда, на два сайта.
Что будет после пробного периода?
Pro выключится, счёт по статусу, оплата или кредит-нота в очереди остановятся с причиной, а бесплатная часть продолжит работать.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















