Сервис kartoteka.by предоставляет возможность интеграции информации в вашу рабочую систему посредством API. Вы сможете с легкостью автоматизировать получение актуальной информации по актуальным статусам (включая ликвидации и банкротства), по судам, тендерам, проверкам, торговым объектам и т.д. делая до 500 уникальных запросов в сутки, не более 5000 запросов в течение календарного месяца. Изменение лимитов невозможно.
Настройку API для 1С или CRM клиент производит самостоятельно или с привлечением подрядной организации согласно представленной в данном разделе технической документации. Сотрудники ООО "Картотека" не занимаются внедрением API на стороне клиента.
В структуре методов присутствует метод API /account/limit. Он показывает сколько у конкретного пользователя осталось запросов в сутки и за месяц. Запросы по нему не учитываются.
Дополнительные методы, кроме указанных в настоящем руководстве - не возможны. Например, "можно ли по API получать номера телефонов?" Нет, такая передача невозможна.
Уникальный запрос - это запрос к какому-либо методу API с использованием входящих параметров, отличный от других запросов.
Пример 1:/summary/809000219 и /summary/791212537 - 2 запроса к одному методу, но с разными входящими параметрами, в данном случае УНП. Запросы уникальные.
Пример 2:/summary/490421749 и /court/writ/490421749 - 2 запроса по УНП 490421749, но к разным методам. Они тоже уникальны. Запросы summary/490421749 и summary/490421749 - запросы к одному методу с одинаковыми входящими параметрами. Это НЕ уникальные запросы, абсолютно одинаковые.
500 уникальных в день - это 500 уникальных запросов в сутки.
5000 уникальных запросов в месяц - 5000 уникальных запросов в течение календарного месяца.
Услуга включена во все тарифы, кроме Эксперт на 24 часа. В демо-режиме услугу подключить не возможно.
Для пользователей задать технические вопросы по работе услуги можно на электронную почту help@kartoteka.by
Получение доступа
Для начала работы необходимо получить токен для доступа к сервису api.kartoteka.by
Нажмите "Сгенерировать Token" во вкладке "настройки" в личном кабинете.
Входные параметры: unp (int (9)), access-token (string (32))
Доступные методы
+'''Ответ'''
-
success
boolean
-
data
EGRInfo[]
+EGRInfo
-
unp
int(9)
УНП
-
short_name
string (255)
Краткое наименование
-
name
string (500)
Полное наименование
-
address
string (255)
Юридический адрес
-
imns
int(3)
Код ИМНС
-
imns_title
varchar(255)
Наименование ИМНС
-
reg_date
date (Y-m-d)
Дата регистрации МНС
-
status
string (255)
Статус
-
date_of_elimination
date (Y-m-d)
Дата ликвидации
-
elimination_description
string (255)
Комментарий ликвидации
-
checks
boolean
Есть информация в канале "Проверки"
-
risk_date
date (Y-m-d)
Дата добавление контрагента в реестр лжепредпринимателей
-
risk_reason
string(255)
Основания включения в реестр
-
bankruptcy
boolean
Есть информация в канале "Банкротства"
-
imns_debtor
boolean
Есть информация в канале "Задолженность перед бюджетом"
-
capital
int(20)
Уставной капитал
+Ответ
-
success
bool
-
data
Checks
+Checks
-
debtor_unp
int(9)
УНП
-
title
string(255)
Наименование
-
reason_to_check
string(255)
Причина назначения проверки
-
year
int(4)
Год проведения проверки
-
month
string(16)
Месяц проведения проверки
-
plan_number
int(9)
№ пункта плана
-
gos_acceptor
string(255)
Государственный орган, утвердивший сводный план проверок
-
gos_check_unp
int(9)
УНП контролирующего (надзорного) органа
-
gos_check_title
string(255)
Наименование контролирующего (надзорного) органа
-
gos_agent_phone
string(32)
Контактный телефон исполнителя
+Ответ
-
success
bool
-
data
IMNSDebtors
+Checks
-
unp
int
УНП должника
-
date
date(Y-m-d)
По состоянию на дату
+Ответ
-
success
bool
-
data
Counts
+Counts
-
writ_debtor
int(11)
приказное-должник: число зафиксированных в системе споров
-
writ_creditor
int(11)
приказное-взыскатель: число зафиксированных в системе споров
-
writ_other
int(11)
приказное-другое: число зафиксированных в системе споров
-
eco_creditors
int(11)
исковое-истец: число зафиксированных в системе заседаний
-
eco_debtors
int(11)
исковое-ответчик: число зафиксированных в системе заседаний
+'''Ответ'''
-
success
boolean
-
data
SummaryData
+SummaryData
-
unp
int
УНП
-
name
string
Наименование
-
short_name
string
Полное наименование
-
address
string
Юридический адрес
-
mns_reg_date
date (Y-m-d)
Дата регистрации в МНС
-
status_mns
string
Статус МНС
-
elimination_date
date (Y-m-d)
Дата ликвидации
-
elimination_description
string
Причина ликвидации
-
imns_code
int
Код ИМНС
-
imns_name
string
Наименование МНС
-
charter_capital
int
Уставной фонд
-
charter_capital_currency
int
Код валюты
-
ambargo
boolean
Запрет на отчуждение доли
-
egr_reg_ogr_code
int
Код регистрирующего органа
-
egr_reg_ogr_name
string
Наименование регистрирующего органа
-
egr_reg_date
date (Y-m-d)
Дата регистрации в ЕГР
-
egr_elimination_date
date (Y-m-d)
Дата исключения из ЕГР
-
egr_status_code
int
Код статуса ЕГР
-
egr_status_name
string
Статус ЕГР
-
egr_name
string
Наименование по ЕГР
-
egr_short_name
string
Краткое наименование по ЕГР
-
egr_brand_name
string
Фирменное наименование юридического лица на русском языке
-
egr_name_bel
string
Наименование по ЕГР на белорусском
-
egr_short_name_bel
string
Краткое наименование по ЕГР на белорусском
-
egr_brand_name_bel
string
Фирменное наименование юридического лица на белорусском языке
-
egr_changes
EGRChanges[]
Изменения в ЕГР
-
egr_subject_history
EGRSubjectHistory[]
История субъекта хозяйствования
-
writ
WritInfo
Сводная информация по приказному производству
-
court_sessions
СourtSessionsInfo
Сводная информация по судебным заседаниям
-
executory
ExecutoryInfo
Сводная информация по исполнительному производству
-
imns_debtors
IMNSDebtors[]
Долги перед бюджетом за 1-е число
-
imns_debtors_in_month
IMNSDebtorsInMonth[]
Долги перед бюджетом в течении месяца
-
social_security_found
SocialSecurityFound[]
Задолженность перед ФСЗН
-
bankruptcy
BankruptcyInfo
Банкротство
-
risk
RiskInfo
Реестр лжепредпринимателей
-
liquidation
LiquidationInfo
Информация о ликвидации
-
checks
Checks[]
Сведения по проверкам
-
disqualified_providers
DisqualifiedProvidersInfo
Реестр недобросовестных поставщиков
-
certs
Certs[]
Сертификаты и декларации
-
charter_capital_changes
CharterCapitalChangesInfo
Изменение уставного фонда
-
trades
TradesInfo
Тендеры
-
banks_guarantees
BanksGuaranteesInfo
Банковские гарантии
-
belcci
BelcciInfo
БелТПП
-
fez
FezInfo
СЭЗ
-
auctions
Auctions[]
Госзаказы
-
trademarks
TrademarksInfo
Торговые марки
-
certs_of_conf
CertsOfConfInfo
Реестр аттестатов соответствия
+EGRChanges
-
egr_status_name
string
Статус ЕГР
-
egr_name
string
Наименование контрагента
-
egr_short_name
string
Короткое наименование контрагента
-
egr_brand_name
string
Фирменное наименование юридического лица
-
actual
boolean
Актуальность данных
+EGRSubjectHistory
-
date
date (Y-m-d)
Дата
-
info
string
Информация субъекта хозяйствования
-
actual_date
date (Y-m-d)
Актуальность информации на дату
+WritInfo
-
creditor
int
Кол-во дел, где контрагент участвовал в качестве взыскателя
-
debtor
int
Кол-во дел, где контрагент участвовал в качестве должника
+СourtSessionsInfo
-
creditor
int
Кол-во дел, где контрагент участвовал в качестве взыскателя
-
debtor
int
Кол-во дел, где контрагент участвовал в качестве должника
+ExecutoryInfo
-
debtor
int
Кол-во дел, где контрагент участвовал в качестве должника
+IMNSDebtors
-
city
string
Город
-
date
date (Y-m-d)
Дата на которую была задолженность
+IMNSDebtorsInMonth
-
mns_code
int
Код ИМНС
-
date
date (Y-m-d)
Дата на которую была задолженность
+SocialSecurityFound
-
sum
float
Сумма долга
-
date
date (Y-m-d)
Дата на которую была задолженность
+BankruptcyInfo
-
deal_number
string
Номер дела
-
process_code
int
Код процесса
-
process_name
string
Наименование процесса банкротства
-
start_date
date (Y-m-d)
Дата начала процесса банкротства
-
close_date
date (Y-m-d)
Дата окончания процесса банкротства
-
status
boolean
Статус процесса банкротства
+RiskInfo
-
reason
string
Причина включения в реестр
-
date
date (Y-m-d)
Дата включения в реестр
+LiquidationInfo
-
decision_date
date (Y-m-d)
Дата принятия решения о ликвидации
-
liq_fio
string
Ф.И.О. ликвидатора (председателя ликвидационной комиссии, наименование юридического лица, назначенного ликвидатором)
-
liq_address
string
Адрес ликвидатора (председателя ликвидационной комиссии)
-
liq_phone
string
Телефон ликвидатора
-
decision_term
int
Срок принятия претензий с момента опубликования, мес.
-
publish_date
date (Y-m-d)
Дата опубликования сведений о ликвидации
-
current_status
string
Текущее состояние
+Checks
-
checks_in_month
int
Количество проверок за месяц
-
month
int
Месяц проверки
-
year
int
Год проверки
+DisqualifiedProvidersInfo
-
description
string
Дата и основание включения в список
-
exc_description
string
Дата и основание исключения из списка
+Certs
-
code
int
Код типа сертификации
-
type
string
Тип сертификации
-
quantity
int
Количество сертификатов
+CharterCapitalChangesInfo
-
new_charter_capital
int
Сумма измененного уставного капитала
-
decree_date
date (Y-m-d)
Дата постановления
-
publish_date
date (Y-m-d)
Дата публикации
+TradesInfo
-
customer
TradeStats
Информация о тендерах, где контрагент выступает в качестве заказчика
-
provider
TradeStats
Информация о тендерах, где контрагент выступает в качестве поставщика
+TradeStats
-
quantity
int
Количество договоров
-
sum_byn
float
Общая сумма
+BanksGuaranteesInfo
-
principal
int
количество гарантий, где контрагент выступает в качестве принципала
-
beneficiary
int
количество гарантий, где контрагент выступает в качестве бенефициара
+BelcciInfo
-
manager
string
Руководитель
-
email
string
E-mail
-
site
string
Вебсайт
-
phone
string
Телефон
+FezInfo
-
name
string
Наименование СЭЗ
-
project
string
Наименование проекта
+Auctions
-
status
string
Статус закупки
-
quantity
int
Количество закупок
+TrademarksInfo
-
quantity
int
Количество торговых марок
+CertsOfConfInfo
-
quantity
int
Количество аттестатов
+egr_status_code
-
1
Действующий
-
2
Исключен из ЕГР
-
3
Находится в процессе ликвидации
-
4
Процедура банкротства
-
5
Прекращение деятельности в результате реорганизации
-
10
Приостановлена деятельность
-
11
Утрата правоспособности
+Ответ
-
success
bool
-
data
CourtWrit[]
-
total
TotalQuantity
+CourtWrit
-
debtor_unp
int(9)
УНП должника
-
creditor_unp
int(9)
УНП взыскателя
-
court
string(255)
Наименование суда
-
judge
string(255)
Судья
-
deal_number
string(124)
Номер дела
-
date
date(Y-m-d)
Дата возбуждения приказного производства
-
result
string(255)
Последнее процессуальное решение
-
debt
string(124)
Сумма долга
-
creditor
string(255)
Взыскатель
-
debtor
string(255)
Должник
+Ответ
-
success
bool
-
data
CourtsSession[]
Судебные заседания за период от 01.03.2018 до 01.06.2021
+CourtsSession
-
creditor_unp
int (9)
УНП истца
-
debtor_unp
int (9)
УНП ответчика
-
other_unp
int(9)
Унп других лиц, участвующих в деле
-
court_type_code
int
Код вида судебного производства
-
court_code
int
Код суда
-
deal_date
date(Y-m-d)
Дата проведения судебного заседания
-
deal_number
string
Номер дела
-
creditor_name
string
Наименование взыскателя
-
debtor_name
string
Наименование должника
-
others_name
string
Наименования других лиц, участвующих в деле
-
original_data
object
Информация официального источника. Ассоциативный массив. Пример: "Наименование кредитора": "\"ПРИОРБАНК\" ОАО", "Дата судебного заседания": "01.03.2018", "Наименование должника": "ООО \"ЭКСПРЕССКУРЬЕР\"", "Судья": "САКОВИЧ А.С.", "Номер дела": "108-22Б/2015", "№ кабинета": "205", "Время судебного заседания": "12.20"
-
result_html
string
результат судебного заседания
-
court_type
string
Вид судебного производства
-
court
string
Наименование суда
+Ответ
-
success
bool
-
data
CourtExecutory[]
+CourtExecutory
-
number
string
Номер дела
-
status
string
Статус дела
-
debt
string
Долг
-
date
date(Y-m-d)
Дата
+Ответ
-
success
bool
-
data
BankruptcyData
+BankruptcyData
-
status
int
Статус дела о банкротстве
-
email
string
Емэйл
-
legal_index
int
Индекс юридического адреса
-
legal_city
string
Город юридического адреса
-
legal_address
string
Юридический адрес
-
actual_index
int
Индекс фактического адреса
-
actual_city
string
Город фактического адреса
-
actual_address
string
Фактический адрес
-
deal_number
string
Номер дела
-
court
string
Наименование суда
-
declarant_type
string
Ликвидатор
-
declarant_name
string
Ф.И.О. ликвидатора
-
telephone
string
Телефон
-
date_start
date (Y-m-d)
Дата начала производства по делу
-
date_close
date (Y-m-d)
Дата прекращения производства по делу
-
close_reason
string
Причина прекращения дела
-
date_receivership
date (Y-m-d)
Дата начала конкурсного производства и подготовка дела к судебному разбирательству
-
date_protection_start
date (Y-m-d)
Дата начала защитного периода
-
date_protection_end
date (Y-m-d)
Дата окончания защитного периода
-
date_exclusion
date (Y-m-d)
Дата исключения должника из ЕГР
-
date_start_process
date (Y-m-d)
Постановление суда об открытии ликвидационного производства
-
date_finish_pocess
date (Y-m-d)
Дата завершения , установленная судом
-
start_process_type
string
Вид начала процесса
-
manager
ManagerInfo
Управляющий
-
judgments
Judgments[]
Судебное решение
-
messages
Messages[]
Объявления
+ManagerInfo
-
surname
string
Фамилия
-
name
string
Имя
-
third_name
string
Отчество
-
birth_date
date (Y-m-d)
Дата рождения
-
birth_place
string
Место рождения
-
unp
int
Регистрационный номер
-
availability
int
Готовность принять дело
-
correspondence_address
string
Адрес для корреспонденции
-
work_telephone
string
Рабочий телефон
-
email
string
Емэйл
-
fax
string
Факс
-
website
string
Сайт
+Judgments
-
judgment_type_value
string
Тип судебного решения
-
date
date (Y-m-d)
Дата
-
full_text_html
string
Полный текст
-
additional_info
string
Дополнительная информация
+Messages
-
date_time
date (Y-m-d)
Дата
-
message_type
string
Сообщение
-
pdf_file
string
Ссылка на pdf файл(только для зарегистрированных пользователей сайта kartoteka.by)
+'''Ответ'''
-
success
boolean
-
data
SummaryData
-
total
TotalQuantity
+SummaryData
-
g_number
string
Номер банковской гарантии
-
bank_name
string
Наименование банка
-
g_date
date
Дата выдачи банковской гарантии
-
introduction_date
date
Дата вступления в силу банковской гарантии
-
increment_number
int
Порядковый номер изменения и (или) дополнения
-
modification_date
date
Дата внесения изменения и (или) дополнения
-
changes_introduction_date
date
Дата вступления в силу изменений и (или) дополнений, внесенных в текст банковской гарантии
-
end_date
date
Дата прекращения действия банковской гарантии
-
cause
string
Причины прекращения действия банковской гарантии
-
actual_end_date
date
Фактическая дата прекращения действия банковской гарантии
-
introduction_info
string
Информация о вступлении в силу банковской гарантии либо изменений и (или) дополнений, внесенных в текст банковской гарантии, и (или) сроке действия банковской гарантии
-
principal_info
string
Информация о принципале
-
princ_unp
int(9)
УНП принципала
-
instructor_info
string
Информация об инструктирующей стороне
-
instructor_unp
int(9)
УНП инструктирующей стороны
-
beneficiary_info
string
Информация о бенефициаре
-
beneficiary_unp
int(9)
Унп бенефициара
-
currency
string
Валюта банковской гарантии
-
sum
float
Денежная сумма банковской гарантии (в единицах валюты с точностью до 0,01)
-
full_sum
string
Полная сумма
-
additional_info
string
Дополнительная информация о банковской гарантии
-
purpose
string
Целевое назначение
-
industry
string
Отраслевой классификатор принадлежности
-
guarantee_form
string
Форма выдачи банковской гарантии
+'''Ответ'''
-
success
boolean
-
data
SummaryData
-
total
TotalQuantity
+SummaryData
-
code
int
Код типа сертификата
-
doc_id
string
Номер документа
-
type
string
Тип документа
-
status
string
Статус документа
-
status_code
string
Статус код
-
manufacturer_name
string
Наименование изготовителя
-
manufacturer_reg_number
int(9)
УНП изготовителя
-
manufacturer_address
string
Адрес изготовителя
-
manufacturer_contacts
ContactsInfo[]
Контакты
-
declarant_name
string
Наименование заявителя
-
declarant_reg_number
int(9)
УНП заявителя
-
declarant_address
string
Адрес заявителя
-
declarant_contacts
ContactsInfo[]
Контакты
-
start_date
date
Дата регистрации сертификата
-
end_date
date
Дата окончания действия сертификата
-
brand_name
string
Марка объекта
-
commodity_code
string
Код товара по ТН ВЭД ЕАЭС
-
product
string
Наименование продукта
-
product_id
string
Идентификатор продукта (тип, марка, модель)
-
product_details
string
Иные сведения о продукции, обеспечивающие ее идентификацию (описание продукта)
-
product_additional_text
string
Информация об использовании продукции (условия, срок хранения, срок службы, ресурс)
-
product_info
string
Наименование документа, в соответствии с которым изготовлена продукция
-
product_info_doc
string
Номер документа в соответствии с которым изготовлена продукция
-
products_instance
array
Наименования группы одинаковых единиц продукции
+ContactsInfo
-
phones
array
Номера телефонов
-
emails
array
Электронная почта
+'''Ответ'''
-
success
boolean
-
data
SummaryData
-
total
int - записей всего, используйте параметр page
+SummaryData
-
contacts_sh
string
Контакты субъекта хозяйствования
-
address_sh
string
Адрес субъекта хозяйствования
-
object_type
string
Тип объекта
-
domain
string
Наименование объекта/доменное имя интернет магазина
-
trade_mark
string
Название торговой сети, сети общественного питания (при наличии)
-
trade_format
string
Вид розничного торгового объекта по формату
-
trade_goods_type
string
Вид розничного торгового объекта по ассортименту реализуемых товаров
-
trade_place_type
string
Вид розничного торгового объекта по месту расположения
-
official_trade_object
string
Фирменный торговый объект
-
trade_sq
string
Торговая площадь
-
trade_catering_type
string
Тип объекта общественного питания (при наличии)
-
trade_catering_class
string
Класс объекта общественного питания (при наличии)
-
trade_catering_spec
string
Специализация объекта общественного питания (при наличии)
-
catering_places
string
Количество мест в объекте общественного питания (ед.)
-
shoping_center_spec
string
Специализация торгового центра
-
market_type
string
Тип рынка
-
market_spec
string
Специализация рынка
-
retail_form
string
Форма розничной торговли
-
object_area
string
Область объекта
-
object_district
string
Район объекта
-
settlement_type
string
Тип населенного пункта
-
settlement
string
Населенный пункт объекта
-
street
string
Улица
-
building
string
Здание
-
room
string
Помещение
-
contacts
string
Контакты объекта
-
worktime
string
Время работы
-
goods_classes
string
Класс товаров
-
goods_subclasses
string
Подгруппы товаров
-
trade_number
string
Регистрационный номер в Торговом реестре
-
inclusion_date
date
Дата включения сведений в Торговый реестр
-
actual
bool
False - исключен из ТР, True - находится в ТР
+'''Ответ'''
-
success
boolean
-
data
SummaryData
+SummaryData
-
subject_type
string
Тип субъекта
-
full_name
string
Полное наименование субъекта хозяйствования
-
kind_of_subject
string
Вид субъекта
-
region
string
Область
-
area
string
Район
-
village
string
Сельсовет
-
city
string
Город
-
street
string
Улица
-
house
string
Дом
-
building
string
Здание
-
room
string
Помещение
-
index
string
Почтовый индекс
-
patterns_of_ownership
string
Форма собственности
-
reg_date
date
Дата решения о гос. регистрации
-
reg_org
string
Наименование рег. органа
-
scope
string
Сфера деятельности
-
stop_date
date
Дата прекращения деятельности
-
include_date
date
Дата включения в реестр
-
website
string
Вебсайт
-
services
string
Услуги
-
description
string
Примечание
-
starts_at
string
Начало рабочего дня
-
ends_at
string
Конец рабочего дня
-
working_days
string
Рабочие дни
- /monitoring/week
- /account/limit
Больше интересных кейсов и новостей - следите за нашими новостями в социальных сетях:
