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

**1. Подготовка файла**

1. **Выберите тип объекта** для импорта:
   * Люди
   * Должности
   * Элементы справочника
   * Категории
   * Организации
   * Статусы пропусков
   * Типы документов
2. **Скачайте образец CSV/Excel** и заполните его:
   * Первая строка должна содержать **заголовки столбцов**
   * Для автоматического сопоставления полей укажите **полный путь до поля** в PassOffice

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

3. **Требования к файлу:**
   * Первая строка должна содержать **заголовки столбцов**
   * Форматы: **CSV (UTF-8, Windows-1251)** или **Excel (XLSX)**
   * Все поля в Excel должны быть **текстовыми**
   * Excel 2003 не поддерживается
   * Для CSV: используйте разделитель-запятую
4. **Загрузка файла**

* **Загрузите файл** или укажите путь к нему на сервере
* **Опции обработки**:
* **Распознать заголовки** – автоматическое сопоставление колонок (если указаны полные пути к полям)
* **Первичный ключ** – предотвращает дублирование объектов (см. таблицу ниже)
* **Создавать объект, если не найден по первичным ключам** – добавляет новые записи

*Пример использования первичных ключей:*

| Объект        | Первичный ключ                 | Результат при совпадении    |
| ------------- | ------------------------------ | --------------------------- |
| Тип документа | Название (например, "Паспорт") | Не создаст дубль            |
| Человек       | ФИО + дата рождения            | Обновит существующую запись |

3. **Конфигурирование**:

* Укажите **маску для дат** (например, `DD.MM.YYYY`)
* Выберите **категорию людей по умолчанию**
* **Загрузка изображений** (если требуется):
* Прикрепите фото (названия файлов должны соответствовать Фото.Содержимое из CSV)

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

* Нажмите **«Запустить»**

Система выведет:

* Количество обработанных строк
* Ошибки (если есть)

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


---

# 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://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/background-tasks/import-iz-csv.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.