ERP migration

Migrate from Decision Builder to Dolibarr ERP

Field-level mapping, validation, and rollback between Decision Builder and Dolibarr ERP. We move data and schema; workflows are rebuilt natively in Dolibarr ERP.

Decision Builder logo

Decision Builder

Source

Dolibarr ERP

Destination

Dolibarr ERP logo

Compatibility

67%

8 of 12

objects map 1:1 between Decision Builder and Dolibarr ERP.

Complexity

CModerate

Timeline

5-8 weeks

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

Moving from Decision Builder to Dolibarr is a cross-platform ERP migration constrained by Decision Builder's lack of a documented migration API and its proprietary .dec.obj export format. Decision Builder organizes business data around Data Structures and Projects, storing custom logic in rule flows and workflows; Dolibarr uses a modular architecture with Third Parties (merging customers and suppliers), Products, and Projects as separate modules. We extract records using the appropriate export method per object type, convert .dec.obj files to intermediate formats for schema translation, and map chart-of-accounts segments to Dolibarr's flexible account framework. Open AP/AR invoices, credit memos, and payment records migrate cleanly. Workflows, rule flows, and automations do not migrate as code; we deliver a written inventory of every active rule flow and workflow for the customer's admin to rebuild in Dolibarr's modular configuration layer.

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

Decision Builder logo

Decision Builder

What's pushing teams away

  • Limited documentation makes it difficult for new team members to learn the platform and for existing users to resolve advanced configuration problems.
  • Poor upgrade path for .NET compatibility creates frustration during version transitions and limits access to newer framework features.
  • Lack of comprehensive documentation means teams spend excessive time experimenting with features rather than applying them directly to business needs.
  • The platform's age means some integrations with modern SaaS tools require custom development that newer ERP platforms provide out of the box.

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 Decision Builder objects map to Dolibarr ERP

Each row shows how a Decision Builder 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.

Decision Builder

Customer

maps to

Dolibarr ERP

Third Party (customer type)

1:1
Fully supported

Decision Builder Customer records map to Dolibarr Third Party objects with Type = Customer. We preserve all contact details, customer-specific pricing tiers, and associated hierarchies. Dolibarr uses a single Third Party object for customers, prospects, and suppliers differentiated by the Client/Supplier checkboxes, so multi-type entities require separate Third Party records or the Multi-contact module.

Decision Builder

Vendor

maps to

Dolibarr ERP

Third Party (supplier type)

1:1
Fully supported

Decision Builder Vendor records map to Dolibarr Third Party objects with Type = Supplier. We preserve payment terms, tax IDs, and address information. Dolibarr's Supplier module must be activated in Dolibarr's module configuration before vendor records import. Address formats require normalization because Decision Builder and Dolibarr use different field structures for address lines.

Decision Builder

Item

maps to

Dolibarr ERP

Product or Service

1:1
Fully supported

Decision Builder Item records (inventory products, services, non-inventory items) map to Dolibarr Product records with type flagged as Product, Service, or stock-enabled based on Decision Builder item type. We map item pricing, unit of measure, and bill of materials structures. Multi-level BOMs require decomposition into Dolibarr's multi-level BOM model or simplification depending on Dolibarr's installed modules.

Decision Builder

Open AP/AR

maps to

Dolibarr ERP

Invoice, Credit Note, and Payment

1:1
Fully supported

Open invoices, credit memos, and payment records export cleanly from Decision Builder. We preserve document numbers, dates, amounts, aging information, and payment terms. In Dolibarr, open invoices map to Facture (Customer) or Supplier Facture (Vendor), credit memos map to Credit Note, and payments map to Payment records linked via PaiementFacture junction table. Post-migration reconciliation closes the loop between open items and their payments.

Decision Builder

Historical Transactions

maps to

Dolibarr ERP

Invoice History and Journal Entries

1:1
Mapping required

Invoice history, payment records, and adjustment logs migrate with full audit trails preserved in record comments or custom fields. Journal entries require mapping to Dolibarr's chart of accounts which uses a different account numbering scheme than Decision Builder. We run a pre-migration account mapping session to align source and destination account frameworks before journal records are inserted.

Decision Builder

Chart of Accounts

maps to

Dolibarr ERP

Bank Accounts and Accounting Account

lossy
Mapping required

Decision Builder's account structures including segment definitions, account types, and rollup hierarchies require pre-migration mapping to Dolibarr's Accounting Account objects. Dolibarr's accounting module must be enabled and configured before account import. We recommend mapping the top-level account segments first and handling detail accounts in subsequent phases based on transaction volume.

Decision Builder

Data Structures

maps to

Dolibarr ERP

Custom fields or custom tables

lossy
Mapping required

Custom Data Structures in Decision Builder store business-specific data that does not map directly to standard Dolibarr objects. We assess each Data Structure during scoping: simple flat structures with no interdependencies migrate via CSV to Dolibarr custom fields; complex structures with relationships require Project-level .dec.obj export converted to Dolibarr custom object format or stored as JSON in a custom text field pending module development.

Decision Builder

Project

