Перейти к основному содержимому

Создание сделки

Процесс создания сделки состоит из нескольких этапов, в рамках которых есть подэтапы, позволяющие конфигурировать параметры сделки:

  1. Создание сделки и передача данных по сделке
  2. Подтверждение конфигурации по сделке
  3. Обновление черновика сделки
  4. Добавление продуктов в сделку (ЭР, СБР)
  5. Подтверждение создания продуктов

Сценарии сделки​

Существует 3 основных сценария, по которым создается сделка:

  • Сделка только с СБР от М2 с самостоятельной регистрацией (не через сервис электронной регистрации от М2)
  • Сделка с СБР и ЭР от М2
  • Сделка только с ЭР от М2 (когда используется иной способ расчетов по сделке)

В зависимости от сценария могут отличаться обязательные параметры, которые нужно передавать при создании сделки, и набор методов, необходимых для создания продукта М2 в рамках сценария.

Последовательность методов для создания сделки​

Создание сделки​

Справка

Конфигурация сделки – этап, при котором необходимо указать базовые (первичные) параметры сделки, такие как:

  • участники и их роли в сделке
  • объекты недвижимости

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

Пример запроса
POST https://m2.ru/api/public/deal-api/v1/deals HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  // ...
}

В ответ сервис возвращает идентификатор созданной сделки. По этому идентификатору в дальнейшем, возможно получить текущее состояние сделки или обновить ее.

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

Пример запроса
PUT https://m2.ru/api/public/deal-api/v1/deals/{id}/config HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  // ...
}

Тестовые банковские реквизиты​

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

Покупатель счет эскроу ФЛ

ПАО ВТБ

  • БИК 044525745
  • Корр счет 30101810345250000745
  • Счет эскроу 40824008106360060002

Продавец ФЛ

ПАО ВТБ

  • БИК 044525745
  • Корр счет 30101810345250000745
  • Счет 40817248106360060002

Продавец ЮЛ

ПАО ВТБ

  • БИК 044525745
  • Корр счет 30101810345250000745
  • Счет 40500000000000000009
Важно

Важно использовать предложенные тестовые реквизиты на этапе тестирования, так как сделка не перейдет на следующий этап, если реквизиты в сделке будут указаны некорректные.
В сервисе настроена валидация на соответствие БИК Банка и номера счета.

Признак, указывающий, кто из участников сделки будет участвовать во взаиморасчетах​

Продавец

Если сделка с одним продавцом (не важно, со счетом эскроу или нет), то ему обязательно нужно указать признак calculation, который означает, что продавец участвует в расчетах.

Покупатель

У одного из покупателей в сделке также должен быть указан признак calculation.

Справка

Поле calculation должно быть настроено только у одного покупателя. На основе этого параметра М2 понимает, что данный покупатель является заказчиком. Аналогично чек-боксу в карточке покупателя в UI.

Пример тела запроса
{
  "sellers": [
    {
      "participantId": "108dfbfd-f575-445a-8f4b-15973e48d480", 
      "calculation": {
        "type": "@calculation",
        "share": 9613767.35,
        "moneyReceiver": "PARTICIPANT"
      }
    }
  ]
}
Детали

Если эскроу-счета нет — нужно указать реквизиты продавца.
Если эскроу счет есть — реквизиты покупателя.

Подтверждение конфигурации сделки​

На данном шаге можно подать заявку в ипотечном брокере.

Пример запроса
PUT https://m2.ru/api/public/deal-api/v1/deals/{id}/config/products HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  // ...
}

Обновление черновика сделки​

Работа со сделкой до момента получения реквизитов должна заканчиваться на этом этапе.
На данном этапе указываются оставшиеся параметры для проведения сделки, а также определяется способ взаиморасчетов и регистрации недвижимости.

Пример запроса
PUT https://m2.ru/api/public/deal-api/v1/deals/{id}/draft HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  // ...
}
На этапе черновика сделки необходимо задать

1. Номер договора/Дату договора/Стоимость ОН (без аванса/задатка)

Пример тела запроса
{
  "contract": {
    "type": "DDU",
    "number": "ДДУ-100500",
    "date": "2022-01-01",
    "amount": 100500,
    "document": null
  }
}
Детали

В стоимости ОН необходимо указать сумму, которая будет размещена на номинальном счете М2.

2. Способы регистрации недвижимости:

  • MANUAL — Самостоятельная или сторонняя регистрация.
  • M2 - Регистрация через сервис Электронной Регистрации М2.

3. Способ оплаты:

  • MANUAL - Самостоятельная оплата.
  • M2 - Оплата через СБР.

4. Отлагательные условия

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

Перечисленные ниже отлагательные условия применимы к сделкам с ДКП.

Виды отлагательных условий:

  • acceptanceCertificate - акт приема-передачи объекта недвижимости;
  • certificateOfAbsenceOfRegisteredPersons - справка об отсутствии зарегистрированных лиц;
  • certificateOfAbsenceOfArrearsOnUtilityBills - справка об отсутствии задолженностей по коммунальным платежам;
  • propertyAllocation - выделение доли продавцу в другом объекте недвижимости;
  • registrationsAtPermanentPlaceOfResidence - регистрация продавца по постоянному месту жительства.

Пример передачи параметра без отлагательных условий:

Пример
{
  "suspensiveConditions": {
    "@type": "@no_suspensive_conditions"
  }
}

Пример с отлагательными условиями (в случае, если необходимо создать сделку со всеми возможными отлагательными условиями):

