Migrate from Konnect ERP to Dolibarr ERP

Konnect ERP Customer records map to Dolibarr ThirdParty with the Customer type flag. We export name, contact details, GSTIN, billing address, shipping address, and outstanding balance. GSTIN maps to a custom extrafield (fk_extrafields) on ThirdParty rather than a native field. Dolibarr requires the Banque module and the Clients module to be activated before third-party import; we confirm activation during Dolibarr setup and flag any missing module before migration begins.

Konnect ERP inventory items map to Dolibarr Product records with type=0 (product/stock). We preserve SKU, description, unit of measure (mapped to Dolibarr's unit category system), cost price, and sales price. HSN codes from Konnect ERP migrate as a Product extrafield; Dolibarr does not have a native HSN field. If the source item carries a stock quantity, we migrate warehouse-linked Stock product lines via the Dolibarr Stock module if activated in the destination.

Konnect ERP service items map to Dolibarr Product records with type=1 (service). The service flag maps to Dolibarr's ProductType field. Description, SAC (Services Accounting Code) as an extrafield, and the last known service price migrate. Service billing cycles (monthly, annual) require manual configuration in Dolibarr's Service module after migration if recurring billing is required.

Konnect ERP COA records map to Dolibarr Bank accounts, cash accounts, customer accounts, supplier accounts, and miscellaneous accounts. We extract the full account code hierarchy and map each code to a Dolibarr account class (classe 1 through 9 corresponding to French-style accounting or the customer's chosen accounting plan). Account codes that have no direct Dolibarr equivalent are flagged in a reconciliation report before import; the customer provides the target account for each unmapped code.

Konnect ERP outstanding customer invoices map to Dolibarr Facture records with type=customer. We migrate invoice number, invoice date, due date, line items referencing the Product lookup (migrated first), tax amounts, and payment status (unpaid/partial/paid). The Customer link resolves to the ThirdParty record migrated first. Paid invoices are migrated as historical records with the paid status flag set; open invoices retain their status for AR follow-up.

Konnect ERP outstanding supplier invoices map to Dolibarr Facture records with type=supplier. The supplier link resolves to a ThirdParty record of type=supplier migrated first. Line items reference the Product or service records already present. GST tax amounts from Konnect ERP's E-Way Bill records are preserved as extrafield values for tax audit trails.

Konnect ERP Project records map to Dolibarr Project with project_ref, title, description, customer link (ThirdParty), status, and dates. Project budgets and milestone schedules from Konnect ERP migrate as ProjectTask hierarchy records in Dolibarr. If Konnect ERP project billing is tied to a rate card, we migrate the rate card as a ProjectTask line with predefined billing values.

Konnect ERP timesheet records link an employee to a project and a date range with hours logged. These map to Dolibarr ProjectTaskTime records linked to the matching Project and a user record. Dolibarr requires the Timesheets module and the Project module to both be active. Entries that reference a project or employee not yet migrated are held in a reconciliation queue until parent records are present.

Konnect ERP Employee records map to Dolibarr User records (for system login) plus HRM-related extrafields (department, designation, date of joining, employment status). We export personal details, department, designation, and effective-dated status. Dolibarr's HRM module must be activated; if it is not, we create User records with the employee fields migrated as extrafields on the User object. Salary and compensation fields require explicit customer instruction before migration as they may fall under data privacy considerations.

Konnect ERP E-Invoicing records carry the IRN (Invoice Reference Number), QR code URL, and GSTIN of both parties. We migrate these as invoice extrafields on the corresponding Dolibarr Facture record. The HSN/SAC codes on line items also migrate as line extrafields. Dolibarr has no native GST compliance module; Indian businesses using Dolibarr typically use community modules from the Dolistore or custom-built extensions for GST filing. We flag this gap explicitly and escalate before any GST record import.

Konnect ERP E-Way Bill records carry the E-Way Bill number, transporter details, vehicle number, and distance. These do not have a native Dolibarr equivalent. We map them as extrafields on a Dolibarr Expedition (shipment) record linked to the corresponding sales invoice. If the Expedition module is not active, we map to a Note attached to the invoice with the E-Way Bill data as structured text.

Konnect ERP custom objects created within the platform migrate to Dolibarr as standard objects (ThirdParty, Product, Project, etc.) with custom extrafield columns added via Dolibarr's ExtraFields system (llx_extrafields tables). We pre-create the destination extrafields before import, matching the Konnect ERP field name to a Dolibarr column name and type (string, int, float, date, select). The Dolibarr module that hosts each standard object must be activated before its extrafields can be defined.