Стандарты ТрэкРекордс к отчетности об инвестиционных портфелях и результатах управления активами

Редакция 1.5.10 от 20.10.2025

Связаться: support@trackrecords.ru

Обновления

О документе

Документ содержит требования к отчетности о составе инвестиционных портфелей и результатах управления, используемых в ТрэкРекордс для портфельной аналитики. В документе содержится информация о требованиях к составу и структуре такой отчетности, рекомендациях по заполнению, форматах файлов, типов данных, рекомендациях к регулярности предоставления.

Документ будет полезен для инвестиционных компаний, страховых компаний, управляющих компаний, банков, фондов, брокеров, а также для разработчиков ПО для учета инвестиционных портфелей.

Файлы JSON и XLSX с требуемым набором и форматом данных представляют собой стандарт, благодаря которому программное обеспечение ТрэкРекордс позволяет пользователю провести подробный анализ его результатов управления, получить информацию о рисках портфеля буквально в несколько кликов. Эта отчетность также используется для контрибутивного и атрибутивного анализа результатов управления инвестиционными портфелями.

Примеры отчетов и дашбордов, которые можно построить с помощью этой отчетности и инструментов ТрэкРекордс смотрите здесь: Скачать пример

{.is-info}

ТрэкРекордс делит отчетность на несколько разделов/категорий:

• Метаинформация (meta) - информация о портфеле, дате и периоде отчетности и прочие метаданные. Позволяет идентифицировать портфель, управляющего и прочие параметры.
• Состав портфеля на отчетные даты (portfolio) - отчетность о составе инвестиционных портфелей на определенную дату. Включает в себя информацию о структуре портфеля, активах, их стоимости. Позволяет проанализировать текущий состав портфеля, характеристики его активов, провести стресс-тестирование и оценку рисков. Не позволяет рассчитать доходность портфеля или оценить результаты управления.
• Инструменты (instruments) - отчетность о характеристиках нерыночных активов, таких как депозиты, кредиторская и дебиторская задолженность, РЕПО, займы, недвижимость и прочие активы. Необходимо учета характеристик по таким активам при оценке рисков и доходности портфеля. Информация о таких активах уникальная для каждого отдельного портфеля и не является публичной. Параметры рыночных активов (таких как акции, облигации или пиф) предполагается определить автоматически по ISIN коду (или другому коду) исходя из справочника ТрэкРекордс.
• Транзакции (transactions) - отчетность о транзакциях по портфелю за определенный период. Включает в себя информацию о сделках, купонах, дивидендах, амортизации и прочих операциях движения денежных средств и активов. Используется для расчета доходности портфеля и отдельных активов и классов, контрибутивного анализа и воссоздания состава и оценки портфеля на любую дату в периоде.
• Цены активов (prices) - отчетность о ценах активов из портфеля, посчитанные по учетной политике клиента. Используется для оценки портфеля на любую дату в периоде.
• Результаты управления (results) - отчетность управляющего активами, его расчеты доходности за период, доход, вознаграждение, стоимость портфеля по данным управляющего и прочая важная информация.
• Динамика СЧА и вводы/выводы (nav) - дополнительная отчетность, позволяющая расчитать TWR и MWR доходность портфеля, а также оценить влияние вводов и выводов на доходность портфеля на совокупном уровне.

Загрузить данные в терминал можно как в формате ХLSX, так и в формате JSON На этапе тестирования Терминала удобным будет загрузка данных с помощью файлов ХLSX.

При промышленной эксплуатации системы рекомендуется использование файлов в формате JSON.

{.is-info}

Структура отчетности в формате JSON

ТрэкРекордс предлагает использовать единый формат файла отчетности в формате JSON для всех типов отчетности. Это позволяет упростить процесс обмена данными между участниками процесса, уменьшить количество ошибок и упростить процесс аналитики и контроля.

Файл JSON может содержать часть данных, относящихся к одному типу отчетности, или все типы отчетов одновременно. Например файл отчета может содержать метаинформацию, данные о составе портфеля на начало и конец периода (portfolio) и результаты управления, без данных по транзакциям. Тогда можно будет проанализировать состав портфеля и оценить данные о результатах УК, но пересчитать доходность и провести контрибутивный анализ не получится. При наличии данных о транзакциях и ценах, можно будет перепроверить и пересчитать результаты управления и провести контрибутивный анализ.

