API freeze (Решение МВК)

API для проверки клиентов по решениям Межведомственной комиссии (МВК).

Сервис предоставляет методы для массовой и индивидуальной проверки клиентов по решениям МВК о замораживании (блокировании) денежных средств или иного имущества, формирования отчетов и интеграции с системой принятия решений.

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

Method	URI	Description
`GET\|HEAD`	`/api/maintenance/freeze/report/make`	Создать отчет freeze
`GET\|HEAD`	`/api/freeze/all-clients/result/files` `/api/freeze/check-all-clients-result/files`	Получить список файлов результатов проверки всех клиентов
`GET\|HEAD`	`/api/freeze/all-clients/result/file/{filename}` `/api/freeze/check-all-clients-result/file/{filename}`	Скачать файл результата проверки всех клиентов
`GET\|HEAD`	`/api/freeze/all-clients/result/list` `/api/freeze/check-all-clients-result/list`	Получить список результатов проверки всех клиентов
`GET\|HEAD`	`/api/freeze/all-clients/result/qty` `/api/freeze/check-all-clients-result/qty`	Получить количество результатов проверки всех клиентов

Индивидуальные проверки клиентов

Method	URI	Description
`GET\|HEAD`	`/api/freeze/check-client/{client_id}`	Получить информацию о проверке клиента
`POST`	`/api/freeze/check-client/{client_id}`	Запустить новую проверку клиента
`GET\|HEAD`	`/api/freeze/client-result/{client_id}`	Получить результат проверки клиента
`GET\|HEAD`	`/api/freeze/client-status/{client_id}`	Показать текущий статус клиента по его ID
`GET\|HEAD`	`/api/freeze/client/{client_id}/check`	Получить информацию о проверке клиента
`POST`	`/api/freeze/client/{client_id}/check`	Запустить новую проверку клиента
`GET\|HEAD`	`/api/freeze/client/{client_id}/result`	Получить результат проверки клиента
`GET\|HEAD`	`/api/freeze/client/{client_id}/status`	Показать текущий статус клиента по его ID

Описание Методов API

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

Создать отчет freeze

GET|HEAD /api/maintenance/freeze/report/make

Описание

Методы предназначены для создания в системе RFM отчета с результатами проверок по решениям МВК (Межведомственной комиссии) по противодействию финансированию терроризма. Метод используется для формирования аналитических отчетов по результатам проверок, мониторинга эффективности работы системы и подготовки данных для внешних систем.

Примеры запросов

GET /api/maintenance/freeze/report/make

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

{
    "status": "ok",                      // Статус выполнения операции ("ok" при успешном выполнении)
    "timestamp": 1755006198000,          // Временная метка ответа в миллисекундах
    "data": null                         // Данные ответа (null, так как методы только запускают процесс создания отчета)
}

Получить список файлов результатов проверки всех клиентов

GET|HEAD /api/freeze/all-clients/result/files GET|HEAD /api/freeze/check-all-clients-result/files

Описание

Метод возвращает список всех доступных файлов с результатами проверок по решениям МВК. Файлы содержат результаты массовых проверок клиентов в системе решений МВК.

Пример запроса

GET /api/freeze/all-clients/result/files

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754181490000,                        // Временная метка ответа
    "data": [                                          // Массив имен файлов результатов
        "2023-09-13_010113.xlsx",                      // Файл от 13.09.2023 01:01:13
        "2023-09-14_010100.xlsx",                      // Файл от 14.09.2023 01:01:00
        "2023-09-15_010045.xlsx",                      // Файл от 15.09.2023 01:00:45
        "2023-09-16_010049.xlsx",                      // Файл от 16.09.2023 01:00:49
        "2023-09-17_010048.xlsx",                      // Файл от 17.09.2023 01:00:48
        "2023-09-18_010054.xlsx"                       // Файл от 18.09.2023 01:00:54
    ]
}

Файлы содержат результаты проверок клиентов по решениям МВК за период с 13 по 18 сентября 2023 года. Каждый файл создается ежедневно в ранние утренние часы (около 01:00).

