Чорний листопад: −35% на всі модулі до 30 листопада Чорний листопад: −35% до 30 листопада Обрати модуль

Зв'язатись
OpenCart

KolayBi Invoices для OpenCart — рахунки із замовлень, TCKN/VKN, KDV, e-Arşiv (Туреччина)

KolayBi Invoices для OpenCart 4.x, 3.x, 2.3 (Туреччина): рахунок із замовлення однією кнопкою; Pro додає автоматику за статусом, e-Arşiv / e-Fatura, оплату, журнал. Ліцензія назавжди.

Pro · ліцензія назавжди Тестові копії сайтів у ціні. Чим більше сайтів, тим дешевше кожен
Сумісність
OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · мови модуля: English, Türkçe
PHP
7.0 і новіший
Версія
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Ліцензія
сайт + тестова копія, назавжди
Тріал
7 днів, без картки, один на сайт
Оновлено
15.11.2026
Або всі 509 Pro-модулів з All Access — 3 244 грн / рік

Що є в Free,
а що дає Pro

Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.

Функція Free Pro
Підключення KolayBi за ключем API і каналом, перевірка фірми й кас ✔ ✔
Тестове й бойове середовище ✔ ✔
Ручне створення рахунку із замовлення з превʼю рядків і сум ✔ ✔
Клієнт (cari) і товари створюються й знаходяться автоматично ✔ ✔
TCKN/VKN і податкова в замовленні вручну ✔ ✔
KDV 0/1/8/10/18/20, купон у ціні рядка, доставка рядком ✔ ✔
Internet sale: сайт, тип оплати, дата ✔ ✔
Інші валюти за курсом магазину ✔ ✔
PDF e-документа, повтор і видалення рахунку ✔ ✔
Захист від дубля рахунку ✔ ✔
Рахунок за статусом замовлення — ✔
e-Arşiv / e-Fatura в GİB автоматично або кнопкою — ✔
Відмітка оплати (tahsilat) у касу чи банк — ✔
Скасування за статусом повернення — ✔
Поля TCKN/VKN і податкової на касі з перевіркою — ✔
Синхронізація товарів і залишків — ✔
KDV за податковим класом — ✔
Журнал з фільтрами, підсумками й CSV — ✔
Масове створення рахунків і повтор усіх зупинених — ✔

Як це виглядає

Блок KolayBi в замовленні
Сторінка замовлення: TCKN/VKN і податкова, дані покупця, таблиця рядків з KDV, підсумок і кнопка «Create the invoice in KolayBi».
Рахунок і скасування в замовленні
Блок KolayBi в замовленні: рахунок із номером і сумою та скасування зі статусом.
Журнал рахунків (Pro)
Журнал: фільтри, підсумки за період, CSV, «Retry all stopped», таблиця рахунків і скасувань зі статусами.

Головне про модуль

Що отримує продавець

Менеджер відкриває замовлення, бачить блок «KolayBi» з полями TCKN/VKN і податкової, даними покупця й адресою, таблицею рядків (назва, кількість, ціна без KDV, ставка, сума), підсумком «Total with KDV» і кнопкою «Create the invoice in KolayBi».

Що в адмінці

Extensions → Extensions → Modules → KolayBi Invoices: вкладки «Connection», «Buyer», «Invoice», «Automation (Pro)», «Pro».

Тріал стартує, коли ви попросите

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

Один ключ — сайт і тестова копія

Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.

Технічні вимоги

  • OpenCart 4.0.2.0–4.1.x, 3.0.x або 2.3.0.2; PHP 7.0+ для 2.3, розширення cURL.
  • Акаунт KolayBi з ключем API і каналом API (Ayarlar → Profil Hesabı); тестове й бойове середовища мають окремі ключі та фірми.
  • Для e-Arşiv / e-Fatura (Pro) у компанії KolayBi має бути активна інтеграція e-fatura, для бойових документів — турецька фірма.
  • e-Fatura через API не скасовується: модуль зупиняється з поясненням, що потрібен зворотний рахунок (iade faturası) у KolayBi.
  • Подарункові сертифікати й фіксовані податки OpenCart не підтримуються, ставка KDV поза 0/1/8/10/18/20 зупиняє замовлення з причиною.
  • Для OpenCart 3.x і 2.3 регулярні задачі виконуються при відкритті сторінок; серверний cron на адресу з налаштувань кожні 5 хвилин робить це надійніше. В OpenCart 4 це робить вбудований планувальник, раз на годину.

