Пример строки
|
HD;123;456;2011-07-01T00:00:00.000+04:00;2011-07-02T00:00:00.000+04:00
|
Зачисление (D строка)
Для каждого перевода, зачисленного за отчетный период, формируется отдельная D-строка.
Внимание! Временем совершения операции считается время, возвращенное сервером Системы в поле processedDT в ответе на запрос Контрагента. Границы отчетного периода исчисляются в соответствии со значением поля processedDT.
Формат строки
|
D;clientOrderId;amount;currency;ymAccount;processedDT;subAgentId
|
Таблица 3 Поля зачисления
Поле
|
Тип данных
|
Описание
|
clientOrderId
|
ClientTransactionNumber
|
Идентификатор операции, ранее указанный Контрагентом для данной операции.
|
amount
|
CurrencyAmount
|
Сумма операции.
|
currency
|
CurrencyCode
|
Код валюты по ISO-4217 (643 - рубль РФ)
|
ymAccount
|
YMAccount
|
Идентификатор получателя перевода в системе "Яндекс.Деньги"
|
processedDT
|
xs:dateTime
|
Время зачисления средств на счет получателя, ранее возвращенное в ответе на запрос операции зачисления.
|
subAgentId
|
xs:long
|
Идентификатор канала приема переводов. Необязательный параметр. Присутствует в случае, если Контрагент разделяет платежи по нескольким каналам.
|
Пример строки
|
D;123;1000.00;643;41001000040;2011-07-01T10:52:01.000+04:00
|
Пример строки для Контрагента разделяющего переводы по subAgentId
|
D;123;1000.00;643;41001000040;2011-07-01T10:52:01.000+04:00;456
|
Контрольная строка (TD строка)
Контрольная строка представляет собой сумму операций по реестру. Для нулевого реестра контрольная строка отсутствует.
Формат строки
|
TD;count;sum;currency
|
Таблица 4 Поля контрольной строки
Поле
|
Тип данных
|
Описание
|
count
|
xs:int
|
Количество операций в реестре.
|
sum
|
CurrencyAmount
|
Общая сумма по операциям в реестре.
|
currency
|
CurrencyCode
|
Код валюты суммы по ISO-4217 (643 - рубль РФ)
|
Пример строки
|
TD;10;10547.25;643
|
Нулевая строка (Z строка)
Указывает, что за данный отчетный период операций не было (нулевой реестр). Присутствует только для нулевого реестра.
Примеры реестров
Пример реестра за сутки 01.07.2011
|
HD;123;456;2011-07-01T00:00:00.000+04:00;2011-07-02T00:00:00.000+04:00
D;123;1000.00;643;41001000040;2011-07-01T10:52:01.000+04:00;456
D;124;25000.00;643;41001000040;2011-07-01T10:52:02.000+04:00;457
TD;2;26000.00;643
|
Пример нулевого реестра за сутки 01.07.2011
|
HD;123;456;2011-07-01T00:00:00.000+04:00;2011-07-02T00:00:00.000+04:00
Z
|
Приложения
Формат данных CSV (Comma Separated Values)
Реализация формата CSV соответствует рекомендации IETF RFC4180 http://tools.ietf.org/html/rfc4180 .
Разделитель полей точка с запятой «;». Кодировка символов - UTF-8.
Текстовый формат CSV представляет собой набор строк, разделенных символом переноса строки (LF или CRLF). Каждая строка содержит поля, разделенные точкой с запятой «;». Если в значении параметра встречаются символы двойные кавычки «"» или точки с запятой «;» или переносы строк, то такие параметры должны заключаться в кавычки «"». Если в значении поля присутствуют кавычки, то они удваиваются:
Пример
|
643;5000.00;”ОАО КБ ””Банк”””
|
Допустимо помещать в кавычки все поля, вне зависимости от присутствующего в них набора символов. Если поле не помещено в кавычки, то все «соседние» пробелы (до точек с запятой или до начала или конца строки) игнорируются.
Обязательные и необязательные параметры, NULL значения
NULL-значение (отсутствие данных) поля указывается как пустая строка (строка нулевой длины).
Значение поля “пустая строка” указывается как строка нулевой длины, заключенная в двойные кавычки.
Структура CSV документа требует обязательного наличия всех полей. Разрешается опускать необязательные поля, но только в том случае, если они находятся в конце строки.
Пример: NULL значение в середине строки
|
col1;;col2
|
Пример: «пустое» значение в середине строки
|
col1;””;col2
|
Пример: отсутствующие необязательные поля в середине строки
|
col1;col2;;;col3
|
Пример: отсутствующие необязательные поля в конце строки
|
col1;col2;;;
col1;col2
|
Типы данных
Таблица 5 Типы данных
Тип
|
Описание
|
xs:int
|
32-bit целое знаковое число. Int32, определенный в стандарте: http://www.w3.org/TR/xmlschema-2/#int.
|
xs:long
|
64-bit целое знаковое число. Int64, определенный в стандарте: http://www.w3.org/TR/xmlschema-2/#long.
|
xs:decimal
|
Десятичное число с фиксированной точкой, определенное в стандарте: http://www.w3.org/TR/xmlschema-2/#decimal.
|
xs:string
|
Текстовая строка, определенная в стандарте: http://www.w3.org/TR/xmlschema-2/#string.
|
xs:normalizedString
|
Текстовая строка, определенная в стандарте: http://www.w3.org/TR/xmlschema-2/#normalizedString.
|
xs:dateTime
|
Временная метка в формате согласно рекомендациям:
http://www.w3.org/TR/xmlschema-2/#dateTime
ISO8601:2004
Формат определяется как:
YYYY-MM-DDThh:mm:ss.fZZZZZ
Расшифровка формата:
YYYY
|
год, точно 4 цифры
|
MM
|
месяц, точно 2 цифры (01=январь и т.д.)
|
DD
|
день месяца, точно 2 цифры (от 01 до 31)
|
T
|
латинский символ «T», должен быть в верхнем регистре
|
h
|
часы, точно 2 цифры (24-часовой формат, от 00 до 24)
|
mm
|
минуты, точно 2 цифры (от 00 до 59)
|
ss
|
секунды, точно 2 цифры (от 00 до 59)
|
f
|
дробная часть секунды (от одной до 6 цифр),
может отсутствовать, в этом случае следует опускать и разделитель «.»
|
ZZZZZ
|
описатель временной зоны, обязательный параметр, может принимать значения:
Z – UTC, символ "Z" должен быть в верхнем регистре;
+hh:mm или -hh:mm – смещение относительно UTC (показывает, что указано локальное время, которое на данное число часов и минут опережает или отстает от UTC)
|
Примеры:
2011-07-01T19:00:00.000+04:00 — 19 часов 00 минут 1 июля 2011 года, часовой пояс Санкт-Петербурга (Москвы) — UTC + 4 часа.
|
ClientTransactionNumber
|
Уникальный идентификатор операции. Должен быть уникальным для Контрагента на протяжении всей истории операций. Значением параметра должна быть строка длиной от 1 до 24 символов, содержащая символы, принадлежащие множеству значений: 0-9 A-Z a-z . , \ | / - + = # ~ ( ) { } [ ] : ; Рекомендуемые значения: целое положительное линейно нарастающее число в десятичной системе счисления.
|
YMAccount
|
Идентификатор получателя перевода, строка десятичных цифр длиной до 33 символов.
В качестве идентификатора может использоваться:
Счет пользователя в Системе (вида 4100175017397; длина существующих в Системе Счетов на данный момент варьируется от 10 до 16 цифр);
номер телефона пользователя, привязанный к Счету в Системе (допускаются номера российских операторов, рекомендуемое представление – 10-значные номера вида 9217575400, без дополнительных символов и пробелов);
код платежа в ООО «Яндекс» (все номера, начинающиеся с «50», «51»).
|
CurrencyAmount
|
Сумма. Положительное десятичное число с фиксированной точкой, кол-во цифр после точки точно равно двум.
|
CurrencyCode
|
Код валюты. Возможные значения:
643 — рубль Российской Федерации;
10643 — тестовая валюта (демо-рублики демо-системы «Яндекс.Деньги»).
|
От Оператора:
М.П.
Председатель Правления Шабанова Т.А.
|
От Контрагента:
М.П.
Должность, ФИО
|
Приложение №4
К договору об информационно-технологическом взаимодействии
при перечислении денежных средств в пользу физических лиц
№_________ от_____ |