maps to

Dolibarr ERP

Project

1:1
Fully supported

Decision Builder Projects bundle related Data Structures, workflows, and configurations. Project-level export (.dec.obj) preserves context that individual object export cannot. We map Decision Builder Project records to Dolibarr Project objects, including dates, status, description, and linked third parties. Note that Dolibarr's Project module must be activated in module configuration before import.

Decision Builder

Documents

maps to

Dolibarr ERP

Documents attached to parent records

1:1
Mapping required

Attached documents and files migrate alongside their parent records (Third Parties, Products, Projects, Invoices). We verify file integrity after transfer and flag any documents that reference objects not included in the migration scope. Dolibarr stores documents in the /documents/ directory with references in the database; we map the file paths accordingly during import.

Decision Builder

Users

maps to

Dolibarr ERP

User

1:1
Mapping required

Decision Builder user accounts and role assignments require mapping to Dolibarr's permission model. Dolibarr's User module handles internal users; external contacts use the Third Party contact model. Active versus inactive status transfers, but login credentials do not migrate for security reasons. Dolibarr's permission system (global permissions, per-module permissions, and per-entity permissions) differs significantly from Decision Builder's role model and requires a separate permission mapping session.

Decision Builder

Rule Flows

maps to

Dolibarr ERP

No direct equivalent

lossy
Fully supported

Decision Builder rule flows encode business logic that has no automatic migration path to Dolibarr. We document every active rule flow with its trigger conditions, field evaluations, and resulting actions as a written specification for the customer's admin to configure in Dolibarr's module-based workflow layer or via custom module development. This is a rebuild scope, not a data migration.

Decision Builder

Workflows

maps to

Dolibarr ERP

No direct equivalent

lossy
Fully supported

Decision Builder workflows encode multi-step approval and routing logic. Dolibarr does not have a native workflow engine at the core level; workflow automation requires third-party modules or custom development. We deliver a written inventory of every active workflow including its steps, conditions, assignees, and escalation paths so the customer's admin can evaluate Dolibarr workflow modules or commission custom development. This is an admin rebuild scope outside standard data migration.

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.

Decision Builder logo

Decision Builder gotchas

High

Complex Data Structures require Project-level export

Medium

Advanced decision table rows are read-only in Excel export

High

No publicly documented migration API or bulk export endpoint

Medium

Data Structure export format creates vendor lock-in

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

  • Complex Data Structures require Project-level export or manual handling

    Decision Builder's platform documentation explicitly warns that Data Structures with complex relationships cannot always be exported individually. Due to varying complexity handling across data types, we assess each Data Structure during scoping and recommend Project-level export (.dec.obj) for anything with interdependent relationships. Individual data export via Excel is only viable for simple, flat structures. Failure to use the correct export method results in orphaned records and broken relationships in Dolibarr. The .dec.obj format requires conversion to intermediate formats before Dolibarr import, adding processing time and validation overhead.

  • .dec.obj export format requires format conversion for Dolibarr

    The .dec.obj export format is proprietary to Decision Builder and cannot be imported directly into Dolibarr. We convert .dec.obj exports to intermediate formats during migration, which adds processing time and requires validation to ensure all fields and relationships survive the format conversion. We test sample records in Dolibarr before running the full migration to catch any data loss in the conversion layer. This conversion step adds one to two weeks to the discovery phase for migrations with complex Data Structures.

  • No publicly documented migration API or bulk export endpoint in Decision Builder

    Decision Builder does not expose a documented API endpoint for bulk data extraction. Data export relies on the platform UI for simple records and .dec.obj file generation for complex structures. We work within these constraints by sequencing exports to avoid timeout scenarios and by using the appropriate export method (individual versus Project-level) based on data complexity. Migration projects from Decision Builder require longer discovery phases compared to platforms with open APIs to map out the correct export strategy and validate data completeness before building the Dolibarr import pipeline.

  • Dolibarr accounting module requires explicit activation and configuration

    Dolibarr's accounting features are not enabled by default; the customer must activate the accounting module in Setup > Modules before chart of accounts and invoice migration can proceed. If the accounting module is not active, open AP/AR invoices still migrate as commercial documents but do not generate accounting entries. We configure the accounting module during the Dolibarr setup phase and coordinate account mapping before financial records are inserted. Migrations that skip this step result in invoices without proper general ledger impact.

  • Dolibarr custom field transfer between Proposal and Order requires module

    Dolibarr community forums document that transferring custom fields from Proposal (Quote) to Order (Sales Order) is not native functionality without a custom module or third-party addon. If Decision Builder's sales workflow relies on custom fields that carry forward between quote and order stages, those fields must be manually re-entered in Dolibarr or a custom module must be commissioned. We identify any Quote-to-Order custom field dependencies during discovery and document them as post-migration configuration tasks.

Migration approach

