curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
🇧🇷 Brasil
Brasil - API de socis i administradors d'empreses (QSA)
Consulta autoritativa de socis i administradors d’empreses al Brasil amb Didit. Des de $0.20 per crida, sense contractes ni mínims.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
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
| Camp | Obligatori | Exemple |
|---|---|---|
company_registration_number | Sí | 11222333000181 |
vendor_data | No | user-1234 |
- 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
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:
BRAstring
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_directorsstring
predeterminat:"11222333000181"
requerit
Valor de
company_registration_number que requereix aquest servei de base de dades.Exemple: 11222333000181string
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-1234Regles d’entrada i notes de validació
company_registration_numberha 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
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
Cada crida satisfactòria retorna HTTP 200. El camp outcome_code us indica què ha passat realment, i distingeix, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status que es mostra és l’estat predeterminat de la funcionalitat; les vostres accions configurades per a Coincidència parcial / Sense coincidència poden substituir-lo.MATCH — El registre ha confirmat la identitat i tots els camps comprovats han coincidit.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
Dades retornades
Els camps exactes que apareixen asource_data depenen del que retorni el registre. L’exemple generat per a bra_company_directors documenta actualment aquesta forma normalitzada:
directorsregistration_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