Чёрный ноябрь: −35% на все модули до 30 ноября Чёрный ноябрь: −35% до 30 ноября Выбрать модуль

Связаться
OpenCart

Nilvera e-Fatura и e-Arşiv для OpenCart — счета из заказов, VKN/TCKN, KDV (Турция)

Nilvera e-Fatura и e-Arşiv для OpenCart 4.x, 3.x, 2.3 (Турция): счёт из заказа одной кнопкой; Pro добавляет автовыдачу, e-Fatura, поля VKN/TCKN на кассе, журнал. Лицензия навсегда.

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 грн / год ≈ 66 €

Что есть во Free,
а что даёт Pro

Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.

Функция Free Pro
Подключение Nilvera по ключу API, проверка фирмы, VKN и серий ✔ ✔
Тестовая и боевая среда ✔ ✔
Выбор серии e-Arşiv ✔ ✔
Ручное создание e-Arşiv из заказа с превью строк и сумм ✔ ✔
VKN/TCKN и налоговая в заказе вручную, проверка контрольных цифр ✔ ✔
KDV 0/1/8/10/18/20, купон в цене строки, 0% как İSTİSNA с кодом льготы ✔ ✔
Internet sale: сайт, способ оплаты, перевозчик ✔ ✔
Другие валюты по курсу магазина ✔ ✔
PDF и проверка статуса GİB ✔ ✔
ETTN до отправки: без дублей счёта ✔ ✔
Аккаунты и серии Nilvera 1 до 3 по магазинам
Автовыдача счёта по статусу заказа — ✔
e-Fatura автоматически для плательщиков из реестра — ✔
Поля VKN/TCKN и налоговой на кассе с проверкой — ✔
Отмена e-Arşiv вручную и по статусу — ✔
Письмо покупателю от Nilvera — ✔
Статус GİB в фоне — ✔
Журнал с фильтрами, итогами и CSV — ✔
Массовое создание счетов — ✔

Как это выглядит

Подключение Nilvera
Вкладка «Connection»: среда, ключ API, проверка соединения с названием фирмы, VKN и сериями, выбор серии e-Arşiv.
Настройки счёта
Вкладка «Invoice»: KDV, код льготы, канал продаж, способ оплаты, перевозчик, единица, код товара, примечание.
Блок Nilvera в заказе
Страница заказа: VKN/TCKN и налоговая, таблица строк с KDV, итог и кнопка «Create the invoice».

Главное о модуле

Что получает продавец

Менеджер открывает заказ, видит блок «Nilvera e-Arşiv / e-Fatura» с таблицей строк (название, количество, цена без KDV, ставка, сумма), итогом «без KDV / KDV / всего» и нажимает «Create the invoice».

Что в админке

Extensions → Extensions → Modules → Nilvera e-Fatura and e-Arşiv: вкладки «Connection», «Buyer», «Invoice», «Automation and e-Fatura», «Series and accounts», «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.
  • Договор с Nilvera и аккаунт с ключом API («API Tanımları» → «Yeni Anahtar»); у тестовой и боевой среды отдельные ключи и фирмы.
  • Кредиты (kontör) или пакет на аккаунте Nilvera: без них Nilvera отклоняет счёт, модуль показывает причину и даёт кнопку «Retry».
  • Адрес покупателя (адрес, район, город) в заказе: Nilvera требует его на счёте.
  • Серия e-Arşiv, а для Pro-автоматики e-Fatura ещё и серия e-Fatura, созданные в портале Nilvera.
  • e-Fatura через API не отменяется: покупатель отклоняет TİCARİ-счёт или выписывается возвратный счёт. Это делается в портале Nilvera, модуль объясняет это в заказе.
  • Выставленный в GİB счёт изменить нельзя, e-Arşiv можно только отменить.
  • Для OpenCart 3.x и 2.3 регулярные задачи (повтор, статусы GİB) выполняются при открытии страниц; серверный cron на адрес из настроек каждые 5 минут делает это надёжнее. В OpenCart 4 это делает встроенный планировщик, раз в час.