Пример файла отчетности в формате JSON:

Для просмотра примеров в Excel воспользуйтесь программой TR-Validator (см ниже). Загрузите файл отчетности в формате JSON и сохраните любую таблицу в Excel.

Требования к формату файла отчетности в формате JSON

• Файл должен быть в формате JSON
• Кодировка файла UTF-8 с поддержкой кириллицы
• Файл может содержать все или комбинацию разделов отчетности: meta, portfolio, instruments, results, nav, transactions, prices Например для анализа состава портфеля и результатов управления достаточно предоставить разделы meta, portfolio и results. Для анализа доходности и контрибутивного анализа необходимо предоставить разделы meta, portfolio, results, transactions и prices.
• В случае большого размера файла, его можно заархивировать и загрузить в ZIP архиве

Структура отчетности в формате XLSX

ТрэкРекордс на этапе тестирования Терминала предлагает использовать загрузку в формате XLSX. Также такой способ загрузки подойдет для импорта небольшого объема информации.

Файл XLSX может содержать часть данных, относящихся к одному типу отчетности, или все типы отчетов одновременно.

Пример файла отчетности в формате XLSX :

Программа для валидации файла JSON/XLSX (TR-Validator)

Для проверки корректности заполнения файла отчетности в формате JSON, мы предлагаем воспользоваться программой для валидации. Программа проверяет структуру файла, наличие обязательных полей, типы данных и формат дат.

Программа позволяет посмотреть данные из каждой таблицы файла и сохранить их в формате .xlsx (в случае с файлом формата JSON)

Требования:

• ОС Windows 10 и выше
• 64-разрядная
• Программа работает в оффлайн режиме, не требует установки и доступа в интернет

Необходимо скачать архив, распаковать все файлы (в т.ч. сертификаты) в одну папку и запустить файл tr_validator.exe. После запуска программы, выберите файл отчетности и нажмите кнопку “Открыть”. Программа выведет результат проверки файла и список ошибок, если они есть.

Программа доступна для скачивания по ссылке: Скачать программу

Валидация файла и коды ошибок

Описание состава отчетности

Метаинформация (meta)

Информация о портфеле, дате и периоде отчетности и прочие метаданные. Позволяет идентифицировать портфель, управляющего и другие параметры:

*Обязательное поле

Состав портфеля на отчетную дату (portfolio)

Данные о составе инвестиционных портфелей на определенную дату. Включает в себя информацию о структуре портфеля, активах, их стоимости. Позволяет проанализировать текущий состав портфеля, характеристики его активов, провести стресс-тестирование и оценку рисков. Не позволяет рассчитать доходность портфеля или оценить результаты управления.

*Обязательное поле

Названия классов активов/обязательств (типы инструментов) и их ID ограничены следующим списком:

Инструменты (instruments)

Публичные активы (акции, облигации, фонды) будут определены автоматически на основании ISIN или другого типа кода (при наличии другого типа кода в базе данных). Характеристики прочих активов должны быть указаны в таблице Инструменты (instruments). В таблице заполняются данные о неторговых инструментах, которые присутствуют на начало/конец отчетного периода и/или с такими инструментами были сделки в отчетном периоде (присутствуют в таблице transaction).

Требования к заполнению данных по инструментам:

*обязательное поле. Для депозитов и РЕПО необходимо заполнить поля start_date, maturity_date, nominal, yield_or_dividend_rate, yield_or_dividend_freq.

Результаты управления (results)

В данном разделе представлена информация о результатах управления, рассчитанная при подготовке отчетности создателем отчетности.

Таблица не является обязательной для импорта данных, при этом загрузка указанных данных предполагает возможность представить расчет дохода, доходности и прочих показателей за любые периоды и в любой валюте.

Динамика СЧА и вводы/выводы (nav)

Дополнительная отчетность, позволяющая рассчитать TWR и MWR доходность портфеля, а также оценить влияние вводов и выводов на доходность портфеля на совокупном уровне.

В случае включения данной информации в отчетность желательно предоставить динамику СЧА и вводов/выводов на все дни периода. Минимально необходимый набор дат: начало и окончания периода, а также на даты, где были внешние поступления и выводы.