Скачать файл результата проверки всех клиентов

GET|HEAD /api/freeze/all-clients/result/file/{filename} GET|HEAD /api/freeze/check-all-clients-result/file/{filename}

Описание

Метод позволяет скачать конкретный файл с результатами проверок по решениям МВК по его имени. Файл содержит детальную информацию о результатах массовой проверки клиентов. Имя файла должно точно соответствовать списку из метода GET /api/freeze/all-clients/result/files

Параметры запроса

{filename} (string, обязательный) — имя файла для скачивания (например: "2023-09-13_010113.xlsx").

Пример запроса

GET /api/freeze/all-clients/result/file/2023-09-13_010113.xlsx

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754220845000,                        // Временная метка ответа
    "data": {
        "redirectTo": "https://rfm-stage-svc-stage.brainysoft.ru/web/report/download?ac-jar=0GzsXoMsSbCCPGe90d1G3MuSRZ82DshI4ZF7Od8fl71IrTY8qU0ANVPehSaqfkif9UMaQdTQACgCXFpXRH9B0SeLQdvycPoeEcTuAXF4fXrKdw3h9I7KVbt0PZsrtv8FOisaFw3IrJUJ8T4WP0FgbAZc4Beup4mKyQJoOk1HrJ0ldwqBI24KD7ef8IIEc3bVJconNpTJ4VTmHMENGW3jLuN8jWP5M6wdFF0jaZvfr1SnHu507qMhcPdBYQT6RxctuR8IaaPOOynjEiyp0JKFHSZjuo3c4l5hX4CS33AxawwDcfFVlWz1foontCbu9a1rZccbkWNUhlENZWUNqpUohPjz42CJDldwlAxDjjIpEbdyZAihxEb7QwuL98XfVhH430SqcSLVnUkN4oej0PLmrIKr0SDlwiHIS75WMDLN944zqBsgASKFu52jKboyP9tzOUtsMBz4Gx9KsS9mM0ApuZPQf8lvS2z0W8aRt3YGzAp7tS3W2BSA0ee52lic0zZO"
    }
}

Получить список результатов проверки всех клиентов

GET|HEAD /api/freeze/all-clients/result/list GET|HEAD /api/freeze/check-all-clients-result/list

Описание

Метод возвращает список всех результатов проверок клиентов по решениям МВК. Каждая запись содержит историю проверок клиента, его текущий статус и идентификаторы.

Пример запроса

GET /api/freeze/all-clients/result/list

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754221000000,                        // Временная метка ответа
    "data": [                                          // Массив результатов проверок
        {
            "checkLog": [                               // История проверок клиента
                {
                    "found": true,                      // Результат проверки - найден
                    "date": "2025-02-25T14:57:27+00:00" // Дата и время проверки
                },
                {
                    "found": true,                      // Результат проверки - найден
                    "date": "2025-02-25T15:09:17+00:00" // Дата и время проверки
                },
                {
                    "found": true,                      // Результат проверки - найден
                    "date": "2025-03-24T11:26:09+00:00" // Дата и время проверки
                },
                {
                    "found": true,                      // Результат проверки - найден
                    "date": "2025-07-14T07:47:02+00:00" // Дата и время проверки
                }
            ],
            "clientId": 1163,                           // ID клиента
            "currentStatus": 1,                          // Текущий статус клиента (1 - найден, 0 - не найден)
            "num": 6908488,                             // Номер записи
            "freeze_id": 6908488                           // ID записи в системе решений МВК
        }
    ]
}

Получить количество результатов проверки всех клиентов

GET|HEAD /api/freeze/all-clients/result/qty GET|HEAD /api/freeze/check-all-clients-result/qty

Описание

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

Пример запроса

GET /api/freeze/all-clients/result/qty

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754222232000,                        // Временная метка ответа
    "data": {
        "count": 1                                     // Количество клиентов, найденных в системе решений МВК
    }
}

Индивидуальные проверки клиентов

Получить информацию о проверке клиента

GET|HEAD /api/freeze/check-client/{client_id}

Описание

