
KolayBi Invoices for OpenCart — invoices from orders, TCKN/VKN, KDV, e-Arşiv (Turkey)
KolayBi Invoices for OpenCart 4.x, 3.x, 2.3 (Turkey): an invoice from an order with one button; Pro adds automation by status, e-Arşiv / e-Fatura, collection, 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
A manager opens an order and sees the “KolayBi” box with the TCKN/VKN and tax office fields, the buyer and the address, a table of lines (name, quantity, price without KDV, rate, total), the “Total with KDV” and the “Create the invoice in KolayBi” button.
What is in the admin
Extensions → Extensions → Modules → KolayBi Invoices: the tabs “Connection”, “Buyer”, “Invoice”, “Automation (Pro)”, “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 KolayBi account with an API key and an API channel (Ayarlar → Profil Hesabı); the test and live environments have their own keys and companies.
For e-Arşiv / e-Fatura (Pro) the KolayBi company needs the e-invoice integration switched on, and live documents need a Turkish company.
An e-Fatura cannot be cancelled through the API: the module stops with an explanation that a return invoice (iade faturası) is needed in KolayBi.
Gift vouchers and fixed taxes of OpenCart are not supported, and a KDV rate outside 0/1/8/10/18/20 stops the order with a reason.
On OpenCart 3.x and 2.3 the regular jobs run when pages are opened; a server cron on the address from the settings every 5 minutes makes it more dependable. OpenCart 4 uses its built-in scheduler, once an hour.
Version history
For OpenCart 4.x, 3.x and 2.3: invoices from orders at KolayBi, a preview of lines, the cari and products made automatically, TCKN/VKN and tax office by hand, KDV 0/1/8/10/18/20, a coupon…
Frequently bought with KolayBi Invoices


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
KolayBi Invoices for OpenCart 4.x, 3.x and 2.3 creates invoices at KolayBi (ön muhasebe) straight from shop orders: the module shows the lines with amounts and KDV on the order page, and after a click on “Create the invoice in KolayBi” the customer, the products and the invoice appear in your books. The module talks to the KolayBi API with an API key and a channel name, in the test or the live environment.
What the seller gets
A manager opens an order and sees the “KolayBi” box with the TCKN/VKN and tax office fields, the buyer and the address, a table of lines (name, quantity, price without KDV, rate, total), the “Total with KDV” and the “Create the invoice in KolayBi” button. After the click the buyer becomes a KolayBi associate (cari), or an existing one with the same name, number, e-mail and tax office is reused, and the invoice gets its number.
Invoice rows are looked up in KolayBi by Model or SKU and created when missing. A coupon goes into the row price, shipping and fees are separate service rows, and the KDV rate of every row comes from the OpenCart tax. For another currency the module sends the shop’s rate. The buyer’s address is carried over with the province and district, and for buyers abroad with the building number.
Before creating, the module compares the invoice total with the order total and writes a note in the order if they differ. If the KolayBi answer is lost, the module looks the invoice up by the order reference in its description and does not make a second one. A second click says “already created”.
What is in the admin
Extensions → Extensions → Modules → KolayBi Invoices: the tabs “Connection”, “Buyer”, “Invoice”, “Automation (Pro)”, “Pro”. In KolayBi open Ayarlar → Profil Hesabı, create an API key and an API channel, paste the key and the channel name, choose the environment (test and live have their own keys and companies) and press “Save and check the connection”: the module shows the company name, VKN/TCKN, the currency, whether the e-invoice integration is on, and the number of cash and bank accounts. The key is stored encrypted and is not shown again.
The “Buyer” tab sets the buyer fields: the “Create the fields” button makes “TR ID / tax number” and “Tax office” for every customer group (account and checkout), the TCKN check digits test at the checkout, and the number for buyers without one (11111111111) and for buyers abroad. The “Invoice” tab holds the KDV mode (from the order, prices include KDV, or no KDV), the product code (Model or SKU), creating missing products, payment codes for “paid later”, the internet sale data, payment type mapping, the due term, and a text on every invoice.
The module texts follow the admin language, English or Turkish. Amounts are shown in the shop’s format.
In Pro the “Automation (Pro)” tab opens invoicing at chosen statuses, e-Arşiv / e-Fatura at GİB right after the invoice (scenarios for people and for companies, a series prefix, the buyer’s e-mail as the receiver), collection (tahsilat) into a chosen cash or bank account at a status or at an online payment, cancellation at a refund status, KDV per tax class, and a product and stock sync in portions of 15 products every 10 minutes. The journal in the Sales menu has the filters “Waiting”, “Stopped”, “Invoices”, “e-Documents”, “Cancellations”, “Orders without an invoice”, totals for a period, CSV, bulk invoicing and “Retry all stopped”.
How it works, step by step
- Install the archive for your OpenCart version and install the module in the “Modules” section.
- In KolayBi create an API key and an API channel, paste them on the “Connection” tab, choose the environment and press “Save and check the connection”.
- On the “Buyer” tab press “Create the fields”, on the “Invoice” tab set the KDV mode, the product code and the payment type.
- Open an order, check the lines and amounts in the preview and press “Create the invoice in KolayBi”.
- If needed, type the TCKN/VKN and tax office in the order by hand and save them for the order.
- In Pro switch on invoices by status, e-Arşiv / e-Fatura, collection and cancellation.
- Watch the state in the order and in the journal; the PDF of the e-document opens with a button.
Under the hood
- KolayBi REST API v1: a 24-hour token by the key and channel (cached for 23 hours, a new one is taken once on 401), customers (associates) and addresses, products, invoices, e-documents (create, cancel, PDF), collection (proceed), cash and bank accounts.
- The key is stored encrypted, is not shown in the settings, and the module log has no keys.
- Creating an invoice does not block checkout: when KolayBi is slow or down, the button in the admin answers in 8–9 seconds with a clear text and the job is retried.
- Errors 400, 401, 429 and 5xx are shown next to the order in plain words without service codes; 429 respects the wait time.
- Parallel clicks and parallel cron passes give one invoice.
- After the trial ends, Pro jobs in the queue are not sent and are marked as switched off; the free manual invoice keeps working.
- The interface is in English and Turkish.
Installation
- OpenCart 4: Extensions → Installer, upload cc_kolaybi.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_kolaybi-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, upload cc_kolaybi-oc23.ocmod.zip (FTP settings are needed in System → Settings → FTP; otherwise unpack the archive and copy the upload/ folder into the store root by hand), then Extensions → Modifications → Refresh.
- Extensions → Modules → KolayBi Invoices: install it and open the settings.
- Paste the API key and the channel, press “Save and check the connection”.
- 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 KolayBi module?
No, it is an independent integration through the public API. KolayBi is a trademark of its owner.
Where do I get the API key and the channel?
In KolayBi: Ayarlar → Profil Hesabı. The key is made in the API keys section and the channel in the API channels section. The test and live environments have their own accounts and keys.
Do I need the e-invoice integration?
Not for plain invoices. e-Arşiv and e-Fatura at GİB (Pro) need the e-invoice integration switched on in the KolayBi company; the "Connection" tab shows whether it is on.
What about buyers who gave no tax number?
The invoice is made to the default number from the "Buyer" tab (11111111111). You can change it, agree it with your accountant. A TCKN/VKN can be typed in the order by hand, and in Pro the buyer enters it at the checkout.
Can an e-Fatura be cancelled?
Not through the API: the module stops with an explanation that a return invoice (iade faturası) is needed in KolayBi. An e-Arşiv is cancelled at GİB, and an invoice that is not yet an e-document is deleted.
Does the free version work without Pro?
Yes: the connection, a manual invoice with a preview, the automatic cari and products, PDF, retry and delete work in the free version. Invoices by status, e-Arşiv / e-Fatura, collection, cancellation, sync, KDV per class and the journal 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.




















