ERP migration

Migrate from Epicor BisTrack to Dolibarr ERP

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 logo

Epicor BisTrack

Source

Dolibarr ERP

Destination

Dolibarr ERP logo

Compatibility

92%

11 of 12

objects map 1:1 between Epicor BisTrack and Dolibarr ERP.

Complexity

BStandard

Timeline

4-8 weeks

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

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.

Field-level fidelity

Every standard and custom field arrives verified.

Schema-aware mapping

AI proposes the map; you confirm before any record moves.

Relationships preserved

Parent–child, lookups, and ownership stay linked.

Full activity history

Calls, emails, meetings — with original timestamps.

Attachments & notes

Documents, uploads, and inline notes move with the record.

Why teams make this switch

Two sides of the same decision

Leaving

Epicor BisTrack logo

Epicor BisTrack

What's pushing teams away

  • Speed and performance lag, especially during high-volume counter-sale periods or large data-entry sessions, frustrates users who need fast transaction throughput.
  • The system freezes or hangs regularly, forcing users to restart the application—a friction point noted across multiple reviews for accounts payable and daily operational use.
  • Steep learning curve and complex navigation require significant training investment, and knowledge is concentrated in a few power users who configured the system.
  • Customer service quality is inconsistent—support responsiveness and resolution quality depend heavily on whether the customer is on a monthly payment plan.
  • Organizational instability at Epicor's executive level and uncertainty around the company's direction has made some customers hesitant to continue investing in the platform.

Choosing

Dolibarr ERP logo

Dolibarr ERP

What's pulling them in

  • Free open-source core with no per-user license fee makes it the lowest-cost entry point for small teams needing ERP and CRM in one package.
  • Self-hosted deployment gives full data ownership and eliminates vendor lock-in, especially attractive to businesses with compliance requirements.
  • Modular architecture means teams enable only the features they use, keeping the interface uncluttered and reducing learning curve.
  • Fast installation with no technical knowledge required — one reviewer set up multiple businesses in minutes using their own hosting.
  • Active community forum and marketplace of third-party add-ons provide support and extension options without mandatory subscription costs.

Object mapping

How Epicor BisTrack objects map to Dolibarr ERP

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

maps to

Dolibarr ERP

ThirdParty (type: Customer)

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

ThirdParty (type: Supplier)

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Product

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Order (Commande)

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Supplier Order

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Proposal (Propal)

1:1
Fully supported

BisTrack 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)

maps to

Dolibarr ERP

Stock

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Customer Invoice (Facture client)

1:1
Mapping required

BisTrack 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

maps to

Dolibarr ERP

Supplier Invoice (Facture fournisseur)

1:1
Mapping required

BisTrack 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

maps to

Dolibarr ERP

Chart of Accounts

1:1
Mapping required

BisTrack 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)

maps to

Dolibarr ERP

ExtraFields (custom fields)

1:1
Fully supported

BisTrack 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

maps to

Dolibarr ERP

Not migrated (rebuild required)

lossy
Fully supported

BisTrack 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.

Gotchas + challenges

What specifically takes care here

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 logo

Epicor BisTrack gotchas

High

Web Service License Throttling Affects API Migration Speed

High

FTP-Based Import Requires BisTrack-Side Setup

Medium

Special Order SKU Generation is Configurable and Must Match

Medium

Dashboard and Smart View Configurations Are Not API Exportable

Low

Epicor Cloud Migration Requires Ascend Program Enrollment

Dolibarr ERP logo

Dolibarr ERP gotchas

High

Foreign key constraint errors on cross-distribution database restore

High

SQL injection vulnerabilities in version 9.0.1

Medium

Custom fields stored as JSON in extraoptions require field-by-field deserialization

Medium

Decimal precision and rounding configuration affects price fields

Low

No native iOS/Android app forces reliance on browser

Pair-specific challenges

  • Web Service License Throttling Limits Extraction Throughput

    BisTrack licenses Web Service seats separately from named-user seats. When Web Service licenses are exhausted, API response times double incrementally, degrading migration throughput unpredictably during large record imports. We request a count of available Web Service licenses during scoping, throttle our API calls to stay within the licensed window, and coordinate with the customer to temporarily increase Web Service seats before high-volume extraction phases if the timeline permits. Without this scoping step, extraction can silently slow to a fraction of expected throughput mid-migration.

  • Special Order SKU Pattern Conflicts with Dolibarr Auto-Generation

    BisTrack generates special order SKUs using a configurable DefaultSKU prefix pattern (e.g., zz_SOWINDOWS_0001). If Dolibarr's product reference auto-generation is active during import, it will generate conflicting SKUs for the same items. We suppress Dolibarr's auto-generation during the import phase, preserve the original BisTrack SKU pattern in the product ref field, and document the configuration change for the customer's admin to review post-migration. Skipping this step results in SKU duplicates that break downstream order line references.

  • Bin-Location Inventory Requires Post-Migration Warehouse Structuring

    BisTrack stores inventory at the bin-location level within warehouses (e.g., BIN-A-12-3). Dolibarr's native stock module uses warehouse-level locations without built-in bin sub-location tracking. Bin-level data extracted from BisTrack cannot map directly to Dolibarr's standard stock table without either activating a third-party bin-location add-on module or structuring Dolibarr warehouses to mirror BisTrack's location hierarchy. We preserve full bin-location data in a custom field during import and document the recommended warehouse structuring for the customer's admin to implement.

  • Kit Assembly Rules Require Manual BOM Reconstruction

    BisTrack's kit assembly rules with BOM pricing and component substitution logic have no direct Dolibarr equivalent in the standard migration scope. Dolibarr's BOM module exists but requires activation and manual configuration of assembly structures. We extract kit definitions from BisTrack during the pre-migration audit, document each kit's components and pricing rules in a BOM reconstruction guide, and flag which kits are currently active in open orders versus which are historical. The customer's admin rebuilds BOMs in Dolibarr using this guide as the reference.

  • FTP-Based eBusiness Imports Require BisTrack-Side Configuration

    Third-party integrations that push quotes and orders into BisTrack via the FTP process within eBusiness require BisTrack-side import definition setup. The integration partner (e.g., SaberisConnect) cannot self-service this configuration. If the customer has active third-party integrations feeding BisTrack via FTP, we flag these during scoping, document the integration endpoints, and recommend the customer coordinate with their integration partner to redirect feeds to Dolibarr or rebuild the import process post-migration. Data already in BisTrack via FTP import migrates normally through our SQL extraction.

