Введение. Моя мфо учет в микрофинансовых организациях

Моя МФО - IT-партнер конференции по микрофинансированию

В 2016 году с16 по 18 ноября компания "Моя МФО" стала участником и партнером конференции по микрофинансированию. Этому способствовало несколько причин.

Во-первых, откровенно, мы почувствовали уверенность в своих силах. Из небольшой компании, за полтора года мы серьезно выросли, и на текущий момент нашим продуктом пользуется более 170 МФО нашей страны. Мы получаем положительную обратную связь от клиентов и очевидно, что наш продукт действительно делает бизнес-процессы МФО проще и удобней. Когда ты чувствуешь, что направление в котором ты движешься верное, ты хочешь увеличивать скорость, чтобы двигаться к намеченной цели быстрее, тем более, когда ты помимо этого соревнуешься с более зрелыми соперниками.

В этому году мы решили, что пора нам заявить о себе как о серьезной компании, которая имеет право на амбиции. Можем с уверенностью сказать - у нас это получилось! Наш стенд посетило большое количество участников конференции, они задавали очень предметные вопросы, что не может не радовать, поскольку чувствуется, что уровень самих МФО и погружение в проблемы и тонкости учета повышается. Очень много вопросов было связано с переходом на Единый план счетов и ОСБУ. Поскольку наш продукт уже готов к переходу на новые стандарты - участники много вопросов задавали именно способу реализации перехода.

Во-вторых, участие в конференциях подобного рода, это всегда обмен опытом, что позволяет четко осознавать вектор развития продукта и самого рынка микрофинансирования. На таких мероприятиях происходят обозначения дальнейших планов ЦБ, изменения в законодательстве, интересные кейсы и успешный опыт в тех или иных задачах.

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

Хотели бы поблагодарить организаторов конференции за предоставленную возможность участвовать в столь интересном и полезном мероприятии, надеемся что наше участие так же пошло ему на пользу. Так же хотим поблагодарить всех кто обратил на нас внимание, надеемся на взаимовыгодное сотрудничество.

Команда компании "Моя МФО"

mfo1c.ru

API Моя МФО

Данная документация создана с целью описания механизмов взаимодействия системы "Моя МФО" и сайта компании, которая является пользователем данного программного продукта. Данный API (программный интерфейс) позволяет реализовать различные схемы взаимодействия: загрузку заявок, выдачу займов и прием платежей. Чтобы начать использовать эти возможности нужно начать с публикации веб-сервисов. Далее вы найдете описание самих веб-сервисов с примерами.

Настройка веб-сервера и подключение http-сервисов, требуют определенного опыта, и не являются самыми простыми механизмами, поэтому при необходимости возможна помощь специалиста 1С.

При работе на собственном сервере

На сервере, где требуется произвести публикацию веб-сервисов необходимо произвести установку веб сервера (MS IIS или Apache), после этого, к нему устанавливается плагин от 1С, который передает запросы пользователей на сервер 1С.

Таким образом, операции физически выполняет сервер 1С, а веб-сервер (веб-сервис) служит просто передающим звеном.

Производим установку веб сервера 1С.

Установим веб сервер Microsoft Information Services (IIS) Установку веб сервера можно произвести из Панели управления Windows (варианты):

Установка и удаление программ/Компоненты Windows/IIS
Program and features/Turn windows features on or off/Add features.

В Windows 8 перейдите на закладку Roles, выберите Add Roles (откроется мастер).

На соответствующих закладках мастера нужно выбрать:

Web Server (IIS)
Application Development/ISAPI Extensions.

В других версиях Windows первая галочка может называться «Internet Information Services», вторая так же, или «Расширения ISAPI».

Установим компоненты 1С:Предприятие (после IIS)

Нужно проверить, что при установки платформы были установлены следующие компоненты:

Адаптер Web-сервисов 1С:Предприятие

Проведем настройку IIS (после установки 1С)

Настройку можно проводить в «Диспетчере служб IIS (IIS manager)», который находится в Панели управления Windows/Администрирование.

В ветке «Узлы (Web Sites)» находится веб-узел по-умолчанию, нажмите на него правой кнопкой и выберите «Добавить виртуальный каталог». Выделим курсором созданный каталог (левой кнопкой мыши), справа отобразятся различные его настройки. Выберите «Сопоставление обработчиков (Handler mappings)».

Справа появятся доступные действия. Выберите «Добавить сопоставление сценария (Add script map)».

Введите путь запроса «*», выберите исполняемый файл «wsisapi.dll» в каталоге bin соответствующей версии 1С:Предприятие, установленной на этом сервере (не забываем про права, если они у Вас специально ограничены).

По кнопке «Ограничение запроса (Request Restrictions)» там же, необходимо установить разрешающую галочку. После создания этого обработчика, установите на него курсор мыши, выберите «Проверка подлинности (Edit handler permissions)», разрешите его выполнение (Execute). Если база файловая, необходимо дать доступ к папке базы.

Далее правой кнопкой на созданный каталог, пункт «Преобразовать в приложение (Convert to Application)».

