
Nilvera e-Fatura і e-Arşiv для WooCommerce — рахунки із замовлень, VKN/TCKN, KDV (Туреччина)
Nilvera e-Fatura і e-Arşiv для WooCommerce (Туреччина): рахунок із замовлення однією кнопкою; Pro додає автовидачу, e-Fatura, поля VKN/TCKN на чекауті, скасування й журнал.
- Сумісність
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, блокова каса) · PHP 7.4+ · акаунт Nilvera з e-Arşiv · валюта TRY · інтерфейс: English (Türkçe у Pro)
- Ліцензія
- сайт + тестова копія, річна
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 16.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує продавець
Менеджер відкриває замовлення й бачить блок «Nilvera e-Arşiv / e-Fatura»: таблицю рядків (назва, кількість, ціна без KDV, ставка, сума) і підсумок «без KDV / KDV / разом».
Підключення
У WooCommerce → Nilvera invoices оберіть середовище, вставте ключ і натисніть «Save and check the connection»: модуль покаже назву фірми, VKN і кількість серій e-Arşiv та e-Fatura.
Що додає Pro
Автовидача. Рахунок створюється у фоні, коли замовлення досягає обраних статусів, один раз на замовлення.

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
WordPress 6.4+, WooCommerce 8.6+ (HPOS і блокова каса підтримуються), PHP 7.4+.
Договір з Nilvera й акаунт з e-Arşiv та ключем API; кредити (kontör) на акаунті.
Серія e-Arşiv у порталі Nilvera, для автоматичної e-Fatura в Pro ще й серія e-Fatura.
Валюта магазину TRY; замовлення в іншій валюті виписуються за курсом із замовлення.
Історія версій
E-Arşiv із замовлень через Nilvera, превʼю рядків, VKN/TCKN і податкова вручну, KDV 0/1/8/10/18/20, İSTİSNA, дані internet sale, інші валюти, ETTN до відправлення, PDF і статус GİB, HPOS…
Разом з Nilvera e-Fatura і e-Arşiv купують


Кинуті кошики для WooCommerce

Trendyol Connector для WooCommerce — ціни, залишки й замовлення Trendyol у вашому магазині

