
Nilvera e-Fatura and e-Arşiv for WooCommerce — invoices from orders, VKN/TCKN, KDV (Turkey)
Nilvera e-Fatura and e-Arşiv for WooCommerce (Turkey): an invoice from an order with one button; Pro adds automatic invoices, e-Fatura, VKN/TCKN fields at the checkout, cancellation and a journal.
- Compatibility
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, block checkout) · PHP 7.4+ · a Nilvera account with e-Arşiv · currency TRY · interface: English (Türkçe in Pro)
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 16.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.
What it looks like
Key points
What the seller gets
The manager opens an order and sees the box “Nilvera e-Arşiv / e-Fatura”: a table of lines (name, quantity, price without KDV, rate, amount) and the total “without KDV / KDV / total”.
Connection
In WooCommerce → Nilvera invoices choose the environment, paste the key 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.
What Pro adds
Automatic invoices. The invoice is made in the background when an order reaches the statuses you choose, once for an order.

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
WordPress 6.4+, WooCommerce 8.6+ (HPOS and the block checkout are supported), PHP 7.4+.
A contract with Nilvera and an account with e-Arşiv and an API key; credits (kontör) on the account.
An e-Arşiv series in the Nilvera portal, and for automatic e-Fatura in Pro an e-Fatura series too.
Shop currency TRY; orders in another currency are invoiced at the rate typed in the order.
Version history
E-Arşiv invoices from orders through Nilvera, a preview of the lines, the VKN/TCKN and tax office by hand, KDV 0/1/8/10/18/20, İSTİSNA, the internet sale data, other currencies, the ETTN…
Frequently bought with Nilvera e-Fatura and e-Arşiv


Abandoned Cart Recovery for WooCommerce

Trendyol Connector for WooCommerce — Trendyol prices, stock and orders in your store