Публикация веб-сервисов конкретной базы

Зайдите в конфигуратор требуемой базы данных на этом сервере (компьютере).

В меню Администрирование/Публикация на веб-сервере выберите:

имя базы
каталог (обычно это «C:\Intetpub\wwwroot\КаталогОпубликованногоHTTPСервиса\»)

КаталогОпубликованногоHTTPСервиса - можно назвать именем базы

на вкладке http-сервисы проставьте все галки

Нажмите кнопку «Опубликовать».

В результате в требуемом каталоге должен появится файл с расширением VRD.

Проверяем брандмауэр (фаервол), антивирус и фильтры трафика на блокировку доступа к веб-сервису

При работе через "Сервис Клауд"

В случае, если вы работаете на сервере компании "Сервис Клауд", нужно произвести ряд действий:

Добавить в информационную базу пользователя с таким же логином и паролем, как у одного из учетных записей для подключения к серверу "Сервис Клауд". Именно под этим пользователем будет происходить авторизация и выполнение веб-сервисов.
Написать в службу технической поддержки запрос о публикации всех веб-сервисов вашей рабочей информационной базы. Путь к базе или название нужно указать, чтобы они поняли о какой базе идет речь.
В случае, если специалисты тех.поддержки опубликуют веб-сервисы, уточнить у них пути к веб-сервисам, если они не предоставят их в письме-уведомлении.

Загрузка заявок

POST http://АдресСервера/КаталогОпубликованногоHTTPСервиса/hs/Request/ User-Agent: АдресСервера Content-Type: application/json { "ID" : "" "last_name" : "Тестов", "first_name" : "Тест", "middle_name" : "Тестович", "phone" : "89117115544", "birthday" : "2017-05-05", "email" : "[email protected]", "amount" : "15000", "period" : "2017-06-20", "inn_number" : "4445558877", "id_sex" : "Мужской", "passport_series" : "45 10", "passport_number" : "666666", "passport_date_of_issue" : "2008-01-09", "birthplace" : "г. Хабаровск", "passport_org" : "ОВД Центрального округа, гор. Хабаровска", "passport_code" : "270-009", "incoming" : "35000", "work_name" : "ОАО РЖД", "experience" : "60", "work_phone" : "88123839935", "residential_region" : "Забайкальский кр.", "residential_city" : "г. Самара", "residential_street" : "Афонина", "residential_house" : "12", "residential_building" : "2", "residential_apartment" : "62", "match_addresses" : "0" "registrarion_region" : "Санкт-Петербург", "registrarion_city" : "Зеленогорск", "registrarion_street" : "Порядковая", "registrarion_house" : "11", "registrarion_building" : "3", "registrarion_apartment" : "58", }

Данный запрос возвращает строку в формате JSON:

{ "result": "1", "description": "Заявка создана", "IDDeal": "ТСК000157", "IDClient": "000019183" }

В случае ошибки запрос вернет:

{ "result": "0", "description": "Описание ошибки", }

Данный запрос позволяет загружать заявки с сайта компании или других ресурсов (лидогенераторов)

HTTP-запрос

POST http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/Request/

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом

Описание обязательных полей анкеты

Параметр Описание

amount	Сумма займа
period	Дата возврата
interval	Количество платежей (для займов с периодическим платежами)
creditproduct	Кредитный продукт
last_name	Фамилия
first_name	Имя
middle_name	Отчество
phone	Телефон
birthday	Дата рождения
passport_series	Серия паспорта
passport_number	Номер паспорта

В системе предоставляется загрузка любых доступных полей и назначение им соответствующих тегов при передаче. Данный функционал настраивается в системе "Моя МФО" в разделе Настройки "Моя МФО"\Общие\Обмен с сайтом\Онлайн-заявки

Возвращаемые значения

Параметр Описание

result	Результат, 1 - загружено успешно; 0 - не загружено
description	Описание
IDDeal	Номер заявки (договора)
IDClient	Код заемщика

Отправка договора в формате "pdf" (без подписи)

GET http://192.168.0.1/MeMFOWork/hs/dealinpdf/1_000000001/?pd=0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

Данный запрос позволяет получить заполненную даными клиента форму договора в формате pdf до подписания его клиентом, для вывода на сайте (в личном кабинете).

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealinpdf/<IDDeal>/?pd=<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов (не обязательный)
IDDeal	Номер договора займа

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Запрос на получение кода АСП (аналога собсвенаручной подписи) из "Моя МФО"

GET http://192.168.0.1/MeMFOWork/hs/dealsign/code/0808223433/1_000000001` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

Данный запрос позволяет получить код АСП (аналог собсвенаручной подписи) с целью его отправки клиенту в виде СМС или вывода на сайте для подписания договора.

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealsign/code/<Паспорт>/<IDDeal>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов
IDDeal	Номер договора займа

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Отправка полученного от клиента кода АСП и возврат подписанного договора в формате "pdf"

