Migrate from AltheaSuite to Dolibarr ERP

AltheaSuite Items (Products and Services) map to Dolibarr Products/Services. Standard fields (SKU, name, description, unit price, cost) migrate directly. Custom Item fields (text, number, lookup, date, fractional) are enumerated during schema profiling, typed against Dolibarr's field type equivalents, and created as extra fields on the Product record. We validate each custom field has a value in the dump before importing to avoid null-handling mismatches.

AltheaSuite serial numbers are assigned records linked to Items. We extract the full serial-to-item mapping as a child table during the export phase, then re-associate each serial record with the correct Dolibarr Product ID at import time. We flag any orphaned serial records (serial with no parent Item) for manual resolution before the import finalizes. Dolibarr's serial number tracking requires the Stocks module to be enabled.

AltheaSuite lot-controlled items carry lot number and expiry date metadata. We migrate lot assignment records with their parent Items, preserving expiry dates for destinations that support FEFO (First Expired First Out) logic. Dolibarr's base lot tracking is included in the Stocks module; expiry date enforcement requires configuration or the Perishable Stock add-on depending on the Dolibarr version.

AltheaSuite Customer records migrate to Dolibarr Third Parties with the Customer flag enabled. Contact details, addresses, and account-level fields transfer intact. In Dolibarr, customers and suppliers share a single Third Party object with a Type field; we set Type=Customer based on the AltheaSuite source record type. The customer code from AltheaSuite becomes the Dolibarr Ref (reference) field as the dedupe key.

AltheaSuite Vendor records migrate to Dolibarr Third Parties with the Supplier flag enabled. Contact info, addresses, and supplier-level fields transfer intact. The vendor-managed inventory flag from AltheaSuite (indicating whether the vendor supplies managed stock) migrates as a boolean property on the Dolibarr Third Party record. The vendor code becomes the Dolibarr Ref field as the dedupe key.

AltheaSuite Purchase Orders carry line items, quantities, and costs. We map PO headers and line items to Dolibarr Supplier Order and Supplier Order Line. Multi-currency or landed-cost fields require explicit value-mapping against Dolibarr's currency fields; we flag any landed-cost line items that cannot map cleanly for manual handling. Purchase Order status (draft, sent, received) maps to Dolibarr Draft, Validated, Approved states.

AltheaSuite Sales Orders include header data, line items, fulfillment status, and delivery assignments. We preserve order-to-delivery linkage in the mapping notes but note that fulfillment state (partial vs. complete) must be explicitly set in Dolibarr's order status workflow. Delivery addresses from AltheaSuite migrate to Dolibarr's contact address or delivery address fields on the Customer Order header.

AltheaSuite Work Orders are tied to multi-level BOMs and track production status with step-level labor and machine time. We flatten BOM hierarchies during migration mapping: each level of the AltheaSuite BOM becomes a separate BOM definition in Dolibarr, and Work Order header data migrates to Dolibarr Project records with tasks representing production steps. Step-level labor and machine time entries migrate as child task records if the destination supports task time tracking; otherwise they are flagged for manual entry post-migration.

Bill of Materials structures in AltheaSuite support nested sub-assemblies. We flatten BOM hierarchies during migration mapping and reconstruct the correct parent-child relationships in Dolibarr's BOM module. Each AltheaSuite BOM level maps to a Dolibarr BOM with line items referencing sub-assembly Products. The BOM revision and有效期 fields migrate as custom properties on the Dolibarr BOM.

AltheaSuite supports user-defined custom fields on Items (Text, Number, Lookup Value, Date Time, Fractional Number). We discover these during schema profiling by requesting a full list of custom Item field definitions from the customer and verifying them against the live system during the profile walkthrough. Each field type converts explicitly: AltheaSuite Lookup Value becomes a Dolibarr select-type extra field; Number becomes an integer or decimal extra field; Fractional Number becomes a decimal extra field. Field types are converted explicitly to avoid type mismatches at import.

AltheaSuite reorder levels per Item migrate to Dolibarr's stock replenishment alert thresholds on the Product record. We map reorder point quantities to Dolibarr's stock alert level, enabling the reorder workflow in Dolibarr's Stocks module after migration.

AltheaSuite Item categories and labels migrate to Dolibarr Product Categories. We preserve the category hierarchy as a flat or nested category structure depending on Dolibarr's category module configuration. Categories with no assigned Items are flagged for the customer to handle post-migration.