Метод возвращает текущую информацию о проверке клиента в системе решений МВК. Показывает актуальный статус клиента на момент последней проверки.

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/check-client/1162

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754222806000,                        // Временная метка ответа
    "data": {
        "found": "not found",                          // Результат проверки - клиент не найден в системе решений МВК
        "status": "NOT_FOUND"                          // Статус клиента - не найден в системе решений МВК
    }
}

Запустить новую проверку клиента

POST /api/freeze/check-client/{client_id}

Описание

Метод запускает новую проверку клиента в системе решений МВК и возвращает актуальный результат. В отличие от GET-метода, этот метод принудительно обновляет статус клиента.

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

POST /api/freeze/check-client/1162

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754222806000,                        // Временная метка ответа
    "data": {
        "found": "not found",                          // Результат проверки - клиент не найден в системе решений МВК
        "status": "NOT_FOUND"                          // Статус клиента - не найден в системе решений МВК
    }
}

Получить результат проверки клиента

GET|HEAD /api/freeze/client-result/{client_id}

Описание

Метод возвращает детальную историю проверок клиента по его ID. Каждая запись в истории содержит информацию о том, был ли клиент найден в системе решений МВК на момент проверки.

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/client-result/1162

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754222999000,                        // Временная метка ответа
    "data": [                                          // Массив результатов проверок клиента
        {
            "number": 1,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста (Нет - не найден, Да - найден)
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "25.02.2025",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        },
        {
            "number": 2,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "12.07.2024",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        },
        {
            "number": 3,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "12.07.2024",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        }
    ]
}

Анализ результатов проверки клиента ID 1162:

Проверка №1: Тест от 03.08.2025 - совпадений не выявлено
Проверка №2: Тест от 03.08.2025 - совпадений не выявлено
Проверка №3: Тест от 03.08.2025 - совпадений не выявлено

Общий результат: Клиент не найден в списках Межведомственной комиссии по противодействию легализации

Показать текущий статус клиента по его ID

GET|HEAD /api/freeze/client-status/{client_id}

Описание

Метод возвращает текущий статус клиента по его ID. Статус может быть FOUND (найден) или NOT_FOUND (не найден).

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/client-status/1162

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754223115000,                        // Временная метка ответа
    "data": {
        "clientId": "1162",                            // ID клиента
        "checkLog": [                                   // История проверок клиента
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:06:46+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:07:59+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:08:04+00:00"    // Дата и время проверки
            }
        ],
        "currentStatus": false,                         // Текущий статус клиента (false - не найден, true - найден)
        "rfm_id": 0,                                   // ID записи в системе решений МВК (0 если не найден)
        "lastCheck": "2025-08-03T12:08:04+00:00"      // Дата и время последней проверки
    }
}

Анализ истории проверок клиента ID 1162:

03.08.2025 12:06:46: Клиент не найден в системе решений МВК
03.08.2025 12:07:59: Клиент не найден в системе решений МВК
03.08.2025 12:08:04: Клиент не найден в системе решений МВК

Получить информацию о проверке клиента

GET|HEAD /api/freeze/client/{client_id}/check

Описание

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/client/1162/check

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754223301000,                        // Временная метка ответа
    "data": {
        "found": "not found",                          // Результат проверки - клиент не найден в системе решений МВК
        "status": "NOT_FOUND"                          // Статус клиента - не найден в системе решений МВК
    }
}

Запустить новую проверку клиента

POST /api/freeze/client/{client_id}/check

Описание

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

POST /api/freeze/client/1162/check

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754223420000,                        // Временная метка ответа
    "data": {
        "found": "not found",                          // Результат проверки - клиент не найден в системе решений МВК
        "status": "NOT_FOUND"                          // Статус клиента - не найден в системе решений МВК
    }
}

Получить результат проверки клиента

GET|HEAD /api/freeze/client/{client_id}/result