Історія версій

v1.0.0 Поточна 15.11.2026

Для OpenCart 4.x, 3.x і 2.3: рахунки з замовлень у KolayBi, превʼю рядків, cari і товари створюються самі, TCKN/VKN і податкова вручну, KDV 0/1/8/10/18/20, купон, доставка, internet sale…

Разом з KolayBi Invoices купують

All Access Потрібно більше? Усі модулі (509) однією ліцензією, нові додаються самі. 3 244 грн Детальніше →

Повний опис модуля

KolayBi Invoices для OpenCart 4.x, 3.x і 2.3 створює рахунки в KolayBi (ön muhasebe) прямо із замовлень магазину: на сторінці замовлення модуль показує рядки з сумами й KDV, а після натискання «Create the invoice in KolayBi» клієнт, товари й рахунок зʼявляються в обліку. Модуль працює з API KolayBi за ключем API і назвою каналу, у тестовому або бойовому середовищі.

Що отримує продавець

Менеджер відкриває замовлення, бачить блок «KolayBi» з полями TCKN/VKN і податкової, даними покупця й адресою, таблицею рядків (назва, кількість, ціна без KDV, ставка, сума), підсумком «Total with KDV» і кнопкою «Create the invoice in KolayBi». Після натискання покупець створюється в KolayBi як cari (або береться наявний із тими самими ім’ям, номером, email і податковою), а рахунок отримує номер.

Товари рахунку шукаються в KolayBi за Model або SKU й створюються, якщо їх там немає. Купон потрапляє в ціну рядка, доставка й збори йдуть окремими рядками як послуги, ставка KDV кожного рядка береться з податку OpenCart. Для іншої валюти модуль передає курс магазину. Адреса покупця переноситься з областю й районом, для покупців з-за кордону — з номером будинку.

Перед створенням модуль перевіряє, що сума рахунку збігається з сумою замовлення, і пише примітку в замовлення при розбіжності. Якщо відповідь KolayBi загубилась, модуль шукає рахунок за посиланням на замовлення в описі й не створює другий. Повторне натискання кнопки каже «вже створено».

Що в адмінці

Extensions → Extensions → Modules → KolayBi Invoices: вкладки «Connection», «Buyer», «Invoice», «Automation (Pro)», «Pro». У KolayBi відкрийте Ayarlar → Profil Hesabı, створіть ключ API та канал API, вставте ключ і назву каналу, оберіть середовище (тестове й бойове мають окремі ключі й фірми) і натисніть «Save and check the connection»: модуль покаже назву фірми, VKN/TCKN, валюту, чи ввімкнена інтеграція e-fatura, і кількість кас та банків. Ключ зберігається зашифрованим і більше не показується.

Вкладка «Buyer» задає поля покупця: кнопка «Create the fields» створює «TR ID / tax number» і «Tax office» для кожної групи клієнтів (акаунт і каса), перевірка контрольних цифр TCKN на касі, номер для покупців без номера (11111111111) і для покупців з-за кордону. Вкладка «Invoice» — режим KDV (з замовлення, ціни з KDV або без KDV), код товару (Model чи SKU), створення відсутніх товарів, коди способів оплати для «оплата пізніше», дані internet sale, відповідність типів оплати, термін оплати, текст на кожному рахунку.

Тексти модуля мовою адмінки — англійською або турецькою. Суми показуються у форматі магазину.

У Pro вкладка «Automation (Pro)» відкриває видачу рахунку за вибраними статусами, e-Arşiv / e-Fatura в GİB одразу після рахунку (сценарії для людей і для фірм, префікс серії, email покупця як отримувач), відмітку оплати (tahsilat) у вибрану касу чи банк за статусом або при онлайн-оплаті, скасування за статусом повернення, KDV за податковим класом і синхронізацію товарів та залишків порціями по 15 товарів кожні 10 хвилин. Журнал у меню Sales має фільтри «Waiting», «Stopped», «Invoices», «e-Documents», «Cancellations», «Orders without an invoice», підсумки за період, CSV, масове створення рахунків і «Retry all stopped».

