11.11. fraudwall_doc. Получение платежей для анализа

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

Внимание

В режиме интеграции в режиме анализа таблицы fraudwall_alert либо по http/https запросу внешней системы, fraudwall_doc не используется.

Внимание

fraudwall_doc должна возвращать все платежные документы от клиентов банка, имеющие статусы вида "сохранен черновик", "подписан", "отправлен в АБС" и т.д.

Результат выполняемого запроса не должен содержать документы с конечным статусом ( "исполнен", "отказан в исполнении", "удален" и т.д.)

fraudwall_doc по желанию банка может возвращать реквизиты даже платежей, которые еще не отправлены в банк на исполнение (т.е. черновики). Для того, чтобы FraudWall мог отличить черновик документа от его конечной версии (т.е. отправленной в банк на исполнение), предусмотрено поле docid - если оно пустое (NULL или пустая строка), FraudWall будет считать этот документ черновиком. Как только платежное поручение было отправлено в банк на исполнение, у него должно обновится поле updated (чтобы этот документ опять попал в результат выборки), а также docid - оно должно уже содержать непустое значение.

11.11.1. Описание полей структуры fraudwall_doc

Таблица 28. Перечень полей fraudwall_doc

Поле Тип данных Описание
updated ДАТА ВРЕМЯ Время последнего изменения состояния документа на стороне сервера банка

Примечание

При создании VIEW убедитесь, что поле в базе данных соответствует времени на стороне сервера, а не времени на стороне клиента (особенно это актуально для толстого клиента ДБО)

docid текст или число Идентификатор документа в анализируемой системе, или пустое значение, если документ еще не отправлен в банк на исполнение (например, является черновиком или еще не подписан клиентом)
sid текст или число

Идентификатор сессии на стороне сервера ДБО банка. Если не известен, то можно всегда возвращать пустое значение.

Примечание

Идентификатор сессии применим только для тонкого клиента - это значение, передаваемое браузером на сервер банка в виде JSESSIONID=12345678, SID=12345678, ASPSESSIONID=12345678. Если система ДБО не сохраняет в базе значение SID, всегда возвращайте пустое значение. Для "толстого" клиента ДБО возвращайте всегда пустое значение, т.к. в "толстом" клиенте сессия отсутствует.

ip текст IP адрес компьютера клиента банка в сети Интернет, с которого была работа с документом. Если неизвестно, можно возвращать пустую строку
device текст

строка, содержащая информацию об идентификаторах устройства клиента, с которого была работа с документом (например, перечень обнаруженных MAC-адресов, IMEI и т.д.). Если неизвестно, можно возвращать пустую строку.

Наименование идентификаторов: mac - MAC-адрес сетевой карты, appid - уникальный ID моб. приложения на моб. устройстве, serial-number - уникальный серийный номер моб. аппарата, imei - IMEI-номер моб. устройства, imsi - IMSI-номер SIM-карты, iccid - уникальный идентификационный номер SIM-карты в международном формате. Если у Вашей системы ДБО есть также свой цифровой отпечаток устройства клиента, необходимо сообщить об этом нам, м.б. выделено уникальное наименование идентификатора

Примечание

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

mac="00:11:22:33:44:55" mac="00:11:22:33:44:66" imei="123456789012345"

userid текст Логин, который вводил клиент для входа в ДБО. Если неизвестно, можно возвращать пустую строку
docnumber текст или число Поле документа «Номер документа».
docdate ДАТА ВРЕМЯ Поле документа «Дата документа».

Внимание

Обратите внимание, что тип данных этого поля - ДАТА ВРЕМЯ

from_operid текст или число

ID сотрудника банка в системе АБС, который создал данный платеж (если платеж был создан не клиентом, а сотрудником банка в АБС), NULL в остальных случаях

Примечание

Если анализируемая система - ДБО, создавать это поле нельзя.

Если анализируемая система - АБС, создавать это поле нужно всегда, даже если оно всегда будет возвращать NULL

from_oper текст

Фамилия Имя Отчество сотрудника банка в системе АБС, который создал данный платеж (если платеж был создан не клиентом, а сотрудником банка в АБС), NULL в остальных случаях

Примечание

Если анализируемая система - ДБО, создавать это поле нельзя.

Если анализируемая система - АБС, создавать это поле нужно всегда, даже если оно всегда будет возвращать NULL

from_id текст или число

ID клиента - владельца счета плательщика в анализируемой системе или NULL, если не известен

Примечание

Размерность и тип поля выбираются исходя из соответствующих типов полей в базе АБС или ДБО, т.к. FraudWall обрабатывает это поле как текст неограниченной длины.

from_name текст Поле документа «Наименование плательщика»
from_inn текст Поле документа «ИНН плательщика»
from_account текст Поле документа «расчетный счет плательщика»
from_bic текст Поле документа «БИК банка плательщика»
from_bank текст

Наименование банка, соответствующего БИК банка плательщика

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

from_city текст

Город, соответствующий банку плательщика

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

to_id текст или число

Идентификатор клиента в анализируемой системе, которому принадлежит расчетный счет получателя

Примечание

Если такой информации нет, или же расчетный счет получателя открыт в другом банке, можно возвращать NULL

to_name текст Поле документа «Наименование получателя»
to_inn текст Поле документа «ИНН получателя»
to_account текст Поле документа «расчетный счет получателя»
to_bic текст Поле документа «БИК банка получателя»
to_bank текст

Наименование банка, соответствующего БИК банка получателя

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

to_city текст

Город, соответствующий банку получателя

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

currency текст или число

3-х буквенный или 3-х числовой код валюты платежа

amount число с 2 знаками после запятой

Поле документа «Сумма платежа» (в валюте currency)

Примечание

При отсутствии или пустом значении поля currency валюта платежа берется из 20-значного счета получателя, а при его отсутствии - из 20-значного счета плательщика

purpose текст Поле документа «Назначение платежа»
speedy число Значение 1 соответствует платежу с признаком "срочно", остальные значения (NULL, 0) - обычный платеж
to_paygate_dboid текст Идентификатор поставщика услуг в ДБО (цифровой идентификатор уникальной связки "поставщик услуги -тип услуги" (например, идентификаторы для услуг Ростелеком-интернет, Ростелеком-телевидение и т.д.)) - опционально, значение может быть пустым
to_paygate_account текст Идентификатор лицевого счета, номер кошелька, но мер телефона или иной идентификатор клиента в системе поставщика услуг - опционально, значение может быть пустым

11.11.2. Получение платежей для проверки из VIEW fraudwall_doc

Назначение:

Данный запрос выполняется только в режиме анализа платежей из VIEW fraudwall_doc.

Когда выполняется запрос:

Период опроса указывается в свойствах сайта в параметре "Периодичность поиска платежей в базе данных" и составляет обычно раз в 5-30 секунд.

Входные параметры для запроса:

updated >= максимальное время updated, полученное в предыдущем запросе

Если в свойствах сайта в параметре Анализировать платежи, у которых поле "дата платежа" отлично от "любое", в запросе дополнительно указывается:

И docdate >= текущие сутки минус число рабочих дней, указанных в параметре "Анализировать платежи, у которых поле "дата платежа"..."

Примечание

Если FraudWall получает информацию из анализируемой системы через VIEW fraudwall_doc в базе Microsoft SQL Server, в SELECT также добавляется WITH(NOLOCK), исключая тем самым блокировку таблиц анализируемой системы.

Результат выполнения запроса:

Возвращает массив структур fraudwall_doc платежей, не исполненных и не отказанных в АБС, возможно даже не отправленных в банк на исполнение (см. поле docid), удовлетворяющий заданным критериям.