Режим совместимости с форматом «ЗАПРАВИЛЬНЫЙБИЗНЕС» (ZB)¶

Для клиентов, использующих интеграционные модули, CRM-коннекторы или клиентские библиотеки, рассчитанные на распространенную в РФ схему данных ZB («ЗАПРАВИЛЬНЫЙБИЗНЕС»), NewDB поддерживает встроенный режим конвертации ответов на лету.

Как включить формат «ЗАПРАВИЛЬНЫЙБИЗНЕС»¶

Вы можете запросить ответ в формате ZB любым удобным способом:

Параметр в строке запроса (Query parameter):
format=zb (или _format=zb, format=ЗБ)
Поле в теле JSON-запроса:
"format": "zb"
HTTP-заголовок запроса:
X-Response-Format: zb

Структура ответа (Конверт ZB)¶

При включении параметра format=zb API NewDB оборачивает полезные данные в привычный конверт формата:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": { ... }
}

Коды статусов (`status`):¶

"200" — Запрос выполнен успешно. Полезные данные находятся в объекте body.
"201" — Отсутствует параметр - ключ API (api_key / token).
"212" — Истек лимит запросов по вашему тарифному плану (недостаточно средств).
"214" — Задан неверный ID компании.
"215" — Задан неверный ключ API.
"216" — Введен неверный ОГРН/ИНН.

Поддерживаемые методы и соответствие контрактам¶

Метод NewDB	Метод / раздел ZB («За честный бизнес»)	Возвращаемая структура `body`	Описание
`egrul`	`/card` (ЮЛ)	Объекты реквизитов ЮЛ (`ОГРН`, `ИНН`, `КПП`, `НаимЮЛПолн`, `Руководители`, `СумКап` и др.)	Полная карточка юридического лица по ЕГРЮЛ
`egrul_ip`	`/card` (ИП)	Объекты реквизитов ИП (`ОГРНИП`, `ИННФЛ`, `ФИО`, `ДатаОГРН`, `НаимОКВЭД` и др.)	Карточка индивидуального предпринимателя по ЕГРИП
`self_employed`	`/self-employed`	`{"status": true/false, "inn": "...", "message": "...", "registration_date": "..."}`	Статус плательщика налога на профессиональный доход (НПД)
`fssp_legal` / `fssp_person`	`/fssp-list`	`{"total": N, "docs": [ {"НомИспПроизв": "...", "СуммаДолга": ..., "ТребИспДок": ...} ]}`	Исполнительные производства ФССП (по компании или физлицу)
`arbitr_legal` / `pravo_search`	`/arbitr-list` / `/court-arbitration`	`{"total": N, "cases": [ {"Номер": "...", "Суд": "...", "СуммаИска": ...} ]}`	Арбитражные судебные дела и картотека арбитражных дел
`fns_block` / `fns_block_person`	`/bank-restrict`	`{"total": N, "items": [ {"bik": "...", "decision_number": "...", "decision_date": "..."} ]}`	Блокировки и приостановления операций по банковским счетам (ФНС)
`bankrot_legal` / `bankrot_person`	`/bankrupt-card`	`{"status": "...", "stage": "...", "arbitr_manager": "...", "case_number": "..."}`	Сведения о процедурах банкротства (Федресурс / ЕФРСБ)
`fns_mass_leaders`	`/mass-leaders`	`{"total": N, "is_mass": true/false, "companies": [...]}`	Реестр массовых руководителей ФНС
`fns_mass_founders`	`/mass-founders`	`{"total": N, "is_mass": true/false, "companies": [...]}`	Реестр массовых учредителей/участников ФНС
`intellectual_property`	`/trademarks` / `/patents`	`{"total": N, "items": [ {"reg_num": "...", "name": "...", "holder": "..."} ]}`	Товарные знаки, патенты и интеллектуальная собственность (Роспатент)
`complex_by_passport` / `complex_by_innfiz`	`/fl-card`	Комплексная анкета физлица: ФИО, ИНН, проверки массовости, ИП, самозанятость, банкротство	Полный скоринг физического лица в формате карточки физлица ZB
`complex_by_inn`	`/multiple-methods` / комплексная карточка ЮЛ	Карточка ЮЛ, обогащенная блоками `ФССП`, `Суды`, `БлокировкаСчетов`, `Банкротство`	Единая карточка юридического лица со всеми проверками
`fns_bo`	`/fs-fns`	Бухгалтерская отчетность (`Форма1`, `Форма2`, `Выручка`, `ЧистаяПрибыль`, `ДинамикаПоГодам`)	Финансовая и бухгалтерская отчетность организации (ФНС / ГИР БО)
`vin_check`	`/transport` / `/pledges`	Карточка ТС: марка, модель, VIN, розыск ГИБДД, ограничения, залог ФНП, периоды владения	Комплексная проверка транспортного средства по VIN / госномеру
`requests` / `history`	`/flcheck/data/list`	Список заявок: `{"total": N, "currentPage": 1, "data": [ {"id": "...", "status": "Готово", "ФИО": "...", "create_at": "..."} ]}`	Журнал и история проведенных проверок физлиц
`data`	`/flcheck/data/report`	Полный отчет по проверке физлица в структуре ЗБ	Получение результатов проверки по ее идентификатору (`id`)

