---
title: "\u041c\u0430\u0441\u0441\u043e\u0432\u044b\u0439 \u044d\u043a\u0441\u043f\u043e\u0440\u0442 / \u0438\u043c\u043f\u043e\u0440\u0442 \u2014 Dinext"
description: "\u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430, \u0432\u044b\u0433\u0440\u0443\u0437\u043a\u0430 \u0438 \u043c\u0430\u0441\u0441\u043e\u0432\u043e\u0435 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u0434\u0430\u043d\u043d\u044b\u0445 \u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0444\u0430\u0439\u043b\u043e\u0432\u043e\u0433\u043e \u043e\u0431\u043c\u0435\u043d\u0430."
space: "Docs"
url: "https://docs.dinext.ru/docs/servisy-platformy/massovyy-eksport-import"
updated: "2026-07-09"
---

# Массовый экспорт и импорт

## Назначение

Сервис обеспечивает загрузку, выгрузку и массовое обновление данных с использованием файлового обмена. Включает Data Import , Data Export (exporter), документацию Dinext по импорту и экспорту, а также типовые сценарии выгрузки в Excel/CSV и загрузки из шаблонов.

## Цели и задачи

- Выгружать данные списков и отчетов в Excel/CSV для анализа и архивирования.
- Загружать данные из файлов (импорт новых записей или обновление существующих).
- Использовать шаблоны импорта с валидацией и сопоставлением полей.
- Массово обновлять атрибуты документов при поддержке импорта обновлений.
- Обеспечивать контроль ошибок импорта и откат при необходимости.

## Для кого

- Аналитики и контролеры, выгружающие данные для отчетов.
- Администраторы и ключевые пользователи, выполняющие импорт и миграции.
- Интеграторы при обмене данными с внешними системами через файлы.
- Все пользователи при экспорте списков в Excel (кнопка Export в списках).

## Основные понятия

- **Data Export** — выгрузка данных тип документа или отчета в файл (Excel, CSV); через экспортер (exporter.py) или кнопку Export в списке.
- **Data Import** — загрузка данных из файла: выбор тип документа, загрузка файла, сопоставление колонок с полями, валидация, импорт. Поддержка новых записей и при настройке — обновление существующих по ключу.
- **Шаблон импорта** — файл с заголовками колонок, соответствующими полям тип документа; пользователь заполняет данные и загружает.
- **Валидация** — проверка типов, обязательных полей и связей перед записью; ошибки отображаются в отчете импорта.

## Основные сущности / объекты

- **Data Import**  — мастер импорта и журнал импортов.
- **exporter.py**  — выгрузка данных.

## Основные сценарии / процессов

### Экспорт данных

1. Открыть список документов (тип документа) или отчет; применить нужные фильтры.
2. Нажать Export; выбрать формат (Excel, CSV) и при необходимости поля.
3. Файл скачается; использовать для анализа, передачи или архива.
4. Для выгрузки по API или по расписанию использовать экспортер в коде или фоновую задачу с вызовом экспорта.

### Импорт данных (новые записи)

1. Подготовить файл: первая строка — заголовки, совпадающие с именами полей тип документа (или скачать шаблон через Data Import).
2. Открыть Data Import; выбрать тип документа, загрузить файл.
3. Сопоставить колонки файла с полями (если не совпадают автоматически).
4. Запустить валидацию; исправить ошибки в файле или в маппинге и повторить.
5. Выполнить импорт; просмотреть отчет об успешных и ошибочных строках.
6. Ошибочные строки не импортируются; скорректировать данные и повторить импорт только для них при необходимости.

### Массовое обновление (при поддержке)

1. В Data Import выбрать режим обновления (если доступен): указать ключевое поле (например, name или код).
2. Загрузить файл с полями для обновления и ключом для сопоставления существующих документов.
3. Валидация и импорт обновят только указанные поля у найденных документов.
4. Использовать осторожно: проверить резервную копию и выборочно проверить результат.

## Правила и ограничения

- Импорт выполняется в рамках прав текущего пользователя; для массового импорта в защищенные тип документа может потребоваться роль с правами на создание/изменение.
- Размер файла и количество строк ограничены настройками (timeout, лимиты); очень большие файлы разбивать на части или выполнять импорт в фоне.
- Связи (Link, Table) должны указывать существующие документы; при импорте дочерних таблиц порядок импорта родительских записей должен быть соблюден (сначала родитель, потом дочерние со ссылкой на него).
- Рекомендуется тестировать импорт на копии данных или на тестовом сайте.

## Результаты / отчетность

- Выгруженные файлы (Excel/CSV) по спискам и отчетам.
- Отчет Data Import: количество импортированных строк, ошибки по строкам с причиной.
- Обновленные документы в системе после успешного импорта.

## Типовые вопросы и ошибки (FAQ)

### Импорт падает с таймаутом

Уменьшите количество строк в одном файле (например, до 1000–2000) или выполните импорт в несколько заходов. Для очень больших объемов рассмотрите импорт через скрипт/фоновую задачу с пакетной вставкой.

### Ошибка «Link must be valid» при импорте

Поле типа Link ссылается на документ, которого нет в системе (например, клиент или проект). Сначала импортируйте справочники, затем документы со связями. Либо укажите в файле существующие имена документов (name) в связанном тип документа.

### Как скачать шаблон для импорта?

В Data Import после выбора тип документа обычно есть кнопка «Download Template» или «Скачать шаблон»; файл будет с заголовками полей. Заполните данные, сохраните в CSV/Excel и загрузите обратно.

## Связанные темы

- [Гибкая отчетность](/docs/servisy-platformy/gibkaya-otchetnost)
- [Открытый API](/docs/servisy-platformy/otkrytyy-api)
- [Фоновые задания](/docs/servisy-platformy/fonovye-zadaniya)
- [Роли и полномочия](/docs/servisy-platformy/roli-i-polnomochiya)
- [Массовое изменение](/docs/servisy-platformy/massovoe-izmenenie)