Данные из учётной системы можно загрузить в XBRLca CSV-файлами, по одному файлу на каждую таблицу отчёта. Здесь по шагам описано, как подготовить такие файлы, чтобы они загрузились с первого раза.

Как пользоваться страницей

  1. Выберите способ загрузки в разделе Два способа загрузки.
  2. Пройдите семь шагов по порядку, план шагов ниже.
  3. Если при загрузке появились ошибки, откройте страницу Типичные ошибки загрузки CSV.

Два способа загрузки

  • Кнопка в проекте «Загрузить → CSV»
  • Что загружается один или несколько файлов .csv
  • Разделитель табуляция
  • Когда подходит вы выгружаете данные из учётной системы по таблицам
  • Кнопка в проекте «Загрузить → XBRL-CSV»
  • Что загружается один архив .zip с mapping.json и всеми .csv
  • Разделитель как указано в mapping.json, обычно «|»
  • Когда подходит у вас уже есть готовый пакет, например выгруженный из другой системы

Шаги ниже описывают отдельные CSV-файлы. Отличия пакета собраны в разделе Если у вас пакет XBRL-CSV.

План: семь шагов

  1. Скачайте правила для своего отчёта
  2. Назовите файл по имени таблицы
  3. Заполните первую строку
  4. Запишите данные
  5. Сохраните файл правильно
  6. Проверьте файл перед загрузкой
  7. Загрузите файлы и проверьте результат

Шаг 1. Скачайте правила для своего отчёта

У каждого отчёта свой набор таблиц и колонок. Их не нужно угадывать, всё есть в правилах.

  1. Откройте проект нужного отчёта.
  2. В карточке «Правила формирования CSV» нажмите «Выгрузить». Скачается архив.
  3. В архиве общие правила и по одному файлу на каждую таблицу. Файлы правил можно открывать в Excel.

В файле таблицы каждая колонка описана сверху вниз. Главное в нём две строки.

Строка файла правил

Что в ней

Пример

5

Название колонки для первой строки CSV

purcb_dic_Asst_CrncEnumerator_dimGrp_1_periodGrp_1

10 и ниже

Допустимые значения, если колонка заполняется из справочника

=> RUB и под ним mem-int:OKV_643Member

Строка со стрелкой (=> RUB) это подсказка для вас. В CSV пишите код из строки под ней, целиком (mem-int:OKV_643Member).

↑ К плану шагов

Шаг 2. Назовите файл по имени таблицы

Один файл на одну таблицу. Имя файла совпадает с именем таблицы из правил, расширение .csv.

(отметить) Правильно

(ошибка) Неправильно

sr_R1.csv

R1.csv

sr_R10.csv

sr_R10 (1).csv

sr_sved_purcb.csv

sr_sved_purcb.txt

↑ К плану шагов

Шаг 3. Заполните первую строку

  1. В первую строку файла запишите названия колонок из строки 5 файла правил, через табуляцию.
  2. Копируйте названия из правил, а не набирайте вручную.
  3. Колонки, по которым у вас нет данных, можно не включать. Лишних названий, которых нет в правилах, быть не должно.

Например, purcb_dic_A_N2_dimGrp__periodGrp_1 вместо purcb_dic_A_N2_dimGrp_1_periodGrp_1. В логе будет «Не удалось распознать разделитель значений», хотя дело не в разделителе.

↑ К плану шагов

Шаг 4. Запишите данные

Каждая строка после первой это одна запись. Значения идут в том же порядке, что и названия колонок. В примерах ниже → это табуляция.

Что

(отметить) Правильно

(ошибка) Неправильно

Разделитель

Б-10→10→2007-12-26

Б-10,10,2007-12-26 или Б-10|10|2007-12-26

Пустое значение

Б-10→→2007-12-26 (два разделителя подряд)

Б-10→2007-12-26 (колонка выпала, значения съехали)

Текст с запятой

"Выписка из реестра сделок, принятых в клиринг"

Выписка из реестра сделок, принятых в клиринг

Кавычки внутри текста

"ПАО ""Московская Биржа"""

ПАО "Московская Биржа"

Дата

2026-09-30

30.09.2026

Время

15:11:03

15:11:3

Часовой пояс

UTC+3

UTC3 или UTC + 3

Дробное число

12424.64

12424,64 или 12 424.64

Код с нулём впереди

01

1

Длинный номер

все цифры, например 1892951821475916204

1,89295182147591E+018

Значение справочника