Invoices with Paraşüt for WooCommerce — invoices, e-Arşiv and e-Fatura from the order
Full module description
Nilvera e-Fatura and e-Arşiv for WooCommerce makes electronic invoices in Nilvera straight from the orders of your shop. The box on the order screen shows the lines with their amounts and KDV, and after one click Nilvera issues an e-Arşiv fatura and passes it to the GİB. The module works with the Nilvera API through the key from your portal, in the test or the live environment of Nilvera.
What you need from Nilvera. A contract of your company with Nilvera and an account with e-Arşiv. In the portal open “API Tanımları”, press “Yeni Anahtar” and paste the key on the settings page of the module. The test and the live environments have separate keys and companies.
What the seller gets
The manager opens an order and sees the box “Nilvera e-Arşiv / e-Fatura”: a table of lines (name, quantity, price without KDV, rate, amount) and the total “without KDV / KDV / total”. Each line keeps the rate of its WooCommerce tax (0, 1, 10 or 20%), the coupon is already in the line price, shipping and fees are lines of their own. Lines at 0% go as İSTİSNA with your exemption code.
After “Create the invoice” the invoice gets its series number, and the order shows the PDF, a button that asks the GİB for the status and a note in the order history.
A buyer without a tax number gets the default number (11111111111, changeable in the settings). The VKN of a company or the TCKN of a person and the tax office can be typed in the order: the module checks the check digits. The internet sale data carries the web site, the payment method (card, EFT/havale, cash on delivery, payment services such as iyzico or PayTR), the payment date and the carrier. An order in another currency is invoiced at the rate you type in the order.
Every invoice gets its ETTN before the first call. If the answer of Nilvera is lost, the module looks the document up by that ETTN, and Nilvera refuses a second document with the same ETTN, so there is no double invoice. The invoice total is compared with the order total before anything is sent: if they differ, the invoice stops with an explanation. The module works with HPOS and the block checkout.
Connection
In WooCommerce → Nilvera invoices choose the environment, paste the key 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 never shown again. The e-Arşiv series is picked by itself when the portal has only one.
What Pro adds
Automatic invoices. The invoice is made in the background when an order reaches the statuses you choose, once for an order. The orders list gets the bulk action “Create Nilvera invoices”.
e-Fatura by the register. The module checks the buyer’s VKN or TCKN in the register of e-Fatura taxpayers: a taxpayer gets an e-Fatura (TEMELFATURA or TİCARİFATURA, the e-Fatura series), everyone else an e-Arşiv invoice.
Fields at the checkout. VKN / TCKN and the tax office on the classic and the block checkout (optional, off by default), with a check of the check digits if you want it. The fields of Hezarfen, Paraşüt and any meta keys are read too.
Cancellation and the e-mail to the buyer. An e-Arşiv invoice is cancelled with a button or at the statuses you choose (for example Refunded), and after that a new invoice with a new ETTN can be made. Nilvera can e-mail the invoice to the buyer, by itself or with a button.
GİB status in the background. Every 15 minutes the module asks Nilvera about the invoices, 5 at a time, the oldest first, and leaves a note when the GİB reports an error.
Journal. Every document of a period with filters (in progress, stopped, e-Fatura, cancelled, orders without an invoice), totals, a CSV export and the button “Retry all stopped”.
Limits
- The module works only with your own Nilvera account: the contract with Nilvera and the API key come from Nilvera.
- Invoices are paid under your contract with Nilvera from the credits (kontör) of the account. When there are none, Nilvera refuses the invoice: the module shows the reason in plain words with the buttons “Try again” and “Forget it”.
- The address of the buyer (street, district, city) must be in the order: Nilvera demands it on the invoice.
- An invoice reported to the GİB cannot be changed. An e-Arşiv invoice can only be cancelled (Pro, with a button or by status); an e-Fatura is not cancelled through the API, that is done in the Nilvera portal.
- Lines at 0% KDV go as İSTİSNA with the exemption code of the settings: without it an order with such lines stops. The proportional shipping tax of WooCommerce is split into several lines by rate.
- Unusual discounts (a negative fee) are spread as a percentage over the products; if the invoice total differs from the order total by more than a few kuruş, the invoice stops with an explanation.
- For an order in another currency the rate to TRY is typed in the order box; without it the invoice stops.
- The e-Arşiv series, and for automatic e-Fatura the e-Fatura series as well, are created in the Nilvera portal.
- When Nilvera is silent, the button in the admin answers within 9 seconds with a clear text, and the invoice is queued and retried in the background (Pro).
- Automatic invoices run through Action Scheduler (part of WooCommerce). After the module is deactivated the entries in the queue wait, and “Try again” in the order starts them.
- The interface is in English; the Turkish translation is in the Pro build.
How it works, step by step
- Install the plugin and activate it (WooCommerce must be active).
- In the Nilvera portal create a key (“API Tanımları” → “Yeni Anahtar”), in WooCommerce → Nilvera invoices choose the environment, paste the key and press “Save and check the connection”.
- Choose the e-Arşiv series and set KDV, the payment method, the carrier and the unit.
- Open an order, check the lines and the sums and press “Create the invoice”: the order shows the number, the PDF and the status.
- If needed, type the VKN/TCKN and the tax office in the order by hand.
- In Pro switch on automatic invoices by status, e-Fatura by the register, the checkout fields, cancellation, the e-mail to the buyer and the journal.
Under the hood
- Nilvera REST API: Genel (company data, the e-Fatura taxpayer check by VKN/TCKN), e-Arşiv (sending, series, details, status, PDF, cancellation) and e-Fatura (sending with the alias of the receiver, status, PDF, the e-mail to the buyer). The address of the API depends on the environment you chose; the module calls Nilvera only after you have saved the key.
- Authorisation by a Bearer key; the key is stored encrypted in the database and never returned in HTML.
- Sent to Nilvera: the name or company name of the buyer, the VKN or TCKN, the tax office, the e-mail, the phone and the address, the order lines (name, product code, quantity, price, KDV rate), the currency and the rate, the order number and date, the address of the shop, the payment method and date and the carrier.
- The checkout of the buyer does not wait for Nilvera: the invoice is made from the admin or in the background.
- Answers 401, 403, 422, 429, 502 and 503 are shown beside the order in plain words; 429 respects Retry-After.
- Parallel clicks and parallel background passes give one invoice and one entry in the order history.
- When Pro ends, the jobs in the queue are not sent and are marked with the reason; the free manual e-Arşiv keeps working.
How to install
- Plugins → Add New → Upload Plugin: choose the zip and activate it.
- WooCommerce → Nilvera invoices: choose the environment, paste the API key, check the connection, choose the e-Arşiv series and save.
- Open an order and press “Create the invoice” in the Nilvera box.
- For Pro: paste the licence key or start the trial in the “Licence” section of the same page.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this the official Nilvera plugin?
No, it is an independent integration made by CatCode through the public API. Nilvera is a trademark of its owner; the plugin is not affiliated with Nilvera and is not endorsed by it.
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 fee per invoice.
Can an invoice be changed after it is made?
No: the invoice goes to the GİB and is not editable. An e-Arşiv invoice can be cancelled from the order (Pro, with a button or by 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 to the default number of the settings (11111111111). You can change it, agree it with your accountant. The VKN/TCKN can be typed in the order by hand, and in Pro the buyer types 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 invoice. Without Pro an invoice for an e-Fatura taxpayer has to be issued in the Nilvera portal.
What is in the free version?
The connection, the series choice, a manual e-Arşiv invoice with a preview, a manual VKN/TCKN, the PDF and the status check. Automatic invoices, e-Fatura, the checkout fields, cancellation, the e-mail to the buyer, the GİB status in the background, the journal and the bulk action are in Pro.
Does it work with HPOS and the block checkout?
Yes. In Pro the VKN/TCKN fields are available on both the classic and the block checkout.
What happens after the trial?
Pro switches off, Pro jobs in the queue stop with a reason, the free part keeps working.
How many sites does a key cover?
One key works on two sites: the shop and its development copy.
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.

















