Goal
Import one reviewed data set without committing unknown columns, guessed dates, or unresolved validation errors.
Prerequisites
- You are the owner of the active company. The Import workspace is owner-only.
- You have an export from the source system or a completed 4fleet template.
- You know the source date order and timezone when dates could be ambiguous.
- You have a safe copy of the original export outside 4fleet.
Steps
- Open Settings > Import / Migrate. Use the public Switch to 4fleet guide only to prepare source exports before signing in.
- In the Source step, choose the matching source profile. Choose the generic or AI-assisted lane only when no specific profile matches the file.
- Read the export instructions for the chosen source and acknowledge the template requirements.
- In Upload, add each file to the correct slot. Confirm ambiguous workbook sheets manually instead of accepting an uncertain assignment.
- Set date order and timezone when the source profile exposes those controls.
- In Map, review every target field and source column. Correct required fields and mark irrelevant columns as ignored.
- Save the mapping as a template only when the source export format is stable and the mapping has been verified.
- Open Preview and run the dry-run check. Review created, updated, skipped, duplicate, warning, and error counts for every entity.
- Return to Map or Upload when the preview exposes missing required data, wrong dates, wrong currencies, or uncertain entity links.
- Select Commit only when the preview report is acceptable, then review the final import report and spot-check records in their owning screens.
Expected result
The committed counts match the reviewed preview closely, imported records belong to the active company, and spot checks confirm correct dates, links, money, and statuses.
Troubleshooting
- Upload is rejected: confirm the file type, size, template, and source slot.
- Dates are reversed: return to the source settings and choose the correct day-first or month-first order and timezone.
- Columns are unmapped: map the required target fields manually. Do not commit an uncertain identity, date, or amount.
- Preview shows duplicates: inspect the matching identifiers before deciding whether to skip or update.
- The commit fails: the UI reports that no data was changed. Keep the job reference and report if the same reviewed input fails again.
- The completed import is wrong: use the import rollback action promptly when available, then verify the rollback report. Rollback removes records created by that import, not unrelated company data.
