Перейти к содержанию

Подключение самозанятого

Метод подключения самозанятого в системе и отправки приглашения в ФНС.

URL

Метод: POST

  • Production: https://api.baas.kvell.group/v1/smz/clients
  • Stage: https://api.baas.stage.kvell.group/v1/smz/clients

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

Название Тип данных Обязательно Описание
inn string Да ИНН самозанятого
first_name string Да Имя самозанятого
last_name string Да Фамилия самозанятого
second_name string Нет Отчество самозанятого
email string Да Email самозанятого
phone string Да Номер телефона самозанятого. Только цифры.

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

{
  "inn": "230900456295",
  "first_name" : "Иван",
  "last_name": "Иванов",
  "second_name": null,
  "phone": "79991111111",
  "email": "i.ivanov@mail.mail"
}

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор магазина
X-Signature string Да Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, inn, first_name, last_name, email, phone и secret_key. Формируется sha256 от полученной строки:

sha256({X-Api-Key}{inn}{first_name}{last_name}{email}{phone}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта;

Ответ запроса

Пример ответа

{
  "id": 0,
  "inn": "string",
  "first_name" : "string",
  "second_name" : "string",
  "last_name" : "string",
  "phone": "string",
  "email": "string",
  "created_at": "2024-07-10T18:18:46.472Z"
}

{
  "errors": [
    {
      "code": 4,
      "message": "Исполнитель с таким номером телефона уже существует"
    }
  ]
}

Внимание

Ответ 200 означает, что приглашение отправлено на телефон самозанятого и необходимо ожидать подтверждение регистрации вызывая метод проверки ИНН самозанятого.