История версий

v1.0.0 Текущая 15.11.2026

Для OpenCart 4.x, 3.x и 2.3: e-Arşiv из заказов через Nilvera, превью строк, VKN/TCKN и налоговая вручную, KDV 0/1/8/10/18/20, İSTİSNA, данные internet sale, другие валюты, ETTN до…

Вместе с Nilvera e-Fatura и e-Arşiv покупают

All Access Нужно больше? Все модули (509) одной лицензией, новые добавляются сами. 3 244 грн≈ 66 € Подробнее →

Полное описание модуля

Nilvera e-Fatura and e-Arşiv для OpenCart 4.x, 3.x и 2.3 создаёт электронные счета в Nilvera прямо из заказов магазина: кнопка на странице заказа показывает строки с суммами и KDV, а после нажатия Nilvera выдаёт e-Arşiv fatura и передаёт её в GİB. Модуль работает с API Nilvera по ключу из портала, в тестовой или боевой среде.

Что получает продавец

Менеджер открывает заказ, видит блок «Nilvera e-Arşiv / e-Fatura» с таблицей строк (название, количество, цена без KDV, ставка, сумма), итогом «без KDV / KDV / всего» и нажимает «Create the invoice». Счёт получает номер серии, в заказе появляются PDF и статус в Nilvera и GİB, а в истории заказа — заметка.

Покупателю, не указавшему налоговый номер, счёт выписывается на номер по умолчанию (11111111111, его можно изменить на вкладке «Buyer»). VKN или TCKN с налоговой можно вписать в заказе вручную, модуль проверяет контрольные цифры. Купон попадает в цену строки, доставка идёт отдельной строкой с остатком налога, строки с 0% KDV выходят как İSTİSNA с кодом льготы, другие валюты считаются по курсу магазина.

Каждый счёт получает ETTN ещё до отправки. Если ответ Nilvera потерялся, модуль ищет документ по ETTN, а Nilvera не принимает второй документ с тем же ETTN, поэтому двойного счёта не будет. Повторное нажатие кнопки отвечает «уже создан».

Что в админке

Extensions → Extensions → Modules → Nilvera e-Fatura and e-Arşiv: вкладки «Connection», «Buyer», «Invoice», «Automation and e-Fatura», «Series and accounts», «Pro». В портале Nilvera откройте «API Tanımları», нажмите «Yeni Anahtar» и вставьте ключ; выберите среду (у тестовой и боевой отдельные ключи и фирмы) и нажмите «Save and check the connection»: модуль покажет название фирмы, VKN и число серий e-Arşiv и e-Fatura. Ключ хранится зашифрованным и больше не показывается.

На вкладке «Invoice» задаются KDV (по налогам OpenCart или фиксированная ставка), код льготы для 0%, канал продаж (İNTERNET), способ оплаты (карта, EFT/HAVALE, KAPIDAODEME, посредник) с соответствием для ваших платёжных расширений, перевозчик и его VKN, единица (C62), код товара (Model или SKU) и примечание на счёте. Данные «internet sale» (сайт, оплата, перевозчик) попадают в e-Arşiv.

Заметки на счёте и тексты модуля идут на языке заказа, интерфейс админки доступен на английском и турецком. Суммы показываются в формате магазина.

В Pro вкладка «Automation and e-Fatura» открывает выдачу счёта при выбранных статусах, отдельный список статусов для отмены e-Arşiv, e-Fatura для плательщиков из реестра (серия e-Fatura и сценарий TEMELFATURA или TİCARİFATURA), письмо покупателю от Nilvera. Вкладка «Buyer» добавляет поля «VKN/TCKN» и «Tax office» на кассе, кнопку «Create the fields» и проверку контрольных цифр. Журнал открывается в меню Sales с фильтрами «In progress», «Stopped or with an error», «e-Fatura», «Cancellations», «Orders without an invoice», итогами за период и CSV; здесь же массовое создание счетов для отмеченных заказов.

Вкладка «Series and accounts» (Pro) позволяет до трёх отдельных серий или аккаунтов Nilvera для разных магазинов мультимагазина.

