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

# Sudafrica - Verifica della proprietà del veicolo API

> Verifica della proprietà del veicolo in Sudafrica tramite database ufficiale con Didit. Da $3.36 per chiamata, senza contratti né minimi.

Conferma che una persona fisica sudafricana è il proprietario registrato di un determinato veicolo tramite il registro dei veicoli NATIS. Didit espone questo servizio tramite `POST /v3/database-validation/` in modo che tu possa verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

## Copertura

* **Copertura:** —
* **Paese:** Sudafrica
* **ID servizio:** `zaf_vehicle_ownership`
* **Dominio dei dati:** Governo
* **Categoria:** Altro

## Input

| Campo | Obbligatorio | Esempio |
| - | -: | - |
| `national_id` | Sì | `SAMPLE-NID-12345` |
| `vehicle_register_number` | Sì | `VRN123456` |
| `vehicle_licence_plate` | Sì | `ABC123GP` |
| `vin` | Sì | `1HGCM82633A004352` |
| `vendor_data` | No | `user-1234` |

* **Input obbligatori:** `national_id`, `vehicle_register_number`, `vehicle_licence_plate`, `vin`
* **Input facoltativi:** `vendor_data`
* **Consenso:** non richiesto
* **Disponibilità nel workflow:** disponibile nel workflow con mappatura dei campi
* **Copertura:** —
* **Prezzo:** \$3.36 per query riuscita

In un workflow, `vehicle_register_number`, `vehicle_licence_plate` e `vin` non sono stampati su un documento d'identità, quindi nessun passaggio li produce autonomamente. Raccoglili da una risposta a un questionario, da un campo di estrazione di Document AI oppure da un valore che invii quando crei la sessione, e mappa ciascuno nel passaggio Validazione su database. Finché non sono mappati, l'editor del workflow mostra questo servizio disabilitato e indica l'input mancante; in fase di esecuzione un input mancante significa che il controllo viene saltato prima di qualsiasi query, quindi non ti viene mai addebitato un database che non si sarebbe potuto interrogare.

## Parametri del corpo

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

Codice paese ISO 3166-1 alpha-3 per questo servizio di database.

Esempio: `ZAF`

**services** `string` *required* (default: zaf\_vehicle\_ownership)

Array che contiene l'ID di questo servizio. Fissare il servizio mantiene la richiesta limitata a questo specifico database.

Esempio: `zaf_vehicle_ownership`

**national\_id** `string` *required* (default: SAMPLE-NID-12345)

Numero di identità nazionale per questo servizio.

Esempio: `SAMPLE-NID-12345`

**vehicle\_register\_number** `string` *required* (default: VRN123456)

Valore di `vehicle_register_number` richiesto da questo servizio di database.

Esempio: `VRN123456`

**vehicle\_licence\_plate** `string` *required* (default: ABC123GP)

Valore di `vehicle_licence_plate` richiesto da questo servizio di database.

Esempio: `ABC123GP`

**vin** `string` *required* (default: 1HGCM82633A004352)

Valore di `vin` richiesto da questo servizio di database.

Esempio: `1HGCM82633A004352`

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

Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dei rilevamenti di duplicati.

Esempio: `user-1234`

## Regole di input e note di validazione

* Invia i campi sopra elencati esattamente come acquisiti dall'utente o dal documento.
* Didit convalida i campi obbligatori prima di chiamare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

## Come chiamarlo

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_vehicle_ownership" \
  -F "vendor_data=user-1234" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "vehicle_register_number=VRN123456" \
  -F "vehicle_licence_plate=ABC123GP" \
  -F "vin=1HGCM82633A004352"
```

Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo ad esempio una reale mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non è stato possibile leggere (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità; le [azioni configurate per Partial Match / No Match](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sostituirlo.

**`MATCH`**: il registro ha confermato l'identità e ogni campo verificato corrispondeva.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_vehicle_ownership",
      "service_name": "South Africa - Vehicle Ownership Verification",
      "source_data": {
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: il registro non ha restituito alcuna corrispondenza per i dati inviati.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_vehicle_ownership",
      "service_name": "South Africa - Vehicle Ownership Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

## Dati restituiti

I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `zaf_vehicle_ownership` documenta attualmente questa struttura normalizzata:

* `identification_number`

## Prezzi e SLA

Sudafrica - le query di Verifica della proprietà del veicolo vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.

* **Prezzo per chiamata:** \$3.36 USD.
* **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
* **Latenza:** p95 tipico \< 2 s.
* **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

## Continua a leggere

* [Panoramica della Validazione su database per il Sudafrica](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Panoramica della Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md)
* [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md)


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