
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. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















