Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

Используется для настройки статусной модели подключаемого сервиса. На текущий момент поддерживаются такие действия: 

  • CLIENT_EXTERNAL_SIGN (ссылка для перехода в сервис по определенному URL клиента).
  • AGENT_GET_EXTERNAL_SIGN_URL (ссылка для передачи клиенту его агентом, оформившим заявку).
  • CLIENT_INTERNAL_SIGN (подписание заявок одной кнопкой).
  • AGENT_GET_INTERNAL_SIGN_URL (ссылка для подписания заявок клиентом одной кнопкой).
  • CLIENT_SIGN_OFFER (Принять предложение банка)
  • CORRECT_REQUEST (ссылка для внесения исправлений в заявку в сервисе).
  • GO_TO_SERVICE (ссылка для перехода в сервис).

APPLICATION_ID - идентификатор заявки в сервисе, которая указывается в составе URL. Должен быть передан в Goodfin в составе сообщения при получении заявки (см. пример в ШАГ 4.4. Отправка сообщения о присвоении номера заявке в сервисе).

EXT_APPLICATION_NUMBER - идентификатор, который приходит в сообщении от сервиса (тип сообщения: UpdateApplicationParams атрибут сообщения: applicationNumber).

SERVICE_SYS_VALUE - идентификатор поставщика продуктов(банка)

Сторона поставщика продуктов(банка)

Примеры объектов в составе userActions

(по требованиям поставщика сервиса возможно доработка и расширение поддерживаемых действий)

Описание назначения

{
"actionType": "CLIENT_EXTERNAL_SIGN",
"label": "Принять",
"description": "Перейти по ссылке для принятия предложения"
"template": "https://exampleService.com/указание на страницу с принятием предложения/{EXT_APPLICATION_NUMBER}?idp=системное имя банка"
}

Показан пример, который будет выводить клиенту кнопку "Принять" с всплывающей подсказкой "Перейти по ссылке для принятия предложения". При нажатии на кнопку клиент перейдет по ссылке, сгенерированной на основе значения поля template.

{

"actionType": "AGENT_GET_EXTERNAL_SIGN_URL",
"label": "Получить ссылку",
"description": "Получить ссылку для принятия предложения"
"template": "https://exampleService.com/указание на страницу для передачи клиенту с предложением без необходимости авторизации/{APPLICATION_ID}/"
}

Показан пример, который будет выводить агенту кнопку "Получить ссылку" с всплывающей подсказкой "Получить ссылку для принятия предложения". При нажатии на кнопку агент увидит модальное окно, в котором будет показана ссылка, сгенерированная на основе значения поля template. Агент сможет скопировать ссылку в буфер и далее передать клиенту любым удобным им способом.

{

"actionType": "CLIENT_INTERNAL_SIGN",
"label": "Подписать",
"description": "Подписать заявку"
"documentsToSignUrlTemplate": "http://указать страницу с документами на подписание}"
}

Показан пример, который будет выводить клиенту кнопку "Подписать все ( {количество заявок})". При нажатии на кнопку клиент перейдёт на страницу Подписания всех заявок в статусе "Готова к подписанию" средствами Goodfin. Результат подписания будет передан в банковские сервисы, с которыми выполнена интеграция по подписанию заявок на стороне Goodfin.
Примечание: На текущий момент работает для банковских сервисов на базе  платформ IT-Finance, ITCredit.

{
"actionType": "AGENT_GET_INTERNAL_SIGN_URL",
"label": "Получить ссылку",
"description": "Получить ссылку для подписания клиентом"
}

Показан пример, который будет выводить агенту кнопку "Подписать все ( )". При нажатии на кнопку агент скопирует ссылку для отправки клиенту на подписание всех заявок в статусе "Готова к подписанию". Агент может отправить ссылку клиенту любым удобным способом.