GET http://192.168.0.1/MeMFOWork/hs/dealsign/codereview/0808223433/1_000000001/1233243454354366234` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

Данный запрос позволяет отправить в базу "Моя МФО" код АСП (аналог собсвенаручной подписи), который клиент ввел на стороне сайта и в случае, если код введен верно вернуть подписанный данной АСП договор в формате pdf. В результате запроса статус займа меняется на "Подисан (дистанционно)".

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealsign/codereview/<Паспорт>/<IDDeal>/<CodeSHA256>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов
IDDeal	Номер договора займа
CodeSHA256	Строка: "IDClient + IDDeal + Код АСП", зашифрованная алгоритмом SHA256

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Получение сводных данных о сумме текущей задолженности по конкретному договору для вывода в личном кабинете

GET http://192.168.0.1/MeMFOWork/hs/PS/deal/1_000000001/0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "НомерДоговора": "06042017.00001", "ОбщийДолгНаТекДату": 245592.68, "ОстатокОД": 79249, "СуммаПроценты": 166343.68, "ДолгПоТекПлатежу": 70515, "ОстатокОДПоТекПлатежу": 1781, "СуммаПроцентыПоТекПлатежу": 68734, "ДолгПросроченный": 70515, "КоличествоДнейПросрочки": 18, "ОстатокОДПросрочено": 1781, "СуммаПроцентыПросрочено": 68734, "СуммаШтрафы": 0, "СуммаПошлина": 0, "СуммаПрочиеПлатежи": 0, "ОстатокНаСчете": 0, "ТекущийГрафикПлатежей": [ { "НомерСтроки": 1, "ДатаПлатежа": "2017-07- 06T00:00:00", "СуммаПлатежа": 70515, "СуммаОД": 1781, "СуммаПроцентов": 68734, "СуммаПрочиеПлатежи": 0, "ОстатокОД": 77468, "СуммаШтраф": 0 }, { "НомерСтроки": 2, "ДатаПлатежа": "2017-08- 06T00:00:00", "СуммаПлатежа": 270515, "СуммаОД": 5573, "СуммаПроцентов": 264942, "СуммаПрочиеПлатежи": 0, "ОстатокОД": 71895, "СуммаШтраф": 0 }, { "НомерСтроки": 3, "ДатаПлатежа": "2017-09- 06T00:00:00", "СуммаПлатежа": 170515, "СуммаОД": 17439, "СуммаПроцентов": 153076, "СуммаПрочиеПлатежи": 0, "ОстатокОД": 54456, "СуммаШтраф": 0 }, { "НомерСтроки": 4, "ДатаПлатежа": "2017-10- 06T00:00:00", "СуммаПлатежа": 170402, "СуммаОД": 54456, "СуммаПроцентов": 115946, "СуммаПрочиеПлатежи": 0, "ОстатокОД": 0, "СуммаШтраф": 0 } ], "Оплаты": [ { "НомерПриходника": "ТСТ00000129", "ДатаОплаты": "2017-06- 05T00:00:00", "СуммаОплаты": 200000, "ОнлайнОплата": false, "ОплатаНаРС": false }, { "НомерПриходника": "ТСТ00000141", "ДатаОплаты": "2017-06- 08T00:00:00", "СуммаОплаты": 141030, "ОнлайнОплата": false, "ОплатаНаРС": false } ], "СообщениеОбОшибке": "" }

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

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/PS/deal/<IDDeal>/<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
IDDeal	Номер договора займа
Паспорт	Серия и номер паспорта без пробелов

Возвращаемые значения

Параметр Описание

СообщениеОбОшибке

Описание ошибки, если она возникает

Получение данных о задолженности при оплате через сайт (для эквайринга)

GET http://192.168.0.1/MeMFOWork/hs/PS/dealforps/1_000000001/?pd=0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "НомерДоговора": "17062017.03.01", "ИмяОтчествоФ": "Андрей Александрович К.", "Телефон": "8968*****10", "ОбщийДолгНаТекДату": 17866.74, "СообщениеОбОшибке": "" }

Данный запрос позволяет получить информацию о сумме текущего платежа, а так же информацию для проверки заемщиком достоверности предоставленных сведений. Если на сайте имеется возможность приема платежей, перед перенаправлением клиента на форму ввода данных банковской карты система позволяет предоставить клиенту проверочную информацию, которая позволяет ему узнать сумму, необходимую для внесения, а так же убедиться, что данная сумма действительно относится к нему, поскольку выводится его номер телефона и ФИО.

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/PS/dealforps/<IDDeal>/?pd=<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
IDDeal	Номер договора займа
Паспорт	Серия и номер паспорта без пробелов (не обязательный)

Возвращаемые значения

Параметр Описание

СообщениеОбОшибке

Описание ошибки, если она возникает

Отражение в системе "Моя МФО" полученного на сайте платежа (эквайринг)

GET http://192.168.0.1/MeMFOWork/hs/Payment/Site/<IDPayServise>/?command=pay&txn_id=4431523121&txn_date=20170825120133&account=1_1000089&sum=2200 User-Agent: АдресСервера Content-Type: application/xml

