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

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

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

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

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

  1. Параметр в строке запроса (Query parameter):
  2. format=zb (или _format=zb, format=ЗБ)
  3. Поле в теле JSON-запроса:
  4. "format": "zb"
  5. HTTP-заголовок запроса:
  6. 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 / комплексная карточка ЮЛ Карточка ЮЛ, обогащенная блоками ФССП, Суды, БлокировкаСчетов, Банкротство Единая карточка юридического лица со всеми проверками

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

Все примеры протестированы и доступны как на боевом контуре (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"
  }
}

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

Конвертер полностью поддержан в тестовом контуре NewDB API: 

curl -X GET "https://api.newdb.net/test/v2/run?method=egrul&inn=7707083893&format=zb"
Запрос мгновенно вернет тестовую карточку компании в формате ZB без списания реального баланса.