Invoices with Paraşüt для WooCommerce — рахунки, e-Arşiv і e-Fatura із замовлення
Повний опис модуля
Nilvera e-Fatura and e-Arşiv for WooCommerce створює електронні рахунки в Nilvera прямо із замовлень магазину. Блок на сторінці замовлення показує рядки з сумами й KDV, а після натискання кнопки Nilvera видає e-Arşiv fatura і передає її до GİB. Модуль працює з API Nilvera за ключем із вашого порталу, у тестовому або бойовому середовищі Nilvera.
Що потрібно від Nilvera. Договір вашої компанії з Nilvera і акаунт з e-Arşiv. У порталі відкрийте «API Tanımları», натисніть «Yeni Anahtar» і вставте ключ у налаштуваннях модуля. Тестове й бойове середовища мають окремі ключі та фірми.
Що отримує продавець
Менеджер відкриває замовлення й бачить блок «Nilvera e-Arşiv / e-Fatura»: таблицю рядків (назва, кількість, ціна без KDV, ставка, сума) і підсумок «без KDV / KDV / разом». Кожен рядок зберігає ставку податку WooCommerce (0, 1, 10 або 20%), купон уже в ціні рядка, доставка й збори йдуть окремими рядками. Рядки з 0% виходять як İSTİSNA з вашим кодом пільги.
Після кнопки «Create the invoice» рахунок отримує номер серії, у замовленні з’являються PDF, кнопка перевірки статусу в GİB і нотатка в історії замовлення.
Покупцеві без податкового номера рахунок виписується на номер за замовчуванням (11111111111, його можна змінити в налаштуваннях). VKN компанії чи TCKN людини й податкову можна вписати в замовленні вручну: модуль перевіряє контрольні цифри. У дані internet sale потрапляють сайт, спосіб оплати (картка, EFT/havale, готівка при отриманні, платіжні сервіси на кшталт iyzico чи PayTR), дата оплати й перевізник. Замовлення в іншій валюті виписується за курсом, який ви вказали в замовленні.
Кожен рахунок отримує ETTN ще до першого виклику. Якщо відповідь Nilvera загубилась, модуль шукає документ за ETTN, а Nilvera не приймає другий документ з тим самим ETTN, тому подвійного рахунку не буде. Сума рахунку звіряється із сумою замовлення перед відправленням: якщо вони розходяться, рахунок зупиняється з поясненням. Модуль працює з HPOS і блоковим чекаутом.
Підключення
У WooCommerce → Nilvera invoices оберіть середовище, вставте ключ і натисніть «Save and check the connection»: модуль покаже назву фірми, VKN і кількість серій e-Arşiv та e-Fatura. Ключ зберігається зашифрованим і більше не показується. Серія e-Arşiv підставляється сама, коли в порталі вона одна.
Що додає Pro
Автовидача. Рахунок створюється у фоні, коли замовлення досягає обраних статусів, один раз на замовлення. У списку замовлень з’являється масова дія «Create Nilvera invoices».
e-Fatura за реєстром. Модуль перевіряє VKN або TCKN покупця в реєстрі платників e-Fatura: платнику йде e-Fatura (TEMELFATURA або TİCARİFATURA, серія e-Fatura), усім іншим e-Arşiv.
Поля на чекауті. VKN / TCKN і податкова на класичному й блоковому чекауті (необов’язкові, вимкнені за замовчуванням), перевірка контрольних цифр за бажанням. Поля Hezarfen, Paraşüt і довільні meta-ключі читаються теж.
Скасування й лист покупцю. e-Arşiv скасовується кнопкою або за статусами (наприклад Refunded), після скасування можна створити новий рахунок з новим ETTN. Nilvera може сама надсилати рахунок покупцю на e-mail, автоматично або кнопкою.
Статус GİB у фоні. Кожні 15 хвилин модуль питає Nilvera про рахунки, по 5 за прохід, найстаріші першими, і лишає нотатку, коли GİB повідомляє про помилку.
Журнал. Усі документи за період із фільтрами (в роботі, зупинені, e-Fatura, скасовані, замовлення без рахунку), підсумками, експортом у CSV та кнопкою «Retry all stopped».
Обмеження
- Модуль працює лише з вашим акаунтом Nilvera: договір з Nilvera й ключ API видає Nilvera.
- Рахунки оплачуються за вашим договором з Nilvera з кредитів (kontör) акаунта. Коли їх немає, Nilvera відхиляє рахунок: модуль показує причину людською мовою й дає кнопки «Try again» і «Forget it».
- Адреса покупця (вулиця, район, місто) мусить бути в замовленні: Nilvera вимагає її на рахунку.
- Виставлений в GİB рахунок змінити не можна. e-Arşiv можна лише скасувати (Pro, кнопкою або за статусом); e-Fatura через API не скасовується, це робиться в порталі Nilvera.
- Рядки з 0% KDV виходять як İSTİSNA з кодом пільги з налаштувань: без нього замовлення з такими рядками зупиняється. Пропорційний податок доставки WooCommerce ділиться на кілька рядків за ставками.
- Нетипові знижки (від’ємний збір) розподіляються відсотком по товарах; якщо сума рахунку розходиться із сумою замовлення більш ніж на кілька копійок, рахунок зупиняється з поясненням.
- Для замовлення в іншій валюті курс до TRY вписується в блоці замовлення; без нього рахунок зупиняється.
- Серія e-Arşiv, а для автоматичної e-Fatura ще й серія e-Fatura, створюються в порталі Nilvera.
- Коли Nilvera мовчить, кнопка в адмінці відповідає за 9 секунд зрозумілим текстом, а рахунок ставиться в чергу й повторюється у фоні (Pro).
- Автовидача працює через Action Scheduler (входить у WooCommerce). Після деактивації модуля записи в черзі лишаються в стані очікування, їх запускає «Try again» у замовленні.
- Інтерфейс англійською, турецька локалізація входить у Pro-збірку.
Як це працює, крок за кроком
- Встановіть плагін і активуйте його (WooCommerce має бути активним).
- У порталі Nilvera створіть ключ («API Tanımları» → «Yeni Anahtar»), у WooCommerce → Nilvera invoices оберіть середовище, вставте ключ і натисніть «Save and check the connection».
- Оберіть серію e-Arşiv, задайте KDV, спосіб оплати, перевізника й одиницю.
- Відкрийте замовлення, перевірте рядки й суми й натисніть «Create the invoice»: у замовленні з’явиться номер, PDF і статус.
- За потреби впишіть VKN/TCKN і податкову в замовленні вручну.
- У Pro увімкніть автовидачу за статусом, e-Fatura за реєстром, поля на чекауті, скасування, лист покупцю й журнал.
Що під капотом
- Nilvera REST API: Genel (дані фірми, перевірка платника e-Fatura за VKN/TCKN), e-Arşiv (відправлення, серії, деталі, статус, PDF, скасування) і e-Fatura (відправлення з alias отримувача, статус, PDF, лист покупцю). Адреса API залежить від середовища, яке ви обрали; модуль звертається до Nilvera лише після того, як ви зберегли ключ.
- Авторизація Bearer-ключем; ключ зберігається в базі зашифрованим і в HTML не повертається.
- У Nilvera передаються ім’я або назва компанії покупця, VKN чи TCKN, податкова, e-mail, телефон і адреса, рядки замовлення (назва, код товару, кількість, ціна, ставка KDV), валюта й курс, номер і дата замовлення, адреса магазину, спосіб і дата оплати й перевізник.
- Оформлення замовлення покупцем не чекає Nilvera: рахунок створюється з адмінки або у фоні.
- Відповіді 401, 403, 422, 429, 502 і 503 показуються поруч із замовленням людською мовою; 429 дотримується Retry-After.
- Паралельні кліки й паралельні проходи у фоні дають один рахунок і один запис в історії замовлення.
- Після закінчення Pro завдання в черзі не відправляються й позначаються причиною; безкоштовний ручний e-Arşiv працює.
Як встановити
- Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
- WooCommerce → Nilvera invoices: оберіть середовище, вставте ключ API, перевірте з’єднання, оберіть серію e-Arşiv, збережіть.
- Відкрийте замовлення й натисніть «Create the invoice» у блоці Nilvera.
- Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний плагін Nilvera?
Ні, це незалежна інтеграція від CatCode через публічний API. Nilvera є торговою маркою свого власника; плагін не афілійований із Nilvera й не схвалений ним.
Де взяти ключ API?
У порталі Nilvera відкрийте «API Tanımları», натисніть «Yeni Anahtar» і скопіюйте ключ: він показується один раз. Тестове й бойове середовища мають окремі ключі.
Хто платить за рахунки?
Документи оплачуються за вашим договором з Nilvera з кредитів (kontör) акаунта. Модуль не додає плати за рахунок.
Чи можна змінити виставлений рахунок?
Ні: рахунок іде в GİB і не редагується. e-Arşiv можна скасувати із замовлення (Pro, кнопкою або за статусом), e-Fatura через API не скасовується, це робиться в порталі Nilvera.
Що з покупцями, які не вказали податковий номер?
Рахунок виписується на номер за замовчуванням з налаштувань (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.
Що входить у безкоштовну версію?
Підключення, вибір серії, ручне створення e-Arşiv із превʼю, ручний VKN/TCKN, PDF і перевірка статусу. Автовидача, e-Fatura, поля на чекауті, скасування, лист покупцю, статус GİB у фоні, журнал і масова дія — у Pro.
Чи працює модуль з HPOS і блоковим чекаутом?
Так. Поля VKN/TCKN в Pro доступні і на класичному, і на блоковому чекауті.
Що буде після пробного періоду?
Pro вимикається, завдання Pro в черзі зупиняються з причиною, безкоштовна частина працює далі.
Скільки сайтів покриває ключ?
Один ключ працює на двох сайтах: магазин і копія для розробки.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















