What it does

The EU Deforestation Regulation applies from 30 December 2026; only micro and small operators established by 2024 get until 30 June 2027, traders and downstream operators do not. Operators pass the reference numbers of their due diligence statements to the businesses they supply; downstream operators and traders keep supplier and buyer records for five years. This add-on gives CS-Cart and Multi-Vendor stores one place for these numbers. It does not submit statements and is not legal advice: check your obligations.

How it works

Enter the HS code and the reference and verification numbers on the EUDR tab of a product, per batch if needed. When an order is placed, each relevant line receives the current references. The invoice, the order e-mail and the packing slip print an EUDR table after the products, and the customer sees them on the order page. Correct a line on the admin order page and export buyer, product, reference and supplier per line as CSV.

Features

Relevance by HS / CN code against the built-in Annex I list, by category rule or by hand
Reference number, verification number or declaration identifier per product and batch, or a supplier record when the supplier is not an operator
Missing-reference report for products and orders
References recorded on each order line, editable per order
EUDR table on invoices, order e-mails and packing slips, line on the customer order page
Show to all buyers or to business buyers only
B2B order export and CSV import / export
Multi-Vendor vendor access to own products and orders, Ultimate per-storefront settings
Records kept on uninstall, full page cache safe

What you get

Package	kv_eudr_references-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

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	Tested	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: CS-Cart 4.21.2, Nov 9, 2026Tested on: Multi-Vendor 4.17.2, CS-Cart 4.17.2, CS-Cart 4.21.2

Requirements

Platform	CS-Cart or Multi-Vendor 4.17.2 to 4.21.x (Ultimate and Multi-Vendor editions)
Platform	Tested on CS-Cart 4.17.2 (Ultimate) and Multi-Vendor 4.17.2; templates compiled with the Smarty 5 engine of CS-Cart 4.21.2 (not yet run on a 4.21 store)
Requirement	Administrator access to the store's admin panel
Requirement	No external service, API key or cron job is needed
Core changes	None. Hooks and template overrides only

1.0.0

Nov 9, 2026

Latest

Added 11

Supplier records without a reference number (supplier is not an operator, Article 5(3)(a)); order lines keep a copy of the supplier data.
Ultimate: an administrator working in one storefront sees and exports only that storefront's products and orders.
EUDR relevance per product: by HS / CN code against a built-in Annex I list (Regulation (EU) 2023/1115 as amended by Regulation (EU) 2025/2650 and Delegated Regulation (EU) 2026/2102, checked 2026-11-09), by category rule or by hand.
Due diligence statement reference and verification numbers, or simplified declaration identifiers, per product and batch, with supplier name, address, e-mail and website and a "current" flag.
Missing-reference report for products and orders, with KPI cards and filters.
References recorded on each order line when the order is placed, with an order editor (choose the shipped batch or type a reference).
EUDR table on the order invoice, the order summary (order e-mails) and the packing slip (snippet "EUDR reference numbers" in Design > Documents) and a line on the customer order page; buyer scope "all orders" or "orders with a company name".
B2B order export (buyer, product, quantity, HS code, reference, verification number, batch, supplier) and CSV import / export of product settings and references.
Multi-Vendor: vendors manage their own products and orders; category rules and settings are administrator-only.
Records are kept on uninstall unless "Permanently delete all EUDR reference records on uninstall" is ticked.
Domain-bound licence check and self-healing upgrades.

Tested on Multi-Vendor 4.17.2, CS-Cart 4.17.2, CS-Cart 4.21.2. First release.

Does the add-on submit due diligence statements to the EU?

No. Version 1.0 has no connection to the EUDR Information System (TRACES). You submit statements there (or receive the numbers from your supplier) and enter the numbers in CS-Cart. A connection that submits statements needs the merchant's own EU Login access and is planned as a separate step.

Am I an operator, a downstream operator or a trader?

That depends on your role in the supply chain, and the add-on cannot decide it for you. In short, under Regulation (EU) 2023/1115 as amended by Regulation (EU) 2025/2650: the business that places a relevant product on the EU market first (or exports it) is the operator and submits the due diligence statement; downstream operators and traders collect and keep the information of Article 5(3) for at least five years. The European Commission explains the roles on its EUDR implementation pages. Check your obligations with your competent authority or adviser.

Do I have to show the numbers to consumers?

Consumers are not part of the EUDR supply chain. Operators pass the reference numbers to the downstream operators and traders they supply. Set Show references to buyers on to Only orders with a company name to show them to business buyers only, or keep All orders if you prefer to show them to everyone.

Which dates apply?

The Regulation applies from 30 December 2026. The later date of 30 June 2027 is only for operators (the business that places a relevant product on the EU market first, or exports it) that are natural persons or micro or small undertakings established as such by 31 December 2024, and not for timber products that were covered by the former EU Timber Regulation. Downstream operators and traders, whatever their size, are bound from 30 December 2026: a small web shop that buys relevant products inside the EU and resells them does not get the later date. Entries added to Annex I by Delegated Regulation (EU) 2026/2102 apply from 30 December 2027.

Is leather still in scope?

Delegated Regulation (EU) 2026/2102 removed the cattle hides, skins and leather headings (ex 4101, ex 4104, ex 4107) from Annex I. Printed products of chapter 49 were removed by Regulation (EU) 2025/2650. The built-in list follows both. Live cattle, cattle meat and offal stay in scope.

My supplier does not give me a reference number. What do I record?

Under Article 5(3)(a) a downstream operator or trader keeps the reference number only when its supplier is an operator (the business that placed the product on the EU market first). If you buy from a wholesaler or another trader, keep the supplier's name, postal address, e-mail and website: add a reference of the type Supplier record only. The product then shows "Supplier record on file" instead of "Missing reference", and orders keep the supplier data for your records.

What is the verification number?

The EUDR Information System shows a verification number together with the reference number of each statement. With both, the next business in the chain can find the statement in the system. The add-on stores and prints it next to the reference number; the setting Include the verification number turns it off.

My references change with every delivery. How do I handle that?

Add a reference per batch (field Batch / lot) and keep the batches in stock current. New orders get all current references; on the order you can narrow it down to the batch you shipped. Untick a batch when it is sold out.

A product is made from several commodities. Can it have several references?

Yes. A product can have any number of references, and all current ones are copied to new orders.

Does it work with the full page cache?

Yes. The add-on adds nothing to cached storefront pages. The customer order page is a personal page that is never cached.

What happens to my data when I uninstall?

It is kept, unless you tick Permanently delete all EUDR reference records on uninstall first. Reinstalling continues with the same data and settings.

How is this different from the GPSR add-on?

GPSR Product Safety & EU Guarantee Labels shows product safety information and guarantee notices to every shopper on the product page. EUDR Reference Numbers manages supply-chain reference numbers on orders and business documents. They do not overlap and work side by side.