Данный запрос возвращает строку в формате XML:

<?xml version="1.0" encoding="UTF-8"?> <response> <osmp_txn_id>4431523121</osmp_txn_id> <prv_txn>16286f65-9bc9-11e7-ae9f-000c2990aa10</prv_txn> <sum>2200</sum> <result>0</result> </response>

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

Данный запрос отправляет сайт после получения информации от платежного сервиса о внесенном платеже.

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/Payment/Site/<IDPayServise>/?command=<Command>&txn_id=<osmp_txn_id>&txn_date=<DatePayment>&account=<IDDeal>&sum=<Sum>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
IDPayServise	Идентификатор платежного сервиса в системе "Моя МФО" (Настройки Моя МФО\Общие\Обмен с сайтом\Платежные сервисы)
Command	Команда для отражения в системе "Моя МФО". Может принимать два значения: check - проверка возможности, pay - внесение оплаты
osmp_txn_id	Идентификатор платежа на стороне платежного сервиса
DatePayment	Дата платежа в формате 'yyyymmddhhmmss'
IDDeal	Номер договора займа
Sum	Сумма платежа

Возвращаемые значения

Параметр Описание

osmp_txn_id	Идентификатор платежа на стороне платежного сервиса
prv_txn	Идентификатор платежа в системе "Моя МФО"
sum	Сумма платежа
result	Результат выполнения (0 - успешно; 1 - не успешно)
comment	Описание ошибки
СообщениеОбОшибке	Описание ошибки, если она возникает

Отражение в системе "Моя МФО" полученного платежа через платежные системы: QIWI, Золотая корона, МКБ (Московский кредитный банк)

GET http://192.168.0.1/MeMFOWork/hs/Payment/QIWI/?command=pay&txn_id=4431523121&txn_date=20170825120133&account=1_1000089&sum=2200 User-Agent: АдресСервера Content-Type: application/xml

Данный запрос возвращает строку в формате XML:

<?xml version="1.0" encoding="UTF-8"?> <response> <osmp_txn_id>4431523121</osmp_txn_id> <prv_txn>16286f65-9bc9-11e7-ae9f-000c2990aa10</prv_txn> <sum>2200</sum> <result>0</result> </response>

Данный запрос позволяет произвести отражение в системе платежа, который был осуществлен клиентом через платежный сервис.

Данный запрос отправляет непосредственно платежный сервис.

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/Payment/<PayServise>/?command=<Command>&txn_id=<osmp_txn_id>&txn_date=<DatePayment>&account=<IDDeal>&sum=<Sum>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
PayServise	Название платежного сервиса: MKB, ZK, QIWI
Command	Команда для отражения в системе "Моя МФО". Может принимать два значения: check - проверка возможности, pay - внесение оплаты
osmp_txn_id	Идентификатор платежа на стороне платежного сервиса
DatePayment	Дата платежа в формате 'yyyymmddhhmmss'
IDDeal	Номер договора займа
Sum	Сумма платежа

Возвращаемые значения

Параметр Описание

osmp_txn_id	Идентификатор платежа на стороне платежного сервиса
prv_txn	Идентификатор платежа в системе "Моя МФО"
sum	Сумма платежа
result	Результат выполнения (0 - успешно; 1 - не успешно)
comment	Описание ошибки
СообщениеОбОшибке	Описание ошибки, если она возникает

Авторизация клиента на сайте

GET http://192.168.0.1/MeMFOWork/hs/client/?phone=89111111111&pass=Hgu32D11` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате xml:

<?xml version="1.0" encoding="UTF-8"?> <response> <status>0</status> <errormessage></errormessage> <fio>Иванов Иван Иванович</fio> <series>0101</series> <number>111222</number> <issued>МО УФМС России</issued> <dateissue>29.07.2008</dateissuecode> <code>270-000</code> <residence>190000, Санкт-Петербург, пр. Обуховской обороны д.86 кв.17</residence> <registration>190000, Санкт-Петербург, пр. Елизарова д.12 кв.271</registration> <placeofwork>ООО "Перспектива"</placeofwork> </response>

Данный запрос позволяет получить данные по клиенту по номеру телефона и хэш-паролю (параметр Pass).

Если хэш-пароль не задан, система его создает. В этом случае в запросе он не передается.

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/client/?phone=<phone>&pass=<pass>

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

Параметр Описание

phone	Телефон клиента
pass	Хэш-пароль, формируется как phone + Пароль клиента в базе. Если не передается система формирует его и возвращает в ответе.

Возвращаемые значения

Параметр Описание

status	Статус: 0 - успешно; 2 - не успешно, не совпадает пароль; 11 - успешно, создан пароль; 1 - не найден контрагент или не задан СМС-шаблон
errormessage	Описание ошибки
sum	Сумма платежа
fio	ФИО клиента
series	Серия паспорта
issued	Орган выдачи паспорта
dateissue	Дата выдачи паспорта
code	Код подразделения
residence	Адрес по месту проживания
registration	Адрес по месту регистрации
placeofwork	Место работы

