Saltar al contingut principal
POST
Retorna els socis i administradors (QSA) actuals d’una empresa brasilera del registre de la Receita Federal, amb el rol de cada un i la data d’inici. Els CPF de les persones físiques es mostren emmascarats tal com els publica la Receita Federal. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè pugueu verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: ~ 100%
  • País: Brasil
  • ID del servei: bra_company_directors
  • Àmbit de dades: Governament
  • Categoria: CompanyRegister

Entrades

  • Entrades obligatòries: company_registration_number
  • Entrades opcionals: vendor_data
  • Consentiment: No cal
  • Disponibilitat en un flux de treball: Disponible en un flux de treball amb mapatge de camps
  • Cobertura: ~ 100%
  • Preu: $0.20 per consulta satisfactòria
En un flux de treball, company_registration_number no apareix imprès en cap document d’identitat, així que cap pas no el produeix per si sol. Recolliu-lo d’una resposta d’un Qüestionari, d’un camp d’extracció de Document AI o d’un valor que envieu en crear la sessió, i mapeu-lo al pas de Validació en bases de dades. Mentre no estigui mapat, l’editor de flux de treball mostra aquest servei desactivat i indica l’entrada que falta. En temps d’execució, una entrada que falta fa que la comprovació s’ometi abans de cap consulta, de manera que mai no us facturen una base de dades que no s’ha pogut consultar.

Paràmetres del cos

string
predeterminat:"BRA"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: BRA
string
predeterminat:"bra_company_directors"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: bra_company_directors
string
predeterminat:"11222333000181"
requerit
Valor de company_registration_number que requereix aquest servei de base de dades.Exemple: 11222333000181
string
predeterminat:"user-1234"
La vostra referència estable d’usuari per a aquesta persona, com ara el vostre ID intern d’usuari. Didit l’utilitza per enllaçar les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • company_registration_number ha de coincidir amb [0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a bra_company_directors documenta actualment aquesta forma normalitzada:
  • directors
  • registration_number

Preus i SLA

Les consultes de socis i administradors d’empreses del Brasil (QSA) es facturen només quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.20 USD.
  • Facturació: per consulta satisfactòria. No se us factura quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típica < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font aigües avall varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026