Langsung ke konten utama
POST
Memverifikasi terhadap database CPF/CNPJ. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang sudah dinormalisasi. Format input: tax_number menerima CPF Brasil (tepat 11 digit).

Cakupan

  • Cakupan: ~ 100%
  • Negara: Brasil
  • ID layanan: bra_tax_registration
  • Domain data: Keuangan
  • Kategori: TaxRegistry

Input

  • Input wajib: first_name, last_name, date_of_birth, tax_number
  • Input opsional: vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 100%
  • Harga: $0.15 per query yang berhasil
Tidak setiap dokumen yang diterima layanan ini memuat pengenal yang digunakan untuk query. Jika pengenal tidak diekstrak dari dokumen, pemeriksaan dicatat sebagai tidak berlaku – tidak ada kueri database yang dijalankan dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini berlaku pada sebagian besar pengguna nyata. Untuk menjangkau mereka, kumpulkan juga pengenal dari jawaban Kuesioner, kolom ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"BRA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: BRA
string
default:"bra_tax_registration"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: bra_tax_registration
string
default:"John"
wajib
Nama depan yang akan divalidasi.Contoh: John
string
default:"Doe"
wajib
Nama belakang yang akan divalidasi.Contoh: Doe
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"11111111111"
wajib
Nomor identifikasi pajak atau fiskal.Contoh: 11111111111
string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • CPF Brasil (tepat 11 digit)
  • tax_number hanya boleh berisi angka; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • tax_number harus tepat 11 karakter.

Cara memanggilnya

Data yang dikembalikan

Kolom persis yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk bra_tax_registration saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • date_of_birth
  • identification_number
  • name_match_score

Harga & SLA

Query Brazil Tax Registration (CPF/CNPJ) hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.15 USD.
  • Penagihan: per query yang berhasil. Anda tidak dikenai biaya 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.

Lanjut membaca

Terakhir diubah pada 7 November 2026