Получения статусов договоров (сделок)

POST http://192.168.0.1/MeMFOWork/hs/statusdeal` User-Agent: АдресСервера Content-Type: application/json { "IDDeal1" : "1_000000001" "IDDeal2" : "1_000000012" "IDDeal3" : "1_000000003" "IDDeal4" : "1_000000010" }

Данный запрос возвращает строку в формате JSON:

{ "ID1": { "НомерСделки": "1_000000001", "ДатаСделки": "2017-09-21T10:15:30", "Статус": "Выдан" }, "ID2": { "НомерСделки": "1_000000012", "ДатаСделки": "2017-09-12T10:15:30", "Статус": "На рассмотрении" }, "ID3": { "НомерСделки": "1_000000003", "ДатаСделки": "2017-09-23T10:15:30", "Статус": "Оплачен" }, "ID3": { "НомерСделки": "1_000000010", "ДатаСделки": "2017-09-20T10:15:30", "Статус": "Предварительно одобрено" }, "КодОтвета": 0 }

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

HTTP-запрос

POST http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/statusdeal

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
IDDeal (n)	Номер договора займа

Возвращаемые значения

Параметр Описание

НомерСделки	Номер договора займа
ДатаСделки	Дата договора займа
Статус	Статус договора займа

Список статусов

Статус Описание

Новый	Заведена заявка, новый займ
На рассмотрении	Займ находится на рассмотрении
Одобрен	По займу приняли положительное решение
Отказ	По займу приняли отрицательное решение
Отменен	Заемщик отказался от займа
Подписан (дистанционно)	Договор подписан дистанционно
Ожидает списания с р/с	Ожидает отправки ден.средств с банковского счета организации
Выдан	Займ выдан
Внесен аванс	Внесен аванс раньше даты платежа
Оплачен	Займ полностью погашен
У коллектора	Передан коллектору
На текущем контроле у коллектора	Коллектор контролирует займ
Готовится выезд	Коллектор готовит выезд по адресам заемщика
Признан коллектором как безнадежный	Коллектор установил, что взыскать займ невозможно
Ожидает передачи на судебную стадию	Коллектор определили перспективу взыскания через суд
Передан на судебную стадию	Займ передан в юридический отдел на взыскание через суд
Отправлена претензия	По займу отправлена претензия
Оплачена пошлина	По займу оплачена пошлина
В суде	По займу отправлено исковое заявление
Получен исполнительный лист	Получили исполнительный лист
Передан судебному приставу	Исполнительный лист передан судебному приставу
Продан	Займ продан
Списан	Займ списан

Получения всех номеров договоров (сделок) по одному клиенту

GET http://192.168.0.1/MeMFOWork/hs/NumbersDeals/0808761223` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "Договоры": [ { "НомерДоговора": "ТСК000153", "Оплачен": true }, { "НомерДоговора": "ТСК000145", "Оплачен": false }, { "НомерДоговора": "ТСК000075", "Оплачен": false }, { "НомерДоговора": "ТСК000030", "Оплачен": false }, { "НомерДоговора": "ТСК000161", "Оплачен": false }, ], "СообщениеОбОшибке": "" }

Данный запрос позволяет получить информацию о всех номерах договоров (сделкок).

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/NumbersDeals/<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов

Возвращаемые значения

Параметр Описание

НомерДоговора	Номер договора займа
Оплачен	Статус оплаты займа: true или false
СообщениеОбОшибке	Описание ошибки, если она возникает

ftp.mfo1c.ru

API Моя МФО

При работе на собственном сервере

Производим установку веб сервера 1С.

Установка и удаление программ/Компоненты Windows/IIS
Program and features/Turn windows features on or off/Add features.

В Windows 8 перейдите на закладку Roles, выберите Add Roles (откроется мастер).

На соответствующих закладках мастера нужно выбрать:

Web Server (IIS)
Application Development/ISAPI Extensions.

В других версиях Windows первая галочка может называться «Internet Information Services», вторая так же, или «Расширения ISAPI».

Установим компоненты 1С:Предприятие (после IIS)

Нужно проверить, что при установки платформы были установлены следующие компоненты:

Адаптер Web-сервисов 1С:Предприятие

Проведем настройку IIS (после установки 1С)

Справа появятся доступные действия. Выберите «Добавить сопоставление сценария (Add script map)».

Далее правой кнопкой на созданный каталог, пункт «Преобразовать в приложение (Convert to Application)».

Публикация веб-сервисов конкретной базы

Зайдите в конфигуратор требуемой базы данных на этом сервере (компьютере).

В меню Администрирование/Публикация на веб-сервере выберите:

имя базы
каталог (обычно это «C:\Intetpub\wwwroot\КаталогОпубликованногоHTTPСервиса\»)

КаталогОпубликованногоHTTPСервиса - можно назвать именем базы

на вкладке http-сервисы проставьте все галки

Нажмите кнопку «Опубликовать».

