Перейти к основному содержанию
POST
Возвращает текущих партнёров и директоров (QSA) бразильской компании из реестра Receita Federal с указанием их роли и даты начала. Номера CPF физических лиц маскируются так, как их публикует Receita Federal. Didit предоставляет эту услугу через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сопоставления.

Охват

  • Охват: ~ 100%
  • Страна: Бразилия
  • ID сервиса: bra_company_directors
  • Домен данных: Государственные данные
  • Категория: 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_directors"
обязательно
Массив, содержащий идентификатор этого сервиса. Указание сервиса ограничивает запрос этой конкретной базой данных.Пример: bra_company_directors
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_directors в настоящее время документирует такую нормализованную структуру:
  • directors
  • registration_number

Цены и SLA

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

Читайте также

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