> ## 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.

# Validasi Database Brazil: API Partner & Direktur (QSA)

> Validasi database resmi Brazil via Didit untuk partner dan direktur perusahaan (QSA). Mulai $0.20 per panggilan, tanpa kontrak, tanpa minimum.

Mengembalikan mitra dan direktur (QSA) terkini dari sebuah perusahaan Brasil dari registri Receita Federal, lengkap dengan peran dan tanggal mulai masing-masing. CPF individu disamarkan sebagaimana dipublikasikan oleh Receita Federal. Didit menyediakan layanan ini melalui `POST /v3/database-validation/` agar Anda dapat memverifikasi data yang dikirimkan terhadap sumber otoritatif dan menerima hasil pencocokan yang sudah dinormalisasi.

## Cakupan

* **Cakupan:** \~ 100%
* **Negara:** Brasil
* **ID layanan:** `bra_company_directors`
* **Domain data:** Pemerintah
* **Kategori:** CompanyRegister

## Input

| Kolom | Wajib | Contoh |
| - | -: | - |
| `company_registration_number` | Ya | `11222333000181` |
| `vendor_data` | Tidak | `user-1234` |

* **Input wajib:** `company_registration_number`
* **Input opsional:** `vendor_data`
* **Persetujuan:** Tidak diperlukan
* **Ketersediaan alur kerja:** Tersedia dalam alur kerja dengan pemetaan kolom
* **Cakupan:** \~ 100%
* **Harga:** \$0.20 per kueri yang berhasil

Dalam alur kerja, `company_registration_number` tidak tercetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya dengan sendirinya. Kumpulkan nilainya dari jawaban Kuesioner, kolom ekstraksi Document AI, atau nilai yang Anda kirimkan saat membuat sesi, lalu petakan ke langkah Validasi Database. Sebelum dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang belum ada. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum kueri apa pun, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dimintai kueri.

## Parameter body

**issuing\_state** `string` *required* (default: BRA)

Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.

Contoh: `BRA`

**services** `string` *required* (default: bra\_company\_directors)

Array yang berisi ID layanan ini. Menetapkan layanan ini menjaga permintaan tetap terbatas pada database yang persis ini.

Contoh: `bra_company_directors`

**company\_registration\_number** `string` *required* (default: 11222333000181)

Nilai `company_registration_number` yang diperlukan oleh layanan database ini.

Contoh: `11222333000181`

**vendor\_data** `string` (default: user-1234)

Referensi pengguna tetap Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam deteksi duplikat.

Contoh: `user-1234`

## Aturan input & catatan validasi

* `company_registration_number` harus cocok dengan `[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}`.

## Cara memanggilnya

```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"
```

Setiap panggilan yang berhasil mengembalikan HTTP `200`. Field **`outcome_code`** memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang sebenarnya (`BIOMETRIC_NO_MATCH`) dari swafoto yang tidak dapat dibaca (`BIOMETRIC_IMAGE_UNUSABLE`). `status` yang ditampilkan adalah status fitur default; [tindakan Partial Match / No Match](https://docs.didit.me/id/core-technology/database-validation/database-validation-warnings.md) yang Anda konfigurasi dapat menggantinya.

**`MATCH`** — Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.

```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": {}
    }
  ]
}
```

## Data yang dikembalikan

Kolom persis yang muncul di `source_data` bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk `bra_company_directors` saat ini mendokumentasikan bentuk ternormalisasi berikut:

* `directors`
* `registration_number`

## Harga & SLA

Kueri Brasil - Mitra dan Direktur Perusahaan (QSA) hanya ditagih ketika Didit menerima hasil konklusif dari sumber validasi.

* **Harga per panggilan:** \$0.20 USD.
* **Penagihan:** per kueri yang berhasil. Anda tidak ditagih ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
* **Latensi:** p95 tipikal \< 2 s.
* **Ketersediaan:** 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

## Lanjutkan membaca

* [Ikhtisar Validasi Database Brasil](https://docs.didit.me/api-reference/database-validation/brazil.md)
* [Ikhtisar Validasi Database](https://docs.didit.me/id/core-technology/database-validation/overview.md)
* [Kode Hasil](https://docs.didit.me/id/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.