В результате в требуемом каталоге должен появится файл с расширением VRD.

Проверяем брандмауэр (фаервол), антивирус и фильтры трафика на блокировку доступа к веб-сервису

При работе через "Сервис Клауд"

В случае, если вы работаете на сервере компании "Сервис Клауд", нужно произвести ряд действий:

Добавить в информационную базу пользователя с таким же логином и паролем, как у одного из учетных записей для подключения к серверу "Сервис Клауд". Именно под этим пользователем будет происходить авторизация и выполнение веб-сервисов.
Написать в службу технической поддержки запрос о публикации всех веб-сервисов вашей рабочей информационной базы. Путь к базе или название нужно указать, чтобы они поняли о какой базе идет речь.
В случае, если специалисты тех.поддержки опубликуют веб-сервисы, уточнить у них пути к веб-сервисам, если они не предоставят их в письме-уведомлении.

Загрузка заявок

Данный запрос возвращает строку в формате JSON:

{ "result": "1", "description": "Заявка создана", "IDDeal": "ТСК000157", "IDClient": "000019183" }

В случае ошибки запрос вернет:

{ "result": "0", "description": "Описание ошибки", }

Данный запрос позволяет загружать заявки с сайта компании или других ресурсов (лидогенераторов)

HTTP-запрос

POST http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/Request/

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом

Описание обязательных полей анкеты

Параметр Описание

amount	Сумма займа
period	Дата возврата
interval	Количество платежей (для займов с периодическим платежами)
creditproduct	Кредитный продукт
last_name	Фамилия
first_name	Имя
middle_name	Отчество
phone	Телефон
birthday	Дата рождения
passport_series	Серия паспорта
passport_number	Номер паспорта

Возвращаемые значения

Параметр Описание

result	Результат, 1 - загружено успешно; 0 - не загружено
description	Описание
IDDeal	Номер заявки (договора)
IDClient	Код заемщика

Отправка договора в формате "pdf" (без подписи)

GET http://192.168.0.1/MeMFOWork/hs/dealinpdf/1_000000001/?pd=0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealinpdf/<IDDeal>/?pd=<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов (не обязательный)
IDDeal	Номер договора займа

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Запрос на получение кода АСП (аналога собсвенаручной подписи) из "Моя МФО"

GET http://192.168.0.1/MeMFOWork/hs/dealsign/code/0808223433/1_000000001` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealsign/code/<Паспорт>/<IDDeal>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов
IDDeal	Номер договора займа

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Отправка полученного от клиента кода АСП и возврат подписанного договора в формате "pdf"

GET http://192.168.0.1/MeMFOWork/hs/dealsign/codereview/0808223433/1_000000001/1233243454354366234` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealsign/codereview/<Паспорт>/<IDDeal>/<CodeSHA256>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов
IDDeal	Номер договора займа
CodeSHA256	Строка: "IDClient + IDDeal + Код АСП", зашифрованная алгоритмом SHA256

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Получение сводных данных о сумме текущей задолженности по конкретному договору для вывода в личном кабинете

GET http://192.168.0.1/MeMFOWork/hs/PS/deal/1_000000001/0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

api.mfo1c.ru

5 проблем руководителя МФО

Проблема 1 - Бухгалтерия

Первое с чем сталкивается начинающие руководители микрофинансовых организаций - это не стандартная бухгалтерия МФО и отсуствие бухгалтеров, которые внятно могут объяснить как ее необходимо вести и способны на это. Поэтому первое, что необходимо определить, имеет ли ваш бухгалтер правильную квалификацию в этой области. Это важно, поскольку в конце каждого квартала необходимо сдавать отчетность в Центральный Банк - надзорный орган МФО, и без поддержки и знаний бухгалтера это может стать проблемой, т.к. в нем присутствую финансовые показатели, которые строятся на основании бухгалтерского баланса, поэтому к этому моменту бухгалтерия должна иметь актальные данные по начисленным процентам, резервам и т.п. Во-вторых, расходы на ведение бух. учета, без специализированных средств автоматизации многократно возрастают, т.к. в данном случае все бухгалтерские движения по займам необходимо считать и вбивать вручную - типовая 1С:Бухгалтерия не умеет правильно этого делать.

Основные трудности связанные с бухгалтерией: начисление процентов, формирование резервов на возможные потери по займам.

Проблема 2 - Выгрузка информации о заемщиках в бюро кредитных историй (БКИ)

Следующая проблема появилась относительно недавно в связи с вступлением в действие с 01.03.2015 года корректировок в закон "О кредитных историях", согласно которому все микрофинансовые организации должны выгружать информацию в бюро кредитных историй (БКИ). Один из вариантов - вручную вбивать информацию по каждому займу. При этом, в БКИ так же необходимо вносить информацию о каждом изменении состояния займа, об изменении срока просрочки, частичном погашении, реструктуризации, передачи коллекторам и в суд, решении суда и т.д. Как вы понимаете, когда речь идет о 10 займах, наверное физически это реально, но вот если займов больше, а скорее всего для рентабельной организации количество займов скорее должно превышать сотню, отследить изменение состояние каждого займа в ручную опять же - проблема. Здесь либо необходимо нанимать отдельного сотрудника на эту операцию, либо опять же, что лично я считаю необходимым использовать средста автоматизации. В частности в нашей системе данная операция проводится автоматически - что полностью освобождает от необходимости выполнения .