Як це працює, крок за кроком

  1. Встановіть архів для вашої версії OpenCart і встановіть модуль у розділі «Modules».
  2. У KolayBi створіть ключ API й канал API, вставте їх на вкладці «Connection», оберіть середовище й натисніть «Save and check the connection».
  3. На вкладці «Buyer» натисніть «Create the fields», на вкладці «Invoice» задайте режим KDV, код товару й тип оплати.
  4. Відкрийте замовлення, перевірте рядки й суми в превʼю й натисніть «Create the invoice in KolayBi».
  5. За потреби впишіть TCKN/VKN і податкову в замовленні вручну й збережіть для замовлення.
  6. У Pro увімкніть рахунок за статусом, e-Arşiv / e-Fatura, відмітку оплати й скасування.
  7. Стежте за станом у замовленні й у журналі; PDF e-документа відкривається кнопкою.

Що під капотом

  • KolayBi REST API v1: токен на 24 години за ключем і каналом (кешується 23 години, при 401 береться новий один раз), клієнти (associates) і адреси, товари, рахунки, e-документи (створення, скасування, PDF), оплата (proceed), каси й банки.
  • Ключ зберігається зашифрованим і в налаштуваннях не показується, у журналі модуля ключів немає.
  • Створення рахунку не блокує оформлення замовлення: коли KolayBi повільний чи недоступний, кнопка в адмінці відповідає за 8–9 секунд зрозумілим текстом, а завдання повторюється.
  • Помилки 400, 401, 429 і 5xx показуються поруч із замовленням людською мовою без службових кодів; 429 дотримується часу очікування.
  • Паралельні кліки й паралельні проходи крону дають один рахунок.
  • Після закінчення пробного періоду Pro-завдання в черзі не відправляються й позначаються як вимкнені; безкоштовний ручний рахунок працює.
  • Інтерфейс англійською й турецькою.

Встановлення

  1. OpenCart 4: Extensions → Installer, завантажте cc_kolaybi.ocmod.zip, не перейменовуючи його.
  2. OpenCart 3.x: Extensions → Installer, завантажте cc_kolaybi-oc3.ocmod.zip, потім Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, завантажте cc_kolaybi-oc23.ocmod.zip (потрібні налаштування FTP у System → Settings → FTP; інакше розпакуйте архів і залийте вміст теки upload/ у корінь магазину вручну), потім Extensions → Modifications → Refresh.
  4. Extensions → Modules → KolayBi Invoices: встановіть і відкрийте налаштування.
  5. Вставте ключ API і канал, натисніть «Save and check the connection».
  6. Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Pro».

Питання
про модуль

Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.

@catcode_support Налаштування, сумісність, активація
Це офіційний модуль KolayBi?

Ні, це незалежна інтеграція через публічний API. KolayBi є торговою маркою свого власника.

Де взяти ключ API і канал?

У KolayBi: Ayarlar → Profil Hesabı. Ключ створюється в розділі API-ключів, а канал у розділі API-каналів. Тестове й бойове середовища мають окремі акаунти й ключі.

Чи потрібна інтеграція e-fatura?

Для звичайних рахунків ні. e-Arşiv і e-Fatura в GİB (Pro) потребують, щоб у компанії KolayBi була активна інтеграція e-fatura; вкладка «Connection» показує, чи вона ввімкнена.

Що з покупцями, які не вказали податковий номер?

Рахунок виписується на номер за замовчуванням з вкладки «Buyer» (11111111111). Значення можна змінити, узгодьте його з бухгалтером. TCKN/VKN можна вписати в замовленні вручну, а в Pro покупець вводить його на касі.

Чи можна скасувати e-Fatura?

Через API ні: модуль зупиняється з поясненням, що потрібен зворотний рахунок (iade faturası) у KolayBi. e-Arşiv скасовується в GİB, рахунок, який ще не e-документ, видаляється.

Чи працює безкоштовна версія без Pro?

Так: підключення, ручне створення рахунку з превʼю, автоматичний cari і товари, PDF, повтор і видалення працюють у безкоштовній версії. Рахунок за статусом, e-Arşiv / e-Fatura, оплата, скасування, синхронізація, KDV за класом і журнал у Pro.

Які версії OpenCart підтримуються?

OpenCart 4.0.2.0–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному продукті.

Ліцензія назавжди?

Так, для OpenCart це одна оплата і ліцензія назавжди, на два сайти.

Що буде після пробного періоду?

Pro вимикається, Pro-завдання в черзі зупиняються з причиною, безкоштовна частина працює далі.

Не той варіант, що шукаєте?

Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.

Замовити кастомний модуль