Реестры успешных и возвращенных выплат

Яндекс.Деньги ежедневно формируют реестры успешных и возвращенных выплат. В реестрах — все операции за указанную дату (в период с 00:00:00 по 23:59:59 по московскому времени):

  • в реестре успешных выплат — все зачисленные выплаты;
  • в реестре возвращенных выплат — все возвращенные (полностью и частично) выплаты.

Реестры приходят на электронную почту, которую вы сообщили менеджеру при подключении. Реестры успешных и возвращенных выплат приходят разными письмами.

Если за указанную дату не было совершено никаких операций, придет пустой реестр.

Формат письма

Письма подписываются сертификатом Яндекс.Денег (S/MIME подпись).

Тема электронного письма формируется по шаблону (нумерация сквозная):

РЕЕСТР ДЛЯ <Название контрагента> ЗА <дата выплат в формате ДД-ММ-ГГГГ>. №<номер>

Во вложении к письму реестр в двух файлах:

  • в формате CSV — для автоматической обработки;
  • в формате XLS — для разбора вручную.

Формат имени файла реестра успешных выплат:

settlement_file_<agentId>_<yyyy-mm-dd>_<номер>.csv
settlement_file_<agentId>_<yyyy-mm-dd>_<номер>.xls

Формат имени файла реестра возвращенных выплат:

refund_<agentId>_<yyyy-mm-dd>_<номер>.csv
refund_<agentId>_<yyyy-mm-dd>_<номер>.xls

Структура реестра

Реестр содержит:

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

Реестр в формате CSV

Формат файла реестра соответствует рекомендации IETF RFC4180. Разделитель полей — точка с запятой «;». Кодировка символов — UTF-8.

Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"», точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"».

Note. Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.
Структура

Содержимое файла реестра состоит из следующих элементов:

  • HD-строка — заголовок реестра;
  • D-строки — информация о выплатах;
  • TD-строка — контрольная строка, сумма всех выплат за указанный период;
  • Z-строка — маркер отсутствия выплат (присутствует, если за указанный период не было никаких операций).
Заголовок (HD-строка)

Заголовок реестра содержит идентификатор магазина в Яндекс.Деньгах, номер реестра (идентификатор реестра) и отчетный период, за который сформирован реестр.

Параметры заголовка реестра

Параметр

Тип

Описание

registerId xs:long

Идентификатор сформированного реестра, уникальный на протяжении всей истории операций.

agentId xs:long

Идентификатор контрагента.

from xs:dateTime

Начало отчетного периода, за который сформирован реестр, включительно («от» включая).

Дата и время в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

till xs:dateTime

Конец отчетного периода, за который сформирован реестр, исключительно («до» не включая).

Дата и время в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

Параметр

Тип

Описание

registerId xs:long

Идентификатор сформированного реестра, уникальный на протяжении всей истории операций.

agentId xs:long

Идентификатор контрагента.

from xs:dateTime

Начало отчетного периода, за который сформирован реестр, включительно («от» включая).

Дата и время в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

till xs:dateTime

Конец отчетного периода, за который сформирован реестр, исключительно («до» не включая).

Дата и время в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

Пример заголовка реестра:

HD;123456;2277;2015-07-01T00:00:00.000+03:00;2015-07-02T00:00:00.000+03:00
Информация о выплате (D-строка)

Для каждой операции, проведенной за отчетный период, формируется отдельная D-строка.

Формат строки с информацией о выплате:

D;clientOrderId;amount;currency;dstAccount;processedDT;comission;comissionCurrencyCode

Параметры строки с информацией о выплате:

Параметр

Тип

Описание

dstAccount YMAccount

Идентификатор получателя перевода, значение параметра dstAccount из запроса makeDeposition.

clientOrderId ClientTransactionNumber

Уникальный номер транзакции в сервисе Яндекс.Денег (string, до 32 символов). Значение параметра clientOrderId из запроса makeDeposition.

processedDT xs:dateTime

Время зачисления на счет получателя, приходит в ответе на makeDeposition. В случае возврата — время проведения операции возврата денег со счета получателя выплаты.

Дата и время по часам Яндекс.Денег в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

amount CurrencyAmount

Сумма выплаты или возврата. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение amount из запроса makeDeposition.