Проблема 3 - Поиск, привлечение и удержание клиентов в МФО

С ростом конкуренции на рынком микрофинансовых услуг появляется и сложности с привлечением платежеспособных клиентов. Особенно это ощутимо в крупных городах, где количество МФО на душу населения повышенное, а уровень платежеспособности и ответственности клиентов гораздо ниже. В такой ситуации микрофинансовым организациям приходится выделять эффективные каналы продвижения, чтобы иметь стабильный поток "платящих" клиентов. Вообще эта тема отдельного разговора, но в этой теме приведем краткий список испытанный на нашем опыте. Разобьем все инструменты по привлечению на две категории: инструменты для крупных городов (численность свыше 1 млн.) и небольших (численность населения менее 1 млн.). Для первой категории эффективными будут следующие каналы привлечения (ранжируются по эффективности вложений):

1. Интернет - это может быть реклама вашего сайта в яндекс-директ или гугл, либо вложение в органическое продвижение сайта (SEO).

2. Наружная реклама в местах с большим пешеходным трафиком (вывеска, стрит-лайн и т.д.)

3. Реклама на асфальте

Для второй категории мы выделяем следующие инструменты, сортированные по эффективности вложений:

1. Объявления на стендах у подъездов жилых домов

2. Рекламные объявления в местной газете

3. Наружная реклама

4. Интернет

Проблема 4 - Невозвраты

Одной из проблем начинающих организаций через 1-2 месяца работы становятся невозвраты, поскольку в самом начале многие бизнес-процессы начинающих организаций не регламентированы и как правило у не больших организаций отсутствуют четкие правила оценки и выдачи займов. Вследтвие этого, организация сталкивается с большим уровнем невозврата. Есть несколько решений данной проблемы. Во-первых, стоит принять меры в отношении правил оценки и выдачи займов, поскольку основное - это не выдавать займы не правильным заемщикам. Во-вторых, необходимо определить комплекс мер для борьбы с невозвратами, которые должны включать СМС-рассылки, звонки, выезды, письменые уведомления заемщиков - меры досудебного взыскания, а также комплекс действий связанных с судебной стадией взыскания. Касательно досудебной стадии работы с должником - есть несколько вариантов, можно обратиться к коллекторским агентствам, либо иметь свои отдел экономической безопасности. В первом случае плюсом является знание предметной области и вероятная эффективность действий, к минусам можно отнести - большое количество должников, что может являться снижением эффективности. На практике могу сказать, что своя служба безопасности работает эффективней, поскольку позволяет оперативно принимать решения по тому или иному должнику, и эффективность взыскания в денежном выражении выше, чем при сотрудничестве с коллекторскими агентствами. Ксательно суденой стадии, вот здесь на мой взгляд выгодней обратиться к отдельной организации, которая будет сопровождать весь процесс за определенную комисиию от взысканной суммы.

Проблема 5 - Воровство сотрудников

Одна из проблем, про которую говорят чуть ли не каждая 2 организация - воровство сотрудников, чаще менеджеров по выдаче займов. Поскольку специалист по выдаче займов имеет определенный "кредит доверия" в организации и не редко может принимать достаточно ответственные решения, то не редко, такое доверие оборачивается соблазном проведения мошеннических схем на своем рабочем месте. Как правило, данные схемы действую по такому сценарию - менеджер оформляет заявку на существующего клиента, хотя клиент не обращался за займом, и якобы выдает ему деньги, на самом деле забирая их себе. Бывает выдают займы "мертвым душам" по "левым" паспортам. На самом деле, схем очень много и они могут осуществляться как в сговоре с другими работниками организации, так и самостоятельно. Для решения данной проблемы существует несколько вариантов. Во-первых, самое главное правило - ИСКЛЮЧИТЬ ВОЗМОЖНОСТЬ воровства. Это можно сделать средствами автоматизации, настроив программное обеспечение таким образом, что любая операция будет контролироваться, и у потенциального вора не будет возможности провести свою операцию незаметно. Так же необходимо установить видеонаблюдение за работой специалистов такой группы риска. Кроме этого, постоянный мониторинг и проверки дадут понять, что все находится под контролем. А так же особое внимание стоит уделять подбору правильных кадров при приеме на работу, учитывать его предыдущий опыт, рекомендации и другие сведения, которые позволят исключить прием на работу не благонадежного сотрудника.

Итоги:

Поводя итоги, можно сказать, что некоторые из проблем носят фундаментальный характер и требуют скорейшего решения. Одним из решений всех 5 проблем в комплексе мер является программное обеспечение. Некоторые организации пренебрегают данным аспектом деятельности - используют либо простые способы автоматизации типа Excell, либо не использют вообще, но рано или поздно сталиваются с необходимостью перехода на специализированный софт, когда понимают, что справиться в ручную становится невозможным. Мы рекомендуем подойти к выбору качественного ПО с самого начала и рекомендуем нашу программу. Она решает все основные проблемы как руководителя, так и бухгалтера микрофинансовой организации.

mfo1c.ru

API Моя МФО

При работе на собственном сервере

Производим установку веб сервера 1С.

Установка и удаление программ/Компоненты Windows/IIS
Program and features/Turn windows features on or off/Add features.

В Windows 8 перейдите на закладку Roles, выберите Add Roles (откроется мастер).

На соответствующих закладках мастера нужно выбрать:

Web Server (IIS)
Application Development/ISAPI Extensions.

В других версиях Windows первая галочка может называться «Internet Information Services», вторая так же, или «Расширения ISAPI».

Установим компоненты 1С:Предприятие (после IIS)

Нужно проверить, что при установки платформы были установлены следующие компоненты:

Адаптер Web-сервисов 1С:Предприятие

Проведем настройку IIS (после установки 1С)

Справа появятся доступные действия. Выберите «Добавить сопоставление сценария (Add script map)».

Далее правой кнопкой на созданный каталог, пункт «Преобразовать в приложение (Convert to Application)».

Публикация веб-сервисов конкретной базы

Зайдите в конфигуратор требуемой базы данных на этом сервере (компьютере).

В меню Администрирование/Публикация на веб-сервере выберите:

имя базы
каталог (обычно это «C:\Intetpub\wwwroot\КаталогОпубликованногоHTTPСервиса\»)

КаталогОпубликованногоHTTPСервиса - можно назвать именем базы

на вкладке http-сервисы проставьте все галки

Нажмите кнопку «Опубликовать».

В результате в требуемом каталоге должен появится файл с расширением VRD.

Проверяем брандмауэр (фаервол), антивирус и фильтры трафика на блокировку доступа к веб-сервису

При работе через "Сервис Клауд"

В случае, если вы работаете на сервере компании "Сервис Клауд", нужно произвести ряд действий:

Добавить в информационную базу пользователя с таким же логином и паролем, как у одного из учетных записей для подключения к серверу "Сервис Клауд". Именно под этим пользователем будет происходить авторизация и выполнение веб-сервисов.
Написать в службу технической поддержки запрос о публикации всех веб-сервисов вашей рабочей информационной базы. Путь к базе или название нужно указать, чтобы они поняли о какой базе идет речь.
В случае, если специалисты тех.поддержки опубликуют веб-сервисы, уточнить у них пути к веб-сервисам, если они не предоставят их в письме-уведомлении.

Загрузка заявок

Данный запрос возвращает строку в формате JSON:

{ "result": "1", "description": "Заявка создана", "IDDeal": "ТСК000157", "IDClient": "000019183" }

В случае ошибки запрос вернет:

{ "result": "0", "description": "Описание ошибки", }

Данный запрос позволяет загружать заявки с сайта компании или других ресурсов (лидогенераторов)

HTTP-запрос

POST http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/Request/

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом

Описание обязательных полей анкеты

Параметр Описание

amount	Сумма займа
period	Дата возврата
interval	Количество платежей (для займов с периодическим платежами)
creditproduct	Кредитный продукт
last_name	Фамилия
first_name	Имя
middle_name	Отчество
phone	Телефон
birthday	Дата рождения
passport_series	Серия паспорта
passport_number	Номер паспорта

Возвращаемые значения

Параметр Описание

result	Результат, 1 - загружено успешно; 0 - не загружено
description	Описание
IDDeal	Номер заявки (договора)
IDClient	Код заемщика

Отправка договора в формате "pdf" (без подписи)

GET http://192.168.0.1/MeMFOWork/hs/dealinpdf/1_000000001/?pd=0808223433` User-Agent: АдресСервера Content-Type: application/json

Данный запрос возвращает строку в формате JSON:

{ "IDClient": "000005729", "IDDeal": "JJJ000141", "Code": "506712", "СообщениеОбОшибке": "" }

HTTP-запрос

GET http://<АдресСервера>/<КаталогОпубликованногоHTTPСервиса>/hs/dealinpdf/<IDDeal>/?pd=<Паспорт>

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

Параметр Описание

АдресСервера	Адрес сервера, на котором опубликован веб-сервис
КаталогОпубликованногоHTTPСервиса	Каталог в папке wwwroot с опубликованным сервисом
Паспорт	Серия и номер паспорта без пробелов (не обязательный)
IDDeal	Номер договора займа

Возвращаемые значения

Параметр Описание

IDClient	Код заемщика
IDDeal	Номер заявки (договора)
Code	Код АСП
СообщениеОбОшибке	Описание ошибки, если она возникает

Запрос на получение кода АСП (аналога собсвенаручной подписи) из "Моя МФО"

cloud.mfo1c.ru