Клиент по полученной ссылке перейдёт на страницу Подписания всех заявок в статусе "Готова к подписанию" средствами Goodfin. Результат подписания будет передан в банковские сервисы, с которыми выполнена интеграция по подписанию заявок на стороне Goodfin.
Примечание: На текущий момент работает для банковских сервисов на базе  платформ IT-Finance

{
        "actionType": "CLIENT_SIGN_OFFER",
        "label": "Принять",
        "description": "Перейти по ссылке для принятия предложения",
        "documentsToSignUrlTemplate": "https://exampleService.com/bg_offer_document_list?applicationNumber={EXT_APPLICATION_NUMBER}&serviceSysValue={SERVICE_SYS_VALUE}&applicationId={APPLICATION_ID}",
        "commissionInfoUrlTemplate": "https://exampleService.com/comissioninfo?applicationNumber={EXT_APPLICATION_NUMBER}&serviceSysValue={SERVICE_SYS_VALUE}&applicationId={APPLICATION_ID}"
      }

Показан пример, который будет давать возможность выводить кнопку "???". 

documentsToSignUrlTemplate - шаблон формирования URL на получение списка документов. Возможно использовать переменные:

  • EXT_APPLICATION_NUMBER
  • SERVICE_SYS_VALUE
  • APPLICATION_ID

commissionInfoUrlTemplate - шаблон формирования URL на получение информации о комиссии. Возможно использовать переменные:

  • EXT_APPLICATION_NUMBER
  • SERVICE_SYS_VALUE
  • APPLICATION_ID

{
actionType: "CORRECT_REQUEST"
label: "Исправить заявку в сервисе"
description: "Перейти по ссылке для внесения исправлений в заявку в сервисе"
template: "https://exampleService.com/указание на страницу для исправления заявки{APPLICATION_ID}/"
}

Если во внешнем сервисе есть возможность исправить заявку, то можно показать пользователю действие "Исправить заявку". Показан пример, который будет выводить пользователю кнопку "Исправить заявку в сервисе" с всплывающей подсказкой "Перейти по ссылке для внесения исправлений в заявку в сервисе". При нажатии на кнопку пользователь перейдет по указанному URL для редактирования заявки в сервисе.

Если нет специального URL, который сразу переведет пользователя на редактирование заявки в сервисе, то можно указать тот, который переведет на страницу сервиса с кнопкой "Внести изменения" внутри самого сервиса.

{
actionType: "GO_TO_SERVICE"
label: "Перейти в сервис ..."
description: "Перейти по ссылке в сервис ..."
template: "https://.../bidders/requests/{EXT_APPLICATION_NUMBER}?idp=системное имя банка"
}

Показан пример, который будет выводить текст со ссылкой для перехода в сервис. При нажатии на ссылку, сгенерированной на основе значения поля template, пользователь перейдёт в свой профиль в данном сервисе.

Сторона поставщика заявок

Имя поляКратностьТипОписание

actionType

1Enum(
CLIENT_EXTERNAL_SIGN
AGENT_GET_EXTERNAL_SIGN_URL
CLIENT_INTERNAL_SIGN
AGENT_GET_INTERNAL_SIGN_URL
CLIENT_SIGN_OFFER
CORRECT_REQUEST
GO_TO_SERVICE
)
Тип действия

label

1StringНазвание действия

description

1StringОписание действия

CLIENT_EXTERNAL_SIGN:signUrl

1URLURL на страницу с подписанием заявки

AGENT_GET_EXTERNAL_SIGN_URL:signUrl

1URLURL на страницу с подписанием заявки

CORRECT_REQUEST:url

1URLURL на страницу с возможностью редактирования заявки

CLIENT_INTERNAL_SIGN:documentsToSignUrl

1URLURL получения списка документов на подписание

AGENT_GET_INTERNAL_SIGN_URL:documentsToSignUrl

1URLURL получения списка документов на подписание

GO_TO_SERVICE:url

1URLURL на страницу с дальнейшими дополнительными действиями пользователя.
  • Нет меток