Транзакции

Таблица транзакций портфеля состоит из движений денежных средств, ценных бумаг и изменения в дебиторской/кредиторской задолженности портфеля. Транзакции включает не только сделки, но также все движения денежных средств, обязательств и ценных бумаг. ТрэкРекордс объединил все эти движения в одну таблицу, чтобы упростить загрузку данных и уменьшить количество ошибок за счет ввода дополнительных проверок. Таблица является обязательной в случае проведения анализа результатов управления на основе транзакций и проведения контибутивного анализа.

Под транзакцией ТрэкРекордс понимает действие, которое приводит к изменению баланса по деньгам, ценным бумагам и инструментам и/или задолженности. Транзакции - это не только сделки! Таблицу транзакций можно трактовать как отчет о движении ценных бумаг, денег и задолженности по счетам портфеля. В таблице отображаются эти движения со знаком + или -

{.is-info}

*обязательное поле

Со знаком минус при выбытии, со знаком плюс при поступлении

Колонки securities, money, debt таблицы транзакций отражают изменение баланса значений, а не фактическое значение позиции на дату транзакций. Чтобы не внедрять дополнительные поля для определения направления транзакций, в формате транзакций ТрэкРекордс необходимо указывать направление изменения баланса позиции путем изменения знака для значений в этих колонках. Для отрицательных значений предполагается выбытие ценных бумаг, депозитов, денег, дебиторской задолженности и др. Для положительных значений - поступление.

Обратите внимание, что для сделок продажи акций, например, движение по securities будет с отрицательным знаком, в по колонке money будет положительным, т.к. акции выбыли из портфеля, и наоборот, пришли денежные средства от продажи.

Таким образом, колонки securities, money, debt таблицы транзакций отражают изменение баланса активов, денег и долга.

Типы транзакций (transaction_types)

При определении типов транзакций нужно руководствоваться следующей таблицей сопоставления транзакций.

Как учитывать различные типы транзакций?

Сделки покупки/продажи ценных бумаг

Для сделок покупки ценных бумаг в поле securities указывается изменения баланса ценных бумагу со знаком +, в поле money указывается сумма сделки со знаком минус. В данном случае не требуется указывать цену сделки, поскольку сервис ее может вычислить самостоятельно путем простого деления. Мы также избегаем необходимости задумываться про тип цены сделки в случае облигаций (грязная цена/чистая цена сделки), т.к. даже если это чистая цена, уплаченный нкд будет либо включен в сумму сделки, либо должен быть отражен отдельной строкой.

В случае продажи ценных бумаг, знаки для столбцов money и securities меняются местами.

Сделки покупки/продажи фьючерсов

При заведении сделок с фьючерсов необходимо завести в таблицу INSTRUMENTS инструмент с соответствующим кодом (например, Si-12.25)и характеристиками.

Добавить сделку (с кодом trade) в таблицу транзакций.

А также не забыть добавить цены в таблицу PRICES по инструменту с кодом Si-12.25

Как завести начальные позиции в портфеле?

Задача завести начальные значения позиций портфеля возникает, когда нет полной истории транзакций за предыдущие периоды. Для этого необходимо использовать транзакции типов transfer_external.

Вот пример заведения начальных позиций портфеля на отчетную дату. Обратите внимание, что для остатков на счетах мы указываем суммы в валюте счета (account_number), а для таблицы securities мы указываем только остатки ценных бумаг на отчетную дату без их стоимостной оценки. Цены на активы хранятся в отдельной таблице цен. При расчете СЧА портфеля используются таблица транзакций и цен. Важно: если учет идет по партиям и для каждой партии своя оценка, необходимо указать в файле на закладке prices цену для каждой партии.

Как отражать начисление или выбытие кредиторской или дебиторской задолженности?

Для этого используется тип операции debt и поле debt для отражения изменения баланса. В поле code_type указывается значение ‘INSTRUMENT’ для начисления дебиторской/кредиторской задолженности по непубличным инструментам и ISIN или другие типы кодов для публичных инструментов (акции, облигации и т.п.).

Вот пример начисления дебиторской задолженности c 0 до 1 млн, и последующее его списание до 0:

В случае с кредиторской задолженностью будет так (меняется только знак). Мы сперва начислили долг в -1 млн. А потом списали в ноль:

Пример начисление дебиторской задолженности по выплате купонов, которые уже должны были быть выплачены но еще не выплачены:

Если отнести транзакцию по выплате нкд/дивидендов к отдельно созданному общему инструменту с code_type = INSTRUMENT (например code_type=‘INSTRUMENT’, code=‘accint_debits’), вместо отнесения долга к конкретному ISIN, то нкд не будет участвовать в оценке самого инструмента и будет учтен отдельно. На уровне совокупного портфеля все будет ок, но при расчете дохода по инструменту не будет учтен нкд, который должен быть выплачен (не путать с оценкой нкд в ценах). По этому задолженность по конкретным активам нужно учитывать на уровне этих активов. {.is-warning}

Как учитывать операции РЕПО?

Операции РЕПО подразумевают 2 сделки/2 ноги. Для операций РЕПО необходимо использовать типы транзакций repo_l1 и repo_l2. В поле connected_transaction_id указывается номер связанной транзакции. В поле code_type указывается значение ‘INSTRUMENT’. Не указывается ISIN в поле code_type, т.к. мы рассматриваем операцию РЕПО как сделку по денежным средствам, а не по ценным бумагам. Мы предполагаем что РЕПО это аналог дебиторской/кредиторской задолженности с начислением процентов. Параметры РЕПО (процентная ставка, дата погашения) задаются в данных Инструменты.

Для каждой отдельной ноги РЕПО необходимо указывать сумму сделки в поле money. Поле securities заполняется число 1 для первой ноги РЕПО, а для второй ноги РЕПО заполняется число -1.

Вот пример учета операций обратного РЕПО:

для прямого РЕПО знаки будут обратные (минус для бумаг, + для денежных средств)

Ниже пример учета операций прямого РЕПО:

Как учитывать операции депозитов?

Для операции с депозитами используется тип транзакции deposit. В поле code_type указывается значение ‘INSTRUMENT’. Параметры депозита (процентная ставка, дата погашения) определяются в разделе “Инструменты”. При открытии депозита в поле money указывается сумма депозита со знаком минус, а в поле securities указывается число 1. При закрытии депозита в поле money указывается сумма депозита со знаком плюс, а в поле securities указывается число -1.

Накопленный процентный доход по депозиту отражается в виде операций interest. В поле money отражается сумма процентов. В поле code_type указывается значение ‘INSTRUMENT’ с кодом соответствующего инструмента (депозита).

Вот пример учета операций депозитов:

Как учитывать операции по купле/продаже валюты?

Для операций по купле/продаже валюты используется тип транзакции forex. В данном случае подразумевается фактическая поставка денежных средств на валютный счет и списание денежных средств с рублевого или другого валютного счета. В поле code_type указывается значение ‘CASH’. В поле code указывается код валюты (USD, EUR, CNY, GBP и т.д.). В поле money указывается сумма списания или начисления денежных средств. Поле securities не заполняется.

При продаже валюты в поле money указывается сумма сделки со знаком минус на счете, откуда списываются деньги для покупки другой валюты, а на счете, куда поступает валюта, указывается сумма денег со знаком плюс.

В данном случае мы не указываем курс валюты, т.к. он будет вычислен автоматически. Для нас важно понимать изменение баланса денежных средств в исходных валютах каждого счета.

Вот пример учета операций по продаже валюты USD за RUB:

Как учитывать операции по замещению/конвертации ценных бумаг?

Для этого необходимо создать 2 транзакции с типом trade. Лучшим решением будет сделать продажу/покупку по цене 100% от номинала. В этом случае зафиксируем виртуальный доход по замещенной (конвертируемой) бумаге и начнем считать заново доход по новой бумаге.

• В первой транзакции указывается код ценной бумаги, которая выбывает (продается) из портфеля, а во второй транзакции указывается код ценной бумаги, которая поступает в портфель.
• В поле code_type указывается значение ‘ISIN’. В поле code указывается код старой и новой ценной бумаги.
• В поле securities указывается для первой транзакции количество ценных бумаг, которые выбывают, со знаком минус, а для второй транзакции количество поступающих (новых) ценных бумаг со знаком плюс.
• В поле money указываем суммы номиналов (с учетом кол-ва бумаг) с противоположными знаками. В совокупности баланс денежных средств не меняется, при этом фиксируется финансовый результат по позициям .

