Спецификация сообщений
Торгового репозитария НКО АО НРД
Конвертируемый формат. Табличный формат.
Табличный формат предполагает заполнение таблиц в формате csv (разделитель запятая) или dbf или в формате Excel.
В разделе Примеры для каждого примера приводится ссылка Табличный формат,
по которой для скачивания доступен пример в форматах csv, dbf и xls.
При использовании формата csv или dbf один файл указанного формата
содержит одну таблицу, таким образом, участник предоставляет в репозитарий
строго определенный набор файлов в архиве. В сообщениях от репозитария участник
будет также получать строго определенный набор файлов.
При использовании формата Excel: один лист в книге Excel содержит одну таблицу, таким
образом, участник предоставляет в репозитарий книгу Excel, которая содержит строго
определенный набор листов. В сообщениях от репозитария участник будет также
получать книгу excel со строго определенным набором файлов.
Требования к наименованию файла архива
Наименование файла архива
состоит из следующих групп, разделяемых символом "#":
- идентификационный
код участника (репозитарный код), подготовившего архив – 12 символов, включая
только латинские буквы верхнего регистра и цифры. При подготовке архива
репозитарием указывается код репозитария NDC000000000;
- дата создания архива – 8 цифр в формате
YYYYMMDD;
- количество и формат файлов, содержащихся
в архиве – 5 символов: 2 цифры и 3 буквы формата (CSV, DBF, XLS);
- порядковый номер архива в пределах одной
даты – 2 символа, только цифры;
- признак направления движения документов
– "1" – документы для репозитария, "2" – документы от
репозитария (отчетные документы);
- расширение
файла ".zip".
Например, участник с кодом P00000000001
подготавливает второй архив в течение 21февраля 2013 года, содержащий 5
файлов:
P00000000001#20130221#05CSV#02#1.zip
Важно! В один архив включаются файлы только одного формата.
При направлении информации в репозитарий
и при получении информации из репозитария применяются средства электронной
подписи и шифрования информации, предусмотренные системой ЭДО (электронного
документооборота) репозитария. Электронная подпись ставится на архив. Шифрация
данных также производится на уровне архива.
Требования к наименованию файлов, включаемых в архив
Наименование файла состоит из двух групп:
- наименование файла, соответствующее структуре содержащейся в нем информации,
задается в соответствие со Структурой формата.
- расширение файла ".csv" ".dbf".
Например:
- header_new.csv
- product_masterAgreementTerms.dbf
Для файлов формата Excel наименование
файла состоит из двух групп, разделенных символом #, и расширения файла
".xls" или ".xlsx":
- дата и время создания архива – 12 цифр в формате YYYYMMDDHHMM;
- количество листов, содержащихся в архиве – 2 символа, только цифры.
Например: 201302211204#05.xls
Требования к наименованию листов книги Excel
Наименование листов задается в
соответствие со структурой формата.
Например:
- header_new
- product_masterAgreementTerms
Структура формата
Указанная структура описывает набор
файлов или листов книги Excel, направляемых в репозитарий.
Описание характеристик входящих/исходящих сообщений
|
header_[действие] (1)
|
Описание сделки, генерального соглашения, отчета или
специальной информации
|
trade (1)
|
report_[название отчета]
(1)
|
special_[наименование
специальной информации](1)
|
product_[название продукта] (1)
|
tradeCollateral (0)
|
tradeDoc (0)
|
nsdSpecificTradeFields (1)
|
Описание участников
|
parties (1)
|
Описание базовых активов
|
assets (0)
|
Описание характеристика отправляемых/получаемых сообщений
Характеристика отправляемых/получаемых
файлов/файла описывается в файле или листе книги Excel с названием header_[действие].
Конструкция [действие] подменяется
одним из следующих значений, в зависимости от направления сообщения:
- Исходящее сообщения
в репозитарий:
- new – первичная отправка сообщения, регистрация нового
сообщения;
- agreed – согласие с полученными условиями сделки, отчета;
- dispute – не согласие с полученными условиями сделки,
отчета;
- correction – изменение еще не зарегистрированных
условий сделки, отчета;
- change – изменение уже зарегистрированных
условий сделки, отчета;
- retract – отмена еще незарегистрированных условий сделки, отчета.
- Входящее сообщение из репозитария:
- agreed – сообщение зарегистрировано;
- error – сообщение содержит ошибку;
- diff - расхождения в условиях анкет;
- pending - уведомление о нахождении анкет в
статусе «ожидание» (RM007);
- statement - сообщение, содержащее выписку по
договорам участника/клиента;
- confirmationRequest_[требующая подтверждения
информация] – запрос подтверждения условий сделки, отчета. [требующая
подтверждения информация]: new (регистрация нового
сообщения), change (изменение
уже зарегистрированных условий сделки, отчета).
Описание идентификаторов сообщения:
- В
случае первичной отправки, в данном файле/листе указывается:
- репозитарный идентификатор
участника, который отправляет сообщение;
- дата
совершения отчитываемого события (дата актуальности предоставляемых данных). Здесь
и далее в формате дата указывается в следующем формате yyyy-MM-dd, например, 2013-06-05.
- В
случае отправки ответа, в данном файле указывается:
- репозитарный идентификатор участника, который
отправляет сообщение;
- идентификатор входящего сообщения,
указанный во входящем файле или листе header;
- идентификатор
цепочки сообщений указанный во входящем файле/листе header.
- В
случае входящего сообщения, в данном файле указывается: идентификатор цепочки
сообщений указанный во входящем файле/листе header.
Описание
сделки, отчета или специальной информации
Информация о сделке или генеральном соглашении заполняется в файлах или листах книги Excel: trade, product_[название продукта], где:
Информации о сделке:
trade содержит:
- стороны, принимающие участие в сделке:
Party1, Party2, TradeRepository;
- номер генерального соглашения, в рамках
которого совершается сделка;
- репозитарный номер сделки;
- номер сделки, присвоенный каждым из
участников;
- дата заключения сделки.
product_[название продукта] содержит
описание продукта, на месте конструкции [название продукта] указывается
наименование отчитываемого продукта (соответствует названию таблицы с описанием
продукта), например, для валютного свопа: product_fxSwap.
tradeCollateral содержит
описание обязательства стороны по обеспечению по сделке.
tradeDoc содержит описание
документов связанных со сделкой.
nsdSpecificTradeFields содержит
описание специальных атрибутов сделок (коды), требуемые в соответствии с
регулированием ФСФР.
Информация о генеральном соглашении:
trade содержит:
- стороны, принимающие участие в
генеральном соглашении: Party1, Party2, TradeRepository;
- дата заключения генерального соглашения.
product_[название
продукта] содержит
описание условий заключаемого генерального соглашения, на месте конструкции [название продукта] указывается
наименование таблицы, которая описывает параметры генерального соглашения, получаем
product_masterAgreementTerms.
Информации
об отчете заполняется в файле или листе книги Excel report_[наименование отчета]. Конструкция [наименование
отчета] заменяется наименованием отчета, которое соответствует названию таблицы
описывающей требуемый отчет.
Специальная
информация описывается в файле или листе книги Excel special_[наименование специальной информации].
Конструкция [наименование специальной информации] заменяется наименованием
таблицы в которой описывается указанная информация.
Описание
участников
Описание участников осуществляется в файле или листе
книги Excel с названием parties.
Описываются идентификаторы тех участников, которые использовались в «Описание
сделки, отчета или специальной информации». Например, в любой сделке всегда
используются следующие идентификаторы: Party1, Party2, TradeRepository, Sender (при
отправке сообщения в репозитарий), Receiver
(при получении сообщения из репозитария). Следовательно, данные идентификаторы
должны быть описаны, т.е. указаны торговый идентификатор участника и его
наименование.
Описание
базовых активов
Описание базовых активов, которые использовались в
«Описание сделки, отчета или специальной информации», осуществляется в файле
или листе книги Excel с названием assets. Например, в сделке репо использовалась еврооблигация
ОАО «Лукойл», указывался ее ISIN
XS0304273948. Следовательно, указанный ISIN должен быть
описан в файле/листе assets. Например,
таблица, описывающая, выше указанную облигацию, будет выглядеть так:
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
XS0304273948
|
2
|
Еврооблигации
ОАО "Лукойл", 6.356%, срок погашения - 07.06.2017
|
3
|
USD
|
Использования формата
Таблицы, описывающие формат, содержат следующую информацию:
- номер поля в таблице (№);
- наименование поля (Поле)
- краткое наименование поля (Название);
- тип поля (Тип);
- повторяемость поля (Повторяемость);
- расширенное описание (Описание).
Каждый смысловой блок таблицы выделен
следующим образом:
|
Начало описания: … Повторяемость: min: 0; max: 1
|
22
|
Поле 22
|
Название
поля 22
|
Тип поля 22
|
Повторяемость
поля 22
|
Описание
поля 22
|
|
Конец описания: …
|
|
Ветвление
|
|
Ветвь 1
|
23
|
Поле 23
|
Название
поля 23
|
Тип поля 23
|
Повторяемость
поля 23
|
Описание
поля 23
|
…
|
|
|
|
|
|
|
Ветвь 2
|
27
|
Поле 24
|
Название
поля 24
|
Тип поля 24
|
Повторяемость
поля 24
|
Описание
поля 24
|
…
|
|
|
|
|
|
|
Конец ветвления
|
При заполнении формата участник делает
следующее:
1. в первом столбце таблицы указывает номер
поля
2. во втором столбце таблице указывает присваиваемое
этому поле значение.
Со всеми последующими
полями участник поступает аналогично.
Особенности
заполнения нескольких одинаковых блоков таблицы
Заполнение нескольких одинаковых блоков в таблице осуществляется следующим образом:
- последовательно заполняются все строки таблицы, относящиеся к данному блоку, например, если
блок описывается строками с номерами 11, 12, 13, то в последовательно
заполняются указанные строки;
- далее, при необходимости указать еще один такой же блок в данной таблице, но уже с
другой информацией, нумерация повторяется и вносится необходимая информация.
Рассмотрим пример:
Порядковый
номер поля
|
Присваиваемое
значение
|
11
|
Значение 1
|
12
|
Значение 2
|
13
|
Значение 3
|
11
|
Другое значение
1
|
12
|
Другое
значение 2
|
13
|
Другое
значение 3
|
Пример
заполнения файла/листа header_[действие]
Первичная отправка.
Название файла/листа header_new.
Порядковый
номер поля
|
Присваиваемое
значение
|
2
|
P00000000111
|
3
|
2013-06-22
|
Отправка ответа.
Название файла/листа header_dispute.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
MesId-12345
|
2
|
P00000000111
|
Входящее сообщение
из репозитария. Сообщение зарегистрировано.
Название файла/листа header_agreed.
Порядковый
номер поля
|
Присваиваемое
значение
|
2
|
[P00000000111]-[2013]-[MesIdFra-1]
|
Пример
заполнения файла/листа trade. Описание сделки
Исходящее сообщение в
репозитарий. Первичная отправка сообщения.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
Party1-TradeId
|
1
|
Party2
|
2
|
NONREF
|
1
|
TradeRepository
|
2
|
NONREF
|
3
|
MA0123456789
|
4
|
2013-01-21
|
Входящее сообщение из репозитария. Сообщение
зарегистрировано.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
Party1-TradeId
|
1
|
Party2
|
2
|
Party2-TradeId
|
1
|
TradeRepository
|
2
|
D00123456789
|
3
|
MA0123456789
|
4
|
2013-01-21
|
Пример
заполнения файла/листа trade. Описание генерального соглашения
Исходящее сообщение в
репозитарий. Первичная отправка сообщения.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
Party1-MAId
|
1
|
Party2
|
2
|
NONREF
|
1
|
TradeRepository
|
2
|
NONREF
|
4
|
2013-01-21
|
Входящее сообщение из репозитария. Сообщение
зарегистрировано.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
Party1-MAId
|
1
|
Party2
|
2
|
Party2-MAId
|
1
|
TradeRepository
|
2
|
MA0123456789
|
4
|
2013-01-21
|
Пример заполнения файла/листа trade. Описание квартального отчета
Исходящее сообщение в
репозитарий. Первичная отправка сообщения.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
TradeRepository
|
2
|
NONREF
|
3
|
MA0123456789
|
Входящее сообщение из репозитария. Сообщение
зарегистрировано.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
TradeRepository
|
2
|
ReportIdentifier
|
3
|
MA0123456789
|
Пример
заполнения файла/листа parties.
Описание Party1, Party2, TradeRepository.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
P00000000111
|
3
|
Участник №1
|
1
|
Party2
|
2
|
P00000000222
|
3
|
Участник №2
|
1
|
TradeRepository
|
2
|
NDC000000000
|
3
|
НКО АО НРД
|
1
|
Sender
|
2
|
P00000000222
|
3
|
Участник №2
|
1
|
Receiver
|
2
|
NDC000000000
|
3
|
НКО АО НРД
|
Описание
Party1, Party2, TradeRepository с описанием клиентов.
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
Party1
|
2
|
P00000000111
|
3
|
Участник №1
|
4
|
ClientParty1
|
5
|
PC0000000111
|
1
|
Party2
|
2
|
P00000000222
|
3
|
Участник №2
|
4
|
ClientParty2
|
5
|
PC0000000222
|
1
|
TradeRepository
|
2
|
NDC000000000
|
3
|
НКО АО НРД
|
1
|
Sender
|
2
|
P00000000222
|
3
|
Участник №2
|
1
|
Receiver
|
2
|
NDC000000000
|
3
|
НКО АО НРД
|
Пример
заполнения файла/листа assets в случае указания нескольких активов
Порядковый
номер поля
|
Присваиваемое
значение
|
1
|
XS0304273948
|
2
|
Еврооблигации
ОАО «Лукойл», 6.356%, срок погашения - 07.06.2017
|
3
|
USD
|
1
|
RU0007661625
|
2
|
Акции
ОАО «Газпром»
|
3
|
RUB
|
Особенности формата CSV
CSV— текстовый формат,
предназначенный для представления табличных данных. Каждая строка файла — это
одна строка таблицы. Значения отдельных колонок разделяются разделительным
символом (delimiter) — точка с запятой ";". При отсутствии значения
конкретного элемента (пустой элемент) не допускается включения пробелов, сразу
же должна следовать точка с запятой. Пробел будет обрабатываться как значение
элемента.
Значения не
могут содержать символ запятой ",".
Один файл, если не оговорено иное, может
содержать не более 1000 строк.
В архив включается не более 20 файлов.
Особенности формата DBF
DBF — формат
хранения данных, используется версия dBase IV. DBF-файл делится на заголовок, в котором
хранится информация о структуре базы, используемой кодовой странице
(Windows-1251) и количестве записей и, собственно, область данных,
представляющую собой последовательно организованную таблицу из записей
фиксированной длины. Записи, в свою очередь, делятся на поля, также
фиксированной длины. При отсутствии значения конкретного элемента (пустой
элемент) не допускается включения пробелов. Пробел будет обрабатываться как
значение элемента.
Один файл, если не оговорено иное, может
содержать не более 1 000 строк.
В архив включается не более 20 файлов.
Особенности формата XSL, XSLX
XLS, XSLX – формат файла, поддерживаемый программой Microsoft Excel версии
Excel 2007 или Excel 2010. Содержит в себе набор листов, каждый лист, если не
оговорено иное, содержит неограниченное количество строк в области данных,
представляющих собой последовательно организованную таблицу из записей
фиксированной длины. При отсутствии значения конкретного элемента (пустой
элемент) не допускается включения пробелов. Пробел в пустой ячейке будет обрабатываться
как значение элемента.
Описание листа соответствует описанию
отдельного файла.
Не допускается включения в файл макросов.
Один лист, если не оговорено иное, может
содержать не более 1 000 строк.
Один файл Excel может содержать не более 20 листов.
Описание полей отдельных документов