# Загрузить файл CSV или Excel

> **Коротко.** Как добавить в проект файл с данными, загрузить CSV больше 100 МБ в два приёма и обновить данные того же источника новым файлом.

Адрес: https://marfor.pro/docs/data/sources/file · Раздел: Данные: от таблицы до проверенного источника › Источники данных: откуда MARFOR берёт таблицу › Загрузить файл CSV или Excel · Вид: Инструкция · Уровень: для начинающих · Обновлено: 2026-10-14

Файл — самый быстрый способ начать: выгрузите отчёт из рекламного кабинета или CRM и загрузите его в проект. Обновлять файл придётся вручную; если данные нужно забирать каждый день, подойдёт [ссылка на CSV](https://marfor.pro/docs/data/sources/url).

## Что нужно заранее {#before}

- Открытый проект — [создать проект](https://marfor.pro/docs/start/project).
- Таблица по правилам: дата в каждой строке, разрезы текстом, показатели числами — [какие данные нужны](https://marfor.pro/docs/data/requirements).
- CSV в кодировке UTF-8 или Windows-1251 либо Excel (XLSX, XLS). У Excel читается только первый лист, сам файл — до 20 МБ.
- Файл до 100 МБ загружается сразу. CSV больше 100 МБ — в два приёма, [см. ниже](#large-file).
- На тарифе Free в одном источнике — до 10 000 строк: [ограничения на старте](https://marfor.pro/docs/account/limits).

## Шаги {#steps}

1. Откройте проект и раздел «Источники данных».
2. Нажмите «Добавить источник» (в пустом проекте — «Выбрать файл»). Откроется окно «Добавить источник данных».
3. «Название источника» — понятное имя, например «Расходы и заказы 2025–2026». Пустое поле — возьмётся имя файла.
4. Вкладка «Файл» → «Файл данных» → выберите CSV, XLSX или XLS.
5. Нажмите «Загрузить». После «Файл успешно загружен!» окно закроется само.
6. На карточке источника нажмите «Настроить маппинг» — [что там делать](https://marfor.pro/docs/data/mapping/roles).

## Как понять, что получилось {#result}

Появилась карточка источника: статус «Подключен», тип «Файл», строка «Загружен:» с датой и число строк и колонок. Сверьте число строк с файлом: 24 месяца × 3 канала — 72 строки. Что ещё есть на карточке — [экран «Источники данных»](https://marfor.pro/docs/data/sources/screen).

## Большой CSV: превью и полный импорт {#large-file}

![CSV больше 100 МБ загружается в два приёма: 1 — сразу попадают первые 1 000 строк; 2 — колонки размечают и нажимают «Применить маппинг»; 3 — выбирают тот же файл и нажимают «Начать полный импорт»](https://marfor.pro/docs/img/src-large-file.png)

1. Загрузите файл как обычно. MARFOR прочитает начало файла и создаст источник из первых 1 000 строк: статус «Превью», тип «CSV (превью)».
2. «Настроить маппинг» → разметьте колонки → «Применить маппинг». Появится «Маппинг применён. Выберите файл для полного импорта.»
3. Выберите **тот же файл** и нажмите «Начать полный импорт». Файл уйдёт частями по 50 МБ, под кнопкой — полоса хода.
4. Не закрывайте вкладку, пока импорт не закончится: файл читает ваш браузер.

Если импорт прервался, откройте маппинг источника и нажмите «Обновить данные». Появится «Обнаружена прерванная загрузка»: «Продолжить загрузку» — выберите тот же файл, и импорт пойдёт с места остановки; «Начать заново» — с начала.

## Обновить данные того же источника {#update}

Каждый новый файл через «Добавить источник» создаёт **новый** источник: к старому он не дописывается. Чтобы обновить данные источника, на который уже опираются прогнозы и сценарии:

1. На карточке источника — «Настроить маппинг» → «Обновить данные».
2. Выберите режим:
   - «Заменить данные» — полная перезагрузка, старые строки удаляются;
   - «Дополнить данные» — новые строки добавляются к старым. Галочка «Удалить дубли после загрузки» убирает строки, совпадающие во всех колонках.
3. Выберите CSV с теми же колонками и теми же названиями и нажмите «Загрузить».

> [!Важно]
> «Дополнить» подходит для новых периодов. Если в новом файле есть уже загруженные даты с другими цифрами — например, уточнённые расходы за прошлый месяц, — строки задвоятся: дубли убираются только при полном совпадении. Для уточнённой истории берите «Заменить» и полный файл. Прогнозы после обновления сами не пересчитываются.

## Если не получилось {#troubleshooting}

- **«Недопустимый тип файла. Разрешены: CSV, XLSX, XLS».** Сохраните файл в одном из этих форматов.
- **«Не удалось загрузить файл с правильным разделителем».** В файле одна колонка, необычный разделитель или над названиями колонок стоит заголовок отчёта. Уберите лишние строки сверху и сохраните CSV с разделителем «;» или «,».
- **«Не удалось прочитать файл с известной кодировкой».** Пересохраните CSV в UTF-8.
- **«Не удалось прочитать Excel: …».** Причина — в тексте сообщения: файл больше 20 МБ, лист слишком большой, файл повреждён или защищён паролем. Сохраните нужный лист как CSV (UTF-8) и загрузите его.
- **«Запрос слишком большой. Максимальный размер: 100MB».** Сохраните данные в CSV: большой CSV загружается частями.
- **Окно «Нужен тариф Pro» и «Источник превышает лимит вашего тарифа (10 000 строк)…».** Сократите данные: суммируйте по дням вместо часов, уберите лишние разрезы. Или смените тариф.
- **Даты или числа в «Обзоре данных» не те.** [Даты и числа: как записать](https://marfor.pro/docs/data/requirements-formats).
- **Загрузили не тот файл.** Значок корзины на карточке. Вместе с источником удаляются его маппинг, прогнозы и моделирование, поэтому MARFOR переспросит. Удаляет только владелец проекта.

## Связанные

- [Какие данные нужны: таблица для MARFOR](https://marfor.pro/docs/data/requirements)
- [Настроить маппинг источника: дата, метрики и разрезы](https://marfor.pro/docs/data/mapping/roles)
- [Подключить ссылку на CSV или Google Таблицу](https://marfor.pro/docs/data/sources/url)
- [Экран «Источники данных»: карточка источника](https://marfor.pro/docs/data/sources/screen)