Перейти к основному содержанию
POST
Проверяет данные по базе CPF/CNPJ. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с первоисточником и получить нормализованные результаты сопоставления. Формат ввода: tax_number принимает бразильский CPF (ровно 11 цифр).

Охват

  • Охват: ~ 100%
  • Страна: Бразилия
  • Идентификатор сервиса: bra_tax_registration
  • Область данных: Финансовые данные
  • Категория: Налоговый реестр

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

  • Обязательные входные данные: first_name, last_name, date_of_birth, tax_number
  • Необязательные входные данные: vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии
  • Охват: ~ 100%
  • Цена: $0.15 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как не применима: база данных не запрашивается и с вас не взимается плата. Для некоторых стран такие случаи составляют значительную долю реальных пользователей. Чтобы охватить их, получайте идентификатор также из ответа в Анкетах, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге «Проверка по базам данных».

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

string
по умолчанию:"BRA"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: BRA
string
по умолчанию:"bra_tax_registration"
обязательно
Массив, содержащий идентификатор этого сервиса. Фиксация сервиса ограничивает запрос именно этой базой данных.Пример: bra_tax_registration
string
по умолчанию:"John"
обязательно
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия, которую нужно проверить.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"11111111111"
обязательно
Налоговый или фискальный идентификационный номер.Пример: 11111111111
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор пользователя для этого человека, например внутренний ID пользователя. Didit использует его, чтобы связать отдельные проверки с одним и тем же конечным пользователем и уменьшить количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

  • Бразильский CPF (ровно 11 цифр)
  • tax_number должен содержать только цифры; перед отправкой запроса удалите пробелы, дефисы и знаки препинания.
  • tax_number должен содержать ровно 11 символов.

Как выполнить вызов

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

Точный набор полей, которые выводятся в source_data, зависит от того, что возвращает реестр. Сгенерированный пример для bra_tax_registration сейчас описывает такую нормализованную структуру:
  • date_of_birth
  • identification_number
  • name_match_score

Цены и SLA

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

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

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