Описание

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/client/1162/result

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754223536000,                        // Временная метка ответа
    "data": [                                          // Массив результатов проверок клиента
        {
            "number": 1,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста (Нет - не найден, Да - найден)
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "25.02.2025",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        },
        {
            "number": 2,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "12.07.2024",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        },
        {
            "number": 3,                                // Номер проверки
            "testDate": "03.08.2025",                   // Дата тестирования
            "testResult": "Нет",                        // Результат теста
            "testResultNo": "Да",                       // Обратный результат теста
            "listDateYes": "",                          // Дата списка при положительном результате
            "listDate": "12.07.2024",                   // Дата списка
            "listDateCorrect": "12.07.2024",            // Скорректированная дата списка
            "listName": "Межведомственная комиссия по противодействию легализации _12.07.2024.xml (12.07.2024)", // Название списка
            "testMessageResults": "Совпадений не выявлено" // Сообщение о результатах теста
        } 
    ]
}

Анализ результатов проверки клиента ID 1162:

Проверка №1: Тест от 03.08.2025 - совпадений не выявлено
Проверка №2: Тест от 03.08.2025 - совпадений не выявлено
Проверка №3: Тест от 03.08.2025 - совпадений не выявлено

Общий результат: Клиент не найден в списках Межведомственной комиссии по противодействию легализации

Показать текущий статус клиента по его ID

GET|HEAD /api/freeze/client/{client_id}/status

Описание

Метод возвращает текущий статус клиента по его ID. Включает полную историю проверок клиента, его текущий статус и идентификаторы. Статус может быть true (найден) или false (не найден).

Параметры запроса

{client_id} (integer, обязательный) — уникальный идентификатор клиента.

Пример запроса

GET /api/freeze/client/1162/status

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

{
    "status": "ok",                                    // Статус ответа
    "timestamp": 1754223822000,                        // Временная метка ответа
    "data": {
        "clientId": "1162",                            // ID клиента
        "checkLog": [                                   // История проверок клиента
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:06:46+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:07:59+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:08:04+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:15:01+00:00"    // Дата и время проверки
            },
            {
                "found": false,                         // Результат проверки - не найден
                "date": "2025-08-03T12:17:00+00:00"    // Дата и время проверки
            }
        ],
        "currentStatus": false,                         // Текущий статус клиента (false - не найден, true - найден)
        "rfm_id": 0,                                   // ID записи в системе решений МВК (0 если не найден)
        "lastCheck": "2025-08-03T12:17:00+00:00"      // Дата и время последней проверки
    }
}

Анализ истории проверок клиента ID 1162:

03.08.2025 12:06:46: Клиент не найден в системе решений МВК
03.08.2025 12:07:59: Клиент не найден в системе решений МВК
03.08.2025 12:08:04: Клиент не найден в системе решений МВК
03.08.2025 12:15:01: Клиент не найден в системе решений МВК
03.08.2025 12:17:00: Клиент не найден в системе решений МВК

Общий результат: Клиент не найден в системе решений МВК (5 проверок подряд показали отрицательный результат)

Результаты проверок всех клиентов​

Индивидуальные проверки клиентов​

Описание Методов API

Результаты проверок всех клиентов​

Создать отчет freeze​

Получить список файлов результатов проверки всех клиентов​

Скачать файл результата проверки всех клиентов​

Получить список результатов проверки всех клиентов​

Получить количество результатов проверки всех клиентов​

Индивидуальные проверки клиентов​

Получить информацию о проверке клиента​

Запустить новую проверку клиента​

Получить результат проверки клиента​

Показать текущий статус клиента по его ID​

Получить информацию о проверке клиента​

Запустить новую проверку клиента​

Получить результат проверки клиента​

Показать текущий статус клиента по его ID​

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

Индивидуальные проверки клиентов

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

Создать отчет freeze

Получить список файлов результатов проверки всех клиентов

Скачать файл результата проверки всех клиентов

Получить список результатов проверки всех клиентов

Получить количество результатов проверки всех клиентов

Индивидуальные проверки клиентов

Получить информацию о проверке клиента

Запустить новую проверку клиента

Получить результат проверки клиента

Показать текущий статус клиента по его ID

Получить информацию о проверке клиента

Запустить новую проверку клиента

Получить результат проверки клиента

Показать текущий статус клиента по его ID