
KolayBi Invoices для OpenCart — счета из заказов, TCKN/VKN, KDV, e-Arşiv (Турция)
KolayBi Invoices для OpenCart 4.x, 3.x, 2.3 (Турция): счёт из заказа одной кнопкой; Pro добавляет автоматику по статусу, e-Arşiv / e-Fatura, оплату, журнал. Лицензия навсегда.
- Совместимость
- 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
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получает продавец
Менеджер открывает заказ, видит блок «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 это делает встроенный планировщик, раз в час.
История версий
Для OpenCart 4.x, 3.x и 2.3: счета из заказов в KolayBi, превью строк, cari и товары создаются сами, TCKN/VKN и налоговая вручную, KDV 0/1/8/10/18/20, купон, доставка, internet sale, другие…
Вместе с KolayBi Invoices покупают


Geliver Shipping для OpenCart 2.3, 3.x и 4.x — цены турецких перевозчиков и этикетки

Скидки от суммы и N+1 для OpenCart

Trendyol Connector для OpenCart 3.x и 4.x — цены, остатки и заказы Trendyol в вашем магазине
Полное описание модуля
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».
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите модуль в разделе «Modules».
- В KolayBi создайте ключ API и канал API, вставьте их на вкладке «Connection», выберите среду и нажмите «Save and check the connection».
- На вкладке «Buyer» нажмите «Create the fields», на вкладке «Invoice» задайте режим KDV, код товара и тип оплаты.
- Откройте заказ, проверьте строки и суммы в превью и нажмите «Create the invoice in KolayBi».
- При необходимости впишите TCKN/VKN и налоговую в заказе вручную и сохраните для заказа.
- В Pro включите счёт по статусу, e-Arşiv / e-Fatura, отметку оплаты и отмену.
- Следите за состоянием в заказе и в журнале; PDF электронного документа открывается кнопкой.
Что под капотом
- KolayBi REST API v1: токен на 24 часа по ключу и каналу (кешируется 23 часа, при 401 берётся новый один раз), клиенты (associates) и адреса, товары, счета, электронные документы (создание, отмена, PDF), оплата (proceed), кассы и банки.
- Ключ хранится зашифрованным и в настройках не показывается, в журнале модуля ключей нет.
- Создание счёта не блокирует оформление заказа: когда KolayBi медленный или недоступен, кнопка в админке отвечает за 8–9 секунд понятным текстом, а задание повторяется.
- Ошибки 400, 401, 429 и 5xx показываются рядом с заказом человеческим языком без служебных кодов; 429 соблюдает время ожидания.
- Параллельные клики и параллельные проходы крона дают один счёт.
- После окончания пробного периода Pro-задания в очереди не отправляются и помечаются как отключённые; бесплатный ручной счёт работает.
- Интерфейс на английском и турецком.
Установка
- OpenCart 4: Extensions → Installer, загрузите cc_kolaybi.ocmod.zip, не переименовывая его.
- OpenCart 3.x: Extensions → Installer, загрузите cc_kolaybi-oc3.ocmod.zip, затем Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, загрузите cc_kolaybi-oc23.ocmod.zip (нужны настройки FTP в System → Settings → FTP; иначе распакуйте архив и залейте содержимое папки upload/ в корень магазина вручную), затем Extensions → Modifications → Refresh.
- Extensions → Modules → KolayBi Invoices: установите и откройте настройки.
- Вставьте ключ API и канал, нажмите «Save and check the connection».
- Для Pro: вставьте ключ лицензии или запустите пробный период на вкладке «Pro».
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль 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, счёт, который ещё не электронный документ, удаляется.
Работает ли бесплатная версия без 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-задания в очереди останавливаются с причиной, бесплатная часть работает дальше.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