Примеры вызовов по каждому методу¶

Все примеры протестированы и доступны как на боевом контуре (https://api.newdb.net/v2/run?...&token=YOUR_API_TOKEN&format=zb), так и в тестовом контуре Sandbox (https://api.newdb.net/test/v2/run?...&format=zb без списания баланса).

1. Карточка компании по ЕГРЮЛ (`/card`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=egrul&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "ТипДокумента": "ul",
    "ОГРН": "1027700132195",
    "ИНН": "7707083893",
    "КПП": "773601001",
    "НаимЮЛПолн": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
    "НаимЮЛСокр": "ПАО \"СБЕРБАНК\"",
    "Активность": "Действующее",
    "ОбрДата": "1991-06-20",
    "ДатаОГРН": "1991-06-20",
    "Адрес": "117312, Г.МОСКВА, УЛ. ВАВИЛОВА, Д.19",
    "СумКап": 67760844000.0,
    "КодОКВЭД": "64.19",
    "НаимОКВЭД": "Денежное посредничество прочее",
    "Руководители": [
      {
        "ФИО": "ГРЕФ ГЕРМАН ОСКАРОВИЧ",
        "Должн": "Президент, Председатель Правления",
        "ИННФЛ": "770400000000"
      }
    ],
    "urlCard": "https://newdb.net/card/7707083893"
  }
}

2. Карточка ИП по ЕГРИП (`/card`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=egrul_ip&inn=771234567890&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "ТипДокумента": "ip",
    "ОГРН": "320774600123456",
    "ИНН": "771234567890",
    "КПП": "",
    "НаимЮЛПолн": "ИВАНОВ ИВАН ИВАНОВИЧ",
    "НаимЮЛСокр": "ИВАНОВ ИВАН ИВАНОВИЧ",
    "Активность": "Действующее",
    "ОбрДата": "2020-05-15",
    "ДатаОГРН": "2020-05-15",
    "Адрес": "Г. МОСКВА",
    "КодОКВЭД": "62.01",
    "НаимОКВЭД": "Разработка компьютерного программного обеспечения",
    "urlCard": "https://newdb.net/card/771234567890"
  }
}

3. Проверка статуса самозанятого (`/self-employed`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=self_employed&inn=771234567890&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "status": true,
    "inn": "771234567890",
    "message": "Физическое лицо является плательщиком налога на профессиональный доход",
    "registration_date": "2021-02-01"
  }
}

4. Исполнительные производства ФССП (`/fssp-list`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=fssp_legal&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "total": 1,
    "docs": [
      {
        "НомИспПроизв": "12345/21/77001-ИП",
        "ДатаВозбуж": "2021-05-12",
        "Должник": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
        "Адрес": "117312, Г.МОСКВА, УЛ. ВАВИЛОВА, Д.19",
        "ТребИспДок": "Взыскание налогов и сборов",
        "СуммаДолга": 15400.5,
        "ОтделПолиции": "ОСП по ЦАО №1",
        "Пристав": "Петров П.П.",
        "Статус": 1
      }
    ]
  }
}

5. Приостановление операций по счетам ФНС (`/bank-restrict`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=fns_block&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "total": 0,
    "blocked": false,
    "docs": []
  }
}

6. Сведения о банкротстве (`/bankrupt-card`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=bankrot_legal&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "Статус": "NO_BANKRUPTCY",
    "ВсегоЗаписей": 0,
    "Сообщения": []
  }
}

