> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 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. 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 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 **issuing\_state** `string` *required* (default: BRA) Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades. Exemple: `BRA` **services** `string` *required* (default: bra\_company\_directors) 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` **company\_registration\_number** `string` *required* (default: 11222333000181) Valor de `company_registration_number` que requereix aquest servei de base de dades. Exemple: `11222333000181` **vendor\_data** `string` (default: 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 ```bash cURL theme={null} 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](https://docs.didit.me/ca/core-technology/database-validation/database-validation-warnings.md) poden substituir-lo. **`MATCH`** — El registre ha confirmat la identitat i tots els camps comprovats han coincidit. ```json 200 OK — MATCH theme={null} { "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 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 * [Visió general de la validació en bases de dades del Brasil](https://docs.didit.me/api-reference/database-validation/brazil.md) * [Visió general de la validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md) * [Codis de resultat](https://docs.didit.me/ca/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.