Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

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.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
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
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

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.

Feature Free Pro
The connection to Nilvera by API key, a check of the company, VKN and series ✔ ✔
Test and live environment of Nilvera ✔ ✔
A manual e-Arşiv invoice from the order with a preview of lines and sums ✔ ✔
VKN/TCKN and tax office in the order by hand, check digits checked ✔ ✔
KDV 0/1/8/10/18/20 by WooCommerce taxes, the coupon in the line price, 0% as İSTİSNA with an exemption code ✔ ✔
Internet sale: web site, payment method, payment date, carrier ✔ ✔
Orders in another currency at the rate of the order ✔ ✔
PDF and GİB status check ✔ ✔
ETTN before sending: no double invoices, HPOS ✔ ✔
Automatic invoices by order status and a bulk action — ✔
e-Fatura automatically for taxpayers of the register — ✔
VKN/TCKN and tax office fields at the checkout (classic and block) — ✔
Cancellation of e-Arşiv with a button and by status — ✔
E-mail to the buyer from Nilvera — ✔
GİB status in the background every 15 minutes — ✔
Journal with filters, totals and CSV — ✔
Updates from catcode.com.ua and a Turkish interface — ✔

What it looks like

The Nilvera box in an order
A WooCommerce order in the admin: the Nilvera box with lines, prices without KDV, rates, totals and the “Create the invoice” button.
The invoice is made
The Nilvera box after an e-Arşiv invoice is made: the invoice number, the GİB state, the ETTN and the buttons PDF, “Check the status”, “E-mail” and cancel.
Connection and e-Arşiv series
WooCommerce → Nilvera invoices: the environment, the API key, the company name and VKN after the connection check, the e-Arşiv series and the number for a buyer without one.

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

v1.0.0 Current 16.11.2026

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

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

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

  1. Install the plugin and activate it (WooCommerce must be active).
  2. 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”.
  3. Choose the e-Arşiv series and set KDV, the payment method, the carrier and the unit.
  4. Open an order, check the lines and the sums and press “Create the invoice”: the order shows the number, the PDF and the status.
  5. If needed, type the VKN/TCKN and the tax office in the order by hand.
  6. 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

  1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
  2. WooCommerce → Nilvera invoices: choose the environment, paste the API key, check the connection, choose the e-Arşiv series and save.
  3. Open an order and press “Create the invoice” in the Nilvera box.
  4. 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.

@catcode_support Setup, compatibility, activation
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.

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