7. Товарные знаки и интеллектуальная собственность (`/trademarks`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=intellectual_property&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "total": 1,
    "ТоварЗнак": [
      {
        "РегНомер": "890123",
        "Название": "NEWDB SMART SEARCH",
        "Статус": "REGISTERED",
        "МКТУ": [
          "9",
          "35",
          "42"
        ],
        "ДатаОконч": "2034-05-15"
      }
    ],
    "Патенты": []
  }
}

8. Судебные дела и картотека арбитража (`/arbitr-list`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=pravo_search&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "точно": {
      "всего": 1,
      "дела": {
        "02-1234/2026": {
          "НомерДела": "02-1234/2026",
          "Суд": "Басманный районный суд г. Москвы",
          "Судья": "Петров П.П.",
          "ДатаРег": "2026-08-15",
          "Статус": "Дело рассмотрено"
        }
      }
    },
    "неточно": {
      "всего": 0,
      "дела": {}
    }
  }
}

9. Комплексная проверка физического лица (`/fl-card`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=complex_by_passport&series=4510&number=123456&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "ИННФЛ": "771234567890",
    "ФИО": "ИВАНОВ ИВАН ИВАНОВИЧ",
    "РегионПолучИНН": null,
    "РегионВедБизнеса": null,
    "РегионДеятИП": null,
    "МассРуководитель": false,
    "МассУчредитель": false,
    "Руководитель": [],
    "Учредитель": [],
    "ИП": {
      "ОГРНИП": "320774600123456",
      "ДатаОГРН": "2020-05-15",
      "Статус": "ACTIVE"
    },
    "Самозанятый": {
      "status": true
    },
    "Банкрот": {
      "status": "NO_BANKRUPTCY"
    }
  }
}

10. Комплексная проверка организации (`/multiple-methods`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=complex_by_inn&inn=7707083893&token=YOUR_TOKEN&format=zb"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "ТипДокумента": "ul",
    "ОГРН": "1027700132195",
    "ИНН": "7707083893",
    "КПП": "773601001",
    "НаимЮЛПолн": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
    "НаимЮЛСокр": "ПАО \"СБЕРБАНК\"",
    "Активность": "Действующее",
    "ОбрДата": "1991-06-20",
    "ДатаОГРН": "1991-06-20",
    "Адрес": "117312, Г.МОСКВА, УЛ. ВАВИЛОВА, Д.19",
    "СумКап": 67760844000.0,
    "КодОКВЭД": "64.19",
    "НаимОКВЭД": "Денежное посредничество прочее",
    "ФССП": {
      "total": 0,
      "docs": []
    },
    "БлокировкаСчетов": {
      "total": 0,
      "blocked": false
    },
    "urlCard": "https://newdb.net/card/7707083893"
  }
}

11. Бухгалтерская отчетность организации (`/fs-fns`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=fns_bo&inn=7707083893&token=YOUR_TOKEN&format=zb"
# Также поддерживается алиас метода ZB: method=fs-fns

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "ИНН": "7707083893",
    "ОГРН": "1027700132195",
    "ПериодОтчета": 2024,
    "Выручка": {
      "2024": 3500000000000.0,
      "2023": 3100000000000.0,
      "2022": 2800000000000.0
    },
    "ЧистаяПрибыль": {
      "2024": 1500000000000.0,
      "2023": 1250000000000.0,
      "2022": 300000000000.0
    },
    "Форма1": {
      "Баланс": { "2024": 42000000000000.0 },
      "ВнеоборотныеАктивы": { "2024": 5000000000000.0 },
      "ОборотныеАктивы": { "2024": 37000000000000.0 },
      "КапиталИРезервы": { "2024": 6500000000000.0 }
    },
    "Форма2": {
      "Выручка": { "2024": 3500000000000.0 },
      "Себестоимость": { "2024": 1200000000000.0 },
      "ВаловаяПрибыль": { "2024": 2300000000000.0 },
      "ЧистаяПрибыль": { "2024": 1500000000000.0 }
    },
    "ДинамикаПоГодам": [
      {
        "Год": 2024,
        "Выручка": 3500000000000.0,
        "ЧистаяПрибыль": 1500000000000.0,
        "Активы": 42000000000000.0
      }
    ]
  }
}

