> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/manual/organizations/import-iz-csv.md).

# Импорт из CSV/Excel

#### **Пошаговая инструкция: Импорт объектов из CSV/Excel в систему**

**1. Активация функции импорта**

Чтобы в разделе появилась кнопка **«Импортировать объекты из CSV/Excel»**:

1. Перейдите в **«Конфигурирование» → «Внешний вид» → «Меню и отчеты»**.
2. Найдите нужный раздел (например, «Посетители», «Пропуска») и нажмите **«Редактировать»**.
3. Перейдите на вкладку **«Доступные действия»** и активируйте опцию импорта.
4. Сохраните изменения.

Теперь в выбранном разделе появится кнопка **«Импорт»**.

***

**2. Подготовка файла для импорта**

1. Нажмите **«Импорт из CSV/Excel»** → **«Скачать образец»** (чтобы увидеть правильную структуру).
2. Заполните файл (**CSV или Excel**):
   * **Первая строка** должна содержать **названия столбцов** (как в системе).
   * Все поля в **Excel** должны быть в формате **«Текстовый»** (чтобы избежать ошибок с числами и датами).
   * Поддерживаемые кодировки: **UTF-8, Windows-1251**.
   * **Excel 2003 не поддерживается!**
   * При сохранении в **CSV** выбирайте: **CSV (разделитель — запятая) (\*.csv)**.

<figure><img src="/files/ULmW0RkcA82wjXTtjTBN" alt=""><figcaption><p>Образец CSV файла</p></figcaption></figure>

***

**3. Настройка импорта**

1. **Загрузите файл** в систему.
2. Если в файле есть заголовки, отметьте **«Распознать заголовки»** (система сама сопоставит столбцы).
3. **Первичный ключ** (опционально):
   * Поставьте галочку в столбце, который должен проверяться на дубли (например, **«ФИО»** или **«Тип документа»**).
   * Если объект с таким значением уже есть в системе, он **не будет создаваться повторно**.
   * Пример:
     * Если в **PassOffice** уже есть **«Иванов Иван Иванович»**, а в файле он тоже есть, новый посетитель **не создастся**.
     * Если в системе есть тип документа **«Паспорт»**, а в файле он указан, новый тип **не добавится**.
4. **«Создавать объект, если не найден по первичным ключам»**:
   * Если включено, система **добавит только новые объекты**.

<figure><img src="/files/W1OQpIcY7pjHeLEXU2HM" alt=""><figcaption><p>Пример сопоставления полей</p></figcaption></figure>

***

**4. Дополнительные настройки**

1. **Вкладка «Конфигурирование»**:
   * Укажите **маску для дат** (например, `ДД.ММ.ГГГГ`).
   * Выберите **категорию людей по умолчанию**.
2. **Вкладка «Загрузка изображений»** (если нужно):
   * Прикрепите файлы с фотографиями (если в CSV есть ссылки на них).

***

**5. Запуск импорта**

1. Проверьте все настройки.
2. Нажмите **«Импорт»**.
3. Система покажет **отчет об успешном импорте или ошибках** (если данные некорректны).

***


---

# 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.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/manual/organizations/import-iz-csv.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.