Sequential invoice numbers, editable invoice and credit note documents, credit notes on refunds, PDF and bulk print.
Available Updated Oct 25, 2026Version 1.0.1CS-Cart, Multi-Vendor 4.17.2 – 4.21.x No core file edits
Built for
Invoices & Credit Notes: overview1 of 17
What it does
CS-Cart numbers its invoices with one plain counter, with no number formats, no series per storefront or vendor and no credit notes for returns. Invoices & Credit Notes gives every order its own invoice number when it reaches the status you choose, from a series per storefront or vendor, without gaps or duplicates. Each invoice keeps the content it was issued with, and corrections are made with numbered credit notes. Made for stores and marketplaces that want tidy, sequential documents for their bookkeeping.
How it works
Choose the number format and the statuses that issue invoices. When an order reaches such a status, the invoice is numbered and added to the status e-mail. Customers open it from their order page. Admins see an Invoices tab on every order, lists of invoices and credit notes, bulk print, ZIP and CSV, and add credit notes for items, shipping or an amount. The layout is edited in Design, Documents. On Multi-Vendor each vendor invoices its own orders and sees only its own documents.
Features
Gapless sequential invoice numbers, safe with parallel payments
Number formats with prefix, year, month and padding, start number and yearly reset
One series per storefront, per vendor or for the whole marketplace
Invoice and credit note documents editable in Design, Documents
Content frozen at issue: later order or company changes never alter an invoice
Credit notes on cancellation, returns (RMA) and Customer Wallet refunds
Manual credit notes for items, shipping or an amount, never above the open amount
Customer links, print view and PDF with the core PDF documents add-on
Documents added to the customer's order status e-mail
Invoices and Credit notes lists with search, CSV, bulk print and ZIP
Invoices for existing orders in one step, with confirmation
Buyer VAT numbers and reverse-charge notes with EU VAT Validation
Vendor panel documents, own formats and credit notes (Multi-Vendor)
What you get
Package
kv_invoice_builder-1.0.1.zip, installed through Add-ons → Manage add-ons
Updates & support
12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License
1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works
Compatibility
We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.
CS-Cart version and edition compatibility
CS-Cart version
CS-Cart
CS-Cart Ultimate
Multi-Vendor
Multi-Vendor Ultimate
4.22 and later
Testing next
Testing next
Testing next
Testing next
4.21.2
Supported
Supported
Supported
Supported
4.20.x
Supported
Supported
Supported
Supported
4.19.x
Supported
Supported
Supported
Supported
4.18.x
Supported
Supported
Supported
Supported
4.17.2
Tested
Supported
Tested
Supported
Before 4.17.2
Not supported
Not supported
Not supported
Not supported
Last tested build: Multi-Vendor 4.17.2, Oct 25, 2026Tested on: Multi-Vendor 4.17.2, CS-Cart 4.17.2
Requirements
PHP
CS-Cart or CS-Cart Multi-Vendor 4.17.2 – 4.21.x, PHP 7.2.5 – 8.3 (as supported by your CS-Cart version)
Requirement
MySQL or MariaDB with InnoDB tables (the default). The number counter uses database transactions
Requirement
Optional: the core PDF documents add-on for PDF files, the core RMA add-on for credit notes on returns, our EU VAT Validation add-on for VAT numbers, our Customer Wallet & Store Credit add-on for credit notes on wallet refunds
Core changes
None. Hooks and template overrides only
1.0.1
Oct 25, 2026
Latest
Added 1
Hook kv_invoice_builder_document_issued($doc) after a new invoice or credit note was issued, so other add-ons (EU e-Invoicing) can react at once, e.g. to credit notes issued by hand.
Tested on Multi-Vendor 4.17.2, CS-Cart 4.17.2. No breaking changes.
1.0.0
Oct 24, 2026
Added 9
Sequential invoice numbers issued when an order reaches the chosen statuses, gapless and safe with parallel payments (locked counter in a database transaction).
Number formats with {YYYY}, {YY}, {MM}, {DD}, {N}, {VENDOR}, {ORDER}, padding, start number and an optional yearly reset; one series per storefront (CS-Cart), per vendor or for the marketplace (Multi-Vendor).
Invoice and credit note documents (Design > Documents, Twig 2 and 3) with seller, buyer, VAT IDs, lines, tax summary, totals, notes and footer; content frozen at issue.
Credit notes with their own series: on cancellation, on refunded returns (core RMA), on Customer Wallet refunds and by hand (items, shipping, surcharge, amount), never above the open amount.
Invoices and Credit notes lists with search, filters, CSV export, bulk print and ZIP; Invoices tab on the order page; Invoice column and bulk actions in the orders list; invoices for existing orders with confirmation.
Customer links, print view and PDF (core PDF documents add-on); documents added to the order status e-mail; e-mail template for sending documents.
Multi-Vendor: vendor panel documents, own formats, tax ID and texts, optional vendor credit notes.
{{ kv_invoice.number }}, date and credit_notes variables for the core order documents.
Tested on Multi-Vendor 4.17.2, CS-Cart 4.17.2. First release.
Can there be gaps or duplicate numbers?
No. Each number is taken inside a database transaction that locks the series counter, inserts the document and moves the counter together. If anything fails, nothing is saved and the number is not used. We test this with many parallel processes issuing invoices and credit notes at the same time.
Are existing orders numbered when I install the add-on?
No. Existing orders get an invoice only when they next reach an "issue invoice" status, or when you use Orders → Invoices → Invoices for existing orders on purpose.
Can I change or delete an invoice?
No, by design. An issued invoice keeps its number and content, even when the order, the product or your company details change later. Corrections are made with credit notes. The layout (Design → Documents) can be changed at any time and applies to all documents.
Can I continue the numbers from my previous system?
Yes. Set First number of a new series to the next number you need before the first invoice of the series is issued (for example 1043), and use the same format.
Two vendors have invoices with the same number. Is that right?
With numbering per vendor, every vendor is the seller of its own orders and has its own series, so INV-2026-00001 exists once per vendor. Add {VENDOR} to the format (for example INV-{VENDOR}-{YYYY}-{N}) if you want numbers that are unique across the marketplace, or choose Marketplace numbering.
Does the add-on cover the invoicing rules of my country?
The add-on helps you keep sequential invoices with consistent content; it does not know the rules of each country. Check with your accountant which details your invoices need, and add them with the texts, the seller tax ID and the template.
Why are there no PDF buttons?
PDF files are created by the core PDF documents add-on, which uses the CS-Cart PDF conversion service. Activate it in Add-ons → Manage add-ons. Without it, the print view works everywhere and the browser can save it as a PDF.
In which currency are the documents?
In the currency the customer used for the order, with the exchange rate of the moment the document was issued. The lists and the CSV also show the totals in your base currency. Additional credit amounts are entered in the base currency.
A customer cannot open the invoice.
Only the customer of the order can open its documents, after signing in (guests need the access to that order, as for the order page). Check that Customers can open their documents is on. Documents of deleted orders are not shown to customers.
What happens if the license lapses?
Without a valid license (no key after the 14-day start period, an invalid or revoked key, a domain the license does not cover, or no successful check for 14 days), no new invoice or credit note numbers are issued and nothing is attached to e-mails. Invoices and credit notes issued so far stay viewable, printable and downloadable for you, your vendors and your customers. Once the license is valid again, invoice the orders of that period with Issue invoice now or the tool for existing orders.
The admin panel shows a license notice.
Open Add-ons → Manage add-ons → Invoices & Credit Notes → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.
Does the add-on work on my staging copy?
Yes. Subdomains of your licensed domain (for example staging.yourstore.com) and local development hosts (localhost, private IP addresses, .local, .test) are covered by the same license.
Does the license check slow down my storefront or checkout?
No. The check runs in the admin panel or from cron, once a day. The storefront never runs it.
Store Credit WalletGive customers a store credit balance for refunds, cashback and goodwill credit, spendable at checkout in full or in part.
$69
+
EU Withdrawal Button & Returns PortalHelps you provide the online withdrawal function: a "Withdraw from contract here" button, a two-step statement and a dated acknowledgement.
$69
Also from Kavio Labs
Available now and coming next, tested on the same CS-Cart builds.