12. Проверка транспортного средства (`/transport`, `/pledges`)¶

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=vin_check&vin=X4XWY39460L583993&token=YOUR_TOKEN&format=zb"
# Также поддерживается алиас метода ZB: method=transport

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "всего": 1,
    "VIN": "X4XWY39460L583993",
    "МаркаМодель": "BMW X3 XDRIVE20I",
    "ГодВыпуска": 2020,
    "Цвет": "БЕЛЫЙ",
    "КатегорияТС": "B",
    "МощностьЛс": "184",
    "ОбъемДвигателя": "1998",
    "РозыскГИБДД": {
      "НайденВРозыске": false,
      "Описание": "В розыске не значится"
    },
    "Ограничения": {
      "НаличиеОграничений": false,
      "Количество": 0,
      "Описание": "Ограничений не обнаружено",
      "Детали": []
    },
    "Залог": {
      "НаходитсяВЗалоге": false,
      "КоличествоЗалогов": 0,
      "Описание": "Сведений о залоге в реестре залогов ФНП не найдено",
      "Уведомления": []
    },
    "ПТС": {
      "РозыскПТС": false,
      "Описание": "ПТС не разыскивается"
    },
    "ПериодыВладения": [
      {
        "from": "28.07.2020",
        "to": null,
        "is_current": true,
        "owner_type": "Физическое лицо",
        "operation": "Регистрация нового ТС"
      }
    ]
  }
}

13. Участие в государственных закупках 44-ФЗ / 223-ФЗ (`/zakupki`, `/contracts`)¶

Поиск государственных и корпоративных контрактов поставщика или заказчика (для юридических лиц — contracts, для физлиц и ИП — contracts_person).

Запрос:

curl -X GET "https://api.newdb.net/v2/run?method=contracts&inn=7712345678&token=YOUR_TOKEN&format=zb"
# Также поддерживаются алиасы: method=zakupki, method=purchases, method=contracts_person

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "aggr": {
      "customer_sum": 0.0,
      "participant_sum": 126450000.0
    },
    "customer": [],
    "participant": [
      {
        "registry_number": "2770123456725000041",
        "law": "44-ФЗ",
        "customer": "ГБУ ЦИФРОВЫЕ СЕРВИСЫ",
        "subject": "Поставка серверного оборудования",
        "price": 18450000.0,
        "status": "Исполнение завершено",
        "sign_date": "2024-03-15",
        "url": "https://zakupki.gov.ru/epz/contract/contractCard/common-info.html?reestrNumber=2770123456725000041"
      }
    ]
  }
}

Эндпоинты проверки физлиц в стиле ЗЧБ (`/flcheck/data/*`)¶

Для бесшовной миграции интеграций (включая фронтенды и бэкенды на базе API «ЗаЧестныйБизнес» / flcheck) NewDB предоставляет прямые эндпоинты совместимости:

1. Создание проверки (`/flcheck/data/create`)¶

curl -X GET "https://api.newdb.net/flcheck/data/create?lastname=Иванов&firstname=Иван&secondname=Иванович&birthdate=1990-01-01&series_passport=4510&number_passport=123456&api_key=YOUR_KEY"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "idRequest": "900000001",
  "rem_request": 999999
}

2. Журнал и статус проверок (`/flcheck/data/list`)¶

curl -X GET "https://api.newdb.net/flcheck/data/list?page=1&api_key=YOUR_KEY"

Ответ:

{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "total": 1,
  "currentPage": 1,
  "data": [
    {
      "id": "900000001",
      "status": "Готово",
      "ФИО": "ИВАНОВ ИВАН ИВАНОВИЧ",
      "birthdate": "1990-01-01",
      "inn": "771234567890",
      "паспорт": "4510 123456",
      "ВУ": null,
      "create_at": "2026-09-14 12:00:00"
    }
  ]
}

3. Полный 39-блочный отчет (`/flcheck/data/report`)¶

curl -X GET "https://api.newdb.net/flcheck/data/report?fl_request_id=900000001&api_key=YOUR_KEY"

Возвращает точный массив из 39 блоков ЗЧБ: invalid_passport, inn_from_passport, mvd, terror, foreign_agent, fssp, general_jurisdiction, bankrupt, self_employed, bank_restrict, mass_leaders, mass_founders, court_arbitration, tax_deb, egrip, invalid_inn, signs, leasing, s_facts, region_inn, fsin, gibdd, gibdd_tax, cbr_rating, dirty_register, first_buisness, partners, contacts, msp, zakupki, unfair_supplier, measures_for_violation, disqual, no_corr_boss, no_corr_founder, region_buisness, egrul, fssp_company, pledge_person.

