Installation

Requirements

• CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 to 4.21.x.
• PHP 7.4 to 8.3 with the curl, dom, libxml, openssl, mbstring and zlib extensions (all standard). zip is needed for the ZIP download only.
• Outgoing HTTPS from the server to your platform.
• A cron job (every 5 to 15 minutes) for sending, reading statuses and e-reporting.
• An account at an accredited platform (plateforme agréée) of your choice. SUPER PDP is connected through its API; other platforms through the AFNOR Flow API when they offer it; otherwise you upload the files in the platform’s portal.

Install

1. Go to Add-ons > Manage add-ons, upload the package and install France E-Invoicing.
2. Enter your license key in the add-on settings (License tab).
3. Open Orders > French e-invoicing and complete the Seller identity and the Platform connection (see Configuration).
4. Set up the cron job shown in the settings (Queue and log):

*/10 * * * * php /path/to/store/admin.php --dispatch=kv_fr_e_invoicing.cron

or call the secret URL shown there from an external cron service.

Installing creates two optional customer profile fields at checkout and in the profile: SIREN / SIRET (French companies) and, when no VAT field of another add-on exists, VAT ID. A buyer who enters a valid SIREN gets a domestic B2B e-invoice; other buyers are B2C sales for the e-reporting.

Privileges

Administrators need View orders to see the documents and Edit orders to create invoices and credit notes; the seller identity, connection, queue and log need the settings privileges. Vendors (Multi-Vendor) see only their own documents; they act on them only when vendors are the seller of record (see Configuration).

Upgrade

Upload the new version over the old one (or use the Upgrade Center). The add-on finishes the upgrade itself on the next admin page view (new tables, settings and texts); your documents, numbering and connection stay.

Uninstall

Invoices are legal records: French law requires you to keep them (10 years, Code de commerce L123-22) and never to reuse a number. So uninstalling keeps the add-on’s data by default: the invoices and credit notes with their Factur-X files and statuses, the e-reporting history, the number series, the seller identity, the platform connection and the settings (including the license key). Only the checkout fields for the buyer’s SIREN / VAT ID are removed from the customer profiles; the issued documents keep the buyer identifiers.

Installing the add-on again picks everything up: the settings come back and the numbering continues where it stopped, without duplicates. Uninstall + install is also a safe way to reinstall or upgrade.

To delete all data for good (for example on a test store), first download what you must keep (Download PDFs (ZIP) on the documents page and the XML files you need), then tick Permanently delete all invoice data on uninstall in the add-on settings, save, and uninstall. If the add-on is already uninstalled, install it, tick the setting and uninstall again. Upgrades never uninstall.