Give every unit you sell its own serial number, link it to the order at dispatch and track warranty, claims and replacements.
Tested on 2 buildsUpdated Nov 10, 2026Version 1.0.0CS-Cart, Multi-Vendor 4.17.2 – 4.21.x No core file edits
Built for
Serial Numbers & Warranty Tracker: overview1 of 18
What it does
For stores that sell electronics, appliances, tools or any product with a warranty. Factory stickers often show only the manufacture month, the same for every unit of a batch, and repeat customers buy the same model again and again. Serial Numbers & Warranty Tracker gives every unit its own serial number, records which customer got which unit on which order and date, and keeps the warranty, claims and replacements of each unit in one place.
How it works
Turn on serial tracking for a product and receive stock: product, quantity, manufacture month, lot and supplier reference. Serials are generated from a pattern or scanned with a barcode scanner, and PDF labels print on label rolls or A4 sheets. When you create a shipment, serials are linked to the order lines (or on an order status, or by scanning on the order page). Open a warranty claim on a serial; a replacement swaps in a new unit and keeps the history.
Features
Receive stock: product code, quantity, manufacture month and year, lot and supplier reference on every goods receipt
A unique serial number for every unit, generated from a pattern or scanned / pasted from the factory labels
Printable barcode labels (Code 128 PDF) for label rolls 62 x 29 mm, 50 x 25 mm and A4 sheets of 3 x 8
Serials linked to the order line at dispatch: on shipment creation, on an order status or by scanning on the order page
Works with Orders Admin Pro: assignments and claims are noted on the order timeline
Search a serial number and see when it was sold, on which order and to which customer
Repeat buyers: all units of one customer across many orders, each with its own sale date and warranty
Warranty per product: months, start on the order date, dispatch date or manufacture month
Warranty returns: repair, replacement, refund and inspection claims, linked to return requests
Replacements swap in a new unit and keep the full history of both serial numbers
Customers see their serial numbers and warranties in their account and on the order page
Public warranty check page: serial number in, product and warranty out, no personal data
CSV import and export of serial numbers
All editions: CS-Cart, CS-Cart Ultimate, Multi-Vendor (vendors manage their own units) and Multi-Vendor Ultimate
What you get
Package
kv_serial_warranty-1.0.0.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
For developers
Uses 8 CS-Cart PHP hooks. No core files are changed.
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, Nov 10, 2026Tested on: Multi-Vendor 4.17.2, CS-Cart 4.17.2
Requirements
PHP
CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 – 4.21.x, including 4.18.x (tested on CS-Cart Ultimate 4.17.2 and Multi-Vendor 4.17.2 with PHP 8.1; templates compile with the Smarty versions of 4.18 and 4.21)
PHP
PHP 7.2.5 – 8.3, as supported by your CS-Cart version
Requirement
MySQL/MariaDB with InnoDB
Requirement
Optional: a USB or Bluetooth barcode scanner in keyboard mode (any scanner that types the code and presses Enter), a label printer for 62 x 29 mm or 50 x 25 mm labels, or A4 label sheets with 3 x 8 labels
Core changes
None. Hooks and template overrides only
1.0.0
Nov 10, 2026
Latest
Added 10
Goods receipts with product code, quantity, manufacture month and year, lot and supplier reference.
A unique serial number per unit, generated from a pattern ([SKU], [YYYY], [YY], [MM], [LOT], [SEQ:n]) or scanned / pasted, with duplicate checks.
Barcode labels (Code 128, PDF) for 62 x 29 mm and 50 x 25 mm label rolls and A4 sheets of 3 x 8 labels.
Serial numbers linked to order lines on shipment creation, on chosen order statuses or by scanning on the order page; released when an order is cancelled or deleted.
Warranty per product (months; start on the order date, dispatch date or manufacture month), editable per unit.
Serial register with search by serial number, customer name or e-mail, order, status and warranty state; unit page with sale, receipt, warranty, claims, return requests and history.
Warranty claims (repair, replacement, refund, inspection) linked to core RMA return requests and Returns Portal withdrawals; replacements swap the unit and keep the history.
The replacement unit can be entered while a claim is open and is swapped in when the claim is approved or closed; the order tab keeps replaced and returned units as read-only history.
Customer account page "My serial numbers & warranties", serial numbers on the customer's order page and a public warranty check page.
CSV import and export; Orders Admin Pro order timeline notes; Multi-Vendor vendor access to their own serial numbers.
Tested on Multi-Vendor 4.17.2, CS-Cart 4.17.2. First release.
The factory sticker shows only the manufacture month. How do I tell units apart?
Receive the stock with that month, and the add-on gives each unit its own serial number (for example UV27-4K-2609-00001, …00002). Print the barcode labels and stick one on each unit or box before you ship. From then on every unit can be traced to its order and customer.
A customer has bought the same model many times. Can I find which unit came from which order?
Yes. Search the register by the customer's name or e-mail: every unit is listed with its own order, sale date and warranty end. Scanning the serial number of the unit the customer brings back shows exactly which purchase it belongs to.
Can I use the manufacturer's serial numbers instead?
Yes. Choose Scan or paste when you receive stock and scan the existing barcodes, or import them from CSV. On the order page you can also scan serial numbers that are not in the register yet (tick Add serial numbers that are not in the register yet).
Do serial numbers change the stock of a product?
No. CS-Cart keeps managing the stock quantity. Serial numbers are an extra record of the individual units; if no serial number is in stock when an order ships, the order still ships and the missing units are shown on the order's Serial numbers tab.
Which barcode scanners work?
Any USB or Bluetooth scanner in keyboard mode that types the code and sends Enter. Code 128, Code 39, EAN and QR codes all work as long as the scanner outputs the text.
Which label printers work?
The PDF is made for 62 x 29 mm and 50 x 25 mm label rolls (for example Brother QL or thermal label printers) and for A4 sheets of 3 x 8 labels (70 x 37 mm). Print at 100 % scale.
When does the warranty start?
On the order date by default. Per product or for the whole store you can start it on the dispatch date (when the serial number is linked) or on the first day of the manufacture month. The end date is stored with each unit and can be corrected.
What happens when an order is cancelled or deleted?
Its serial numbers go back to stock (statuses in Order statuses that release serial numbers, Canceled, Declined and Failed by default). Claims are kept.
Does it work with the core RMA add-on and Returns Portal?
Yes. A warranty claim can be linked to a return request of the core RMA add-on or to a withdrawal of the Kavio Labs EU Withdrawal Button & Returns Portal, and the unit page lists the return requests of its order.
Does it work with Orders Admin Pro?
Yes. When the Kavio Labs Orders Admin Pro add-on is active, assignments, releases and claim status changes appear on the order timeline.
Can customers see their serial numbers?
Yes, in My serial numbers & warranties in their account and under each line of the order page (both can be switched off). The public warranty check page shows only the product and the warranty state of a serial number.
Does it work on Multi-Vendor?
Yes. Vendors receive stock, print labels, assign serial numbers to their orders and handle claims for their own products in the vendor panel (setting Vendors manage the serial numbers of their products). The marketplace administrator sees everything.
Does it work with the full page cache of CS-Cart 4.21?
Yes. Customer data is shown only on pages that are never cached.
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), customers no longer see serial numbers and warranties in their account, on order pages or on the warranty check page, serial numbers are no longer assigned automatically and labels cannot be printed; your serial numbers, goods receipts, claims and order assignments stay in the admin panel, where you can still search, edit, assign and export them. Once the license is valid again, everything works again.
The admin panel shows a license notice.
Open Add-ons → Manage add-ons → Serial Numbers & Warranty Tracker → 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.
Add a released add-on to this order and save 15% on it. It uses the same edition and store domain.
Serial Numbers & Warranty TrackerThis add-on
+
Orders Admin ProAn order desk for your team: your columns, SKU and phone search, tags, notes, a customer panel with refund rate, and bulk actions with preview.
$79
+
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
+
Purchase Orders & SuppliersReorder suggestions, purchase orders e-mailed to suppliers and receiving that updates your stock, right in the admin panel.
$69
Buy with confidence
What stands behind your license
Tested builds
This product was tested on these builds. Builds we did not test are not listed.
CS-Cart4.17.2
Multi-Vendor4.17.2owner and vendor panel
12 months of updates
Updates and support are included in the price. The product keeps working afterwards; renewing is optional.