EUDR Reference Numbers
Edition: CS-Cart & Multi-Vendor · Latest version: 1.0.0 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view
Keeps the reference numbers of EU Deforestation Regulation (EUDR) due diligence statements for each product and batch, records them on every order line of a relevant product, and prints them on invoices, packing slips, order e-mails and the order page. A report shows relevant products that still have no reference, and the B2B export lists buyer, product, reference and supplier for each order line.
Why it matters
Section titled “Why it matters”Regulation (EU) 2023/1115 (EUDR), as amended by Regulation (EU) 2025/2650, applies from 30 December 2026. Only operators that are natural persons or micro or small undertakings established as such by 31 December 2024 get until 30 June 2027 (Article 38(3)); this later date does not apply to timber products that were covered by the old EU Timber Regulation. Downstream operators and traders of every size, including micro and small shops, are bound from 30 December 2026. It covers cattle, cocoa, coffee, oil palm, rubber, soya and wood and the products listed in its Annex I, for example chocolate, coffee, wooden furniture, paper, tyres and many palm-oil derivatives.
In the supply chain the numbers travel with the goods:
- An operator (who places a relevant product on the EU market first, or exports it) submits a due diligence statement in the EUDR Information System and passes its reference number (or, for micro and small primary operators, the declaration identifier) to the businesses it supplies (Article 4(7)).
- Downstream operators and traders collect and keep, for at least five years, the contact data of their suppliers and of the businesses they supply, and, where the supplier is an operator, the reference numbers of the statements (Article 5(3) and (4)).
The add-on gives you one place for these numbers in CS-Cart and puts them on the documents your business buyers receive. Consumers are not part of the EUDR supply chain; you choose whether references appear on all orders or only on orders with a company name.
What it does
Section titled “What it does”- Relevant products. Mark products by HS / CN code (the built-in Annex I list, updated with Delegated Regulation (EU) 2026/2102), by category rule or by hand.
- Supplier records without a reference. When your supplier is a trader or downstream operator, no reference number is passed on to you: keep a supplier record (name, address, e-mail, website) instead, which counts as “on file”.
- References per product and batch. Due diligence statement reference number and verification number, or the declaration identifier of a micro or small primary operator; batch / lot, supplier name, address, e-mail and website, date received, and which references are current.
- Missing-reference report. Relevant products without a current reference, products whose HS code needs a closer look, and orders that left without a reference.
- Recorded on the order. Each order line keeps a copy of the references that applied when the order was placed. You can correct it on the order, for example to name the batch that was shipped.
- On the documents. A small “EUDR due diligence references” table on the invoice, the order summary used by the order e-mails and the packing slip (Design > Documents), and a line under each product on the customer order page.
- B2B export and CSV import / export. One CSV line per order line with buyer, product, quantity, HS code, reference, verification number, batch and supplier; bulk import of HS codes and references.
- Multi-Vendor. Vendors manage the references of their own products and orders; the marketplace owner keeps the category rules.
- Records survive uninstall. The data is kept when the add-on is uninstalled, unless you tick “Permanently delete all EUDR reference records on uninstall”.
What it does not do
Section titled “What it does not do”- Version 1.0 does not connect to the EUDR Information System (TRACES): it does not submit, check or download due diligence statements. You enter the numbers you received or the system issued to you.
- It does not decide whether you are an operator, downstream operator or trader, or whether a product is in scope. The Annex I list is a helper. Check your obligations under the Regulation with your competent authority or adviser. This is not legal advice.
Compatibility
Section titled “Compatibility”- CS-Cart and Multi-Vendor 4.17.2 to 4.21.x, Ultimate and Multi-Vendor editions (see the changelog for the stores it was tested on).
- PHP 7.4 to 8.3, depending on your CS-Cart version.
- Works with the full page cache: nothing is added to cached storefront pages.