Каждый блок содержит канонический вид:

{
  "id": "bankrupt",
  "source": "Проверка на Банкротство",
  "sourceCode": 9,
  "status": "Готово",
  "statusCode": 2,
  "response": [
    {
      "id": "15978111",
      "category": "Сообщение о судебном акте",
      "date": "15.02.2025"
    }
  ],
  "create_at": "2026-09-15 12:00:00",
  "update_at": "2026-09-15 12:00:05"
}

4. Карточки по клику (детализация)¶

/flcheck/data/bankrupt-message?fl_request_id=...&id=... — детали сообщения о банкротстве
/flcheck/data/sfact-message?fl_request_id=...&id=... — существенный факт / залог
/flcheck/data/court-arbitration-card?fl_request_id=...&id=... — карточка арбитражного дела
/flcheck/data/general-jurisdiction-list?fl_request_id=... — список дел судов общей юрисдикции
/flcheck/data/court-general-jurisdiction-card?id=...&court_id=... — карточка дела СОЮ

Тестирование в Sandbox (без расхода баланса)¶

Конвертер и эндпоинты /flcheck/data/* полностью поддержаны в тестовом контуре NewDB API:

curl -X GET "https://api.newdb.net/test/v2/flcheck/data/report?fl_request_id=900000001"

Запрос мгновенно вернет тестовый 39-блочный отчет физлица в формате ЗБ без списания реального баланса.

Режим совместимости с форматом «ЗАПРАВИЛЬНЫЙБИЗНЕС» (ZB)¶

Как включить формат «ЗАПРАВИЛЬНЫЙБИЗНЕС»¶

Структура ответа (Конверт ZB)¶

Коды статусов (status):¶

Поддерживаемые методы и соответствие контрактам¶

Примеры вызовов по каждому методу¶

1. Карточка компании по ЕГРЮЛ (/card)¶

2. Карточка ИП по ЕГРИП (/card)¶

3. Проверка статуса самозанятого (/self-employed)¶

4. Исполнительные производства ФССП (/fssp-list)¶

5. Приостановление операций по счетам ФНС (/bank-restrict)¶

6. Сведения о банкротстве (/bankrupt-card)¶

7. Товарные знаки и интеллектуальная собственность (/trademarks)¶

8. Судебные дела и картотека арбитража (/arbitr-list)¶

9. Комплексная проверка физического лица (/fl-card)¶

10. Комплексная проверка организации (/multiple-methods)¶

11. Бухгалтерская отчетность организации (/fs-fns)¶

12. Проверка транспортного средства (/transport, /pledges)¶

13. Участие в государственных закупках 44-ФЗ / 223-ФЗ (/zakupki, /contracts)¶

Эндпоинты проверки физлиц в стиле ЗЧБ (/flcheck/data/*)¶

1. Создание проверки (/flcheck/data/create)¶

2. Журнал и статус проверок (/flcheck/data/list)¶

3. Полный 39-блочный отчет (/flcheck/data/report)¶

4. Карточки по клику (детализация)¶

Тестирование в Sandbox (без расхода баланса)¶

Коды статусов (`status`):¶

1. Карточка компании по ЕГРЮЛ (`/card`)¶

2. Карточка ИП по ЕГРИП (`/card`)¶

3. Проверка статуса самозанятого (`/self-employed`)¶

4. Исполнительные производства ФССП (`/fssp-list`)¶

5. Приостановление операций по счетам ФНС (`/bank-restrict`)¶

6. Сведения о банкротстве (`/bankrupt-card`)¶

7. Товарные знаки и интеллектуальная собственность (`/trademarks`)¶

8. Судебные дела и картотека арбитража (`/arbitr-list`)¶

9. Комплексная проверка физического лица (`/fl-card`)¶

10. Комплексная проверка организации (`/multiple-methods`)¶

11. Бухгалтерская отчетность организации (`/fs-fns`)¶

12. Проверка транспортного средства (`/transport`, `/pledges`)¶

13. Участие в государственных закупках 44-ФЗ / 223-ФЗ (`/zakupki`, `/contracts`)¶

Эндпоинты проверки физлиц в стиле ЗЧБ (`/flcheck/data/*`)¶

1. Создание проверки (`/flcheck/data/create`)¶

2. Журнал и статус проверок (`/flcheck/data/list`)¶

3. Полный 39-блочный отчет (`/flcheck/data/report`)¶