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

Проверка ИНН

Метод проверки ИНН самозанятого в системе. Позволяет получить информацию, что самозанятый принял приглашение в ФНС и зарегистрирован в системе.

URL

Метод: GET

  • Production: https://api.baas.kvell.group/v1/smz/inn/check?inn={inn}
  • Stage: https://api.baas.stage.kvell.group/v1/smz/inn/check?inn={inn}

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

Название Тип данных Обязательно Описание
inn string Да ИНН самозанятого

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

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

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

sha256({X-Api-Key}{inn}{secret_key})

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

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

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

{
  "status": "registered",
  "message": "Клиент зарегистрирован"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

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

  • status - статус самозанятого:
    • registered - самозанятый зарегистрирован в системе, можно формировать чек.
    • unregistered - самозанятый не зарегистрирован, требуется отправить приглашение.
    • pending - самозанятый в процессе регистрации.
    • error - ошибка проверки статуса.
  • message - сообщение о статусе.