> 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/background-tasks/import-iz-csv.md).

# Импорт из 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>