Vai al contenuto principale
POST
Restituisce lo stato del CPF (regolare, sospeso, annullato), il nome, il nome sociale e la data di iscrizione dai dati di Receita Federal tramite SERPRO. La ricerca si basa sul CPF e sulla data di nascita. 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. Formato di input: tax_number accetta il CPF brasiliano (esattamente 11 cifre).

Copertura

  • Copertura: ~ 100%
  • Paese: Brasile
  • ID servizio: bra_cpf
  • Dominio dei dati: Identità
  • Categoria: TaxRegistry

Input

  • Input obbligatori: tax_number, date_of_birth
  • Input facoltativi: first_name, last_name, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $0.20 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui il servizio effettua la ricerca. Quando l’identificativo non viene estratto dal documento, il controllo viene registrato come non applicabile: nessuna banca dati viene interrogata e non ti viene addebitato alcun costo. In alcuni paesi questa situazione riguarda una quota importante degli utenti reali. Per coprire questi casi, raccogli l’identificativo anche da una risposta di un Questionario, da un campo di estrazione di Document AI o da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio Validazione su database.

Parametri del corpo

string
predefinito:"BRA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di banca dati.Esempio: BRA
string
predefinito:"bra_cpf"
obbligatorio
Array che contiene questo ID servizio. Specificare il servizio limita la richiesta a questa specifica banca dati.Esempio: bra_cpf
string
predefinito:"11111111111"
obbligatorio
Numero di identificazione fiscale.Esempio: 11111111111
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli indipendenti allo stesso utente finale e ridurre il rumore nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • CPF brasiliano (esattamente 11 cifre)
  • tax_number deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • tax_number deve essere lungo esattamente 11 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per bra_cpf documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

Prezzi e SLA

Brasile - le query di verifica dello stato del CPF vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.20 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato alcun costo quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: tipicamente p95 < 2 s.
  • Disponibilità: 99.9% per trimestre da parte di Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Continua a leggere

Ultima modifica il 7 novembre 2026