> ## 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 Registri Perusahaan Brasil (CNPJ) API

> Pencarian registri perusahaan Brasil (CNPJ) dari basis data resmi lewat Didit. Bayar per panggilan mulai $0.20, tanpa kontrak, tanpa minimum.

Mencari perusahaan Brasil berdasarkan CNPJ di registri Receita Federal: nama hukum dan nama dagang, status registrasi, tanggal pendirian, sifat hukum, aktivitas utama, dan negara bagian kantor pusat. Didit menyediakan layanan ini melalui `POST /v3/database-validation/` agar Anda dapat memverifikasi data yang dikirimkan terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi.

## Cakupan

* **Cakupan:** \~ 100%
* **Negara:** Brasil
* **ID layanan:** `bra_company_registry`
* **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 dicetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan nilainya dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database. Sampai nilai ini dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang hilang. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum kueri apa pun, sehingga Anda tidak pernah ditagih untuk kueri ke database yang tidak dapat dilakukan.

## 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\_registry)

Array yang berisi ID layanan ini. Menetapkan layanan ini memastikan permintaan hanya ditujukan ke database yang tepat.

Contoh: `bra_company_registry`

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

Nilai `company_registration_number` yang diwajibkan 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 mandiri ke pengguna akhir yang sama dan mengurangi gangguan pada 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 memanggil

```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_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"
```

Setiap panggilan yang berhasil mengembalikan HTTP `200`. Kolom **`outcome_code`** memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang nyata (`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_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}
```

**`DOCUMENT_NOT_FOUND`**: Nomor dokumen yang dikirimkan tidak sesuai dengan catatan apa pun di registri.

```json 200 OK — DOCUMENT_NOT_FOUND theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}
```

## Data yang dikembalikan

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

* `company_name`
* `company_status`
* `company_status_date`
* `headquarters_state`
* `identification_number`
* `legal_nature`
* `main_activity`
* `main_activity_code`
* `registration_date`
* `registration_number`
* `trade_name`

## Harga & SLA

Kueri Pencarian Registri Perusahaan Brasil (CNPJ) hanya ditagih jika Didit menerima hasil yang meyakinkan dari sumber validasi.

* **Harga per panggilan:** \$0.20 USD.
* **Penagihan:** per kueri yang berhasil. Anda tidak dikenai biaya saat registri tidak dapat dijangkau, saat kolom wajib tidak ada, atau saat 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.