mem-int:OKV_643Member

643 или mem-int:OKV_643

purcb_dic_A_N2_dimGrp_1_periodGrp_1→purcb_dic_Asst_CrncEnumerator_dimGrp_1_periodGrp_1→purcb_dic_T_PmntPlnDt_dimGrp_1_periodGrp_1
Б-10→mem-int:OKV_643Member→2026-09-30
Б-11→mem-int:OKV_840Member→

↑ К плану шагов

Шаг 5. Сохраните файл правильно

  1. Кодировка UTF-8. В Notepad++ меню «Кодировки → Преобразовать в UTF-8».
  2. Конец строки LF. В Notepad++ меню «Правка → Формат конца строк → Преобразовать в UNIX (LF)».

Excel меняет разделители, убирает нули в начале кодов, обрезает секунды во времени и портит длинные номера. Лучше всего выгружать файл сразу из учётной системы, а смотреть и править его в Блокноте или Notepad++.

↑ К плану шагов

Шаг 6. Проверьте файл перед загрузкой

Откройте файл в Notepad++ и включите «Вид → Отображение символов → Отображать все символы». Табуляция будет видна стрелкой, конец строки подписью LF.

  • ☐ Имя файла совпадает с именем таблицы.
  • ☐ Между всеми значениями стрелки, а не запятые, «|» или пробелы.
  • ☐ В каждой строке столько же значений, сколько названий в первой строке. В конце строки нет лишней стрелки.
  • ☐ Поиск (Ctrl+F) не находит «E+», «UTC » с пробелом и даты через точку.
  • ☐ Справа внизу окна написано UTF-8 и Unix (LF).

↑ К плану шагов

Шаг 7. Загрузите файлы и проверьте результат

  1. Если в проекте уже есть данные, сначала нажмите «Очистить» в карточке «Очистка проекта». Иначе старые значения останутся.
  2. Нажмите «Загрузить → CSV» и выберите файлы. В первый раз удобнее загружать по одному, тогда ошибки в логе легко отнести к файлу.
  3. Откройте «Лог проекта». Красных строк быть не должно. Если они есть, откройте страницу Типичные ошибки загрузки CSV.
  4. В «Списке форм» сравните число в колонке «Строк» у каждой таблицы с числом строк в файле без первой.
  5. Нажмите «Проверить». Как читать результат, написано на странице Валидация и типичные ошибки КС.

Если в логе нет ошибок, а число строк в «Списке форм» совпадает с файлами, данные загружены полностью.

↑ К плану шагов

Если у вас пакет XBRL-CSV

Пакет XBRL-CSV это zip-архив, в котором лежат файл описания mapping.json и CSV-файлы таблиц. Его загружают кнопкой «Загрузить → XBRL-CSV». Правила для пакета отличаются от обычного CSV, главное берётся из mapping.json.

Что

Как должно быть

Состав архива

mapping.json и все .csv лежат сразу в корне zip, без вложенной папки

Разделитель и кодировка

Как указано в mapping.json в блоке header (delimiter, encoding), обычно «|» и UTF-8

Первая строка CSV

Совпадает со списком columns этой таблицы в mapping.json, один в один и в том же порядке

Число строк

csvRowsCount из mapping.json плюс одна строка шапки

Дата проекта

Совпадает с reportDate из mapping.json

  1. Откройте папку с файлами.
  2. Выделите сами файлы, mapping.json и все .csv.
  3. Нажмите правой кнопкой и выберите «Отправить → Сжатая ZIP-папка».

Не архивируйте папку целиком, иначе файлы окажутся внутри неё.

  1. Откройте zip двойным щелчком. Сразу внутри должны быть mapping.json и .csv, а не папка.
  2. Откройте mapping.json в Notepad++ и посмотрите delimiter и encoding в header.
  3. Для каждой таблицы сверьте первую строку CSV со списком columns и число строк с csvRowsCount.

Если в логе «Загрузка данных прервана, не найден файл mapping.json», значит файлы лежат во вложенной папке. Пересоберите архив из самих файлов.

↑ К плану шагов

Если не помогло

(вопрос) Если файл собран по этим правилам, но не загружается, посмотрите страницу Типичные ошибки загрузки CSV, там ошибки из лога и как их исправить.

(предупреждение) Если ответа там нет, напишите в техническую поддержку XBRLca или на почту xbrlka.helpdesk@servers.open-bs.ru. Приложите файл, выгрузку «Лога проекта» и укажите номер проекта.