Вот пример учета операций по замещению (конвертации) ценных бумаг:

Как учитывать операции по переводу ценных бумаг или денежных средств внутри портфеля со счета на счет?

Для этого необходимо создать 2 транзакции с типом transfer_internal с разными номерами счетов.

• Для перевода позиций ценных бумаг нужно указать только код ценной бумаги и количество ценных бумаг.
• Для перевода денежных средств нужно указать только код валюты и сумму денежных средств.
• Для счетов где происходит выбытие знак суммы должен быть минусовым, а для счетов где происходит поступление знак суммы должен быть положительным.

Как учитывать операции по выплате вознаграждения или начислению кредиторской или дебиторской задолженности по вознаграждению?

Для этого необходимо использовать типы транзакций fee и относить их к отдельно созданным инструментам, с классом активов “Вознаграждение управляющего”. Данная конструкция позволит в дальнейшем анализе выделить отдельно выплаты вознаграждений и представить результаты их влияния на доходность портфеля. Также это позволит провести взаимоучет фактических выплат и начислений задолженности по выплате вознаграждений и не отражать их отдельно.

Пример начисления кредиторской задолженности по выплате вознаграждения и дальнейшее ее фактическое списание с расчетного счета:

Как учитывать операции по начислению дивидендов?

После даты фиксации реестра создается запись по увеличению баланса задолженности в поле debt c положительным знаком. Code и code_type указывают код той акции, по которой начисляются дивиденды. После выплаты дивидендов создается запись по списанию задолженности с отрицательным знаком, а также транзакция по начислению дивидендов с положительным знаком в поле money.

Пример начисления дивидендов и их фактического списания:

Таким образом, в СЧА портфеля будут учтены дивиденды, начиная с даты фиксации реестра, а не с даты фактической выплаты.

Список бирж

Названия бирж и их ID (значение exchange_id) ограничены следующим списком:

Цены активов (prices)

Таблица цен определяет динамику котировок для каждого актива в портфеле и нужна для оценки активов и расчета стоимости портфеля на любой день в периоде. Загрузка собственных цен на активы позволяет учесть ценовую политику клиента/отдельного портфеля. Цены на активы обязательно должны включать нкд и указание на используемую валюту котировки.

В таблицу включаются котировки по всем активам из портфеля, на все дни, на которые активы присутствовали в портфеле.

Таблица Prices

*Обязательное поле

Особенности учета цен и нкд в разных валютах

В таблице предусмотрено указание валюты для каждого типа цены, нкд и номинала инструмента. Как правило, все цены и НКД указаны в валюте номинала, однако встречаются ситуации, когда цены указаны в одной валюте, например, НКД в другой. Это зависит от площадки, на которой торгуется инструмент. К примеру, на Московской бирже торгуются инструменты с номиналом в валюте USD, но НКД указан в валюте RUB.

Для оценки стоимости портфеля используется поле price_dirty, которое содержит цену в валюте котировки с учетом НКД. По этому поля price_dirty и price_dirty_currency заполняются обязательно, и при этом валюта котировки может отличаться валюты номинала. Конвертация по курсу при расчете СЧА и стоимости портфеля произойдет автоматически.

Проверка заполнения данных цен

• Если заполняется поле price_clean, то поле price_clean_currency должно быть заполнено
• Если заполняется поле facevalue, то поле facevalue_currency должно быть заполнено
• Если заполняется поле accint, то поле accint_currency должно быть заполнено

Где указывать цены на долевые инструменты (акции, фонды, депозитарные расписки)?

Для долевых инструментов котировки и валюта заполняется только поле price_dirty и price_dirty_currency. Поля с другими типами цен, номиналом и НКД заполнять не требуется.

FAQ

1. Дебиторская задолженность разделена на дебиторскую задолженность и прочую дебиторскую задолженность, что относится к одной, что к другой?

