Перейти к основному содержанию
POST
Ищет бразильскую компанию по CNPJ в реестре Receita Federal: юридическое и торговое наименование, статус регистрации, дату основания, организационно-правовую форму, основной вид деятельности и штат головного офиса. Didit предоставляет эту услугу через POST /v3/database-validation/, чтобы вы могли сверить переданные данные с авторитетным источником и получить нормализованные результаты сопоставления.

Покрытие

  • Покрытие: ~ 100%
  • Страна: Бразилия
  • ID услуги: bra_company_registry
  • Область данных: Государственные данные
  • Категория: CompanyRegister

Входные данные

  • Обязательные входные данные: company_registration_number
  • Необязательные входные данные: vendor_data
  • Согласие: не требуется
  • Доступность в сценарии: доступно в сценарии с сопоставлением полей
  • Покрытие: ~ 100%
  • Цена: $0.20 за успешный запрос
В сценарии company_registration_number не печатается на удостоверении личности, поэтому ни один шаг не создаёт его сам по себе. Получите его из ответа в анкете, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге проверки по базам данных. Пока поле не сопоставлено, редактор сценария показывает эту услугу как отключённую и называет недостающий входной параметр. Во время выполнения отсутствующий входной параметр означает, что проверка пропускается до любого запроса, поэтому с вас не взимается плата за базу данных, по которой не удалось выполнить запрос.

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

string
по умолчанию:"BRA"
обязательно
Код страны ISO 3166-1 alpha-3 для этой услуги проверки по базе данных.Пример: BRA
string
по умолчанию:"bra_company_registry"
обязательно
Массив, содержащий этот ID услуги. Закрепление услуги ограничивает запрос именно этой базой данных.Пример: bra_company_registry
string
по умолчанию:"11222333000181"
обязательно
Значение company_registration_number, обязательное для этой услуги проверки по базе данных.Пример: 11222333000181
string
по умолчанию:"user-1234"
Ваш постоянный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

Правила ввода и примечания по валидации

  • company_registration_number должен соответствовать шаблону [0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}.

Как вызвать

Возвращаемые данные

Точный набор полей, которые выводятся в source_data, зависит от того, что возвращает реестр. Сгенерированный пример для bra_company_registry сейчас описывает такую нормализованную структуру:
  • company_name
  • company_status
  • company_status_date
  • headquarters_state
  • identification_number
  • legal_nature
  • main_activity
  • main_activity_code
  • registration_date
  • registration_number
  • trade_name

Цены и SLA

Запросы в реестр компаний Бразилии (CNPJ) оплачиваются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $0.20 USD.
  • Оплата: за успешный запрос. Плата не взимается, если реестр недоступен, если не хватает обязательных полей или если запрос отклонён до обращения к источнику.
  • Задержка: типичный p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.

Что почитать дальше

Последнее изменение 7 ноября 2026 г.