Six steps for a successful Decision Builder to Dolibarr ERP data migration

  1. Discovery and export strategy assessment

    We audit Decision Builder across every object type: customer and vendor counts, item catalog size and BOM complexity, open invoice volume, historical transaction range, chart of accounts segment structure, Data Structure count and relationship complexity, active projects, and attached document volume. We assess each Data Structure for flat-versus-complex classification to determine individual Excel export versus Project-level .dec.obj export. The discovery output is a written migration scope document specifying the export method per object, the .dec.obj conversion plan for complex structures, and the Dolibarr module activation checklist before import begins.

  2. Dolibarr environment setup and module activation

    We configure the target Dolibarr instance with all modules required for migration scope: Third Party (for customer and supplier import), Products, Stocks, Projects, Invoices, and the Accounting module if financial records are in scope. We set up the Dolibarr mass import tool profiles for each object type and validate the CSV import templates. If custom Data Structures require Dolibarr custom fields or modules, we create those before record import begins. The customer's admin receives a Dolibarr setup checklist with required module activations and permissions configuration.

  3. Chart of accounts mapping and account creation

    We run a pre-migration account mapping session to align Decision Builder's account numbering and segment structure with Dolibarr's accounting framework. Decision Builder's account segments map to Dolibarr Accounting Account objects with corresponding third-dimension analysis if applicable. We create the account framework in Dolibarr before any financial records (invoices, payments, journal entries) are imported to ensure all foreign keys are satisfied at insert time. This phase includes validation of at least one test account per segment type.

  4. Export extraction and .dec.obj conversion

    We execute the export strategy from Decision Builder: flat Data Structures via individual Excel export, complex Data Structures via Project-level .dec.obj export. For .dec.obj exports, we run the conversion process to intermediate format and validate field completeness against a sampling of Decision Builder records. Any Data Structures that cannot export cleanly are flagged and escalated to the customer's Decision Builder administrator for manual data extraction. We do not proceed to Dolibarr import until all source records pass the completeness threshold defined in the scoping document.

  5. Staging migration and reconciliation

    We run a full migration into a Dolibarr staging environment using production-equivalent data volumes. The customer's operations lead reconciles record counts per object type, spot-checks 25-50 records per object against Decision Builder source data, and validates that open AP/AR aging matches. Chart of accounts integrity is verified by running a trial balance in Dolibarr and comparing to the Decision Builder general ledger. Any mapping corrections are documented and applied to the production migration script before the production migration window opens.

  6. Production migration in dependency order

    We run production migration in record-dependency order: account framework (accounting chart first), Third Parties (customers and vendors), Products (with BOM decomposition if applicable), Projects, then open AP/AR invoices and credit memos. Historical transactions follow once the account framework is stable. Documents migrate alongside their parent records. Custom Data Structures migrate last, with Dolibarr custom fields populated from converted .dec.obj data or flat CSV where applicable. Each phase emits a row-count reconciliation report before the next phase begins.

  7. Cutover, validation, and rule flow inventory handoff

    We freeze Decision Builder writes during the cutover window, run a final delta migration of any records modified during migration, then enable Dolibarr as the system of record. We deliver the rule flow and workflow inventory document to the customer's admin team with specifications for Dolibarr module-based rebuild. We support a one-week hypercare window to resolve any data reconciliation issues raised during the first billing or inventory cycle in Dolibarr. We do not rebuild Decision Builder rule flows or workflows as Dolibarr configurations inside the migration scope; that is a separate configuration engagement.

Platform deep dives

Context on both ends of the pair

Decision Builder logo

Decision Builder

Source

Strengths

  • 25+ years of operational history with deep manufacturing and distribution domain expertise
  • Extensive pre-built application library covering industry-specific workflows
  • Flexible architecture supporting extensive customization to match unique business processes
  • Integrated environment combining financials, inventory, and vendor management
  • Project-based export capabilities (.dec.obj format) for complex data structure migrations

Weaknesses

  • Limited and poor documentation creates steep learning curves for new users
  • Poor upgrade path for .NET compatibility causes friction during version transitions
  • Lack of comprehensive technical documentation slows advanced configuration work
  • Modern SaaS integration gaps require custom development compared to newer ERP platforms
  • Excel export for data structures has varying complexity handling across different data types
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?

Moderate ERP migration. 4 of 8 objects need a mapping; the rest are 1:1.

C

Overall complexity

Moderate migration

Derived from compatibility, mapping clarity, API constraints, and data volume across Decision Builder and Dolibarr ERP.

  • Object compatibility

    C

    4 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

    Decision Builder: Not publicly documented.

  • Data volume sensitivity

    B

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

Estimator

Estimate your Decision Builder 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 Decision Builder to Dolibarr ERP data migrations

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

Can't find your answer?

Walk through your Decision Builder 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 five and eight weeks for accounts under 5,000 customers, 2,000 vendors, and simple flat Data Structures. Migrations with complex multi-level Data Structures requiring .dec.obj conversion, large historical transaction sets, multi-site account hierarchies, or chart of accounts segment mapping extend to twelve to eighteen weeks. Decision Builder's lack of a bulk export API adds one to three weeks to the discovery and export extraction phases compared to platforms with open APIs.

Adjacent paths

Related migrations to explore

Ready when you are

Move from Decision Builder.
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