Начало работы

Если у вас нет аккаунта

• Зайдите на сайт, пройдите регистрацию.
• Потдвердите номер телефона и почту.
  

Как получить токен для API

Токен можно найти на сайте Проверка Контрагента в личном кабинете в разделе токены API сервиса

Общая логика

Сервис предоставляет API для получения актуальных данных о юридических лицах Казахстана по принципу "запрос-обновление-получение".

---

Сценарий 1: Синхронный (базовый)

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

1. Запросите данные

GET https://pk.uchet.kz/api/v2/get_bin_info/

2. Проверьте актуальность

Данные актуальны, если:

• relevance_date не null и содержит свежую дату
• Ключевые поля (например, elicense, goszakup, tax_debt) содержат данные, а не null

Если актуальны — используйте их сразу
Если нет — переходите к шагу 3

3. Если получили ошибку not_found, то выполните поиск

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

• Поиск по БИН/ИИН автоматически создаст запись компании в базе

4. Инициируйте обновление

GET https://pk.uchet.kz/api/v2/update/

5. Отслеживайте статус

GET https://pk.uchet.kz/api/v2/update_status/

• Не ждите общего finish_time — проверяйте конкретные нужные вам задачи в блоке tasks
• Когда статус нужных задач = success — переходите к шагу 6

6. Повторите запрос данных

Снова GET https://pk.uchet.kz/api/v2/get_bin_info/

• Если ключевые поля всё ещё null — обратитесь в техподдержку

---

Сценарий 2: С callback (асинхронный)

Рекомендуется для автоматизированных систем и продакшена.

1. Запросите данные

GET https://pk.uchet.kz/api/v2/get_bin_info/

2. Проверьте актуальность

Данные актуальны, если:

• relevance_date не null и содержит свежую дату
• Ключевые поля содержат данные, а не null

Если актуальны — используйте их сразу
Если нет — переходите к шагу 3

3. Если получили ошибку not_found, то выполните поиск

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

4. Инициируйте обновление с callback

GET https://pk.uchet.kz/api/v2/callback_update/

• Укажите ваш callback_url

• Система автоматически отправит обновленные данные HTTP POST запросом на указанный URL

5. Получите данные автоматически

• Если данные уже актуальны — придут немедленно
• Если требуется обновление — придут после завершения сбора
• Формат данных соответствует ответу get_bin_info
• Если ключевые поля содержат null — обратитесь в техподдержку

---

Обработка ошибок

• not_found — компания отсутствует в базе (выполните поиск)
• token_error — проверьте корректность токена
• iin_bin_validation_error — БИН/ИИН должен содержать 12 символов