ERP migration
Field-level mapping, validation, and rollback between Epicor BisTrack and Dolibarr ERP. We move data and schema; workflows are rebuilt natively in Dolibarr ERP.
Epicor BisTrack
Source
Dolibarr ERP
Destination
Compatibility
11 of 12
objects map 1:1 between Epicor BisTrack and Dolibarr ERP.
Complexity
BStandard
Timeline
4-8 weeks
Overview
Moving from Epicor BisTrack to Dolibarr is an industry-downgrade migration with structural implications. BisTrack is purpose-built for lumber and building materials dealers with native counter sales, kit assembly, special order SKU generation, and delivery dispatch features. Dolibarr is a modular open-source ERP CRM that covers third-parties, products, inventory, commercial proposals, and invoices but requires configuration to approach BisTrack's LBM-specific workflows. We extract BisTrack data via Smart View SQL and the REST API, managing Web Service license throttling to stay within the customer's licensed throughput window. We map the Customer-Vendor-Item core triad to Dolibarr's ThirdParty-Product-Stock structures, preserve the DefaultSKU prefix logic for special orders, extract bin-location inventory into Dolibarr warehouses, and map counter-sale and open-order history. Dolibarr has no native equivalent for BisTrack's kit assembly rules, special order SKU auto-generation, or outside-sales module; we document these gaps in a written gap analysis for the customer's admin to address post-migration. Dashboards, Smart Views, and FTP-based import definitions are not API-exportable and are excluded from migration scope.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Epicor BisTrack object lands in Dolibarr ERP, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Epicor BisTrack
Customer
Dolibarr ERP
ThirdParty (type: Customer)
1:1BisTrack Customer records map to Dolibarr ThirdParty with category set to Customer. Address, contact, pricing tier, and Customer Number fields migrate directly. The Customer Number field is the dedupe key during import; we suppress auto-increment on Dolibarr to preserve BisTrack's numbering sequence where it is meaningful for downstream integrations. Default customer settings that are unset in BisTrack require coordination with the customer during scoping to assign sensible defaults in Dolibarr.
Epicor BisTrack
Vendor
Dolibarr ERP
ThirdParty (type: Supplier)
1:1BisTrack Vendor records map to Dolibarr ThirdParty with category set to Supplier. PO terms, lead times, EDI settings, and vendor-specific pricing tiers preserve. Contact data migrates to Dolibarr contacts attached to the ThirdParty. If a default customer is not set in BisTrack, we coordinate with the customer to define one before vendor import so that cross-reference lookups remain consistent.
Epicor BisTrack
Item
Dolibarr ERP
Product
1:1BisTrack Item master records map to Dolibarr Product with SKU preserved as ref. Description, pricing tiers, and bin location fields migrate to Dolibarr's product fields and custom location fields. Kit assembly rules (BOM structures) migrate to Dolibarr's BOM module if activated; if the BOM module is not active, we document the kit structures in a separate output and the customer activates it post-migration. The Max Description Length setting (default 254 characters) may truncate longer item descriptions; we flag and preserve full text in a custom field during import.
Epicor BisTrack
Sales Order
Dolibarr ERP
Order (Commande)
1:1BisTrack Sales Order headers and lines map to Dolibarr Commande records. Line-level pricing, quantities, and back-referenced Customer and Item lookups migrate directly. Special order SKUs generated using the DefaultSKU prefix (e.g., zz_SOWINDOWS_0001) are captured during extraction and re-imported as product references in Dolibarr; we suppress Dolibarr's auto-SKU generation during this phase to avoid conflicts with the preserved BisTrack SKU pattern.
Epicor BisTrack
Purchase Order
Dolibarr ERP
Supplier Order
1:1BisTrack Purchase Order records export via Smart View SQL and map to Dolibarr CommandeFournisseur. Line items reference Vendor and Item records, so we sequence Vendors and Items before POs to maintain referential integrity. PO status (Draft, Sent, Received, Closed) maps to Dolibarr statuts. Receipt line quantities and partial receipt tracking requires a post-migration reconciliation step if the customer's receiving workflow differs from BisTrack's receiving module.
Epicor BisTrack
Quote
Dolibarr ERP
Proposal (Propal)
1:1BisTrack Quotes accessible via API and the outside sales module map to Dolibarr Propal. Quote status, expiration dates, and conversion history preserve. Quoted line items reference current item pricing; we migrate line items as frozen pricing at the time of quote rather than linking to live product prices. Expiration dates that have passed are flagged for the customer's admin to close or regenerate in Dolibarr.
Epicor BisTrack
Inventory (on-hand)
Dolibarr ERP
Stock
1:1BisTrack inventory levels, bin locations, and on-hand quantities per warehouse export via Smart View SQL and map to Dolibarr Stock. Bin-location sub-structures that BisTrack supports natively require either Dolibarr's multi-warehouse setup with location notes or a third-party stock-location add-on; we configure a standard warehouse structure during migration and document any bin-level data for post-migration configuration.
Epicor BisTrack
Accounts Receivable
Dolibarr ERP
Customer Invoice (Facture client)
1:1BisTrack AR invoices and payment records export via Smart View SQL and map to Dolibarr Facture records. Invoice-to-payment reconciliation is preserved through invoice reference matching. Open invoices migrate with status Open; paid invoices migrate with status Paid and payment records attached. The Dolibarr payment module is activated during schema setup to support the reconciliation workflow.
Epicor BisTrack
Accounts Payable
Dolibarr ERP
Supplier Invoice (Facture fournisseur)
1:1BisTrack AP data including vendor invoices and payment records export via SQL and map to Dolibarr FactureFournisseur records. Duplicate invoice controls native to BisTrack are flagged during import scoping to prevent re-triggering; we document any active duplicate-invoice rules as Dolibarr validation rule equivalents for the admin to configure post-migration.
Epicor BisTrack
Chart of Accounts
Dolibarr ERP
Chart of Accounts
1:1BisTrack GL accounts accessible via Smart View map to Dolibarr's accounting module accounts. Account numbers and hierarchies migrate 1:1. Segment structures such as department cost centers that exist in BisTrack as multi-dimensional accounts may require mapping to Dolibarr's auxiliary account dimensions or a custom accounting configuration; we document the source segment structure during scoping and design the destination chart before import.
Epicor BisTrack
Custom Fields (UD Codes)
Dolibarr ERP
ExtraFields (custom fields)
1:1BisTrack user-defined fields (UD codes) with per-field security settings via Field Security Maintenance extract and map to Dolibarr ExtraFields. We preserve the same access restrictions using Dolibarr's field-level visibility settings per user or group. UDFs referencing dropdown lists map to Dolibarr select or checkbox field types with the same option lists.
Epicor BisTrack
Dashboard / Smart View
Dolibarr ERP
Not migrated (rebuild required)
lossyBisTrack role-based dashboards and Smart View grid configurations are user-built and stored in a non-API-exportable format. We document every active dashboard and Smart View during the pre-migration audit with a description of its purpose, data sources, and filters. The customer rebuilds these in Dolibarr using the exported data dictionary and our field mapping reference. This is standard scope exclusion: dashboards and reports are written to a deliverable document, not migrated as code.
| Epicor BisTrack | Dolibarr ERP | Compatibility | |
|---|---|---|---|
| Customer | ThirdParty (type: Customer)1:1 | Fully supported | |
| Vendor | ThirdParty (type: Supplier)1:1 | Fully supported | |
| Item | Product1:1 | Fully supported | |
| Sales Order | Order (Commande)1:1 | Fully supported | |
| Purchase Order | Supplier Order1:1 | Fully supported | |
| Quote | Proposal (Propal)1:1 | Fully supported | |
| Inventory (on-hand) | Stock1:1 | Fully supported | |
| Accounts Receivable | Customer Invoice (Facture client)1:1 | Mapping required | |
| Accounts Payable | Supplier Invoice (Facture fournisseur)1:1 | Mapping required | |
| Chart of Accounts | Chart of Accounts1:1 | Mapping required | |
| Custom Fields (UD Codes) | ExtraFields (custom fields)1:1 | Fully supported | |
| Dashboard / Smart View | Not migrated (rebuild required)lossy | Fully supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Epicor BisTrack gotchas
Web Service License Throttling Affects API Migration Speed
FTP-Based Import Requires BisTrack-Side Setup
Special Order SKU Generation is Configurable and Must Match
Dashboard and Smart View Configurations Are Not API Exportable
Epicor Cloud Migration Requires Ascend Program Enrollment
Dolibarr ERP gotchas
Foreign key constraint errors on cross-distribution database restore
SQL injection vulnerabilities in version 9.0.1
Custom fields stored as JSON in extraoptions require field-by-field deserialization
Decimal precision and rounding configuration affects price fields
No native iOS/Android app forces reliance on browser
Pair-specific challenges
Migration approach
Discovery and license audit
We audit the source BisTrack environment: user count, Web Service license count, Smart View SQL access, custom UD code definitions, kit assembly structures, active third-party FTP integrations, and counter-sale transaction volume. We pair this with a Dolibarr hosting assessment (self-hosted VPS, shared hosting, or managed cloud) to determine PHP execution time limits and MySQL connection constraints that affect migration throughput. The discovery output is a written scope document covering record counts per object, identified gotchas, and a Dolibarr module activation plan.
Smart View SQL extraction and transformation design
We design the SQL extraction queries for Smart View exports covering Customers, Vendors, Items, Sales Orders, Purchase Orders, Quotes, AR/AP history, inventory on-hand, bin locations, and GL account structure. We build the transformation layer in our migration adapter to handle the DefaultSKU prefix logic, null-handling for unset defaults, and date-format normalization. Custom UD code extraction queries are parameterized per field with field security flags preserved. All extraction queries are validated against a test export before full data extraction begins.
Dolibarr schema setup and module activation
We set up the Dolibarr instance: activate required modules (ThirdParties, Products, Stock, Orders, Proposals, Invoices, Supplier Invoices, Accounting, BOM if applicable), configure warehouse structures, set up user accounts and permissions, and define the chart of accounts. Custom ExtraFields matching BisTrack UD codes are created before any data import. The migration adapter's Dolibarr API credentials are scoped to the minimum required permissions (create, read) to limit write risk during extraction.
Sandbox migration and reconciliation
We run a full migration into a Dolibarr test instance using production-like data volume. The customer's team reconciles record counts (ThirdParties in, Products in, Orders in, Stock levels), spot-checks 25-50 records against the BisTrack source, and reviews the bin-location mapping and kit BOM reconstruction plan. Any mapping corrections, SKU conflicts, or BOM gaps are resolved here. Sign-off on the sandbox migration gates the production cutover date.
Production migration in dependency order
We run production migration in record-dependency order: ThirdParties (Vendors first, then Customers), Products (Items with kit structures flagged separately), Stock (on-hand levels with bin locations preserved in custom fields), Purchase Orders, Sales Orders, Quotes, AR/AP history, and GL transactions. Each phase emits a row-count reconciliation report. Special order SKUs are loaded after products with auto-generation suppressed. Counter-sale transaction history is migrated as a final phase with timestamps preserved for audit continuity.
Cutover, gap analysis delivery, and rebuild handoff
We freeze BisTrack writes during cutover, run a final delta migration of any records modified during the migration window, then switch the customer's team to Dolibarr as the system of record. We deliver the dashboard and Smart View inventory document, the kit BOM reconstruction guide, the bin-location warehouse structuring plan, the third-party FTP integration redirect checklist, and the UD code ExtraField reference. We support a one-week hypercare window for reconciliation issues. We do not rebuild automations, workflows, or FTP import definitions as those are scope exclusions requiring separate admin work.
Platform deep dives
Epicor BisTrack
Source
Strengths
Weaknesses
Dolibarr ERP
Destination
Strengths
Weaknesses
Complexity grading
Standard ERP migration. 3 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Epicor BisTrack and Dolibarr ERP.
Object compatibility
3 of 8 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
8-object category — typical timelines run 2–7 days end-to-end.
API constraints
Epicor BisTrack: Not publicly documented; Web Service license exhaustion causes exponential backoff.
Data volume sensitivity
Epicor BisTrack doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Epicor BisTrack to Dolibarr ERP migration scoping. Not seeing yours? Book a call.
Walk through your Epicor BisTrack to Dolibarr ERP migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Epicor BisTrack
Other ways to arrive at Dolibarr ERP
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.