# Import file naming

In order for our importers to recognize the import files the filenames need to conform to the file format that is required for the import file. You can find the import file formats on the individual pages of the different batch interfaces.

For example the naming convention of of the Customers import **\[SHOPNAME]\_**&#x63;ustomers\_**\[INDEXNUMBER]**.xml.

In order to generate correct filenames you need to know the SHOPNAME. This name is provided by Integrace.&#x20;

For example if the shop is named Test Shop the SHOPNAME will probably be TestShop.

Most of our shops come with a Production and a Staging environment.&#x20;

In the above example the SHOPNAME of the Production environment will be TestShop, the SHOPNAME of the Staging environment will be TestShop-Staging.

The INDEXNUMBER has to be a sequence of digits. Common practice is to use the the timestamp of the creation date of the file as number but you can also use another mechanism.

Valid filenames for the customer import of our Test Shop are:

TestSho&#x70;*\_*&#x63;ustomer\_20220127112931.zip

TestSho&#x70;*\_*&#x63;ustomer\_123.zip


---

# Agent Instructions: 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:

```
GET https://shoxl.gitbook.io/erp-integration-guide/2024.2/general-patterns/import-file-naming.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
