
Nilvera e-Fatura and e-Arşiv for OpenCart — invoices from orders, VKN/TCKN, KDV (Turkey)
Nilvera e-Fatura and e-Arşiv for OpenCart 4.x, 3.x, 2.3 (Turkey): an invoice from an order with one button; Pro adds automatic invoicing, e-Fatura, VKN/TCKN fields at the checkout, a journal. A licence for life.
- Compatibility
- OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · module languages: English, Türkçe
- PHP
- 7.0 or newer
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- 15.11.2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What the seller gets
The manager opens an order, sees the “Nilvera e-Arşiv / e-Fatura” box with a table of lines (item, quantity, unit price without KDV, rate, amount), the totals “without KDV / KDV / total”, and presses “Create the invoice”.
What is in the admin
Extensions → Extensions → Modules → Nilvera e-Fatura and e-Arşiv: the tabs “Connection”, “Buyer”, “Invoice”, “Automation and e-Fatura”, “Series and accounts”, “Pro”.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
OpenCart 4.0.2.0–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
A contract with Nilvera and an account with an API key (“API Tanımları” → “Yeni Anahtar”); the test and the live environments have separate keys and companies.
Credits (kontör) or a package on the Nilvera account: without them Nilvera refuses the invoice, and the module shows the reason with a “Retry” button.
The buyer’s address (address, district, city) in the order: Nilvera needs it on the invoice.
An e-Arşiv series, and for Pro automation of e-Fatura an e-Fatura series too, created in the Nilvera portal.
An e-Fatura cannot be cancelled through the API: the buyer rejects a TİCARİ invoice, or a return invoice is made. This is done in the Nilvera portal, and the module explains it in the order.
An invoice sent to the GİB cannot be edited, and an e-Arşiv can only be cancelled.
For OpenCart 3.x and 2.3 the regular jobs (retry, GİB statuses) run when pages are opened; a server cron on the address from the settings every 5 minutes makes it more reliable. In OpenCart 4 the built-in scheduler does it, once an hour.
Version history
For OpenCart 4.x, 3.x and 2.3: e-Arşiv from orders through Nilvera, a preview of lines, VKN/TCKN and tax office by hand, KDV 0/1/8/10/18/20, İSTİSNA, internet sale data, other currencies…
Frequently bought with Nilvera e-Fatura and e-Arşiv


Geliver Shipping for OpenCart 2.3, 3.x and 4.x — Turkish carrier rates and labels

Cart Discounts (Amount-Based and N+1) for OpenCart

