Migrate from Icicle ERP to Dolibarr ERP

Icicle Products with formulation hierarchies (ingredients, BOMs, allergen declarations, nutritional data) map to Dolibarr Product records with BOM configuration enabled. Ingredient-level formulations migrate as Dolibarr BOM records under the finished product. Allergen declarations and nutritional data transfer as Dolibarr extra attributes. Product codes from Icicle's SKU field become Dolibarr barcodes or product refs for inventory scanning. Unit of measure conventions (weight, volume, case-pack configurations) transfer to Dolibarr's uom fields on each product line.

Icicle Production Orders linked to Formulations, scheduled batches, and resource allocations map to Dolibarr Manufacturing Orders. Batch quantities, scheduled start/end dates, and finished-goods lot numbers carry forward. Resource allocation data (equipment, labor flags) transfers as extra attributes on the Manufacturing Order since Dolibarr's base manufacturing module handles production routing without native resource scheduling. Co-packer production orders require additional mapping of customer contract references.

Lot records are the highest-risk object in this migration. Icicle stores lot genealogy as a native linked graph (raw-material lot → in-process lot → finished-goods lot). Dolibarr's standard Lot module stores lot numbers per stock entry but does not model genealogy chains. We resolve this by configuring a custom Lot Relations structure using Dolibarr's linked-elements mechanism or a community module that tracks parent-child lot relationships, and we verify the destination schema can represent the full traceability graph before confirming migration scope. If the customer's food-safety requirements demand audit-ready genealogy, we flag this as a configuration requirement in the delivery document.

Icicle inventory lot records with locations, expiry dates, and QC hold statuses map to Dolibarr Stock entries. Lot IDs from Icicle become Dolibarr lot serial numbers; expiry dates transfer to the lot record; QC hold status transfers as a Dolibarr status flag or stock status update. Multi-facility Icicle locations map to Dolibarr warehouses, which must be configured before stock migration begins so that location lookups resolve at import time.

QC Inspections in Icicle are tied to specific lots and production orders with pass/fail criteria and inspector assignments. Dolibarr has no native QC Inspection object in its base ERP module. We map inspection records to Dolibarr extra attributes on the relevant Stock lot record (last_inspection_date, inspector_name, pass_fail_flag) and document any inspection records that cannot be represented in Dolibarr's base schema as a gap in the migration scope report. For customers with mandatory QC documentation requirements, we recommend a third-party quality management module from the Dolibarr Marketplace.

Icicle Supplier records including food-safety ratings, certifications (organic, kosher, halal), and approval statuses map to Dolibarr ThirdParty records with the Supplier type enabled. Certification fields transfer to Dolibarr extra attributes since the base ThirdParty object does not have native food-safety rating fields. Supplier approval workflow states (approved, pending, suspended) transfer as a status field. Vendor invoice references migrate as separate AP records.

Icicle Customer records with billing and shipping addresses, contact information, and customer-specific pricing tiers map to Dolibarr ThirdParty records with Customer type enabled. Pricing tiers stored in Icicle's customer-specific fields transfer as Dolibarr price negotiation rules or extra attributes. Customer-specific NDA and specification document references (common in co-packer relationships) transfer as extra attributes on the ThirdParty record.

Icicle Sales Orders referencing Products, Customers, and Delivery schedules map to Dolibarr Customer Orders. Open orders migrate by status: draft, validated, shipped, and closed orders all transfer with their line items. Orders tied to specific lots carry the lot reference in the order line notes. Historical closed orders migrate as archived orders; active open orders require a status check to ensure they are not duplicated if the customer plans to keep Icicle running in parallel during migration.

Open Accounts Payable records from Icicle must be extracted with vendor references, invoice numbers, amounts, due dates, and payment terms. These map to Dolibarr Vendor Bills in open status. Closed historical invoices migrate as archived records for audit trail purposes but are flagged as historical (not active ledger entries). The vendor lookup resolves against the migrated Supplier records using vendor name or ID as the dedupe key. Any Icicle payment terms stored per vendor transfer to Dolibarr's payment term configuration.

Accounts Receivable records from Icicle referencing customer accounts and open sales orders map to Dolibarr Customer Invoices in open status. Outstanding balances, due dates, and ageing buckets transfer to the invoice record. Payment terms stored per customer in Icicle apply to the migrated invoice. Closed historical invoices migrate as archived records. Customer-specific pricing flags from Icicle's sales module carry forward to ensure correct pricing on migrated invoices.

Icicle's GL structure includes food-industry-specific accounts (COGS by product category, facility cost splits) that map to Dolibarr chart of accounts entries. We create the destination account structure in Dolibarr before AP/AR migration so that account references resolve on invoice import. Accounts without a clear Dolibarr equivalent are flagged in the mapping document with a recommended account creation or parent-account assignment. Historical GL balances transfer as opening balance entries in Dolibarr's accounting module.

Icicle documents attached to Products, Production Orders, QC Inspections, and Suppliers extract as files and associate with the corresponding migrated Dolibarr record via Dolibarr's document management system. The destination document directory structure mirrors the Icicle attachment hierarchy so that records and their supporting files remain linked. Document metadata (upload date, author, version) transfers where Dolibarr's document model supports it; unsupported metadata is preserved in a companion migration notes document.