Import Marketplace Orders into Your ERP Automatically
ERPkit imports orders from Shopify, WooCommerce, PrestaShop, eBay, Cdiscount, Leroy Merlin, Bricoman (now Tecnomat), Castorama, and Vente-unique into Dolibarr as validated sales orders. Customer matching, order deduplication, and shipping rule assignment happen automatically, with no manual data entry.
How Order Import Works
Every order import follows a reliable three-step process: detect new orders, match the customer, and create the order in Dolibarr with all line items and shipping details.
Order Detection
ERPkit queries your marketplace API for orders that have not yet been imported. It checks each order against Dolibarr's ref_ext field to determine whether it has already been processed. New orders proceed to import; existing orders are silently skipped.
Customer Matching
For each new order, ERPkit looks up the customer's email address in Dolibarr's third-party records, or the buyer's marketplace account on Leroy Merlin, Bricoman, Castorama, and Vente-unique. If a match is found, the order is linked to the existing customer. If no match exists, ERPkit creates a new third-party record using the name, email, and address from the marketplace order.
Deduplication via ref_ext
Each imported order gets a unique external reference stored in Dolibarr's ref_ext field. This reference includes the marketplace name, store URL, and order ID. Because ref_ext is checked before every import, running the same import multiple times is completely safe — duplicates are impossible.
Configurable Shipping Rules
ERPkit lets you define rules that automatically assign the correct carrier and shipping method to imported orders based on the destination country, the order total, the number of items, or, on Shopify, the order weight.
When a marketplace order is imported, its shipping address, total, and item count are evaluated against your shipping rules, and so is its total weight on Shopify, whose orders carry one. Rules are configured in the ERPkit dashboard and can match on any combination of these. When a rule matches, the corresponding Dolibarr transporter is assigned to the order automatically.
For example, you might set a rule that assigns Colissimo to all orders shipping to France, DHL Express to Shopify orders over 30 kg shipping to Germany, and a flat-rate postal service for everything else. Rules are evaluated in priority order, and the first match wins.
Without shipping rules, imported orders arrive in Dolibarr without a carrier assigned. You can still assign carriers manually, but the rules feature eliminates that step for predictable shipping scenarios. This is especially valuable for merchants processing hundreds of orders per day across multiple countries.
What Gets Imported
ERPkit captures everything you need to process an order in Dolibarr. Nothing is left behind on the marketplace.
Line Items & Prices
Every line item from the marketplace order is created in Dolibarr with the correct product reference, quantity, unit price, and applicable discounts. Products are matched by their marketplace link (the variant ID extrafield, or your Dolibarr reference on marketplaces that sell by SKU), so Dolibarr knows exactly which product was ordered.
Customer Data
Customer name, email, phone number, and company name (if provided) are imported. ERPkit matches by email first, or by marketplace account on Leroy Merlin, Bricoman, Castorama, and Vente-unique, to avoid duplicate customer records, and creates a new third-party only when no match is found.
Shipping Address
The full shipping address from the marketplace order is carried over to the Dolibarr order. Street, city, postal code, country, and state/province are all mapped to the corresponding Dolibarr fields.
Order Metadata
The marketplace order number is stored in Dolibarr's ref_client field for easy reference. The full external reference (marketplace, store, order ID) is stored in ref_ext for deduplication and traceability.
Order Import Is Part of Every Plan
Order Import is included in the Core Bundle alongside Product Sync and Invoice Creation. These three phases cover the essential sync pipeline and are included in every ERPkit subscription. See Pricing for plan details.
Frequently Asked Questions
Are orders imported automatically?
Yes. Order imports run automatically based on your subscription tier's sync interval. You can also trigger a manual import from the dashboard at any time. Each import fetches new orders from your marketplace and creates them as validated sales orders in Dolibarr. Orders already imported are automatically skipped, so imports never create duplicates.
How does customer matching work?
ERPkit matches customers by email address. If a Dolibarr third-party record with the same email already exists, the order is linked to that record. On Leroy Merlin, Bricoman, Castorama, and Vente-unique, where the buyer's email changes from one order to the next, it matches on the buyer's marketplace account instead. If no match is found, a new third-party is created from the marketplace order data.
What happens with duplicate orders?
Duplicates are impossible. Each order gets a unique external reference in Dolibarr's ref_ext field. Before importing, ERPkit checks whether that reference already exists. If it does, the order is skipped. This makes imports fully idempotent.
Other Sync Phases
Order Import is one of five phases in the ERPkit sync pipeline. Explore the other phases below.
Product Sync
Push prices and stock from Dolibarr to your marketplaces, plus weight and barcode where the marketplace accepts them.
Learn moreStop Re-Typing Marketplace Orders
Order Import is included in the Core Bundle. Every marketplace order lands in Dolibarr with the correct customer, products, and shipping method.