> ## 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. # Brasile: API soci e amministratori (QSA) > Brasile - Soci e amministratori (QSA): ricerca su database ufficiale brasiliano tramite Didit. A consumo da $0.20 per chiamata, senza contratti né minimi. Restituisce i soci e gli amministratori attuali (QSA) di una società brasiliana dal registro della Receita Federal, con il ruolo e la data di inizio di ciascuno. I CPF delle persone fisiche sono mascherati come li pubblica la Receita Federal. Didit espone questo servizio tramite `POST /v3/database-validation/`, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. ## Copertura * **Copertura:** \~ 100% * **Paese:** Brasile * **ID del servizio:** `bra_company_directors` * **Dominio dei dati:** Governativo * **Categoria:** CompanyRegister ## Input | Campo | Obbligatorio | Esempio | | - | -: | - | | `company_registration_number` | Sì | `11222333000181` | | `vendor_data` | No | `user-1234` | * **Input obbligatori:** `company_registration_number` * **Input facoltativi:** `vendor_data` * **Consenso:** non richiesto * **Disponibilità nel workflow:** disponibile nel workflow con mappatura dei campi * **Copertura:** \~ 100% * **Prezzo:** \$0.20 per query riuscita In un workflow, `company_registration_number` non è stampato su alcun documento di identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta di un Questionario, da un campo estratto da Document AI oppure da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database. Finché non è mappato, l'editor del workflow mostra questo servizio disattivato e indica l'input mancante. In fase di esecuzione, un input mancante fa sì che il controllo venga saltato prima di qualsiasi query, quindi non ti viene mai addebitato il costo di una query a un database che non è stato possibile interrogare. ## Parametri del body **issuing\_state** `string` *required* (default: BRA) Codice paese ISO 3166-1 alpha-3 per questo servizio di database. Esempio: `BRA` **services** `string` *required* (default: bra\_company\_directors) Array che contiene l'ID di questo servizio. Specificare il servizio limita la richiesta esattamente a questo database. Esempio: `bra_company_directors` **company\_registration\_number** `string` *required* (default: 11222333000181) Valore di `company_registration_number` richiesto da questo servizio di database. Esempio: `11222333000181` **vendor\_data** `string` (default: user-1234) Il tuo riferimento stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dovuto al rilevamento dei duplicati. Esempio: `user-1234` ## Regole di input e note di validazione * `company_registration_number` deve corrispondere a `[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}`. ## Come effettuare la chiamata ```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" ``` Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo ad esempio una vera mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non è stato possibile leggere (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità. Le tue [azioni Partial Match / No Match configurate](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sovrascriverlo. **`MATCH`**: il registro ha confermato l'identità e ogni campo verificato corrisponde. ```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": {} } ] } ``` ## Dati restituiti I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `bra_company_directors` documenta attualmente questa struttura normalizzata: * `directors` * `registration_number` ## Prezzi e SLA Le query Brasile - Soci e amministratori (QSA) vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione. * **Prezzo per chiamata:** \$0.20 USD. * **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte. * **Latenza:** p95 tipico \< 2 s. * **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset. ## Continua la lettura * [Panoramica Validazione su database Brasile](https://docs.didit.me/api-reference/database-validation/brazil.md) * [Panoramica Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md) * [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.