Можно использовать любой из предложенных вариантов. По умолчанию используйте класс актива “Дебиторская задолженность”. Если у вас есть необходимость разделить дебиторскую задолженность на несколько категорий, то вы можете использовать класс актива “Прочая дебиторская задолженность”.

Тот же принцип используется и для Кредиторской задолженности.

2. Что за тип инструментов “Вознаграждение управляющего”?

Это специальный класс актива (тип инструмента), который позволяют идентифицировать:

• a) Позицию в составе портфеля как кредиторскую/дебиторскую задолженность по вознаграждению для таблицы Portfolio,
• b) Отобразить операции по начислению задолженности, или фактическому списанию вознаграждения для таблицы Transactions.

Для таблицы Portfolio указывается задолженность по выплате/возврату вознаграждения управляющего. Для таблицы portfolio указывается только кредиторская/дебиторская задолженность по вознаграждению по состоянию на отчетную дату. Фактические выплаты/возвраты вознаграждения управляющего отражаются в таблице Transactions.

Для таблицы Transactions указывается фактическая сумма списания/возврата вознаграждения в поле money с типом операции fee, или сумма начисленной/списанной задолженности в поле debt с типом операции debt

3. Что за тип инструментов “Расходы административные и прочие”?

Это специальный класс актива (тип инструмента), который позволяют идентифицировать:

• a) Позицию в составе портфеля как кредиторскую/дебиторскую задолженность по расходам административным и прочим для таблицы Portfolio,
• b) Отобразить операции по начислению задолженности, или фактическому списанию расходов административных и прочих для таблицы Transactions.

Для таблицы Portfolio указывается задолженность по выплате/возврату расходов административных и прочих (аудиторы, ведение счетов, оплаты прочим контрагентам, и другие начисления, относящие к административным расходам ведения деятельности на усмотрение составителя отчетности). Для таблицы Portfolio указывается только кредиторская/дебиторская задолженность по административным и прочим расходам.

Для таблицы Transactions указывается фактическая сумма списания/возврата административных и прочих расходов в поле money с типом операции fee, или сумма начисленной/списанной задолженности в поле debt с типом операции debt.

4. Вознаграждение управляющего в таблице Portfolio показываем как вознаграждение к удержанию? То есть за месяц показываем авансы к удержанию, а за год итоговое вознаграждение?

Верно, в таблице Portfolio указываются только кредиторская/дебиторская задолженность по вознаграждению управляющего на отчетную дату, если таковая имеются, т.е. указываем позицию, если это учтено в бэкофисе на уровне расчета СЧА портфеля. Аналитические данные по вознаграждению управляющего (начисления, списания) отображать не требуется.

5. Если по итогам года будет возврат ранее уплаченных авансов по вознаграждению?

Если при составлении отчетности на конец года (например 31.12.2024) произведен пересчет вознаграждения управляющего и выявлено, что ранее уплаченные авансы по вознаграждению управляющего превышают фактическое вознаграждение, то в таблице portfolio на дату 31.12.2024 указывается дебиторская задолженность по вознаграждению управляющего. Сделать это можно путем отображения инструмента с типом актива “Вознаграждение управляющего” и указанием суммы дебиторской задолженности в поле price_dirty.

Пример отображения дебиторской задолженности по вознаграждению управляющего на 31.12.2024 в таблице portfolio:

6. На какие даты заполнять таблицу Portfolio?

Минимальный набор дат для таблицы portfolio:

• дата начала периода
• дата конца периода Начало периода - это как правило дата конца предыдущего года, например 31.12.2024. Обратите внимание, что 01.01.2025 в этом примере не будет началом периода, т.к. результаты управления за текущий год считаются от СЧА на дату конца предыдущего года.

Мы рекомендуем заполнять таблицу portfolio на даты окончания каждого календарного месяца в отчетном периоде, в т.ч. на дату начала периода (дата конца предыдущего года, например, 31.12.2024).

7. Если за период отчета, например, за год была начислена кредиторская задолженность (КЗ) и за этот же период закрыта, то нужно ли показывать и начисление КЗ и списание ДС или закрытие КЗ?

Да, для этого нужно создать 2 транзакции с изменением баланса по полю debt для созданного инструментам. Пример создания и списания КЗ:

Таким образом 2023-06-30 будет отражено начисление КЗ, а 2023-09-30 списание КЗ.