Поиск компании в базе Проверки Контрагента

Поиск и создание компании в базе Проверки Контрагента по различным фильтрам.

Адрес подключения

URL: https://pk.uchet.kz/api/v2/search/

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

• value (string, required) - Поле для полнотекстового поиска. Поиск происходит по следующим показателям: ИИН, БИН, Наименование компании на русском и казахском языке, ФИО руководителя.
• kato - Поиск по КАТО. Значения брать из справочника КАТО.
• krp - Поиск по коду размера предприятия. Значения брать из справочника КРП.
• oked - Поиск по коду вида деятельности предприятия. Можно через запятую добавлять несколько ОКЭД-ов. Значения брать из справочника ОКЭД-ов.
• page - Текущая страница в пагинации.
• size - Количество элементов на одной странице в пагинации.

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

curl -X 'GET' \
  'https://pk.uchet.kz/api/v2/search/?value=141040028436&page=1&size=10&kato=751110000&okeds=62099&krp=100&token=3ea356ede9a74dd089b05a8911e2daa7' \
  -H 'accept: application/json'

Возможные ошибки:

token_error - Не был указан либо неверный токен

Пример ответа с ошибкой:

{
  "detail": {
    "code": "token_error",
    "message": "token is not found"
  }
}

Ответ:

{
  "results": (array) Массив найденных компании [
    {
      "name_ru":Наименование компании на русском языке,
      "name_kz":Наименование компании на казахском языке,
      "address_ru":Адрес компании на русском языке,
      "address_kz":Адрес компании на казахском языке,
      "iin":ИИН,
      "bin":БИН,
      "head_fullname":ФИО руководителя,
      "kato_code":КАТО,
      "status":Статус компании. Возможные варианты:
            active = "Действующий"
            undefined = "Не определен"
            liquid = "Субъект с указанным ИИН/БИН ликвидирован"
            stage_of_liquid = "На стадии ликвидации"
            not_register = "Субъект не зарегистрирован как юридическое лицо"
            non_resident = "Субъект с указанным БИН является Нерезидентом РК"
            liquid_reorganization = "Субъект с указанным БИН реорганизован с прекращением деятельности",
    }
  ],
  "pagination": {
    "total_count": Количество найденный компании,
    "relation": Если количество найденных компании в диапазоне от 0 до 10000, то значение "eq", иначе "gte",
    "current_page": Текущяя страница в пагинации,
    "total_pages": Всего страниц в пагинации
  }
}

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

{
  "results": [
    {
      "address_ru": "Г.АЛМАТЫ, АЛМАЛИНСКИЙ РАЙОН, улица Жарокова, дом 41",
      "name_kz": "\"Учёт.Бухгалтерия\" жауапкершілігі шектеулі серіктестігі",
      "address_kz": "АЛМАТЫ Қ., АЛМАЛЫ АУДАНЫ, улица Жарокова, дом 41",
      "name_ru": "ТОО \"Учёт.Бухгалтерия\"",
      "bin": "141040028436",
      "head_fullname": "БАРЫШЕВ  МАКСИМ АНАТОЛЬЕВИЧ",
      "kato_code": 751110000,
      "iin": null,
      "status": "active"
    }
  ],
  "pagination": {
    "total_count": 1,
    "relation": "eq",
    "current_page": 1,
    "total_pages": 1
  }
}

Внимание

Также через данный запрос можно создать компанию, если она отсутствует в базе данных Проверки Контрагента. Необходимо выполнить поиски по ИИН или БИН компании.