Пример
{
  "suspensiveConditions": {
    "@type": "@suspensive_conditions",
    "acceptanceCertificate": true,
    "certificateOfAbsenceOfRegisteredPersons": true,
    "certificateOfAbsenceOfArrearsOnUtilityBills": true,
    "propertyAllocations": [
      {
        "participant": {
          "participantId": "a757b600-284f-4d1a-a7da-10a26d94b22c"
        },
        "newAddress": "г. Москва, Тверской бульвар, 14",
        "newCadastralNumber": "50:22:333333:44",
        "part": {
          "numerator": 2,
          "divider": 15
        }
      }
    ]
  }
}
Заметка

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

5. Информация о материнском капитале или первоначальном взносе.

Если применимо к сделке, возможны следующие варианты:

  • Первоначальный взнос перечисляется напрямую на счет продавца до регистрации:
Пример
{
  "fundOptions": {
    "@type": "@before_deal_registration"
  }
}
  • Первоначальный взнос перечисляется на специальный счет М2:
Пример
{
  "fundOptions": {
    "@type": "@before_deal_registration_m2"
  }
}
  • Первоначальный взнос перечисляется напрямую на счет продавца после регистрации (без участия М2).
Заметка

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

Пример
{
  "fundOptions": {
    "@type": "@before_mortgage",
    "amount": 10000000 // значение не может превышать сумму контракта (contract.amount)
  }
}
  • Материнский капитал (перечисляется напрямую на счет продавца без участия М2).
Заметка

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

Пример (значение amount в мат. капитале не может превышать сумму контракта (contract.amount))
{
  "fundOptions": {
    "@type": "@family_capital",
    "amount": 10000000
  }
}

Добавление продуктов в сделку​

Для создания продуктов «Сервис безопасных расчетов» и «Электронная регистрация» от М2 необходимо воспользоваться методом добавления продуктов.
В запросе необходимо указать тип продукта, который нужно создать в сделке

Пример запроса
PUT https://m2.ru/api/public/deal-api/v1/deals/{id}/products HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  "products": [
    {
      "@type": "@sbr"
    },
    {
      "@type": "@eregistration"
    }
  ]
}

Запросы и ответы будут отличаться, в зависимости от продуктов, которые добавляются в сделку.

Если сделка проводится с участием «Сервиса безопасных расчетов М2», то при создании продукта на электронную почту покупателя, указанную при создании клиента, будут отправлены:

  • договор сервиса СБР (оферта)
  • квитанция/ссылка на оплату комиссии за услугу СБР
  • квитанция на внесение денежных средств за объект недвижимости
Важно

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

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

Подтверждение создания продуктов​

Чтобы продолжить работу со сделкой через API, требуется дождаться завершения задачи по созданию необходимых продуктов. Для этого периодически (раз в несколько секунд) требуется запрашивать данные по созданной задаче, ожидая выставление флага completed в значение true.

Заметка

В случае, если флаг error принял значение true - повторите добавление продуктов в сделку и ожидайте завершения новой задачи или обратитесь в поддержку М2.

Как только данный метод выполнится, то сделка перейдет в статус «Ожидание оплаты» и внести изменения можно будет только до момента поступления одной из оплат: комиссии за услугу СБР или за объект недвижимости

После создания продукта "Сервис безопасных расчетов" Заказчику (Покупателю) будет направлено смс и на эл. почту поступит Договор СБР, квитанция и ссылка для оплаты услуги СБР и квитанция для внесения суммы на номинальный счет М2. Продавцу будет направлено смс и на эл. почту поступит Договор СБР.

Дополнительные методы​

Получение состояния сделки​

Пример запроса
GET https://m2.ru/api/public/deal-api/v1/deals/{id} HTTP/1.1
Authorization: Bearer

С помощью данного метода возможно запрашивать текущее состояние сделки, например статус или id ее продуктов.

Ответ на запрос содержит исчерпывающую информацию по всей сделке, в том числе:

  • Идентификаторы сделки и ее продуктов
  • Данные продуктов, в том числе их статусы
  • Данные участников-контрагентов
  • Объекты недвижимости
  • Наличие ипотеки
  • Данные договора-основания
  • Документы сделки

По продукту СБР можно получить следующие данные:

  • Идентификатор СБР
  • Номер оферты
  • Статус
  • Данные об оплатах СБР и объекта недвижимости

По продукту ЭР можно получить следующие данные:

  • Статус заявления
  • Идентификатор ЭР
  • Договор-основание

Получение состояния выполнения задачи​

Пример запроса
GET https://m2.ru/api/public/deal-api/v1/deals/tasks/{id} HTTP/1.1
Authorization: Bearer

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

Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json

{
  "task": {
    "id": "string",            // идентификатор задачи
    "dealId": "string",        // идентификатор сделки, относящийся к задаче
    "state": [                 // этап выполнения задачи
      "@config_enum_state_definition",
      "SCHEDULED"
    ],
    "completed": false,        // флаг, что задача завершилась
    "error": false,            // флаг, что произошла ошибка при выполнении
    "errorDetails": null       // детали ошибки
  }
}

Предоставление прав на запись и чтение сделки другим компаниям (шаринг)​

Внимание

Данный метод является нестабильным и будет переделан в следующих релизах.
Просьба не завязываться на этот метод в интеграциях.
Если необходима данная функциональность — свяжитесь с поддержкой М2.

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

Запрос содержит ОГРН компании, которой предоставляется доступ.

Пример запроса
PUT https://m2.ru/api/public/deal-api/v1/deals/{id}/share HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  "ogrn": "1197746330132"
}

Ответ на запрос содержит всю информацию по сделке.

Важно

Для того, чтобы отозвать права на чтение и запись требуется обратиться в поддержку М2.