Как это работает, шаг за шагом

  1. Установите архив для вашей версии OpenCart и установите модуль в разделе «Modules».
  2. В портале Nilvera создайте ключ («API Tanımları» → «Yeni Anahtar»), вставьте его на вкладке «Connection», выберите среду и нажмите «Save and check the connection».
  3. Выберите серию e-Arşiv, на вкладке «Invoice» задайте KDV, способ оплаты, перевозчика и единицу.
  4. Откройте заказ, проверьте строки и суммы в превью и нажмите «Create the invoice»: счёт уйдёт в Nilvera, в заказе появится номер, PDF и статус.
  5. При необходимости укажите VKN/TCKN и налоговую в заказе вручную.
  6. В Pro включите автоматическую выдачу по статусу, e-Fatura для плательщиков из реестра, поля на кассе и письмо покупателю.
  7. Следите за статусами в заказе и в журнале; PDF и «Check the status» доступны кнопками.

Что под капотом

  • Nilvera REST API: Genel (данные фирмы, проверка плательщика e-Fatura по VKN/TCKN), e-Arşiv (отправка, серии, детали, статус, PDF, отмена) и e-Fatura (отправка с alias получателя, статус, PDF, письмо покупателю).
  • Авторизация Bearer-ключом, ключ зашифрован и в настройках не показывается.
  • Создание счёта не блокирует оформление заказа: когда Nilvera медленная или недоступна, счёт ставится в очередь и повторяется, а кнопка в админке отвечает за 8–9 секунд понятным текстом.
  • Ответы 401, 403, 422, 429, 502 и 503 показываются рядом с заказом человеческим языком (нет кредитов, ошибка ключа, не хватает адреса); 429 соблюдает Retry-After.
  • Параллельные клики и параллельные проходы крона дают один счёт и одну запись в истории.
  • Статусы GİB подтягиваются в фоне по курсору, по 5 документов за проход, самые старые первыми.
  • После окончания пробного периода Pro-задачи в очереди не отправляются и помечаются «Pro is off»; бесплатный ручной e-Arşiv работает.
  • Интерфейс на английском и турецком.

Установка

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

Вопросы
о модуле

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

@catcode_support Настройка, совместимость, активация
Это официальный модуль Nilvera?

Нет, это независимая интеграция через публичный API. Nilvera является торговой маркой своего владельца.

Где взять ключ API?

В портале Nilvera откройте «API Tanımları», нажмите «Yeni Anahtar» и скопируйте ключ: он показывается один раз. У тестовой и боевой среды отдельные ключи.

Кто платит за счета?

Документы оплачиваются по вашему договору с Nilvera, из кредитов (kontör) аккаунта. Модуль не добавляет плату за счёт.

Можно ли изменить выставленный счёт?

Нет: счёт уходит в GİB и не редактируется. e-Arşiv можно отменить из заказа (Pro, вручную или по статусу), e-Fatura через API не отменяется, это делается в портале Nilvera.

Что с покупателями, не указавшими налоговый номер?

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

Как работает e-Fatura?

В Pro модуль проверяет VKN или TCKN покупателя в реестре плательщиков e-Fatura. Плательщикам идёт e-Fatura (TEMELFATURA или TİCARİFATURA, серия e-Fatura), остальным e-Arşiv. Без Pro для плательщика e-Fatura заказ останавливается с пояснением: счёт нужно выдать в портале Nilvera.

Работает ли бесплатная версия без Pro?

Да: подключение, выбор серии, ручное создание e-Arşiv с превью, PDF и проверка статуса работают в бесплатной версии. Автовыдача, e-Fatura, поля на кассе, отмена, письмо покупателю, журнал, массовое создание и несколько серий в Pro.

Какие версии OpenCart поддерживаются?

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

Лицензия навсегда?

Да, для OpenCart это одна оплата и лицензия навсегда, на два сайта.

Что будет после пробного периода?

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

Не тот вариант, что искали?

Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.

Заказать кастомный модуль