Import Marketplace Orders into Your ERP Automatically
ERPkit imports orders from Shopify, WooCommerce, and PrestaShop into Dolibarr as draft orders. Customer matching, order deduplication, and shipping rule assignment happen automatically — no manual data entry required.
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. 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, order weight, or both.
When a marketplace order is imported, its shipping address and total weight are evaluated against your shipping rules. Rules are configured in the ERPkit dashboard and can match on country, weight thresholds, or a combination of both. 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 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 variant ID extrafield, 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 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 draft 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. 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.
Stop 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.