Trendyol Connector for OpenCart 3.x and 4.x — Trendyol prices, stock and orders in your shop
Full module description
Nilvera e-Fatura and e-Arşiv for OpenCart 4.x, 3.x and 2.3 creates electronic invoices at Nilvera straight from shop orders: a button on the order page shows the lines with amounts and KDV, and after the click Nilvera issues the e-Arşiv fatura and passes it to the GİB. The module talks to the Nilvera API with a key from the portal, in the test or the live environment.
What the seller gets
The manager opens an order, sees the “Nilvera e-Arşiv / e-Fatura” box with a table of lines (item, quantity, unit price without KDV, rate, amount), the totals “without KDV / KDV / total”, and presses “Create the invoice”. The invoice gets a number of the series, the order shows the PDF and the status at Nilvera and the GİB, and the order history gets a note.
A buyer who gave no tax number gets the invoice on the default number (11111111111, it can be changed on the “Buyer” tab). The VKN or TCKN and the tax office can be typed into the order by hand, and the module checks the check digits. A coupon goes into the line price, shipping is a separate line with the rest of the tax, lines with 0% KDV go as İSTİSNA with the exemption code, and other currencies are counted at the shop’s rate.
Every invoice gets its ETTN before it is sent. If the answer of Nilvera is lost, the module looks the document up by the ETTN, and Nilvera refuses a second document with the same ETTN, so there is no double invoice. A second press of the button answers “already there”.
What is in the admin
Extensions → Extensions → Modules → Nilvera e-Fatura and e-Arşiv: the tabs “Connection”, “Buyer”, “Invoice”, “Automation and e-Fatura”, “Series and accounts”, “Pro”. In the Nilvera portal open “API Tanımları”, press “Yeni Anahtar” and paste the key; choose the environment (test and live have separate keys and companies) and press “Save and check the connection”: the module shows the company name, the VKN and the number of e-Arşiv and e-Fatura series. The key is stored encrypted and is not shown again.
The “Invoice” tab holds KDV (as in OpenCart taxes or a fixed rate), the exemption code for 0%, the sales channel (İNTERNET), the payment method (card, EFT/HAVALE, KAPIDAODEME, intermediary) with a map for your payment extensions, the carrier and its VKN, the unit (C62), the product code (Model or SKU) and a note on the invoice. The internet sale data (web site, payment, carrier) goes into the e-Arşiv.
Notes on the invoice and the texts of the module follow the language of the order; the admin interface is in English and Turkish. Amounts are shown in the shop’s format.
In Pro the “Automation and e-Fatura” tab turns on invoicing at chosen statuses, a separate list of statuses for e-Arşiv cancellation, e-Fatura for taxpayers of the register (the e-Fatura series and the scenario TEMELFATURA or TİCARİFATURA) and the e-mail to the buyer from Nilvera. The “Buyer” tab adds the “VKN/TCKN” and “Tax office” fields at the checkout, the “Create the fields” button and the check digits test. The journal opens in the Sales menu with the filters “In progress”, “Stopped or with an error”, “e-Fatura”, “Cancellations”, “Orders without an invoice”, totals for a period and CSV; the same page creates invoices in bulk for ticked orders.
The “Series and accounts” tab (Pro) gives up to three separate series or Nilvera accounts for the stores of a multistore.
How it works, step by step
- Install the archive for your OpenCart version and install the module in “Modules”.
- In the Nilvera portal create a key (“API Tanımları” → “Yeni Anahtar”), paste it on the “Connection” tab, choose the environment and press “Save and check the connection”.
- Choose the e-Arşiv series, and on the “Invoice” tab set KDV, the payment method, the carrier and the unit.
- Open an order, check the lines and amounts in the preview and press “Create the invoice”: the invoice goes to Nilvera and the order shows the number, the PDF and the status.
- If needed, type the VKN/TCKN and the tax office into the order by hand.
- In Pro turn on automatic invoicing by status, e-Fatura for taxpayers of the register, the checkout fields and the e-mail to the buyer.
- Follow the statuses in the order and in the journal; PDF and “Check the status” are buttons.
Under the hood
- Nilvera REST API: Genel (company data, a check of an e-Fatura taxpayer by VKN/TCKN), e-Arşiv (send, series, details, status, PDF, cancel) and e-Fatura (send with the alias of the receiver, status, PDF, e-mail to the buyer).
- Bearer key authorization; the key is encrypted and not shown in the settings.
- Creating an invoice does not hold up the checkout: when Nilvera is slow or down, the invoice goes to a queue and is retried, and the admin button answers within 8–9 seconds with a plain sentence.
- Answers 401, 403, 422, 429, 502 and 503 are shown next to the order in plain words (no credits, a key error, a missing address); 429 follows Retry-After.
- Parallel clicks and parallel cron passes give one invoice and one history note.
- GİB statuses are pulled in the background by a cursor, 5 documents a pass, the oldest first.
- After the trial Pro jobs in the queue are not sent and are marked “Pro is off”; the free manual e-Arşiv works.
- The interface is in English and Turkish.
Installation
- OpenCart 4: Extensions → Installer, upload cc_nilvera.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_nilvera-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, upload cc_nilvera-oc23.ocmod.zip (this needs the FTP settings in System → Settings → FTP; otherwise unpack the archive and upload the contents of the upload/ folder to the shop root by hand), then Extensions → Modifications → Refresh.
- Extensions → Modules → Nilvera e-Fatura and e-Arşiv: install and open the settings.
- Paste the API key, press “Save and check the connection” and choose the e-Arşiv series.
- For Pro: paste the licence key or start the trial on the “Pro” tab.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this an official Nilvera module?
No, it is an independent integration through the public API. Nilvera is a trademark of its owner.
Where do I get the API key?
In the Nilvera portal open "API Tanımları", press "Yeni Anahtar" and copy the key: it is shown once. The test and the live environments have separate keys.
Who pays for the invoices?
The documents are paid under your contract with Nilvera, from the credits (kontör) of the account. The module adds no charge per invoice.
Can an issued invoice be changed?
No: the invoice goes to the GİB and is not edited. An e-Arşiv can be cancelled from the order (Pro, by hand or at a status); an e-Fatura is not cancelled through the API, that is done in the Nilvera portal.
What about buyers who gave no tax number?
The invoice goes on the default number from the "Buyer" tab (11111111111). The value can be changed, agree it with your accountant. The VKN/TCKN can be typed into the order by hand, and in Pro the buyer enters it at the checkout.
How does e-Fatura work?
In Pro the module checks the buyer's VKN or TCKN in the register of e-Fatura taxpayers. Taxpayers get an e-Fatura (TEMELFATURA or TİCARİFATURA, the e-Fatura series), everyone else an e-Arşiv. Without Pro an order of an e-Fatura taxpayer stops with an explanation: the invoice has to be issued in the Nilvera portal.
Does the free version work without Pro?
Yes: the connection, the series choice, a manual e-Arşiv with a preview, PDF and a status check work in the free version. Automatic invoicing, e-Fatura, the checkout fields, cancellation, the e-mail to the buyer, the journal, bulk creation and several series are in Pro.
Which OpenCart versions are supported?
OpenCart 4.0.2.0–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence for life?
Yes, for OpenCart it is one payment and a licence for life, for two sites.
What happens after the trial?
Pro switches off, Pro jobs waiting in the queue stop with a reason, and the free part keeps working.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















