CSV
Prepare CSV files with stable key, unique character set, clear header, and unchanged number and date formats.
A good CSV appears simple - that's exactly what makes it testable. Each line remains visible, comparable and connected to a key to the origin.
The truth is in the mapping
The X-ERP import sources use, among other things, UTF-8, defined separators and fixed headers. These technical details must match field mapping, mandatory values and reference order.
From raw stock to controlled import
- Export an unchanged source version and calculate the file hash and line count.
- Define UTF-8, delimiter, text delimiter, header, decimal and date format.
- Keep alt ID and external keys as text.
- Validate the number of columns, mandatory fields, length, value ranges and foreign keys before importing.
- Write incorrect lines with reason to a separate, reprocessable file.
Evidence instead of gut feeling
- Leading zeros and special characters are retained.
- Each line has unique key.
- Number of lines before and after processing can be explained.
- The error file and import log together make up the entire inventory.
The typical breaking points
- Automatic type conversion turns item numbers into numbers.
- Semicolon in free text moves columns if quoting is incorrect.
- Error lines are changed manually without correcting the rule.
This is what you take with you
The CSV is a controlled exchange package – readable by humans and deterministic for import.
Related topics
- For migration specialists – transfer and optimize data from third-party systems › Data inventory, mapping and management rules
- For migration specialists – transfer and optimize data from third-party systems › Cleaning, sequence and references
- For migration specialists – transfer and optimize data from third-party systems › Test migration, checksums and acceptance
Frequently asked questions
**Which character set makes sense?**
UTF-8 avoids many language and special character problems; Import and export must use the same agreed character set.
**How do I prevent Excel reformatting?**
Import columns with a fixed data type and save the unchanged source version separately. Then check hash and critical fields.