currency CurrencyCode

Код валюты транзакции — целое беззнаковое число. Например: 643 — рубль РФ.

comission CurrencyAmount

Сумма комиссии, которую сервис Яндекс.Денег списал за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует.

Note. Может отсутствовать, если вы подключились до августа 2019 г. Чтобы получать в реестрах информацию о комиссиях, напишите вашему менеджеру.
comissionCurrency CurrencyCode

Код валюты комиссии — целое беззнаковое число. Например: 643 — рубль РФ.

Параметр

Тип

Описание

dstAccount YMAccount

Идентификатор получателя перевода, значение параметра dstAccount из запроса makeDeposition.

clientOrderId ClientTransactionNumber

Уникальный номер транзакции в сервисе Яндекс.Денег (string, до 32 символов). Значение параметра clientOrderId из запроса makeDeposition.

processedDT xs:dateTime

Время зачисления на счет получателя, приходит в ответе на makeDeposition. В случае возврата — время проведения операции возврата денег со счета получателя выплаты.

Дата и время по часам Яндекс.Денег в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

amount CurrencyAmount

Сумма выплаты или возврата. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение amount из запроса makeDeposition.

currency CurrencyCode

Код валюты транзакции — целое беззнаковое число. Например: 643 — рубль РФ.

comission CurrencyAmount

Сумма комиссии, которую сервис Яндекс.Денег списал за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует.

Note. Может отсутствовать, если вы подключились до августа 2019 г. Чтобы получать в реестрах информацию о комиссиях, напишите вашему менеджеру.
comissionCurrency CurrencyCode

Код валюты комиссии — целое беззнаковое число. Например: 643 — рубль РФ.

Пример строки:

D;123;107.00;643;410010000400;2015-07-01T10:52:01.000+03:00;3.21;643
Контрольная строка (TD-строка)

Контрольная строка представляет собой сумму всех переводов по текущему реестру. Если переводов в указанный период не было, то реестр считается пустым и контрольная строка отсутствует.

Note. Пустой реестр содержит только строку заголовка и нулевую строку (Z-строку).

Формат строки:

TD;count;sum;currency;comissionSum;comissionCurrency

Параметры контрольной строки:

Параметр

Тип

Описание

count xs:int

Количество выплат за указанный период.

sum CurrencyAmount

Общая сумма выплат за указанный период.

currency CurrencyCode

Код валюты общей суммы.

comissionSum CurrencyAmount

Общая сумма комиссии за указанный период.

comissionCurrency CurrencyCode

Код валюты общей суммы комиссии.

Параметр

Тип

Описание

count xs:int

Количество выплат за указанный период.

sum CurrencyAmount

Общая сумма выплат за указанный период.

currency CurrencyCode

Код валюты общей суммы.

comissionSum CurrencyAmount

Общая сумма комиссии за указанный период.

comissionCurrency CurrencyCode

Код валюты общей суммы комиссии.

Пример строки:

TD;86;88230.95;643;1163.25;643
Примеры реестров в формате CSV

Пример реестра

HD;123456;2277;2019-07-08T00:00:00.000+03:00;2019-07-09T00:00:00.000+03:00
D;123;107.00;643;41001000040;2019-07-08T08:49:48.648+03:00;3.21;643
D;124;200.00;643;41001000040;2019-07-08T10:37:39.974+03:00;6.00;643
TD;2;307.95;643;9.21;643

Пример пустого реестра

HD;123456;2277;2015-07-01T00:00:00.000+03:00;2015-07-02T00:00:00.000+03:00
Z

Примеры файлов

Реестр в формате XLS

Поля реестра
Поле Значение
Заголовок
AGENT ID Идентификатор контрагента.
Дата

Дата в формате ДД.ММ.ГГГГ

В реестр попадают платежи, датированные этим числом.

Порядковый номер реестра.
Таблица
Номер транзакции Уникальный номер транзакции в сервисе Яндекс.Денег (string, до 32 символов). Значение параметра clientOrderId из запроса makeDeposition.
Сумма Сумма транзакции. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение amount из запроса makeDeposition.
Валюта Валюта транзакции. Трехбуквенный код, например: RUB — рубль РФ.
Идентификатор получателя Идентификатор получателя перевода, значение параметра dstAccount из запроса makeDeposition.
Дополнительные реквизиты

