> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/universal-import/universalimport_en_us/troubleshooting-and-support/faq.md).

# FAQ

### File upload

<details>

<summary><strong>“Please select a mapping first”</strong></summary>

Before you can upload a file, an import mapping must be selected. First select the appropriate mapping from the list, then upload the file again.

</details>

<details>

<summary><strong>“The file does not match the mapping type”</strong></summary>

The file type of your file does not match the format defined in the mapping. For example, you uploaded a CSV file, but the mapping was created for Excel. Create a mapping for the actual format or select the appropriate existing mapping.

</details>

<details>

<summary><strong>“No Excel file found”</strong></summary>

The uploaded file could not be read as a valid Excel file. Check whether it is actually a supported Excel format, such as `.xlsx`, whether the file is corrupted, and whether you have not accidentally selected a different file extension.

</details>

### Column mapping

<details>

<summary><strong>“No columns mapped”</strong></summary>

No file columns have been mapped to the target fields in Business Central yet. Upload a file and assign a target field to each relevant column before continuing with the preview or import.

</details>

<details>

<summary><strong>“Only X of Y columns mapped”</strong></summary>

This is an **informational message**: Not all columns from the file have been assigned to a mapping. You can continue; however, data from unmapped columns will not be imported. Add the missing mappings if all columns should be imported.

</details>

<details>

<summary><strong>Columns are displayed, but target fields are missing</strong></summary>

Check whether the **correct target** table has been selected in the mapping. Only fields from the selected table are available as targets. Change the target table if you want to import into a different table.

</details>

### Import errors

<details>

<summary><strong>“The record already exists”</strong></summary>

You are probably using “Insert Only” mode while the record already exists in Business Central. If existing records should be updated, switch to “Insert & Update” mode. See also Import Modes.

</details>

<details>

<summary><strong>“The enum element does not contain the value X”</strong></summary>

This error may occur if option or enum values are corrupted or invalid. This issue was fixed in an earlier app version. Make sure that your environment is using the latest version of the extension, and then run the import again.

</details>

<details>

<summary><strong>Fields are empty after the import</strong></summary>

Check the “Validate fields” setting: If it is disabled, dependent fields are not filled automatically. In addition, the “If empty” option applies per column — depending on the setting, empty source values may either skip or clear existing values. See Field Validation and Empty Values.

</details>

<details>

<summary><strong>“Asset Type must have a value”</strong> or similar required-field errors</summary>

This is often caused by a field dependency: required fields such as source type or asset type must be populated before the regular file columns are processed. Use virtual columns for these fields — virtual columns are automatically processed **before** the columns from the file. For more information, see Virtual Columns.

</details>

<details>

<summary><strong>“The correct row is not found in the target table.”</strong></summary>

In the *“Select Target Table”* window, a filter is set by default to display the most commonly used entries.

To display all entries, click the arrow to the right of *“Table ID”* and select *“Clear Filter*” from the drop-down menu that opens.

</details>

### Decimal numbers & formatting

<details>

<summary><strong>Prices or amounts are displayed incorrectly</strong></summary>

Check the decimal separator for each column: German files often use a comma (`1.234,56`), while US files use a period (`1,234.56`). The setting must match the format of your source file. See Decimal Separators.

</details>

<details>

<summary><strong>Thousands separators cause errors</strong></summary>

Set the correct decimal separator. Thousands separators are usually removed automatically, provided that the decimal separator clearly matches the file format.

</details>

### Quick Import

<details>

<summary><strong>“No matching template found”</strong></summary>

No matching import mapping was found for the column headings in your file. Create the mapping manually once and save it; Quick Import can then recognize the same structure in future files with similar headers. See Quick Import.

</details>

<details>

<summary><strong>“Multiple templates found”</strong></summary>

Multiple mappings meet the detection criteria. A list is displayed for selection — choose the appropriate mapping. More precise names for your mappings will make it easier to keep track of them later.

</details>

<details>

<summary><strong>Quick Import detects the wrong mapping or no mapping at all</strong></summary>

Automatic mapping is based on a threshold: at least approximately 50% of the mapped columns must match the file. If the column names in your file differ significantly, detection will fail. In this case, select the mapping manually or adjust the column names.

</details>

### Item attributes

<details>

<summary><strong>Attribute values are not mapped</strong></summary>

Check whether “Use alias” is enabled in the mapping line. If your file uses different names than the attribute values in Business Central, set up aliases on the Item Attribute Values page. For details, see Item Attributes.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/universal-import/universalimport_en_us/troubleshooting-and-support/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
