Validasi Registri Perusahaan Brasil (CNPJ) API

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"

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

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

POST

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_registry" \
  -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_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": {}
    }
  ]
}

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

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

string

default:"BRA"

wajib

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

string

default:"bra_company_registry"

wajib

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

string

default:"11222333000181"

wajib

Nilai company_registration_number yang diwajibkan oleh layanan database ini.Contoh: 11222333000181

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

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 yang Anda konfigurasi dapat menggantinya.

MATCH: Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.

{
  "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.

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

Terakhir diubah pada 7 November 2026

​Cakupan

​Input

​Parameter body

​Aturan input & catatan validasi

​Cara memanggil

​Data yang dikembalikan

​Harga & SLA

​Lanjutkan membaca

Cakupan

Input

Parameter body

Aturan input & catatan validasi

Cara memanggil

Data yang dikembalikan

Harga & SLA

Lanjutkan membaca