Одно из трех значений, зависит от назначения выплаты.

На банковский счет: номер банковского счета получателя.

На банковскую карту: синоним номера банковской карты.

На баланс мобильного:

  • PROPERTY1 — код оператора мобильной связи;
  • PROPERTY2 — номер телефона.

PROPERTY1 и PROPERTY передаются в склеенном виде. Присутствуют, если были переданы в запросе makeDeposition.

ФИО получателя

Данные получателя перевода из запроса makeDeposition:

  • pdr_lastName — фамилия;
  • pdr_firstName — имя;
  • pdr_middleName — отчество.

Передаются в склеенном виде, только для выплат на банковские карты или счет.

Время перевода

Время зачисления на счет получателя, приходит в ответе на makeDeposition. В случае возврата — время проведения операции возврата денег со счета получателя выплаты.

Дата и время по часам Яндекс.Денег в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

Назначение

Счет, на который зачисляются деньги. Варианты:

  • Кошелек в Яндекс.Деньгах;
  • Банковская карта;
  • Банковский счет;
  • Баланс мобильного телефона.
Комиссия

Сумма комиссии, которую сервис Яндекс.Денег списал за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует.

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

Трехбуквенный код, например: RUB — рубль РФ.

Контрольная строка
Баланс счета Сумма обеспечения выплат на счете контрагента в сервисе Яндекс.Денег на момент формирования реестра.
Поле Значение
Заголовок
AGENT ID Идентификатор контрагента.
Дата

Дата в формате ДД.ММ.ГГГГ

В реестр попадают платежи, датированные этим числом.

Порядковый номер реестра.
Таблица
Номер транзакции Уникальный номер транзакции в сервисе Яндекс.Денег (string, до 32 символов). Значение параметра clientOrderId из запроса makeDeposition.
Сумма Сумма транзакции. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует. Значение amount из запроса makeDeposition.
Валюта Валюта транзакции. Трехбуквенный код, например: RUB — рубль РФ.
Идентификатор получателя Идентификатор получателя перевода, значение параметра dstAccount из запроса makeDeposition.
Дополнительные реквизиты

Одно из трех значений, зависит от назначения выплаты.

На банковский счет: номер банковского счета получателя.

На банковскую карту: синоним номера банковской карты.

На баланс мобильного:

  • PROPERTY1 — код оператора мобильной связи;
  • PROPERTY2 — номер телефона.

PROPERTY1 и PROPERTY передаются в склеенном виде. Присутствуют, если были переданы в запросе makeDeposition.

ФИО получателя

Данные получателя перевода из запроса makeDeposition:

  • pdr_lastName — фамилия;
  • pdr_firstName — имя;
  • pdr_middleName — отчество.

Передаются в склеенном виде, только для выплат на банковские карты или счет.

Время перевода

Время зачисления на счет получателя, приходит в ответе на makeDeposition. В случае возврата — время проведения операции возврата денег со счета получателя выплаты.

Дата и время по часам Яндекс.Денег в формате ГГГГ-ММ-ДДTчч:мм:сс.ссс±чч:мм (ISO 8601).

Назначение

Счет, на который зачисляются деньги. Варианты:

  • Кошелек в Яндекс.Деньгах;
  • Банковская карта;
  • Банковский счет;
  • Баланс мобильного телефона.
Комиссия

Сумма комиссии, которую сервис Яндекс.Денег списал за проведение выплаты. Разделитель дробной части — запятая, всегда ровно два знака после запятой, разделитель тысяч отсутствует.

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

Трехбуквенный код, например: RUB — рубль РФ.

Контрольная строка
Баланс счета Сумма обеспечения выплат на счете контрагента в сервисе Яндекс.Денег на момент формирования реестра.
Примеры реестров

Пример реестра успешных выплат: settlement_file_123456_2019-07-03_200000654321.xls

Пример реестра возвращенных выплат: refund_123456_2019-07-03_2000013167433.xls

Пример пустого реестра: settlement_file_123456_2019-07-03_2000008765432.xls

Смотрите такжe

Зачисление переводов