Migration approach

Six steps for a successful Epicor BisTrack to Dolibarr ERP data migration

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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

Context on both ends of the pair

Epicor BisTrack logo

Epicor BisTrack

Source

Strengths

  • Industry-specific ERP built natively for LBM dealers—no vertical configuration required for counter sales, special orders, or kit pricing.
  • Centralized data eliminates duplicate tracking between in-store POS and online sales channels.
  • Smart View SQL access provides direct data extraction without relying on canned reports or developer support.
  • Browser-based interface supports remote and mobile access for outside sales representatives.
  • Automation Studio powered by Workato offers 2,000+ pre-built connectors for integrating BisTrack with external platforms.

Weaknesses

  • Performance lags under high-volume data entry or large transaction loads, requiring users to restart the application.
  • No publicly documented pricing tiers—quotes are provided on request, complicating budget planning for migrations.
  • Steep learning curve and complex navigation mean new users and administrators require significant training time.
  • Web Service license gating can throttle API response times, affecting automated migration throughput.
  • Epicor corporate stability concerns (leadership turnover, ownership changes) have created uncertainty for long-term customers.
Dolibarr ERP logo

Dolibarr ERP

Destination

Strengths

  • Free core software with AGPL license and no per-user mandatory fee for self-hosted deployments.
  • Modular architecture lets teams activate only needed features, keeping the interface focused and the database lean.
  • Self-hosted option provides full data sovereignty and avoids recurring SaaS subscription costs.
  • Built-in CSV/Excel import and export wizard with saved profiles simplifies recurring data operations.
  • Low-code Module Builder allows functional extensions without writing PHP code.

Weaknesses

  • No native documented REST API for programmatic bulk operations — all migrations depend on the import/export wizard or direct database access.
  • Reporting and analytics are weak without paid add-ons, and built-in charts are limited compared to modern SaaS platforms.
  • UI design is described as dated by multiple reviewers, with infrequent visual updates to the default theme.
  • Community-only support for self-hosted deployments means no SLA or guaranteed response time for issues.
  • Security vulnerabilities (CVE-2024-5314, CVE-2024-5315) in version 9.0.1 with no immediate patch reported.

Complexity grading

How hard is this migration?

Standard ERP migration. 3 of 8 objects need a mapping; the rest are 1:1.

B

Overall complexity

Standard migration

Derived from compatibility, mapping clarity, API constraints, and data volume across Epicor BisTrack and Dolibarr ERP.

  • Object compatibility

    B

    3 of 8 objects need a mapping; the rest are 1:1.

  • Field mapping clarity

    C

    Field mapping is derived from defaults — final spec confirmed during the sample migration.

  • Timeline complexity

    B

    8-object category — typical timelines run 2–7 days end-to-end.

  • API constraints

    B

    Epicor BisTrack: Not publicly documented; Web Service license exhaustion causes exponential backoff.

  • Data volume sensitivity

    B

    Epicor BisTrack doesn't expose a bulk API — REST + parallelization used for high-volume runs.

Estimator

Estimate your Epicor BisTrack to Dolibarr ERP migration cost

Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.

Step 1

What are you migrating?

Pick a category, then your source and destination platforms.

Category

FAQ

Frequently asked questions about Epicor BisTrack to Dolibarr ERP data migrations

Answers to the questions buyers ask most during Epicor BisTrack to Dolibarr ERP migration scoping. Not seeing yours? Book a call.

Can't find your answer?

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 consultation

Most migrations land between four and eight weeks for accounts under 10,000 customers, 5,000 items, and 2,000 open orders with straightforward inventory structures. Migrations with large inventory histories (50,000+ stock movements), complex bin-location structures, active kit assembly rules, or extensive counter-sale transaction archives move to ten to eighteen weeks because of SKU conflict resolution, BOM reconstruction documentation, and multi-phase inventory sequencing. The Dolibarr module activation and configuration phase adds one to two weeks on top of data migration time.

Adjacent paths

Related migrations to explore

Ready when you are

Move from Epicor BisTrack.
Land in Dolibarr ERP, intact.

Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.

Accuracy guarantee Rollback included Quote in 1 business day